KiCad PCB EDA Suite
Loading...
Searching...
No Matches
drawing_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) 2014-2017 CERN
5 * Copyright (C) 2018-2022 KiCad Developers, see AUTHORS.txt for contributors.
6 *
7 * @author Maciej Suminski <[email protected]>
8 *
9 * This program is free software; you can redistribute it and/or
10 * modify it under the terms of the GNU General Public License
11 * as published by the Free Software Foundation; either version 2
12 * of the License, or (at your option) any later version.
13 *
14 * This program is distributed in the hope that it will be useful,
15 * but WITHOUT ANY WARRANTY; without even the implied warranty of
16 * MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the
17 * GNU General Public License for more details.
18 *
19 * You should have received a copy of the GNU General Public License
20 * along with this program; if not, you may find one here:
21 * http://www.gnu.org/licenses/old-licenses/gpl-2.0.html
22 * or you may search the http://www.gnu.org website for the version 2 license,
23 * or you may write to the Free Software Foundation, Inc.,
24 * 51 Franklin Street, Fifth Floor, Boston, MA 02110-1301, USA
25 */
26
27#ifndef __DRAWING_TOOL_H
28#define __DRAWING_TOOL_H
29
30#include <stack>
31#include <optional>
32#include <tool/tool_menu.h>
33#include <tools/pcb_tool_base.h>
34#include <tools/pcb_actions.h>
35
36namespace KIGFX
37{
38 class VIEW;
39 class VIEW_CONTROLS;
40}
41
42class BOARD;
44class PCB_SHAPE;
46
52{
53public:
56
58 bool Init() override;
59
61 void Reset( RESET_REASON aReason ) override;
62
64 enum class MODE
65 {
66 NONE,
67 LINE,
69 CIRCLE,
70 ARC,
71 IMAGE,
72 TEXT,
73 ANCHOR,
74 DXF,
76 KEEPOUT,
77 ZONE,
79 VIA
80 };
81
86 MODE GetDrawingMode() const;
87
90 std::vector<BOARD_ITEM*> DrawBoardCharacteristics( const VECTOR2I& origin, PCB_LAYER_ID aLayer,
91 bool aDrawNow, VECTOR2I* tablesize );
92
95 std::vector<BOARD_ITEM*> DrawSpecificationStackup( const VECTOR2I& origin, PCB_LAYER_ID aLayer,
96 bool aDrawNow, VECTOR2I* tablesize );
97
100 int PlaceCharacteristics( const TOOL_EVENT& aEvent );
101
104 int PlaceStackup( const TOOL_EVENT& aEvent );
105
113 int DrawLine( const TOOL_EVENT& aEvent );
114
121 int DrawRectangle( const TOOL_EVENT& aEvent );
122
129 int DrawCircle( const TOOL_EVENT& aEvent );
130
138 int DrawArc( const TOOL_EVENT& aEvent );
139
144 int PlaceImage( const TOOL_EVENT& aEvent );
145
150 int PlaceText( const TOOL_EVENT& aEvent );
151
159 int DrawDimension( const TOOL_EVENT& aEvent );
160
174 int DrawZone( const TOOL_EVENT& aEvent );
175
176 int DrawVia( const TOOL_EVENT& aEvent );
177
181 int PlaceImportedGraphics( const TOOL_EVENT& aEvent );
182
195 int InteractivePlaceWithPreview( const TOOL_EVENT& aEvent,
196 std::vector<BOARD_ITEM*>& aItems,
197 std::vector<BOARD_ITEM*>& aPreview, LSET* aLayers );
198
199
203 int SetAnchor( const TOOL_EVENT& aEvent );
204
208 int ToggleHV45Mode( const TOOL_EVENT& toolEvent );
209
211 void setTransitions() override;
212
213 void SetStroke( const STROKE_PARAMS& aStroke, PCB_LAYER_ID aLayer )
214 {
215 m_layer = aLayer;
216 m_stroke = aStroke;
217 }
218
219 void UpdateStatusBar() const;
220
221private:
233 bool drawShape( const TOOL_EVENT& aTool, PCB_SHAPE** aGraphic,
234 std::optional<VECTOR2D> aStartingPoint,
235 std::stack<PCB_SHAPE*>* aCommittedGraphics );
236
245 bool drawArc( const TOOL_EVENT& aTool, PCB_SHAPE** aGraphic,
246 std::optional<VECTOR2D> aStartingPoint );
247
270 bool getSourceZoneForAction( ZONE_MODE aMode, ZONE** aZone );
271
278
286 VECTOR2I getClampedDifferenceEnd( const VECTOR2I& aOrigin, const VECTOR2I& aEnd )
287 {
288 typedef std::numeric_limits<int> coord_limits;
289 const int guardValue = 1;
290
291 VECTOR2I::extended_type maxDiff = coord_limits::max() - guardValue;
292
293 VECTOR2I::extended_type xDiff = VECTOR2I::extended_type( aEnd.x ) - aOrigin.x;
294 VECTOR2I::extended_type yDiff = VECTOR2I::extended_type( aEnd.y ) - aOrigin.y;
295
296 if( xDiff > maxDiff )
297 xDiff = maxDiff;
298 if( yDiff > maxDiff )
299 yDiff = maxDiff;
300
301 if( xDiff < -maxDiff )
302 xDiff = -maxDiff;
303 if( yDiff < -maxDiff )
304 yDiff = -maxDiff;
305
306 return aOrigin + VECTOR2I( int( xDiff ), int( yDiff ) );
307 }
308
316 VECTOR2I getClampedRadiusEnd( const VECTOR2I& aOrigin, const VECTOR2I& aEnd )
317 {
318 typedef std::numeric_limits<int> coord_limits;
319 const int guardValue = 10;
320
321 VECTOR2I::extended_type xDiff = VECTOR2I::extended_type( aEnd.x ) - aOrigin.x;
322 VECTOR2I::extended_type yDiff = VECTOR2I::extended_type( aEnd.y ) - aOrigin.y;
323
324 double maxRadius = coord_limits::max() / 2 - guardValue;
325 double radius = std::hypot( xDiff, yDiff );
326
327 if( radius > maxRadius )
328 {
329 double scaleFactor = maxRadius / radius;
330
331 xDiff = KiROUND<double, int>( xDiff * scaleFactor );
332 yDiff = KiROUND<double, int>( yDiff * scaleFactor );
333 }
334
335 return aOrigin + VECTOR2I( int( xDiff ), int( yDiff ) );
336 }
337
343 bool m_inDrawingTool; // Re-entrancy guard
344
345 PCB_LAYER_ID m_layer; // The layer we last drew on
346 STROKE_PARAMS m_stroke; // Current stroke for multi-segment drawing
348
349 static const unsigned int WIDTH_STEP; // Amount of width change for one -/+ key press
350 static const unsigned int COORDS_PADDING; // Padding from coordinates limits for this tool
351
352
353 friend class ZONE_CREATE_HELPER; // give internal access to helper classes
354};
355
356#endif /* __DRAWING_TOOL_H */
Information pertinent to a Pcbnew printed circuit board.
Definition: board.h:271
Tool responsible for drawing graphical elements like lines, arcs, circles, etc.
Definition: drawing_tool.h:52
TEXT_ATTRIBUTES m_textAttrs
Definition: drawing_tool.h:347
MODE GetDrawingMode() const
Return the current drawing mode of the DRAWING_TOOL or MODE::NONE if not currently in any drawing mod...
void SetStroke(const STROKE_PARAMS &aStroke, PCB_LAYER_ID aLayer)
Definition: drawing_tool.h:213
PCB_LAYER_ID m_layer
Definition: drawing_tool.h:345
int SetAnchor(const TOOL_EVENT &aEvent)
Place the footprint anchor (only in footprint editor).
int DrawDimension(const TOOL_EVENT &aEvent)
Start interactively drawing a dimension.
int DrawVia(const TOOL_EVENT &aEvent)
KIGFX::VIEW_CONTROLS * m_controls
Definition: drawing_tool.h:339
KIGFX::VIEW * m_view
Definition: drawing_tool.h:338
STROKE_PARAMS m_stroke
Definition: drawing_tool.h:346
int DrawZone(const TOOL_EVENT &aEvent)
Start interactively drawing a zone.
int DrawLine(const TOOL_EVENT &aEvent)
Start interactively drawing a line.
int DrawArc(const TOOL_EVENT &aEvent)
Start interactively drawing an arc.
VECTOR2I getClampedDifferenceEnd(const VECTOR2I &aOrigin, const VECTOR2I &aEnd)
Clamps the end vector to respect numeric limits of difference representation.
Definition: drawing_tool.h:286
int ToggleHV45Mode(const TOOL_EVENT &toolEvent)
Toggle the horizontal/vertical/45-degree constraint for drawing tools.
int PlaceCharacteristics(const TOOL_EVENT &aEvent)
bool drawShape(const TOOL_EVENT &aTool, PCB_SHAPE **aGraphic, std::optional< VECTOR2D > aStartingPoint, std::stack< PCB_SHAPE * > *aCommittedGraphics)
Start drawing a selected shape (i.e.
void setTransitions() override
This method is meant to be overridden in order to specify handlers for events.
int PlaceImportedGraphics(const TOOL_EVENT &aEvent)
Place a drawing imported from a DXF or SVG file in footprint editor.
int PlaceStackup(const TOOL_EVENT &aEvent)
VECTOR2I getClampedRadiusEnd(const VECTOR2I &aOrigin, const VECTOR2I &aEnd)
Clamps the end vector to respect numeric limits of radius representation.
Definition: drawing_tool.h:316
bool m_inDrawingTool
Definition: drawing_tool.h:343
static const unsigned int WIDTH_STEP
Definition: drawing_tool.h:349
static const unsigned int COORDS_PADDING
Definition: drawing_tool.h:350
bool drawArc(const TOOL_EVENT &aTool, PCB_SHAPE **aGraphic, std::optional< VECTOR2D > aStartingPoint)
Start drawing an arc.
int InteractivePlaceWithPreview(const TOOL_EVENT &aEvent, std::vector< BOARD_ITEM * > &aItems, std::vector< BOARD_ITEM * > &aPreview, LSET *aLayers)
Interactively place a set of BOARD_ITEM.
std::vector< BOARD_ITEM * > DrawBoardCharacteristics(const VECTOR2I &origin, PCB_LAYER_ID aLayer, bool aDrawNow, VECTOR2I *tablesize)
int PlaceImage(const TOOL_EVENT &aEvent)
Display a dialog that allows one to select and image then decide where to place the image in the edit...
int DrawCircle(const TOOL_EVENT &aEvent)
Start interactively drawing a circle.
std::vector< BOARD_ITEM * > DrawSpecificationStackup(const VECTOR2I &origin, PCB_LAYER_ID aLayer, bool aDrawNow, VECTOR2I *tablesize)
BOARD * m_board
Definition: drawing_tool.h:340
int DrawRectangle(const TOOL_EVENT &aEvent)
Start interactively drawing a rectangle.
bool Init() override
Init() is called once upon a registration of the tool.
void constrainDimension(PCB_DIMENSION_BASE *aDim)
Force the dimension lime to be drawn on multiple of 45 degrees.
int PlaceText(const TOOL_EVENT &aEvent)
Display a dialog that allows one to input text and its settings and then lets the user decide where t...
PCB_BASE_EDIT_FRAME * m_frame
Definition: drawing_tool.h:341
void UpdateStatusBar() const
bool getSourceZoneForAction(ZONE_MODE aMode, ZONE **aZone)
Draw a polygon, that is added as a zone or a keepout area.
An interface for classes handling user events controlling the view behavior such as zooming,...
Hold a (potentially large) number of VIEW_ITEMs and renders them on a graphics device provided by the...
Definition: view.h:67
LSET is a set of PCB_LAYER_IDs.
Definition: layer_ids.h:552
Common, abstract interface for edit frames.
Abstract dimension API.
Class that handles the drawing of a polygon, including management of last corner deletion and drawing...
Simple container to manage line stroke parameters.
Definition: stroke_params.h:81
RESET_REASON
Determine the reason of reset for a tool.
Definition: tool_base.h:78
Generic, UI-independent tool event.
Definition: tool_event.h:167
VECTOR2_TRAITS< int >::extended_type extended_type
Definition: vector2d.h:72
An adjunct helper to the DRAWING_TOOL interactive tool, which handles incoming geometry changes from ...
Handle a list of polygons defining a copper zone.
Definition: zone.h:72
void Reset() override
PCB_LAYER_ID
A quick note on layer IDs:
Definition: layer_ids.h:60
The Cairo implementation of the graphics abstraction layer.
Definition: color4d.cpp:247
ZONE_MODE
Definition: pcb_actions.h:35
VECTOR2< int > VECTOR2I
Definition: vector2d.h:588