KiCad PCB EDA Suite
router_tool.h
Go to the documentation of this file.
1 /*
2  * KiRouter - a push-and-(sometimes-)shove PCB router
3  *
4  * Copyright (C) 2013-2017 CERN
5  * Copyright (C) 2016 KiCad Developers, see AUTHORS.txt for contributors.
6  * Author: Tomasz Wlostowski <tomasz.wlostowski@cern.ch>
7  * Author: Maciej Suminski <maciej.suminski@cern.ch>
8  *
9  * This program is free software: you can redistribute it and/or modify it
10  * under the terms of the GNU General Public License as published by the
11  * Free Software Foundation, either version 3 of the License, or (at your
12  * option) any later version.
13  *
14  * This program is distributed in the hope that it will be useful, but
15  * WITHOUT ANY WARRANTY; without even the implied warranty of
16  * MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the GNU
17  * General Public License for more details.
18  *
19  * You should have received a copy of the GNU General Public License along
20  * with this program. If not, see <http://www.gnu.org/licenses/>.
21  */
22 
23 #ifndef __ROUTER_TOOL_H
24 #define __ROUTER_TOOL_H
25 
26 #include "pns_tool_base.h"
27 
29 {
30 public:
31  ROUTER_TOOL();
32  ~ROUTER_TOOL();
33 
34  bool Init() override;
35  void Reset( RESET_REASON aReason ) override;
36 
37  int RouteSingleTrace( const TOOL_EVENT& aEvent );
38  int RouteDiffPair( const TOOL_EVENT& aEvent );
39  int InlineDrag( const TOOL_EVENT& aEvent );
40 
41  // TODO make this private?
42  int DpDimensionsDialog( const TOOL_EVENT& aEvent );
43  int SettingsDialog( const TOOL_EVENT& aEvent );
44  int CustomTrackWidthDialog( const TOOL_EVENT& aEvent );
45 
46  void setTransitions() override;
47 
48 private:
49  int mainLoop( PNS::ROUTER_MODE aMode );
50 
51  int getDefaultWidth( int aNetCode );
52 
53  void performRouting();
54  void performDragging( int aMode = PNS::DM_ANY );
55  void breakTrack();
56 
57  void getNetclassDimensions( int aNetCode, int& aWidth, int& aViaDiameter, int& aViaDrill );
58  void handleCommonEvents( const TOOL_EVENT& evt );
59 
60  int getStartLayer( const PNS::ITEM* aItem );
61  void switchLayerOnViaPlacement();
62 
63  int onViaCommand( const TOOL_EVENT& aEvent );
64  int onTrackViaSizeChanged( const TOOL_EVENT& aEvent );
65  int onLayerChanged( const TOOL_EVENT& aEvent );
66 
67  bool prepareInteractive();
68  bool finishInteractive();
69 };
70 
71 #endif
virtual void setTransitions() override
This method is meant to be overridden in order to specify handlers for events.
Definition: pcb_tool.cpp:203
Class ITEM.
Definition: pns_item.h:53
#define APIEXPORT
Macros which export functions from a DLL/DSO.
Definition: import_export.h:44
virtual bool Init()
Function Init() Init() is called once upon a registration of the tool.
Definition: tool_base.h:93
virtual void Reset(RESET_REASON aReason) override
Function Reset() Brings the tool to a known, initial state.
Class TOOL_EVENT.
Definition: tool_event.h:162
ROUTER_MODE
Definition: pns_router.h:64
RESET_REASON
Determines the reason of reset for a tool
Definition: tool_base.h:80