KiCad PCB EDA Suite
Loading...
Searching...
No Matches
zone_settings.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) 2008-2018 Jean-Pierre Charras, [email protected]
5 * Copyright The 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
29
30#ifndef ZONE_SETTINGS_H_
31#define ZONE_SETTINGS_H_
32
33#include <optional>
34#include <map>
35#include <layer_ids.h>
36#include <lset.h>
37#include <zones.h>
38#include <geometry/eda_angle.h>
40
41class wxDataViewListCtrl;
42
44{
45 POLYGONS = 0, // fill zone with polygons
46 HATCH_PATTERN = 1 // fill zone using a grid pattern
47};
48
50{
51 std::optional<VECTOR2I> hatching_offset;
52
53 bool operator==( const ZONE_LAYER_PROPERTIES& aOther ) const;
54};
55
56
59{
63 INVISIBLE_BORDER // Disable outline drawing for very special cases
64};
65
73
81
89{
90public:
91 // the actual zone outline shape can be slightly modified (smoothed):
92 enum {
94 SMOOTHING_NONE = 0, // Zone outline is used without change
95 SMOOTHING_CHAMFER, // Zone outline is used after chamfering corners
96 SMOOTHING_FILLET, // Zone outline is used after rounding corners
97 SMOOTHING_LAST // sentinel
98 };
99
100 unsigned m_ZonePriority; // Priority (0 ... N) of the zone
101
103 int m_ZoneClearance; // Minimal clearance value
104 int m_ZoneMinThickness; // Min thickness value in filled areas
105 int m_HatchThickness; // HatchBorder thickness of lines (if 0 -> solid shape)
106 int m_HatchGap; // HatchBorder clearance between lines (0 -> solid shape)
107 EDA_ANGLE m_HatchOrientation; // HatchBorder orientation of grid lines
108 int m_HatchSmoothingLevel; // HatchBorder smoothing type, similar to corner smoothing type
109 // 0 = no smoothing, 1 = fillet, >= 2 = arc
110 double m_HatchSmoothingValue; // HatchBorder chamfer/fillet size as a ratio of hole size
111 double m_HatchHoleMinArea; // min size before holes are dropped (ratio)
112 int m_HatchBorderAlgorithm; // 0 = use min zone thickness
113
114 int m_Netcode; // Net code selection for the current zone
115
116 wxString m_Name; // Unique name for the current zone (can be blank)
117
118 LSET m_Layers; // Layers that this zone exists on
119
122 int m_BorderHatchPitch; // for hatched outlines: dist between 2 hatches
123
124 long m_ThermalReliefGap; // thickness of the gap in thermal reliefs
125 long m_ThermalReliefSpokeWidth; // thickness of the copper bridge in thermal reliefs
126
128
129 /* A zone outline can be a teardrop zone with different rules
130 * priority, smoothed corners, thermal relief...
131 */
133
134 std::map<PCB_LAYER_ID, ZONE_LAYER_PROPERTIES> m_LayerProperties;
135
136private:
137 int m_cornerSmoothingType; // Corner smoothing type
138 unsigned int m_cornerRadius; // Corner chamfer distance / fillet radius
140
141 /*
142 * Keepout zones and keepout flags.
143 * Note that DRC rules can set keepouts on zones whether they're a keepout or not.
144 */
146
153
159
161 long long int m_minIslandArea;
162
163public:
165
166 bool operator==( const ZONE_SETTINGS& aOther ) const;
167
168 bool operator!=( const ZONE_SETTINGS& aOther ) const { return !operator==( aOther ); }
169
176 ZONE_SETTINGS& operator << ( const ZONE& aSource );
177
181 static const ZONE_SETTINGS& GetDefaultSettings();
182
188 void SetupLayersList( wxDataViewListCtrl* aList, PCB_BASE_FRAME* aFrame, LSET aLayers );
189
198 void ExportSetting( ZONE& aTarget, bool aFullExport = true ) const;
199
211 void CopyFrom( const ZONE_SETTINGS& aOther, bool aCopyFull = true );
212
213 void SetCornerSmoothingType( int aType) { m_cornerSmoothingType = aType; }
215
216 void SetCornerRadius( int aRadius );
217 unsigned int GetCornerRadius() const { return m_cornerRadius; }
218
220 void SetPadConnection( ZONE_CONNECTION aPadConnection ) { m_padConnection = aPadConnection; }
221
230
237 bool GetIsRuleArea() const { return m_isRuleArea; }
243
244 void SetPlacementAreaEnabled( bool aEnabled ) { m_placementAreaEnabled = aEnabled; }
246 void SetPlacementAreaSource( const wxString& aSource ) { m_placementAreaSource = aSource; }
247 void SetIsRuleArea( bool aEnable ) { m_isRuleArea = aEnable; }
248 void SetDoNotAllowZoneFills( bool aEnable ) { m_keepoutDoNotAllowZoneFills = aEnable; }
249 void SetDoNotAllowVias( bool aEnable ) { m_keepoutDoNotAllowVias = aEnable; }
250 void SetDoNotAllowTracks( bool aEnable ) { m_keepoutDoNotAllowTracks = aEnable; }
251 void SetDoNotAllowPads( bool aEnable ) { m_keepoutDoNotAllowPads = aEnable; }
252 void SetDoNotAllowFootprints( bool aEnable ) { m_keepoutDoNotAllowFootprints = aEnable; }
253
256
257 long long int GetMinIslandArea() const { return m_minIslandArea; }
258 void SetMinIslandArea( long long int aArea ) { m_minIslandArea = aArea; }
259};
260
261
262#endif // ZONE_SETTINGS_H_
A lightweight representation of a component class.
LSET is a set of PCB_LAYER_IDs.
Definition lset.h:37
Base PCB main window class for Pcbnew, Gerbview, and CvPcb footprint viewer.
ZONE_SETTINGS handles zones parameters.
bool m_keepoutDoNotAllowPads
void SetIsRuleArea(bool aEnable)
bool operator==(const ZONE_SETTINGS &aOther) const
bool operator!=(const ZONE_SETTINGS &aOther) const
unsigned int m_cornerRadius
bool GetDoNotAllowTracks() const
wxString GetPlacementAreaSource() const
EDA_ANGLE m_HatchOrientation
void SetDoNotAllowVias(bool aEnable)
bool GetDoNotAllowFootprints() const
long long int m_minIslandArea
void SetIslandRemovalMode(ISLAND_REMOVAL_MODE aRemove)
bool m_keepoutDoNotAllowTracks
bool GetDoNotAllowPads() const
double m_HatchSmoothingValue
PLACEMENT_SOURCE_T GetPlacementAreaSourceType() const
PLACEMENT_SOURCE_T m_placementAreaSourceType
void SetMinIslandArea(long long int aArea)
void ExportSetting(ZONE &aTarget, bool aFullExport=true) const
Function ExportSetting copy settings to a given zone.
bool GetIsRuleArea() const
bool GetDoNotAllowZoneFills() const
void SetDoNotAllowTracks(bool aEnable)
bool m_keepoutDoNotAllowZoneFills
bool GetDoNotAllowVias() const
wxString m_placementAreaSource
ISLAND_REMOVAL_MODE m_removeIslands
void SetPlacementAreaSource(const wxString &aSource)
double m_HatchHoleMinArea
void SetPadConnection(ZONE_CONNECTION aPadConnection)
long long int GetMinIslandArea() const
long m_ThermalReliefSpokeWidth
void SetPlacementAreaEnabled(bool aEnabled)
ZONE_CONNECTION GetPadConnection() const
TEARDROP_TYPE m_TeardropType
bool m_placementAreaEnabled
Placement rule area data.
static const ZONE_SETTINGS & GetDefaultSettings()
unsigned m_ZonePriority
void SetCornerRadius(int aRadius)
bool GetPlacementAreaEnabled() const
Accessors to parameters used in Rule Area zones:
std::map< PCB_LAYER_ID, ZONE_LAYER_PROPERTIES > m_LayerProperties
bool HasKeepoutParametersSet() const
Accessor to determine if any keepout parameters are set.
int GetCornerSmoothingType() const
ZONE_FILL_MODE m_FillMode
ZONE_CONNECTION m_padConnection
void SetDoNotAllowFootprints(bool aEnable)
void SetDoNotAllowPads(bool aEnable)
void SetCornerSmoothingType(int aType)
ZONE_SETTINGS & operator<<(const ZONE &aSource)
operator << ( const ZONE& ) was Function ImportSetting copies settings from a given zone into this ob...
void CopyFrom(const ZONE_SETTINGS &aOther, bool aCopyFull=true)
Function CopyFrom copy settings from a different ZONE_SETTINGS object.
void SetDoNotAllowZoneFills(bool aEnable)
void SetupLayersList(wxDataViewListCtrl *aList, PCB_BASE_FRAME *aFrame, LSET aLayers)
A helper routine for the various zone dialogs (copper, non-copper, keepout).
unsigned int GetCornerRadius() const
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 SetPlacementAreaSourceType(PLACEMENT_SOURCE_T aType)
Handle a list of polygons defining a copper zone.
Definition zone.h:74
std::optional< VECTOR2I > hatching_offset
bool operator==(const ZONE_LAYER_PROPERTIES &aOther) const
TEARDROP_TYPE
define the type of a teardrop: on a via or pad, or a track end
ISLAND_REMOVAL_MODE
Whether or not to remove isolated islands from a zone.
ZONE_FILL_MODE
ZONE_BORDER_DISPLAY_STYLE
Zone border styles.
PLACEMENT_SOURCE_T
ZONE_CONNECTION
How pads are covered by copper in zone.
Definition zones.h:47