KiCad PCB EDA Suite
edit_tool.h
Go to the documentation of this file.
1 /*
2  * This program source code file is part of KiCad, a free EDA CAD application.
3  *
4  * Copyright (C) 2013-2015 CERN
5  * @author Maciej Suminski <maciej.suminski@cern.ch>
6  * @author Tomasz Wlostowski <tomasz.wlostowski@cern.ch>
7  *
8  * This program is free software; you can redistribute it and/or
9  * modify it under the terms of the GNU General Public License
10  * as published by the Free Software Foundation; either version 2
11  * of the License, or (at your option) any later version.
12  *
13  * This program is distributed in the hope that it will be useful,
14  * but WITHOUT ANY WARRANTY; without even the implied warranty of
15  * MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the
16  * GNU General Public License for more details.
17  *
18  * You should have received a copy of the GNU General Public License
19  * along with this program; if not, you may find one here:
20  * http://www.gnu.org/licenses/old-licenses/gpl-2.0.html
21  * or you may search the http://www.gnu.org website for the version 2 license,
22  * or you may write to the Free Software Foundation, Inc.,
23  * 51 Franklin Street, Fifth Floor, Boston, MA 02110-1301, USA
24  */
25 
26 #ifndef __EDIT_TOOL_H
27 #define __EDIT_TOOL_H
28 
29 #include <math/vector2d.h>
30 #include <tools/pcb_tool.h>
31 
32 class BOARD_COMMIT;
33 class BOARD_ITEM;
34 class SELECTION_TOOL;
35 class CONNECTIVITY_DATA;
36 
44 class EDIT_TOOL : public PCB_TOOL
45 {
46 public:
47  EDIT_TOOL();
48 
50  void Reset( RESET_REASON aReason ) override;
51 
53  bool Init() override;
54 
61  int Main( const TOOL_EVENT& aEvent );
62 
68  int Properties( const TOOL_EVENT& aEvent );
69 
75  int Rotate( const TOOL_EVENT& aEvent );
76 
82  int Flip( const TOOL_EVENT& aEvent );
83 
89  int Mirror( const TOOL_EVENT& aEvent );
90 
96  int Remove( const TOOL_EVENT& aEvent );
97 
103  int Duplicate( const TOOL_EVENT& aEvent );
104 
110  int MoveExact( const TOOL_EVENT& aEvent );
111 
118  int CreateArray( const TOOL_EVENT& aEvent );
119 
126  int ExchangeFootprints( const TOOL_EVENT& aEvent );
127 
129  int MeasureTool( const TOOL_EVENT& aEvent );
130 
132  void SetTransitions() override;
133 
134 private:
137 
140 
143 
147 
151  void updateRatsnest( bool aRedraw );
152 
155  wxPoint getModificationPoint( const SELECTION& aSelection );
156 
157  int editFootprintInFpEditor( const TOOL_EVENT& aEvent );
158 
159  bool invokeInlineRouter();
160 
172  bool hoverSelection( bool aSanitize = true );
173 
183  template<class T> T* uniqueSelected();
184 
196  template<class T>
197  T* uniqueHoverSelection( bool aSanitize = true )
198  {
199  if( !hoverSelection( aSanitize ) )
200  return nullptr;
201 
202  T* item = uniqueSelected<T>();
203 
204  return item;
205  }
206 
207  std::unique_ptr<BOARD_COMMIT> m_commit;
208 };
209 
210 #endif
wxPoint getModificationPoint(const SELECTION &aSelection)
Returns the right modification point (e.g.
Definition: edit_tool.cpp:1167
VECTOR2I m_cursor
Last cursor position (needed for getModificationPoint() to avoid changes of edit reference point)...
Definition: edit_tool.h:146
int Main(const TOOL_EVENT &aEvent)
Function Main()
Definition: edit_tool.cpp:248
int Properties(const TOOL_EVENT &aEvent)
Function Edit()
Definition: edit_tool.cpp:451
int Rotate(const TOOL_EVENT &aEvent)
Function Rotate()
Definition: edit_tool.cpp:498
int ExchangeFootprints(const TOOL_EVENT &aEvent)
Function ExchangeFootprints()
Definition: edit_tool.cpp:1009
Class BOARD_ITEM is a base class for any item which can be embedded within the BOARD container class...
std::unique_ptr< BOARD_COMMIT > m_commit
Definition: edit_tool.h:207
T
enum T contains all this lexer's tokens.
Class SELECTION_TOOL.
T * uniqueHoverSelection(bool aSanitize=true)
Function uniqueHoverSelection()
Definition: edit_tool.h:197
SELECTION_TOOL * m_selectionTool
Selection tool used for obtaining selected items
Definition: edit_tool.h:136
wxPoint m_offset
Offset from the dragged item's center (anchor)
Definition: edit_tool.h:142
int Mirror(const TOOL_EVENT &aEvent)
Function Mirror.
Definition: edit_tool.cpp:574
int Flip(const TOOL_EVENT &aEvent)
Function Flip()
Definition: edit_tool.cpp:645
bool m_dragging
Flag determining if anything is being dragged right now
Definition: edit_tool.h:139
T * uniqueSelected()
Function uniqueSelected()
Definition: edit_tool.cpp:1223
Class TOOL_EVENT.
Definition: tool_event.h:162
bool Init() override
Function Init() Init() is called once upon a registration of the tool.
Definition: edit_tool.cpp:177
Class EDIT_TOOL.
Definition: edit_tool.h:44
bool invokeInlineRouter()
Definition: edit_tool.cpp:225
void updateRatsnest(bool aRedraw)
Updates ratsnest for selected items.
Definition: edit_tool.cpp:1154
void Reset(RESET_REASON aReason) override
Function Reset() Brings the tool to a known, initial state.
Definition: edit_tool.cpp:168
int MoveExact(const TOOL_EVENT &aEvent)
Function MoveExact()
Definition: edit_tool.cpp:718
int Remove(const TOOL_EVENT &aEvent)
Function Remove()
Definition: edit_tool.cpp:680
int CreateArray(const TOOL_EVENT &aEvent)
Function CreateArray()
Definition: edit_tool.cpp:993
int MeasureTool(const TOOL_EVENT &aEvent)
Launches a tool to measure between points
Definition: edit_tool.cpp:1041
RESET_REASON
Determines the reason of reset for a tool
Definition: tool_base.h:80
int editFootprintInFpEditor(const TOOL_EVENT &aEvent)
Definition: edit_tool.cpp:1185
void SetTransitions() override
Sets up handlers for various events.
Definition: edit_tool.cpp:1134
int Duplicate(const TOOL_EVENT &aEvent)
Function Duplicate()
Definition: edit_tool.cpp:846
bool hoverSelection(bool aSanitize=true)
Function hoverSelection()