KiCad PCB EDA Suite
Loading...
Searching...
No Matches
pcb_painter.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) 2013 CERN
5 * Copyright (C) 2016-2023 KiCad Developers, see AUTHORS.txt for contributors.
6 *
7 * @author Tomasz Wlostowski <[email protected]>
8 * @author Maciej Suminski <[email protected]>
9 *
10 * This program is free software; you can redistribute it and/or
11 * modify it under the terms of the GNU General Public License
12 * as published by the Free Software Foundation; either version 2
13 * of the License, or (at your option) any later version.
14 *
15 * This program is distributed in the hope that it will be useful,
16 * but WITHOUT ANY WARRANTY; without even the implied warranty of
17 * MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the
18 * GNU General Public License for more details.
19 *
20 * You should have received a copy of the GNU General Public License
21 * along with this program; if not, you may find one here:
22 * http://www.gnu.org/licenses/old-licenses/gpl-2.0.html
23 * or you may search the http://www.gnu.org website for the version 2 license,
24 * or you may write to the Free Software Foundation, Inc.,
25 * 51 Franklin Street, Fifth Floor, Boston, MA 02110-1301, USA
26 */
27
28#ifndef PCB_PAINTER_H
29#define PCB_PAINTER_H
30
31#include <frame_type.h>
32#include <gal/painter.h>
33#include <pcb_display_options.h>
34#include <math/vector2d.h>
35#include <memory>
37
38
39class EDA_ITEM;
42class BOARD_ITEM;
43class PCB_ARC;
44class BOARD;
45class PCB_VIA;
46class PCB_TRACK;
47class PAD;
48class PCB_SHAPE;
49class PCB_GROUP;
50class FOOTPRINT;
51class ZONE;
52class PCB_BITMAP;
53class PCB_TEXT;
54class PCB_TEXTBOX;
56class PCB_TARGET;
57class PCB_MARKER;
58class NET_SETTINGS;
59class NETINFO_LIST;
60class TEXT_ATTRIBUTES;
61
62namespace KIFONT
63{
64class FONT;
65class METRICS;
66}
67
68namespace KIGFX
69{
70class GAL;
71
76{
77public:
78 friend class PCB_PAINTER;
79
81
88 void LoadDisplayOptions( const PCB_DISPLAY_OPTIONS& aOptions );
89
90 void LoadColors( const COLOR_SETTINGS* aSettings ) override;
91
93 COLOR4D GetColor( const VIEW_ITEM* aItem, int aLayer ) const override;
94
95 bool GetShowPageLimits() const override;
96
97 inline bool IsBackgroundDark() const override
98 {
100
101 return luma < 0.5;
102 }
103
104 const COLOR4D& GetBackgroundColor() const override { return m_layerColors[ LAYER_PCB_BACKGROUND ]; }
105
106 void SetBackgroundColor( const COLOR4D& aColor ) override
107 {
109 }
110
111 const COLOR4D& GetGridColor() override { return m_layerColors[ LAYER_GRID ]; }
112
113 const COLOR4D& GetCursorColor() override { return m_layerColors[ LAYER_CURSOR ]; }
114
117
118 std::map<wxString, KIGFX::COLOR4D>& GetNetclassColorMap() { return m_netclassColors; }
119
120 std::map<int, KIGFX::COLOR4D>& GetNetColorMap() { return m_netColors; }
121
122 std::set<int>& GetHiddenNets() { return m_hiddenNets; }
123 const std::set<int>& GetHiddenNets() const { return m_hiddenNets; }
124
125public:
128
131
132 PAD* m_PadEditModePad; // Pad currently in Pad Edit Mode (if any)
133
134protected:
136 static const double MAX_FONT_SIZE;
137
140
142 std::map<wxString, KIGFX::COLOR4D> m_netclassColors;
143
145 std::map<int, KIGFX::COLOR4D> m_netColors;
146
148 std::set<int> m_hiddenNets;
149
150 // These opacity overrides multiply with any opacity in the base layer color
156};
157
158
162class PCB_PAINTER : public PAINTER
163{
164public:
165 PCB_PAINTER( GAL* aGal, FRAME_T aFrameType );
166
169 {
170 return &m_pcbSettings;
171 }
172
174 virtual bool Draw( const VIEW_ITEM* aItem, int aLayer ) override;
175
176protected:
178
179 // Drawing functions for various types of PCB-specific items
180 void draw( const PCB_TRACK* aTrack, int aLayer );
181 void draw( const PCB_ARC* aArc, int aLayer );
182 void draw( const PCB_VIA* aVia, int aLayer );
183 void draw( const PAD* aPad, int aLayer );
184 void draw( const PCB_SHAPE* aSegment, int aLayer );
185 void draw( const PCB_BITMAP* aBitmap, int aLayer );
186 void draw( const PCB_TEXT* aText, int aLayer );
187 void draw( const PCB_TEXTBOX* aText, int aLayer );
188 void draw( const FOOTPRINT* aFootprint, int aLayer );
189 void draw( const PCB_GROUP* aGroup, int aLayer );
190 void draw( const ZONE* aZone, int aLayer );
191 void draw( const PCB_DIMENSION_BASE* aDimension, int aLayer );
192 void draw( const PCB_TARGET* aTarget );
193 void draw( const PCB_MARKER* aMarker, int aLayer );
194
201 int getLineThickness( int aActualThickness ) const;
202
206 virtual int getDrillShape( const PAD* aPad ) const;
207
211 virtual SHAPE_SEGMENT getPadHoleShape( const PAD* aPad ) const;
212
216 virtual int getViaDrillSize( const PCB_VIA* aVia ) const;
217
218 void strokeText( const wxString& aText, const VECTOR2I& aPosition,
219 const TEXT_ATTRIBUTES& aAttrs, const KIFONT::METRICS& aFontMetrics );
220
221 void renderNetNameForSegment( const SHAPE_SEGMENT& aSeg, const COLOR4D& aColor, const wxString& aNetName ) const;
222
223protected:
226
230};
231} // namespace KIGFX
232
233#endif /* PCB_PAINTER_H */
HIGH_CONTRAST_MODE
Determine how inactive layers should be displayed.
A base class for any item which can be embedded within the BOARD container class, and therefore insta...
Definition: board_item.h:77
Information pertinent to a Pcbnew printed circuit board.
Definition: board.h:271
Color settings are a bit different than most of the settings objects in that there can be more than o...
A base class for most all the KiCad significant classes used in schematics and boards.
Definition: eda_item.h:85
A color representation with 4 components: red, green, blue, alpha.
Definition: color4d.h:104
double GetBrightness() const
Returns the brightness value of the color ranged from 0.0 to 1.0.
Definition: color4d.h:333
Abstract interface for drawing on a 2D-surface.
Contains all the knowledge about how to draw graphical object onto any particular output device.
Definition: painter.h:59
Contains methods for drawing PCB-specific items.
Definition: pcb_painter.h:163
virtual SHAPE_SEGMENT getPadHoleShape(const PAD *aPad) const
Return hole shape for a pad (internal units).
int getLineThickness(int aActualThickness) const
Get the thickness to draw for a line (e.g.
virtual PCB_RENDER_SETTINGS * GetSettings() override
Return a pointer to current settings that are going to be used when drawing items.
Definition: pcb_painter.h:168
void renderNetNameForSegment(const SHAPE_SEGMENT &aSeg, const COLOR4D &aColor, const wxString &aNetName) const
PCB_VIEWERS_SETTINGS_BASE * viewer_settings()
Definition: pcb_painter.cpp:79
void draw(const PCB_TRACK *aTrack, int aLayer)
virtual int getDrillShape(const PAD *aPad) const
Return drill shape of a pad.
PCB_RENDER_SETTINGS m_pcbSettings
Definition: pcb_painter.h:224
virtual int getViaDrillSize(const PCB_VIA *aVia) const
Return drill diameter for a via (internal units).
void strokeText(const wxString &aText, const VECTOR2I &aPosition, const TEXT_ATTRIBUTES &aAttrs, const KIFONT::METRICS &aFontMetrics)
virtual bool Draw(const VIEW_ITEM *aItem, int aLayer) override
Takes an instance of VIEW_ITEM and passes it to a function that knows how to draw the item.
PCB specific render settings.
Definition: pcb_painter.h:76
void SetNetColorMode(NET_COLOR_MODE aMode)
Definition: pcb_painter.h:116
double m_zoneOpacity
Opacity override for filled zones.
Definition: pcb_painter.h:154
double m_trackOpacity
Opacity override for all tracks.
Definition: pcb_painter.h:151
const std::set< int > & GetHiddenNets() const
Definition: pcb_painter.h:123
double m_imageOpacity
Opacity override for user images.
Definition: pcb_painter.h:155
bool IsBackgroundDark() const override
Definition: pcb_painter.h:97
std::set< int > & GetHiddenNets()
Definition: pcb_painter.h:122
const COLOR4D & GetCursorColor() override
Return current cursor color settings.
Definition: pcb_painter.h:113
double m_viaOpacity
Opacity override for all types of via.
Definition: pcb_painter.h:152
ZONE_DISPLAY_MODE m_ZoneDisplayMode
Definition: pcb_painter.h:129
const COLOR4D & GetBackgroundColor() const override
Return current background color settings.
Definition: pcb_painter.h:104
NET_COLOR_MODE GetNetColorMode() const
Definition: pcb_painter.h:115
void LoadColors(const COLOR_SETTINGS *aSettings) override
double m_padOpacity
Opacity override for SMD pads and PTHs.
Definition: pcb_painter.h:153
const COLOR4D & GetGridColor() override
Return current grid color settings.
Definition: pcb_painter.h:111
void SetBackgroundColor(const COLOR4D &aColor) override
Set the background color.
Definition: pcb_painter.h:106
COLOR4D GetColor(const VIEW_ITEM *aItem, int aLayer) const override
Returns the color that should be used to draw the specific VIEW_ITEM on the specific layer using curr...
std::set< int > m_hiddenNets
Definition: pcb_painter.h:148
HIGH_CONTRAST_MODE m_ContrastModeDisplay
Definition: pcb_painter.h:130
std::map< int, KIGFX::COLOR4D > m_netColors
Set of net codes that should not have their ratsnest displayed.
Definition: pcb_painter.h:145
std::map< int, KIGFX::COLOR4D > & GetNetColorMap()
Definition: pcb_painter.h:120
NET_COLOR_MODE m_netColorMode
Overrides for specific netclass colors.
Definition: pcb_painter.h:139
std::map< wxString, KIGFX::COLOR4D > & GetNetclassColorMap()
Definition: pcb_painter.h:118
static const double MAX_FONT_SIZE
< Maximum font size for netnames (and other dynamically shown strings)
Definition: pcb_painter.h:136
std::map< wxString, KIGFX::COLOR4D > m_netclassColors
Overrides for specific net colors, stored as netcodes for the ratsnest to access easily.
Definition: pcb_painter.h:142
bool GetShowPageLimits() const override
void LoadDisplayOptions(const PCB_DISPLAY_OPTIONS &aOptions)
Load settings related to display options (high-contrast mode, full or outline modes for vias/pads/tra...
Container for all the knowledge about how graphical objects are drawn on any output surface/device.
COLOR4D m_layerColors[LAYER_ID_COUNT]
An abstract base class for deriving all objects that can be added to a VIEW.
Definition: view_item.h:82
Container for NETINFO_ITEM elements, which are the nets.
Definition: netinfo.h:338
NET_SETTINGS stores various net-related settings in a project context.
Definition: net_settings.h:34
Definition: pad.h:58
Object to handle a bitmap image that can be inserted in a PCB.
Definition: pcb_bitmap.h:42
Abstract dimension API.
A set of BOARD_ITEMs (i.e., without duplicates).
Definition: pcb_group.h:51
Handle a list of polygons defining a copper zone.
Definition: zone.h:72
FRAME_T
The set of EDA_BASE_FRAME derivatives, typically stored in EDA_BASE_FRAME::m_Ident.
Definition: frame_type.h:33
@ LAYER_GRID
Definition: layer_ids.h:206
@ LAYER_PCB_BACKGROUND
PCB background color.
Definition: layer_ids.h:221
@ LAYER_CURSOR
PCB cursor.
Definition: layer_ids.h:222
The Cairo implementation of the graphics abstraction layer.
Definition: color4d.cpp:247