KiCad PCB EDA Suite
Loading...
Searching...
No Matches
zone_settings.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) 2018 Jean-Pierre Charras, jp.charras at wanadoo.fr
5 * Copyright (C) 2012 SoftPLC Corporation, Dick Hollenbeck <[email protected]>
6 * Copyright (C) 1992-2023 KiCad Developers, see AUTHORS.txt for contributors.
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#include <zone_settings.h>
27
28#include <pcb_base_frame.h>
29#include <board.h>
31#include <zones.h>
32
33#include <zone.h>
34#include <wx/dataview.h>
36
38{
40 m_FillMode = ZONE_FILL_MODE::POLYGONS; // Mode for filling zone
41 // Zone clearance value
43 // Min thickness value in filled areas (this is the minimum width of copper to fill solid areas) :
45 // Arbitrary defaults for the hatch settings
46 m_HatchThickness = std::max( m_ZoneMinThickness * 4, pcbIUScale.mmToIU( 1.0 ) );
47 m_HatchGap = std::max( m_ZoneMinThickness * 6, pcbIUScale.mmToIU( 1.5 ) );
48 m_HatchOrientation = ANGLE_0; // Grid style: orientation of grid lines
49 m_HatchSmoothingLevel = 0; // Grid pattern smoothing type. 0 = no smoothing
50 m_HatchSmoothingValue = 0.1; // Grid pattern chamfer value relative to the gap value
51 m_HatchHoleMinArea = 0.3; // Min size before holes are dropped (ratio of hole size)
52 m_HatchBorderAlgorithm = 1; // 0 = use zone min thickness; 1 = use hatch width
53 m_NetcodeSelection = 0; // Net code selection for the current zone
54 m_ZoneBorderDisplayStyle = ZONE_BORDER_DISPLAY_STYLE::DIAGONAL_EDGE; // Option to show the zone
55 // outlines only, short
56 // hatches or full hatches
58
59 m_Layers.reset().set( F_Cu );
60 m_Name = wxEmptyString;
61
62 // thickness of the gap in thermal reliefs:
64 // thickness of the copper bridge in thermal reliefs:
66
67 m_padConnection = ZONE_CONNECTION::THERMAL; // How pads are covered by copper in zone
68
69 m_Locked = false;
70
73
74 m_removeIslands = ISLAND_REMOVAL_MODE::ALWAYS;
76
77 SetIsRuleArea( false );
79 SetDoNotAllowVias( true );
80 SetDoNotAllowTracks( true );
81 SetDoNotAllowPads( true );
83
84 m_TeardropType = TEARDROP_TYPE::TD_NONE;
85}
86
87
89{
91 m_FillMode = aSource.GetFillMode();
95 m_HatchGap = aSource.GetHatchGap();
101 m_NetcodeSelection = aSource.GetNetCode();
102 m_Name = aSource.GetZoneName();
110 m_isRuleArea = aSource.GetIsRuleArea();
116 m_Locked = aSource.IsLocked();
119
120 // Currently, the teardrop area type is not really a ZONE_SETTINGS parameter,
121 // but a ZONE parameter only.
122 // However it can be used in dialogs
124
125 m_Layers = aSource.GetLayerSet();
126
127 return *this;
128}
129
130
131void ZONE_SETTINGS::ExportSetting( ZONE& aTarget, bool aFullExport ) const
132{
133 aTarget.SetFillMode( m_FillMode );
137 aTarget.SetHatchGap( m_HatchGap );
148 aTarget.SetIsRuleArea( GetIsRuleArea() );
154 aTarget.SetLocked( m_Locked );
157 // Currently, the teardrop area type is not imported from a ZONE_SETTINGS, because
158 // it is not really a ZONE_SETTINGS parameter, but a ZONE parameter only
159#if 0
161#endif
162
163
164 if( aFullExport )
165 {
167 aTarget.SetLayerSet( m_Layers );
168 aTarget.SetZoneName( m_Name );
169
170 if( !m_isRuleArea )
172 }
173
174 // call SetBorderDisplayStyle last, because hatch lines will be rebuilt,
175 // using new parameters values
177 m_BorderHatchPitch, true );
178}
179
180
182{
183 if( aRadius < 0 )
184 m_cornerRadius = 0;
185 else
186 m_cornerRadius = aRadius;
187}
188
189
190#ifdef __WXOSX_MAC__
191const static wxSize LAYER_BITMAP_SIZE( 28, 28 ); // wxCocoa impl unhappy if this isn't square...
192#else
193const static wxSize LAYER_BITMAP_SIZE( 24, 16 );
194#endif
195
196const static wxSize CHECKERBOARD_SIZE( 8, 8 );
197
198
200{
201 static ZONE_SETTINGS defaultSettings;
202
203 return defaultSettings;
204}
205
206
207// A helper for setting up a dialog list for specifying zone layers. Used by all three
208// zone settings dialogs.
209void ZONE_SETTINGS::SetupLayersList( wxDataViewListCtrl* aList, PCB_BASE_FRAME* aFrame,
210 LSET aLayers, bool aFpEditorMode )
211{
212 BOARD* board = aFrame->GetBoard();
213 COLOR4D backgroundColor = aFrame->GetColorSettings()->GetColor( LAYER_PCB_BACKGROUND );
214
215 // In the Footprint Editor In1_Cu is used as a proxy for "all inner layers"
216 if( aFpEditorMode )
217 aLayers.set( In1_Cu );
218
219 wxDataViewColumn* checkColumn = aList->AppendToggleColumn( wxEmptyString );
220 wxDataViewColumn* layerColumn = aList->AppendIconTextColumn( wxEmptyString );
221 wxDataViewColumn* layerIDColumn = aList->AppendTextColumn( wxEmptyString );
222 layerIDColumn->SetHidden( true );
223
224 int textWidth = 0;
225
226 for( LSEQ layer = aLayers.UIOrder(); layer; ++layer )
227 {
228 PCB_LAYER_ID layerID = *layer;
229 wxString layerName = board->GetLayerName( layerID );
230
231 if( aFpEditorMode && layerID == In1_Cu )
232 layerName = _( "Inner layers" );
233
234 // wxCOL_WIDTH_AUTOSIZE doesn't work on all platforms, so we calculate width here
235 textWidth = std::max( textWidth, KIUI::GetTextSize( layerName, aList ).x );
236
237 COLOR4D layerColor = aFrame->GetColorSettings()->GetColor( layerID );
238 auto bitmap = COLOR_SWATCH::MakeBitmap( layerColor, backgroundColor, LAYER_BITMAP_SIZE,
239 CHECKERBOARD_SIZE, aList->GetBackgroundColour() );
240 wxIcon icon;
241 icon.CopyFromBitmap( bitmap );
242
243 wxVector<wxVariant> row;
244 row.push_back( wxVariant( m_Layers.test( layerID ) ) );
245 row.push_back( wxVariant( wxDataViewIconText( layerName, icon ) ) );
246 row.push_back( wxVariant( wxString::Format( wxT( "%i" ), layerID ) ) );
247 aList->AppendItem( row );
248
249 if( m_Layers.test( layerID ) )
250 aList->SetToggleValue( true, (unsigned) aList->GetItemCount() - 1, 0 );
251 }
252
253 int checkColSize = 22;
254 int layerColSize = textWidth + LAYER_BITMAP_SIZE.x + 15;
255
256#ifdef __WXMAC__
257 // TODO: something in wxWidgets 3.1.x pads checkbox columns with extra space. (It used to
258 // also be that the width of the column would get set too wide (to 30), but that's patched in
259 // our local wxWidgets fork.)
260 int checkColMargins = 40;
261#else
262 int checkColMargins = 0;
263#endif
264
265 // You'd think the fact that m_layers is a list would encourage wxWidgets not to save room
266 // for the tree expanders... but you'd be wrong. Force indent to 0.
267 aList->SetIndent( 0 );
268 aList->SetMinClientSize( wxSize( checkColSize + checkColMargins + layerColSize,
269 aList->GetMinClientSize().y ) );
270
271 checkColumn->SetWidth( checkColSize );
272 layerColumn->SetWidth( layerColSize );
273}
274
275
constexpr EDA_IU_SCALE pcbIUScale
Definition: base_units.h:109
bool SetNetCode(int aNetCode, bool aNoAssert)
Set net using a net code.
virtual void SetLocked(bool aLocked)
Definition: board_item.h:278
virtual bool IsLocked() const
Definition: board_item.cpp:73
Information pertinent to a Pcbnew printed circuit board.
Definition: board.h:271
const wxString GetLayerName(PCB_LAYER_ID aLayer) const
Return the name of a aLayer.
Definition: board.cpp:501
COLOR4D GetColor(int aLayer) const
static wxBitmap MakeBitmap(const KIGFX::COLOR4D &aColor, const KIGFX::COLOR4D &aBackground, const wxSize &aSize, const wxSize &aCheckerboardSize, const KIGFX::COLOR4D &aCheckerboardBackground)
A color representation with 4 components: red, green, blue, alpha.
Definition: color4d.h:104
LSEQ is a sequence (and therefore also a set) of PCB_LAYER_IDs.
Definition: layer_ids.h:513
LSET is a set of PCB_LAYER_IDs.
Definition: layer_ids.h:552
LSEQ UIOrder() const
Definition: lset.cpp:922
Base PCB main window class for Pcbnew, Gerbview, and CvPcb footprint viewer.
BOARD * GetBoard() const
virtual COLOR_SETTINGS * GetColorSettings(bool aForceRefresh=false) const override
Helper to retrieve the current color settings.
ZONE_SETTINGS handles zones parameters.
Definition: zone_settings.h:70
bool GetDoNotAllowCopperPour() const
bool m_keepoutDoNotAllowPads
void SetIsRuleArea(bool aEnable)
unsigned int m_cornerRadius
bool GetDoNotAllowTracks() const
EDA_ANGLE m_HatchOrientation
Definition: zone_settings.h:88
int m_HatchBorderAlgorithm
Definition: zone_settings.h:93
void SetDoNotAllowVias(bool aEnable)
bool GetDoNotAllowFootprints() const
int m_NetcodeSelection
Definition: zone_settings.h:95
long long int m_minIslandArea
bool m_keepoutDoNotAllowTracks
bool GetDoNotAllowPads() const
double m_HatchSmoothingValue
Definition: zone_settings.h:91
void ExportSetting(ZONE &aTarget, bool aFullExport=true) const
Function ExportSetting copy settings to a given zone.
bool GetIsRuleArea() const
Accessors to parameters used in Rule Area zones:
int m_cornerSmoothingType
void SetDoNotAllowTracks(bool aEnable)
bool GetDoNotAllowVias() const
bool m_keepoutDoNotAllowCopperPour
ISLAND_REMOVAL_MODE m_removeIslands
double m_HatchHoleMinArea
Definition: zone_settings.h:92
int m_ZoneMinThickness
Definition: zone_settings.h:85
long long int GetMinIslandArea() const
long m_ThermalReliefSpokeWidth
TEARDROP_TYPE m_TeardropType
static const ZONE_SETTINGS & GetDefaultSettings()
unsigned m_ZonePriority
Definition: zone_settings.h:81
void SetCornerRadius(int aRadius)
void SetupLayersList(wxDataViewListCtrl *aList, PCB_BASE_FRAME *aFrame, LSET aLayers, bool aFpEditorMode)
A helper routine for the various zone dialogs (copper, non-copper, keepout).
wxString m_Name
Definition: zone_settings.h:97
ZONE_FILL_MODE m_FillMode
Definition: zone_settings.h:83
ZONE_CONNECTION m_padConnection
long m_ThermalReliefGap
void SetDoNotAllowFootprints(bool aEnable)
void SetDoNotAllowPads(bool aEnable)
ZONE_SETTINGS & operator<<(const ZONE &aSource)
operator << ( const ZONE& ) was Function ImportSetting copies settings from a given zone into this ob...
int m_HatchSmoothingLevel
Definition: zone_settings.h:89
ISLAND_REMOVAL_MODE GetIslandRemovalMode() const
ZONE_BORDER_DISPLAY_STYLE m_ZoneBorderDisplayStyle
Option to show the zone area (outlines only, short hatches or full hatches.
bool m_keepoutDoNotAllowFootprints
bool m_keepoutDoNotAllowVias
void SetDoNotAllowCopperPour(bool aEnable)
Handle a list of polygons defining a copper zone.
Definition: zone.h:72
void SetHatchThickness(int aThickness)
Definition: zone.h:274
void SetHatchBorderAlgorithm(int aAlgo)
Definition: zone.h:292
void SetDoNotAllowPads(bool aEnable)
Definition: zone.h:721
int GetHatchBorderAlgorithm() const
Definition: zone.h:291
bool GetIsRuleArea() const
Accessors to parameters used in Rule Area zones:
Definition: zone.h:710
bool GetDoNotAllowVias() const
Definition: zone.h:712
void SetCornerRadius(unsigned int aRadius)
Definition: zone.cpp:406
void SetCornerSmoothingType(int aType)
Definition: zone.h:659
void SetBorderDisplayStyle(ZONE_BORDER_DISPLAY_STYLE aBorderHatchStyle, int aBorderHatchPitch, bool aRebuilBorderdHatch)
Set all hatch parameters for the zone.
Definition: zone.cpp:879
bool GetDoNotAllowPads() const
Definition: zone.h:714
void SetMinThickness(int aMinThickness)
Definition: zone.h:259
bool GetDoNotAllowTracks() const
Definition: zone.h:713
void SetHatchOrientation(const EDA_ANGLE &aStep)
Definition: zone.h:280
void SetHatchSmoothingValue(double aValue)
Definition: zone.h:286
void SetHatchSmoothingLevel(int aLevel)
Definition: zone.h:283
void SetDoNotAllowCopperPour(bool aEnable)
Definition: zone.h:718
void SetThermalReliefSpokeWidth(int aThermalReliefSpokeWidth)
Definition: zone.h:194
ISLAND_REMOVAL_MODE GetIslandRemovalMode() const
Definition: zone.h:724
long long int GetMinIslandArea() const
Definition: zone.h:727
void SetIsRuleArea(bool aEnable)
Definition: zone.h:717
void SetDoNotAllowTracks(bool aEnable)
Definition: zone.h:720
int GetLocalClearance(wxString *aSource) const override
Return any local clearances set in the "classic" (ie: pre-rule) system.
Definition: zone.cpp:501
const wxString & GetZoneName() const
Definition: zone.h:131
int GetMinThickness() const
Definition: zone.h:258
void SetFillMode(ZONE_FILL_MODE aFillMode)
Definition: zone.h:180
ZONE_CONNECTION GetPadConnection() const
Definition: zone.h:255
int GetHatchThickness() const
Definition: zone.h:273
double GetHatchHoleMinArea() const
Definition: zone.h:288
void SetDoNotAllowVias(bool aEnable)
Definition: zone.h:719
int GetThermalReliefSpokeWidth() const
Definition: zone.h:202
int GetBorderHatchPitch() const
HatchBorder related methods.
Definition: zone.cpp:873
void SetLocalClearance(int aClearance)
Definition: zone.h:160
ZONE_BORDER_DISPLAY_STYLE GetHatchStyle() const
Definition: zone.h:593
void SetThermalReliefGap(int aThermalReliefGap)
Definition: zone.h:183
EDA_ANGLE GetHatchOrientation() const
Definition: zone.h:279
void SetLayerSet(LSET aLayerSet) override
Definition: zone.cpp:278
bool GetDoNotAllowFootprints() const
Definition: zone.h:715
ZONE_FILL_MODE GetFillMode() const
Definition: zone.h:181
virtual LSET GetLayerSet() const override
Return a std::bitset of all layers on which the item physically resides.
Definition: zone.h:129
void SetDoNotAllowFootprints(bool aEnable)
Definition: zone.h:722
bool GetDoNotAllowCopperPour() const
Definition: zone.h:711
int GetHatchGap() const
Definition: zone.h:276
void SetHatchHoleMinArea(double aPct)
Definition: zone.h:289
TEARDROP_TYPE GetTeardropAreaType() const
Definition: zone.h:705
double GetHatchSmoothingValue() const
Definition: zone.h:285
int GetHatchSmoothingLevel() const
Definition: zone.h:282
unsigned int GetCornerRadius() const
Definition: zone.h:665
int GetCornerSmoothingType() const
Definition: zone.h:661
void SetAssignedPriority(unsigned aPriority)
Definition: zone.h:114
void SetPadConnection(ZONE_CONNECTION aPadConnection)
Definition: zone.h:256
void SetZoneName(const wxString &aName)
Definition: zone.h:132
void SetTeardropAreaType(TEARDROP_TYPE aType)
Set the type of teardrop if the zone is a teardrop area for non teardrop area, the type must be TEARD...
Definition: zone.h:700
void SetIslandRemovalMode(ISLAND_REMOVAL_MODE aRemove)
Definition: zone.h:725
void SetMinIslandArea(long long int aArea)
Definition: zone.h:728
int GetThermalReliefGap() const
Definition: zone.h:191
void SetHatchGap(int aStep)
Definition: zone.h:277
unsigned GetAssignedPriority() const
Definition: zone.h:119
#define _(s)
static constexpr EDA_ANGLE & ANGLE_0
Definition: eda_angle.h:437
@ LAYER_PCB_BACKGROUND
PCB background color.
Definition: layer_ids.h:221
PCB_LAYER_ID
A quick note on layer IDs:
Definition: layer_ids.h:60
@ In1_Cu
Definition: layer_ids.h:66
@ F_Cu
Definition: layer_ids.h:65
wxSize GetTextSize(const wxString &aSingleLine, wxWindow *aWindow)
Return the size of aSingleLine of text when it is rendered in aWindow using whatever font is currentl...
Definition: ui_common.cpp:74
const double IU_PER_MM
Definition: base_units.h:77
constexpr int mmToIU(double mm) const
Definition: base_units.h:89
static const wxSize CHECKERBOARD_SIZE(8, 8)
static const wxSize LAYER_BITMAP_SIZE(24, 16)
Class ZONE_SETTINGS used to handle zones parameters in dialogs.
#define ZONE_THERMAL_RELIEF_GAP_MM
Definition: zones.h:33
#define ZONE_BORDER_HATCH_DIST_MM
Definition: zones.h:39
#define ZONE_THERMAL_RELIEF_COPPER_WIDTH_MM
Definition: zones.h:34
#define ZONE_CLEARANCE_MM
Definition: zones.h:37
#define ZONE_THICKNESS_MM
Definition: zones.h:35