KiCad PCB EDA Suite
Loading...
Searching...
No Matches
pcbnew_printout.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) 2009 Jean-Pierre Charras, [email protected]
5 * Copyright The KiCad Developers, see AUTHORS.txt for contributors.
6 * Copyright (C) 2018 CERN
7 * Author: Maciej Suminski <[email protected]>
8 * Author: Tomasz Wlostowski <[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#include "pcbnew_printout.h"
29#include <board.h>
30#include <math/util.h> // for KiROUND
32#include <lset.h>
33#include <pcb_painter.h>
34#include <pcbnew_settings.h>
35#include <view/view.h>
36#include <pcbplot.h>
38#include <pad.h>
39
40#include <advanced_config.h>
41#include <pgm_base.h>
42
51
52
57
58
63
64
66 const KIGFX::VIEW* aView, const wxString& aTitle ) :
67 BOARD_PRINTOUT( aParams, aView, aTitle ), m_pcbnewSettings( aParams )
68{
69 m_board = aBoard;
70}
71
72
74{
75 // Store the layerset, as it is going to be modified below and the original settings are
76 // needed.
77 LSET lset = m_settings.m_LayerSet;
78 int pageCount = lset.count();
79 wxString layerName;
80 PCB_LAYER_ID extractLayer;
81
82 // compute layer mask from page number if we want one page per layer
84 {
85 // This sequence is TBD, call a different sequencer if needed, such as Seq().
86 // Could not find documentation on page order.
87 LSEQ seq = lset.UIOrder();
88
89 // aPage starts at 1, not 0
90 if( unsigned( aPage - 1 ) < seq.size() )
91 m_settings.m_LayerSet = LSET( { seq[aPage - 1] } );
92 }
93
94 if( !m_settings.m_LayerSet.any() )
95 return false;
96
97 extractLayer = m_settings.m_LayerSet.ExtractLayer();
98
99 if( extractLayer == UNDEFINED_LAYER )
100 layerName = _( "Multiple Layers" );
101 else
102 layerName = m_board->GetLayerName( extractLayer );
103
104 // In Pcbnew we can want the layer EDGE always printed
105 if( m_pcbnewSettings.m_PrintEdgeCutsOnAllPages )
106 m_settings.m_LayerSet.set( Edge_Cuts );
107
108 DrawPage( layerName, aPage, pageCount );
109
110 // Restore the original layer set, so the next page can be printed
111 m_settings.m_LayerSet = lset;
112
113 return true;
114}
115
116
117int PCBNEW_PRINTOUT::milsToIU( double aMils ) const
118{
119 return KiROUND( pcbIUScale.IU_PER_MILS * aMils );
120}
121
122
123void PCBNEW_PRINTOUT::setupViewLayers( KIGFX::VIEW& aView, const LSET& aLayerSet )
124{
125 BOARD_PRINTOUT::setupViewLayers( aView, aLayerSet );
126
127 for( PCB_LAYER_ID layer : m_settings.m_LayerSet )
128 {
129 aView.SetLayerVisible( PCBNEW_LAYER_ID_START + layer, true );
130
131 // Enable the corresponding zone layer (copper layers and other layers)
132 aView.SetLayerVisible( LAYER_ZONE_START + layer, true );
133 aView.SetLayerVisible( LAYER_PAD_COPPER_START + layer, true );
134 aView.SetLayerVisible( LAYER_VIA_COPPER_START + layer, true );
135 }
136
137 RENDER_SETTINGS* renderSettings = aView.GetPainter()->GetSettings();
138 // A color to do not print objects on some layers, when the layer must be enabled
139 // to print some other objects
140 COLOR4D invisible_color = COLOR4D::UNSPECIFIED;
141
142 if( m_pcbnewSettings.m_AsItemCheckboxes )
143 {
144 auto setVisibility =
145 [&]( GAL_LAYER_ID aLayer )
146 {
147 if( m_board->IsElementVisible( aLayer ) )
148 aView.SetLayerVisible( aLayer, true );
149 else
150 renderSettings->SetLayerColor( aLayer, invisible_color );
151 };
152
153 setVisibility( LAYER_FOOTPRINTS_FR );
154 setVisibility( LAYER_FOOTPRINTS_BK );
155 setVisibility( LAYER_FP_VALUES );
156 setVisibility( LAYER_FP_REFERENCES );
157 setVisibility( LAYER_FP_TEXT );
158 setVisibility( LAYER_PADS );
159
160 setVisibility( LAYER_TRACKS );
161 setVisibility( LAYER_VIAS );
162 setVisibility( LAYER_VIA_MICROVIA );
163 setVisibility( LAYER_VIA_BBLIND );
164 setVisibility( LAYER_VIA_THROUGH );
165 setVisibility( LAYER_ZONES );
166 setVisibility( LAYER_FILLED_SHAPES );
167
168 setVisibility( LAYER_DRC_WARNING );
169 setVisibility( LAYER_DRC_ERROR );
170 setVisibility( LAYER_DRC_SHAPES );
171 setVisibility( LAYER_DRC_EXCLUSION );
172 setVisibility( LAYER_ANCHOR );
173 setVisibility( LAYER_DRAWINGSHEET );
174 setVisibility( LAYER_GRID );
175 }
176 else
177 {
178 // Enable items on copper layers, but do not draw holes
180 {
181 if( ( aLayerSet & LSET::AllCuMask() ).any() ) // Items visible on any copper layer
182 aView.SetLayerVisible( layer, true );
183 else
184 renderSettings->SetLayerColor( layer, invisible_color );
185 }
186
187 // Keep certain items always enabled/disabled and just rely on the layer visibility
188 // Note LAYER_PADS_SMD_FR, LAYER_PADS_SMD_BK, LAYER_PADS_TH are enabled here because paths must
189 // be drawn on some other (technical) layers.
190 const int alwaysEnabled[] =
191 {
197 };
198
199 for( int layer : alwaysEnabled )
200 aView.SetLayerVisible( layer, true );
201 }
202
204 {
205 // Enable hole layers to draw drill marks
207 {
208 aView.SetLayerVisible( layer, true );
209 aView.SetTopLayer( layer, true );
210 }
211
213 && !m_settings.m_blackWhite )
214 {
215 for( int layer : { LAYER_PAD_HOLEWALLS, LAYER_VIA_HOLEWALLS } )
216 {
217 aView.SetLayerVisible( layer, true );
218 aView.SetTopLayer( layer, true );
219 }
220 }
221 }
222}
223
224
226{
228
229 KIGFX::PCB_PRINT_PAINTER& painter = dynamic_cast<KIGFX::PCB_PRINT_PAINTER&>( aPainter );
230
231 switch( m_pcbnewSettings.m_DrillMarks )
232 {
234 painter.SetDrillMarks( false, 0 );
235 break;
236
238 painter.SetDrillMarks( false, pcbIUScale.mmToIU( ADVANCED_CFG::GetCfg().m_SmallDrillMarkSize ) );
239
243 break;
244
246 painter.SetDrillMarks( true );
247
251 break;
252 }
253}
254
255
257{
259 aGal->SetWorldUnitLength( 0.001/pcbIUScale.IU_PER_MM /* 1 nm */ / 0.0254 /* 1 inch in meters */ );
260}
261
262
264{
265 return m_board->ComputeBoundingBox( false );
266}
267
268
269std::unique_ptr<KIGFX::PAINTER> PCBNEW_PRINTOUT::getPainter( KIGFX::GAL* aGal )
270{
271 return std::make_unique<KIGFX::PCB_PRINT_PAINTER>( aGal );
272}
273
274
280
281
286
287
289{
290 if( m_drillMarkReal )
292 else
293 return SHAPE_SEGMENT( aPad->GetPosition(), aPad->GetPosition(), m_drillMarkSize );
294}
295
296
constexpr EDA_IU_SCALE pcbIUScale
Definition base_units.h:112
BOX2< VECTOR2I > BOX2I
Definition box2.h:922
constexpr BOX2I KiROUND(const BOX2D &aBoxD)
Definition box2.h:990
static const ADVANCED_CFG & GetCfg()
Get the singleton instance's config, which is shared by all consumers.
APP_SETTINGS_BASE is a settings class that should be derived for each standalone KiCad application.
virtual void DrawPage(const wxString &aLayerName=wxEmptyString, int aPageNum=1, int aPageCount=1)
Print a page (or a set of pages).
virtual void setupPainter(KIGFX::PAINTER &aPainter)
Configure #PAINTER object for a printout.
virtual void setupViewLayers(KIGFX::VIEW &aView, const LSET &aLayerSet)
Enable layers visibility for a printout.
BOARD_PRINTOUT(const BOARD_PRINTOUT_SETTINGS &aParams, const KIGFX::VIEW *aView, const wxString &aTitle)
virtual void setupGal(KIGFX::GAL *aGal)
Configure GAL object for a printout.
BOARD_PRINTOUT_SETTINGS m_settings
Printout parameters.
Information pertinent to a Pcbnew printed circuit board.
Definition board.h:317
static const COLOR4D UNSPECIFIED
For legacy support; used as a value to indicate color hasn't been set yet.
Definition color4d.h:398
static const COLOR4D BLACK
Definition color4d.h:402
A color representation with 4 components: red, green, blue, alpha.
Definition color4d.h:104
Abstract interface for drawing on a 2D-surface.
void SetWorldUnitLength(double aWorldUnitLength)
Set the unit length.
Contains all the knowledge about how to draw graphical object onto any particular output device.
Definition painter.h:59
virtual RENDER_SETTINGS * GetSettings()=0
Return a pointer to current settings that are going to be used when drawing items.
virtual SHAPE_SEGMENT getPadHoleShape(const PAD *aPad) const
Return hole shape for a pad (internal units).
PCB_PAINTER(GAL *aGal, FRAME_T aFrameType)
virtual PCB_RENDER_SETTINGS * GetSettings() override
Return a pointer to current settings that are going to be used when drawing items.
virtual PAD_DRILL_SHAPE getDrillShape(const PAD *aPad) const
Return drill shape of a pad.
virtual int getViaDrillSize(const PCB_VIA *aVia) const
Return drill diameter for a via (internal units).
Special flavor of PCB_PAINTER that contains modifications to handle printing options.
void SetDrillMarks(bool aRealSize, unsigned int aSize=0)
Set drill marks visibility and options.
SHAPE_SEGMENT getPadHoleShape(const PAD *aPad) const override
Return hole shape for a pad (internal units).
int getViaDrillSize(const PCB_VIA *aVia) const override
Return drill diameter for a via (internal units).
int m_drillMarkSize
User-specified size (in internal units)
PAD_DRILL_SHAPE getDrillShape(const PAD *aPad) const override
Return drill shape of a pad.
bool m_drillMarkReal
Actual hole size or user-specified size for drill marks.
Container for all the knowledge about how graphical objects are drawn on any output surface/device.
void SetLayerColor(int aLayer, const COLOR4D &aColor)
Change the color used to draw a layer.
Hold a (potentially large) number of VIEW_ITEMs and renders them on a graphics device provided by the...
Definition view.h:66
void SetLayerVisible(int aLayer, bool aVisible=true)
Control the visibility of a particular layer.
Definition view.h:400
virtual void SetTopLayer(int aLayer, bool aEnabled=true)
Set given layer to be displayed on the top or sets back the default order of layers.
Definition view.cpp:839
PAINTER * GetPainter() const
Return the painter object used by the view for drawing #VIEW_ITEMS.
Definition view.h:220
LSEQ is a sequence (and therefore also a set) of PCB_LAYER_IDs.
Definition lseq.h:47
LSET is a set of PCB_LAYER_IDs.
Definition lset.h:37
LSEQ UIOrder() const
Return the copper, technical and user layers in the order shown in layer widget.
Definition lset.cpp:726
static LSET AllCuMask(int aCuLayerCount)
Return a mask holding the requested number of Cu PCB_LAYER_IDs.
Definition lset.cpp:582
Definition pad.h:54
VECTOR2I GetPosition() const override
Definition pad.h:208
Describe the page size and margins of a paper page on which to eventually print or plot.
Definition page_info.h:79
int milsToIU(double aMils) const override
Convert mils to internal units.
bool OnPrintPage(int aPage) override
std::unique_ptr< KIGFX::PAINTER > getPainter(KIGFX::GAL *aGal) override
Return the #PAINTER instance used to draw the items.
void setupGal(KIGFX::GAL *aGal) override
Configure GAL object for a printout.
PCBNEW_PRINTOUT(BOARD *aBoard, const PCBNEW_PRINTOUT_SETTINGS &aParams, const KIGFX::VIEW *aView, const wxString &aTitle)
PCBNEW_PRINTOUT_SETTINGS m_pcbnewSettings
void setupPainter(KIGFX::PAINTER &aPainter) override
Configure #PAINTER object for a printout.
BOX2I getBoundingBox() override
Return bounding box of the printed objects (excluding drawing-sheet frame).
void setupViewLayers(KIGFX::VIEW &aView, const LSET &aLayerSet) override
Enable layers visibility for a printout.
A type-safe container of any type.
Definition ki_any.h:93
#define _(s)
@ FRAME_PCB_EDITOR
Definition frame_type.h:42
constexpr PCB_LAYER_ID PCBNEW_LAYER_ID_START
Definition layer_ids.h:174
GAL_LAYER_ID
GAL layers are "virtual" layers, i.e.
Definition layer_ids.h:228
@ LAYER_GRID
Definition layer_ids.h:253
@ LAYER_PAD_COPPER_START
Virtual layers for pad copper on a given copper layer.
Definition layer_ids.h:336
@ LAYER_VIA_HOLEWALLS
Definition layer_ids.h:297
@ LAYER_FILLED_SHAPES
Copper graphic shape opacity/visibility (color ignored).
Definition layer_ids.h:312
@ LAYER_FOOTPRINTS_FR
Show footprints on front.
Definition layer_ids.h:258
@ LAYER_NON_PLATEDHOLES
Draw usual through hole vias.
Definition layer_ids.h:238
@ LAYER_DRAWINGSHEET
Sheet frame and title block.
Definition layer_ids.h:277
@ LAYER_FP_REFERENCES
Show footprints references (when texts are visible).
Definition layer_ids.h:265
@ LAYER_DRC_EXCLUSION
Layer for DRC markers which have been individually excluded.
Definition layer_ids.h:303
@ LAYER_ZONES
Control for copper zone opacity/visibility (color ignored).
Definition layer_ids.h:294
@ LAYER_DRC_SHAPES
Custom shapes for DRC markers.
Definition layer_ids.h:314
@ LAYER_PADS
Meta control for all pads opacity/visibility (color ignored).
Definition layer_ids.h:291
@ LAYER_DRC_WARNING
Layer for DRC markers with #SEVERITY_WARNING.
Definition layer_ids.h:300
@ LAYER_PAD_PLATEDHOLES
to draw pad holes (plated)
Definition layer_ids.h:270
@ LAYER_VIA_COPPER_START
Virtual layers for via copper on a given copper layer.
Definition layer_ids.h:340
@ LAYER_TRACKS
Definition layer_ids.h:266
@ LAYER_ZONE_START
Virtual layers for stacking zones and tracks on a given copper layer.
Definition layer_ids.h:332
@ LAYER_FP_TEXT
Definition layer_ids.h:239
@ LAYER_FOOTPRINTS_BK
Show footprints on back.
Definition layer_ids.h:259
@ LAYER_ANCHOR
Anchor of items having an anchor point (texts, footprints).
Definition layer_ids.h:247
@ LAYER_VIA_HOLES
Draw via holes (pad holes do not use this layer).
Definition layer_ids.h:273
@ LAYER_FP_VALUES
Show footprints values (when texts are visible).
Definition layer_ids.h:262
@ LAYER_VIA_MICROVIA
Definition layer_ids.h:233
@ LAYER_VIA_THROUGH
Draw blind/buried vias.
Definition layer_ids.h:235
@ LAYER_DRC_ERROR
Layer for DRC markers with #SEVERITY_ERROR.
Definition layer_ids.h:276
@ LAYER_VIAS
Meta control for all vias opacity/visibility.
Definition layer_ids.h:232
@ LAYER_VIA_BBLIND
Draw micro vias.
Definition layer_ids.h:234
@ LAYER_PAD_HOLEWALLS
Definition layer_ids.h:296
PCB_LAYER_ID
A quick note on layer IDs:
Definition layer_ids.h:60
@ Edge_Cuts
Definition layer_ids.h:112
@ UNDEFINED_LAYER
Definition layer_ids.h:61
PAD_DRILL_SHAPE
The set of pad drill shapes, used with PAD::{Set,Get}DrillShape()
Definition padstack.h:69
see class PGM_BASE
void Load(APP_SETTINGS_BASE *aConfig) override
BOARD_PRINTOUT_SETTINGS(const PAGE_INFO &aPageInfo)
void Save(APP_SETTINGS_BASE *aConfig) override
enum PCBNEW_PRINTOUT_SETTINGS::PAGINATION_T m_Pagination
bool m_PrintEdgeCutsOnAllPages
Print board outline on each page.
enum DRILL_MARKS m_DrillMarks
bool m_AsItemCheckboxes
Honor checkboxes in the Items tab of the Layers Manager.
void Load(APP_SETTINGS_BASE *aConfig) override
void Save(APP_SETTINGS_BASE *aConfig) override
PCBNEW_PRINTOUT_SETTINGS(const PAGE_INFO &aPageInfo)