KiCad PCB EDA Suite
Loading...
Searching...
No Matches
edit.cpp
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) 2016 Jean-Pierre Charras, jp.charras at wanadoo.fr
5 * Copyright (C) 2015 SoftPLC Corporation, Dick Hollenbeck <[email protected]>
6 * Copyright (C) 2015 Wayne Stambaugh <[email protected]>
7 * Copyright (C) 2017-2024 KiCad Developers, see AUTHORS.txt for contributors.
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#include <kiface_base.h>
28#include <confirm.h>
29#include <gestfich.h>
30#include <pcb_edit_frame.h>
31#include <pcbnew_id.h>
32#include <board.h>
33#include <footprint.h>
34#include <pad.h>
35#include <zone.h>
36#include <pcb_group.h>
37#include <pcb_generator.h>
38#include <pcb_target.h>
39#include <pcb_dimension.h>
40#include <pcb_textbox.h>
41#include <pcb_table.h>
42#include <pcb_shape.h>
43#include <dialog_drc.h>
45#include <tool/tool_manager.h>
46#include <tools/pcb_actions.h>
47#include <tools/drc_tool.h>
49#include <dialogs/dialog_table_properties.h>
51
52// Handles the selection of command events.
53void PCB_EDIT_FRAME::Process_Special_Functions( wxCommandEvent& event )
54{
55 int id = event.GetId();
56 const PCB_DISPLAY_OPTIONS& displ_opts = GetDisplayOptions();
57
58 switch( id ) // Execute command
59 {
60 case 0:
61 break;
62
65
66 if( displ_opts.m_ContrastModeDisplay != HIGH_CONTRAST_MODE::NORMAL )
67 GetCanvas()->Refresh();
68 break;
69
72 break;
73
76 break;
77
78 default:
79 break;
80 }
81}
82
83
85{
86 PCB_LAYER_ID curLayer = GetActiveLayer();
87 const PCB_DISPLAY_OPTIONS& displ_opts = GetDisplayOptions();
88
89 // Check if the specified layer matches the present layer
90 if( layer == curLayer )
91 return;
92
93 // Copper layers cannot be selected unconditionally; how many of those layers are currently
94 // enabled needs to be checked.
95 if( IsCopperLayer( layer ) )
96 {
97 // If only one copper layer is enabled, the only such layer that can be selected to is
98 // the "Back" layer (so the selection of any other copper layer is disregarded).
99 if( GetBoard()->GetCopperLayerCount() < 2 )
100 {
101 if( layer != B_Cu )
102 return;
103 }
104 // If more than one copper layer is enabled, the "Copper" and "Component" layers can be
105 // selected, but the total number of copper layers determines which internal layers are
106 // also capable of being selected.
107 else
108 {
109 if( layer != B_Cu && layer != F_Cu && layer >= GetBoard()->GetCopperLayerCount() - 1 )
110 return;
111 }
112 }
113
114 // Is yet more checking required? E.g. when the layer to be selected is a non-copper layer,
115 // or when switching between a copper layer and a non-copper layer, or vice-versa?
116
117 SetActiveLayer( layer );
118
119 if( displ_opts.m_ContrastModeDisplay != HIGH_CONTRAST_MODE::NORMAL )
120 GetCanvas()->Refresh();
121}
122
123
125{
126 switch( aItem->Type() )
127 {
130 break;
131
132 case PCB_FIELD_T:
133 case PCB_TEXT_T:
134 ShowTextPropertiesDialog( static_cast<PCB_TEXT*>( aItem ) );
135 break;
136
137 case PCB_TEXTBOX_T:
138 ShowTextBoxPropertiesDialog( static_cast<PCB_TEXTBOX*>( aItem ) );
139 break;
140
141 case PCB_TABLE_T:
142 {
143 DIALOG_TABLE_PROPERTIES dlg( this, static_cast<PCB_TABLE*>( aItem ) );
144
145 //QuasiModal required for Scintilla auto-complete
146 dlg.ShowQuasiModal();
147 break;
148 }
149
150 case PCB_PAD_T:
151 ShowPadPropertiesDialog( static_cast<PAD*>( aItem ) );
152 break;
153
154 case PCB_FOOTPRINT_T:
155 ShowFootprintPropertiesDialog( static_cast<FOOTPRINT*>( aItem ) );
156 break;
157
158 case PCB_TARGET_T:
159 ShowTargetOptionsDialog( static_cast<PCB_TARGET*>( aItem ) );
160 break;
161
163 case PCB_DIM_CENTER_T:
164 case PCB_DIM_RADIAL_T:
166 case PCB_DIM_LEADER_T:
167 {
168 DIALOG_DIMENSION_PROPERTIES dlg( this, static_cast<PCB_DIMENSION_BASE*>( aItem ) );
169
170 // TODO: why is this QuasiModal?
171 dlg.ShowQuasiModal();
172 break;
173 }
174
175 case PCB_SHAPE_T:
176 ShowGraphicItemPropertiesDialog( static_cast<PCB_SHAPE*>( aItem ) );
177 break;
178
179 case PCB_ZONE_T:
180 Edit_Zone_Params( static_cast<ZONE*>( aItem ) );
181 break;
182
183 case PCB_GROUP_T:
185 break;
186
187 case PCB_GENERATOR_T:
188 static_cast<PCB_GENERATOR*>( aItem )->ShowPropertiesDialog( this );
189 break;
190
191 case PCB_MARKER_T:
192 m_toolManager->GetTool<DRC_TOOL>()->CrossProbe( static_cast<PCB_MARKER*>( aItem ) );
193 break;
194
195 default:
196 break;
197 }
198}
199
A base class for any item which can be embedded within the BOARD container class, and therefore insta...
Definition: board_item.h:79
int ShowQuasiModal()
virtual void Refresh(bool aEraseBackground=true, const wxRect *aRect=nullptr) override
KICAD_T Type() const
Returns the type of object.
Definition: eda_item.h:100
Definition: pad.h:54
static TOOL_ACTION groupProperties
Definition: pcb_actions.h:301
int ShowTextBoxPropertiesDialog(PCB_TEXTBOX *aTextBox)
void ShowReferenceImagePropertiesDialog(BOARD_ITEM *aBitmap)
Set the angle used for rotate operations.
void ShowGraphicItemPropertiesDialog(PCB_SHAPE *aShape)
void ShowPadPropertiesDialog(PAD *aPad)
const PCB_DISPLAY_OPTIONS & GetDisplayOptions() const
Display options control the way tracks, vias, outlines and other things are shown (for instance solid...
virtual PCB_LAYER_ID GetActiveLayer() const
PCB_DRAW_PANEL_GAL * GetCanvas() const override
Return a pointer to GAL-based canvas of given EDA draw frame.
BOARD * GetBoard() const
Abstract dimension API.
HIGH_CONTRAST_MODE m_ContrastModeDisplay
How inactive layers are displayed.
void OnEditItemRequest(BOARD_ITEM *aItem) override
Install the corresponding dialog editor for the given item.
Definition: edit.cpp:124
void SetActiveLayer(PCB_LAYER_ID aLayer) override
Change the currently active layer to aLayer and also update the APPEARANCE_CONTROLS.
void SwitchLayer(PCB_LAYER_ID layer) override
Change the active layer in the editor.
Definition: edit.cpp:84
void ShowTargetOptionsDialog(PCB_TARGET *aTarget)
void ExportFootprintsToLibrary(bool aStoreInNewLib, const wxString &aLibName=wxEmptyString, wxString *aLibPath=nullptr)
Save footprints in a library:
void ShowFootprintPropertiesDialog(FOOTPRINT *aFootprint)
void Edit_Zone_Params(ZONE *zone_container)
Edit params (layer, clearance, ...) for a zone outline.
PCB_LAYER_BOX_SELECTOR * m_SelLayerBox
void Process_Special_Functions(wxCommandEvent &event)
Definition: edit.cpp:53
A set of BOARD_ITEMs (i.e., without duplicates).
Definition: pcb_group.h:52
TOOL_MANAGER * m_toolManager
Definition: tools_holder.h:167
bool RunAction(const std::string &aActionName, T aParam)
Run the specified action immediately, pausing the current action to run the new one.
Definition: tool_manager.h:150
Handle a list of polygons defining a copper zone.
Definition: zone.h:73
This file is part of the common library.
bool IsCopperLayer(int aLayerId)
Tests whether a layer is a copper layer.
Definition: layer_ids.h:531
PCB_LAYER_ID
A quick note on layer IDs:
Definition: layer_ids.h:60
@ B_Cu
Definition: layer_ids.h:95
@ F_Cu
Definition: layer_ids.h:64
PCB_LAYER_ID ToLAYER_ID(int aLayer)
Definition: lset.cpp:880
Class to handle a set of BOARD_ITEMs.
@ ID_MENU_EXPORT_FOOTPRINTS_TO_NEW_LIBRARY
Definition: pcbnew_id.h:83
@ ID_MENU_EXPORT_FOOTPRINTS_TO_LIBRARY
Definition: pcbnew_id.h:82
@ ID_TOOLBARH_PCB_SELECT_LAYER
Definition: pcbnew_id.h:96
@ PCB_SHAPE_T
class PCB_SHAPE, a segment not on copper layers
Definition: typeinfo.h:88
@ PCB_DIM_ORTHOGONAL_T
class PCB_DIM_ORTHOGONAL, a linear dimension constrained to x/y
Definition: typeinfo.h:105
@ PCB_DIM_LEADER_T
class PCB_DIM_LEADER, a leader dimension (graphic item)
Definition: typeinfo.h:102
@ PCB_GENERATOR_T
class PCB_GENERATOR, generator on a layer
Definition: typeinfo.h:91
@ PCB_DIM_CENTER_T
class PCB_DIM_CENTER, a center point marking (graphic item)
Definition: typeinfo.h:103
@ PCB_GROUP_T
class PCB_GROUP, a set of BOARD_ITEMs
Definition: typeinfo.h:110
@ PCB_TEXTBOX_T
class PCB_TEXTBOX, wrapped text on a layer
Definition: typeinfo.h:93
@ PCB_ZONE_T
class ZONE, a copper pour area
Definition: typeinfo.h:107
@ PCB_TEXT_T
class PCB_TEXT, text on a layer
Definition: typeinfo.h:92
@ PCB_REFERENCE_IMAGE_T
class PCB_REFERENCE_IMAGE, bitmap on a layer
Definition: typeinfo.h:89
@ PCB_FIELD_T
class PCB_FIELD, text associated with a footprint property
Definition: typeinfo.h:90
@ PCB_MARKER_T
class PCB_MARKER, a marker used to show something
Definition: typeinfo.h:99
@ PCB_TARGET_T
class PCB_TARGET, a target (graphic item)
Definition: typeinfo.h:106
@ PCB_FOOTPRINT_T
class FOOTPRINT, a footprint
Definition: typeinfo.h:86
@ PCB_DIM_ALIGNED_T
class PCB_DIM_ALIGNED, a linear dimension (graphic item)
Definition: typeinfo.h:101
@ PCB_PAD_T
class PAD, a pad in a footprint
Definition: typeinfo.h:87
@ PCB_TABLE_T
class PCB_TABLE, table of PCB_TABLECELLs
Definition: typeinfo.h:94
@ PCB_DIM_RADIAL_T
class PCB_DIM_RADIAL, a radius or diameter dimension
Definition: typeinfo.h:104