KiCad PCB EDA Suite
All Classes Namespaces Files Functions Variables Typedefs Enumerations Enumerator Friends Macros Modules Pages Concepts
pcb_control.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-2020 CERN
5 * Copyright The KiCad Developers, see AUTHORS.txt for contributors.
6 *
7 * @author Maciej Suminski <maciej.suminski@cern.ch>
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 PCB_CONTROL_H
28#define PCB_CONTROL_H
29
30#include <pcb_io/pcb_io_mgr.h>
31#include <memory>
32#include <tools/pcb_tool_base.h>
33#include <status_popup.h>
34
35namespace KIGFX {
36 class ORIGIN_VIEWITEM;
37}
38
39class PCB_BASE_FRAME;
40class BOARD_ITEM;
41
47{
48public:
51
53 void Reset( RESET_REASON aReason ) override;
54
55 int AddLibrary( const TOOL_EVENT& aEvent );
56 int Print( const TOOL_EVENT& aEvent );
57 int Quit( const TOOL_EVENT& aEvent );
58
59 // Footprint library control actions
60 int LoadFpFromBoard( const TOOL_EVENT& aEvent );
61 int SaveFpToBoard( const TOOL_EVENT& aEvent );
62 int IterateFootprint( const TOOL_EVENT& aEvent );
63
64 // Display modes
65 int ToggleRatsnest( const TOOL_EVENT& aEvent );
66 int ZoneDisplayMode( const TOOL_EVENT& aEvent );
67 int TrackDisplayMode( const TOOL_EVENT& aEvent );
68 int ViaDisplayMode( const TOOL_EVENT& aEvent );
69
70 // Update the view with the new high-contrast mode from the display settings
71 int HighContrastMode( const TOOL_EVENT& aEvent );
72
73 int ContrastModeFeedback( const TOOL_EVENT& aEvent );
74
75 // Rotate through the available high-contrast, net color and ratsnest color modes
76 int HighContrastModeCycle( const TOOL_EVENT& aEvent );
77 int NetColorModeCycle( const TOOL_EVENT& aEvent );
78 int RatsnestModeCycle( const TOOL_EVENT& aEvent );
79
80 // Layer control
81 int LayerSwitch( const TOOL_EVENT& aEvent );
82 int LayerNext( const TOOL_EVENT& aEvent );
83 int LayerPrev( const TOOL_EVENT& aEvent );
84 int LayerToggle( const TOOL_EVENT& aEvent );
85 int LayerAlphaInc( const TOOL_EVENT& aEvent );
86 int LayerAlphaDec( const TOOL_EVENT& aEvent );
87 int CycleLayerPresets( const TOOL_EVENT& aEvent );
88 int LayerPresetFeedback( const TOOL_EVENT& aEvent );
89
90 // Grid control
91 int GridPlaceOrigin( const TOOL_EVENT& aEvent );
92 int GridResetOrigin( const TOOL_EVENT& aEvent );
93
94 // Low-level access (below undo) to setting the grid origin
95 static void DoSetGridOrigin( KIGFX::VIEW* aView, PCB_BASE_FRAME* aFrame,
96 EDA_ITEM* originViewItem, const VECTOR2D& aPoint );
97
98 int Undo( const TOOL_EVENT& aEvent );
99 int Redo( const TOOL_EVENT& aEvent );
100
101 // Snapping control
102 int SnapMode( const TOOL_EVENT& aEvent );
103 int SnapModeFeedback( const TOOL_EVENT& aEvent );
104
105 // Miscellaneous
106 int InteractiveDelete( const TOOL_EVENT& aEvent );
107 int Paste( const TOOL_EVENT& aEvent );
108 int AppendBoardFromFile( const TOOL_EVENT& aEvent );
109 int AppendDesignBlock( const TOOL_EVENT& aEvent );
110 int AppendBoard( PCB_IO& pi, const wxString& fileName );
111 int UpdateMessagePanel( const TOOL_EVENT& aEvent );
112
113 int FlipPcbView( const TOOL_EVENT& aEvent );
114
115 // Drag and drop
116 int DdAppendBoard( const TOOL_EVENT& aEvent );
117 int DdAddLibrary( const TOOL_EVENT& aEvent );
118 int DdImportFootprint( const TOOL_EVENT& aEvent );
119
120private:
122 void setTransitions() override;
123
129 void unfilledZoneCheck();
130
135 void pruneItemLayers( std::vector<BOARD_ITEM*>& aItems );
136
148 bool placeBoardItems( BOARD_COMMIT* aCommit, std::vector<BOARD_ITEM*>& aItems, bool aIsNew,
149 bool aAnchorAtOrigin, bool aReannotateDuplicates );
150
151 bool placeBoardItems( BOARD_COMMIT* aCommit, BOARD* aBoard, bool aAnchorAtOrigin,
152 bool aReannotateDuplicates );
153
156
158 std::unique_ptr<KIGFX::ORIGIN_VIEWITEM> m_gridOrigin;
159
161
162 std::unique_ptr<STATUS_TEXT_POPUP> m_statusPopup;
163};
164
165#endif
A base class for any item which can be embedded within the BOARD container class, and therefore insta...
Definition: board_item.h:78
Information pertinent to a Pcbnew printed circuit board.
Definition: board.h:297
A base class for most all the KiCad significant classes used in schematics and boards.
Definition: eda_item.h:96
Hold a (potentially large) number of VIEW_ITEMs and renders them on a graphics device provided by the...
Definition: view.h:67
Base PCB main window class for Pcbnew, Gerbview, and CvPcb footprint viewer.
Handle actions that are shared between different frames in PcbNew.
Definition: pcb_control.h:47
void setTransitions() override
< Sets up handlers for various events.
int AppendBoardFromFile(const TOOL_EVENT &aEvent)
int AddLibrary(const TOOL_EVENT &aEvent)
int DdAppendBoard(const TOOL_EVENT &aEvent)
int LoadFpFromBoard(const TOOL_EVENT &aEvent)
int DdImportFootprint(const TOOL_EVENT &aEvent)
int SnapModeFeedback(const TOOL_EVENT &aEvent)
int NetColorModeCycle(const TOOL_EVENT &aEvent)
int SaveFpToBoard(const TOOL_EVENT &aEvent)
int RatsnestModeCycle(const TOOL_EVENT &aEvent)
int TrackDisplayMode(const TOOL_EVENT &aEvent)
int DdAddLibrary(const TOOL_EVENT &aEvent)
int Redo(const TOOL_EVENT &aEvent)
int LayerPresetFeedback(const TOOL_EVENT &aEvent)
int UpdateMessagePanel(const TOOL_EVENT &aEvent)
int LayerAlphaDec(const TOOL_EVENT &aEvent)
int LayerNext(const TOOL_EVENT &aEvent)
std::unique_ptr< STATUS_TEXT_POPUP > m_statusPopup
Definition: pcb_control.h:162
int ToggleRatsnest(const TOOL_EVENT &aEvent)
int AppendBoard(PCB_IO &pi, const wxString &fileName)
int LayerAlphaInc(const TOOL_EVENT &aEvent)
int HighContrastModeCycle(const TOOL_EVENT &aEvent)
std::unique_ptr< KIGFX::ORIGIN_VIEWITEM > m_gridOrigin
Definition: pcb_control.h:158
int Quit(const TOOL_EVENT &aEvent)
int HighContrastMode(const TOOL_EVENT &aEvent)
int Undo(const TOOL_EVENT &aEvent)
int ViaDisplayMode(const TOOL_EVENT &aEvent)
PCB_BASE_FRAME * m_frame
Grid origin marker.
Definition: pcb_control.h:155
static void DoSetGridOrigin(KIGFX::VIEW *aView, PCB_BASE_FRAME *aFrame, EDA_ITEM *originViewItem, const VECTOR2D &aPoint)
void pruneItemLayers(std::vector< BOARD_ITEM * > &aItems)
Helper for pasting.
int GridPlaceOrigin(const TOOL_EVENT &aEvent)
int FlipPcbView(const TOOL_EVENT &aEvent)
int SnapMode(const TOOL_EVENT &aEvent)
bool placeBoardItems(BOARD_COMMIT *aCommit, std::vector< BOARD_ITEM * > &aItems, bool aIsNew, bool aAnchorAtOrigin, bool aReannotateDuplicates)
Add and select or just select for move/place command a list of board items.
int ContrastModeFeedback(const TOOL_EVENT &aEvent)
int LayerToggle(const TOOL_EVENT &aEvent)
int IterateFootprint(const TOOL_EVENT &aEvent)
int Print(const TOOL_EVENT &aEvent)
int ZoneDisplayMode(const TOOL_EVENT &aEvent)
int GridResetOrigin(const TOOL_EVENT &aEvent)
BOARD_ITEM * m_pickerItem
Definition: pcb_control.h:160
int InteractiveDelete(const TOOL_EVENT &aEvent)
int AppendDesignBlock(const TOOL_EVENT &aEvent)
int LayerPrev(const TOOL_EVENT &aEvent)
int CycleLayerPresets(const TOOL_EVENT &aEvent)
int Paste(const TOOL_EVENT &aEvent)
void unfilledZoneCheck()
We have bug reports indicating that some new users confuse zone filling/unfilling with the display mo...
int LayerSwitch(const TOOL_EVENT &aEvent)
A base class that BOARD loading and saving plugins should derive from.
Definition: pcb_io.h:71
RESET_REASON
Determine the reason of reset for a tool.
Definition: tool_base.h:78
Generic, UI-independent tool event.
Definition: tool_event.h:168
void Reset() override
The Cairo implementation of the graphics abstraction layer.
Definition: eda_group.h:32