KiCad PCB EDA Suite
picker_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) 2019 CERN
5  * Copyright (C) 2019-2020 KiCad Developers, see AUTHORS.txt for contributors.
6  *
7  * This program is free software; you can redistribute it and/or
8  * modify it under the terms of the GNU General Public License
9  * as published by the Free Software Foundation; either version 2
10  * of the License, or (at your option) any later version.
11  *
12  * This program is distributed in the hope that it will be useful,
13  * but WITHOUT ANY WARRANTY; without even the implied warranty of
14  * MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the
15  * GNU General Public License for more details.
16  *
17  * You should have received a copy of the GNU General Public License
18  * along with this program; if not, you may find one here:
19  * http://www.gnu.org/licenses/old-licenses/gpl-2.0.html
20  * or you may search the http://www.gnu.org website for the version 2 license,
21  * or you may write to the Free Software Foundation, Inc.,
22  * 51 Franklin Street, Fifth Floor, Boston, MA 02110-1301, USA
23  */
24 
25 #ifndef PICKER_TOOL_H
26 #define PICKER_TOOL_H
27 
28 #include <core/optional.h>
29 #include <gal/cursors.h>
30 #include <math/vector2d.h>
31 #include <tool/tool_interactive.h>
32 
33 class EDA_DRAW_FRAME;
34 
35 
37 {
38 public:
40  typedef std::function<bool(const VECTOR2D&)> CLICK_HANDLER;
41  typedef std::function<void(const VECTOR2D&)> MOTION_HANDLER;
42  typedef std::function<void(void)> CANCEL_HANDLER;
43  typedef std::function<void(const int&)> FINALIZE_HANDLER;
44 
46  {
52  };
53 
55  m_frame( nullptr )
56  {
57  reset();
58  }
59 
60  virtual ~PICKER_TOOL_BASE() = default;
61 
62  inline void SetCursor( KICURSOR aCursor ) { m_cursor = aCursor; }
63 
64  inline void SetSnapping( bool aSnap ) { m_snap = aSnap; }
65 
71  inline void SetClickHandler( CLICK_HANDLER aHandler )
72  {
73  wxASSERT( !m_clickHandler );
74  m_clickHandler = aHandler;
75  }
76 
82  inline void SetMotionHandler( MOTION_HANDLER aHandler )
83  {
84  wxASSERT( !m_motionHandler );
85  m_motionHandler = aHandler;
86  }
87 
91  inline void SetCancelHandler( CANCEL_HANDLER aHandler )
92  {
93  wxASSERT( !m_cancelHandler );
94  m_cancelHandler = aHandler;
95  }
96 
102  inline void SetFinalizeHandler( FINALIZE_HANDLER aHandler )
103  {
104  wxASSERT( !m_finalizeHandler );
105  m_finalizeHandler = aHandler;
106  }
107 
108 protected:
110  virtual void reset();
111 
114  bool m_snap;
115 
120 
122 };
123 
124 
126 {
127 public:
128  PICKER_TOOL();
129 
130  PICKER_TOOL( const std::string& aName );
131 
132  virtual ~PICKER_TOOL() = default;
133 
135  bool Init() override;
136 
138  void Reset( RESET_REASON aReason ) override { }
139 
141  int Main( const TOOL_EVENT& aEvent );
142 
143 protected:
145  void setControls();
146 
148  void setTransitions() override;
149 };
150 
151 #endif /* PICKER_TOOL_H */
std::function< void(void)> CANCEL_HANDLER
Definition: picker_tool.h:42
bool Init() override
Init() is called once upon a registration of the tool.
Definition: picker_tool.cpp:58
KICURSOR m_cursor
Definition: picker_tool.h:113
int Main(const TOOL_EVENT &aEvent)
Definition: picker_tool.cpp:75
OPT< VECTOR2D > m_picked
Definition: picker_tool.h:121
void Reset(RESET_REASON aReason) override
Bring the tool to a known, initial state.
Definition: picker_tool.h:138
std::function< void(const VECTOR2D &)> MOTION_HANDLER
Definition: picker_tool.h:41
KICURSOR
Definition: cursors.h:33
OPT< CANCEL_HANDLER > m_cancelHandler
Definition: picker_tool.h:118
void SetFinalizeHandler(FINALIZE_HANDLER aHandler)
Set a handler for the finalize event.
Definition: picker_tool.h:102
The base class for create windows for drawing purpose.
OPT< FINALIZE_HANDLER > m_finalizeHandler
Definition: picker_tool.h:119
virtual ~PICKER_TOOL_BASE()=default
void setTransitions() override
This method is meant to be overridden in order to specify handlers for events.
virtual void reset()
< Reinitializes tool to its initial state.
Definition: picker_tool.cpp:31
Generic, UI-independent tool event.
Definition: tool_event.h:152
void SetMotionHandler(MOTION_HANDLER aHandler)
Set a handler for mouse motion.
Definition: picker_tool.h:82
void setControls()
< Applies the requested VIEW_CONTROLS settings.
std::function< bool(const VECTOR2D &)> CLICK_HANDLER
< Event handler types.
Definition: picker_tool.h:40
OPT< CLICK_HANDLER > m_clickHandler
Definition: picker_tool.h:116
virtual ~PICKER_TOOL()=default
void SetCursor(KICURSOR aCursor)
Definition: picker_tool.h:62
void SetClickHandler(CLICK_HANDLER aHandler)
Set a handler for mouse click event.
Definition: picker_tool.h:71
EDA_DRAW_FRAME * m_frame
Definition: picker_tool.h:112
OPT< MOTION_HANDLER > m_motionHandler
Definition: picker_tool.h:117
RESET_REASON
Determine the reason of reset for a tool.
Definition: tool_base.h:77
boost::optional< T > OPT
Definition: optional.h:7
void SetSnapping(bool aSnap)
Definition: picker_tool.h:64
std::function< void(const int &)> FINALIZE_HANDLER
Definition: picker_tool.h:43
void SetCancelHandler(CANCEL_HANDLER aHandler)
Set a handler for cancel events (ESC or context-menu Cancel).
Definition: picker_tool.h:91