KiCad PCB EDA Suite
Loading...
Searching...
No Matches
pcbplot.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) 1992-2023 KiCad Developers, see AUTHORS.txt for contributors.
5 *
6 * This program is free software; you can redistribute it and/or
7 * modify it under the terms of the GNU General Public License
8 * as published by the Free Software Foundation; either version 2
9 * of the License, or (at your option) any later version.
10 *
11 * This program is distributed in the hope that it will be useful,
12 * but WITHOUT ANY WARRANTY; without even the implied warranty of
13 * MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the
14 * GNU General Public License for more details.
15 *
16 * You should have received a copy of the GNU General Public License
17 * along with this program; if not, you may find one here:
18 * http://www.gnu.org/licenses/old-licenses/gpl-2.0.html
19 * or you may search the http://www.gnu.org website for the version 2 license,
20 * or you may write to the Free Software Foundation, Inc.,
21 * 51 Franklin Street, Fifth Floor, Boston, MA 02110-1301, USA
22 */
23
24#ifndef PCBPLOT_H_
25#define PCBPLOT_H_
26
27#include <pad_shapes.h> // for PAD_DRILL_SHAPE_T
28#include <pcb_plot_params.h>
31#include <board.h>
33#include <board_item.h>
34
35class EDA_TEXT;
36class PLOTTER;
37class PCB_TEXT;
38class PAD;
39class PCB_SHAPE;
41class FOOTPRINT;
42class PCB_TARGET;
43class ZONE;
44class REPORTER;
45class wxFileName;
46
47
48// Define min and max reasonable values for plot/print scale
49#define PLOT_MIN_SCALE 0.01
50#define PLOT_MAX_SCALE 100.0
51
52
53
54// A helper class to plot board items
56{
57public:
58 BRDITEMS_PLOTTER( PLOTTER* aPlotter, BOARD* aBoard, const PCB_PLOT_PARAMS& aPlotOpts ) :
59 PCB_PLOT_PARAMS( aPlotOpts ),
60 m_plotter( aPlotter ),
61 m_board( aBoard )
62 { }
63
69 int getFineWidthAdj() const
70 {
71 if( GetFormat() == PLOT_FORMAT::POST )
72 return GetWidthAdjust();
73 else
74 return 0;
75 }
76
77 // Basic functions to plot a board item
78 void SetLayerSet( LSET aLayerMask ) { m_layerMask = aLayerMask; }
79 void PlotFootprintGraphicItems( const FOOTPRINT* aFootprint );
80 void PlotFootprintTextItems( const FOOTPRINT* aFootprint );
81
82 void PlotDimension( const PCB_DIMENSION_BASE* aDim );
83 void PlotPcbTarget( const PCB_TARGET* aMire );
84 void PlotZones( const ZONE* aZone, PCB_LAYER_ID aLayer, const SHAPE_POLY_SET& aPolysList );
85 void PlotText( const EDA_TEXT* aText, PCB_LAYER_ID aLayer, bool aIsKnockout );
86 void PlotShape( const PCB_SHAPE* aShape );
87
94 void PlotPad( const PAD* aPad, const COLOR4D& aColor, OUTLINE_MODE aPlotMode );
95
99 void PlotBoardGraphicItem( const BOARD_ITEM* item );
100
107 void PlotDrillMarks();
108
117 COLOR4D getColor( int aLayer ) const;
118
119private:
125 void plotOneDrillMark( PAD_DRILL_SHAPE_T aDrillShape, const VECTOR2I& aDrillPos,
126 const VECTOR2I& aDrillSize, const VECTOR2I& aPadSize,
127 const EDA_ANGLE& aOrientation, int aSmallDrill );
128
132};
133
134
135PLOTTER* StartPlotBoard( BOARD* aBoard, const PCB_PLOT_PARAMS* aPlotOpts, int aLayer,
136 const wxString& aFullFileName, const wxString& aSheetName,
137 const wxString& aSheetPath );
138
147void PlotBoardLayers( BOARD* aBoard, PLOTTER* aPlotter, const LSEQ& aLayerSequence,
148 const PCB_PLOT_PARAMS& aPlotOptions );
149
153void PlotInteractiveLayer( BOARD* aBoard, PLOTTER* aPlotter, const PCB_PLOT_PARAMS& aPlotOpt );
154
165void PlotOneBoardLayer( BOARD* aBoard, PLOTTER* aPlotter, PCB_LAYER_ID aLayer,
166 const PCB_PLOT_PARAMS& aPlotOpt );
167
188void PlotStandardLayer( BOARD* aBoard, PLOTTER* aPlotter, LSET aLayerMask,
189 const PCB_PLOT_PARAMS& aPlotOpt );
190
199void PlotLayerOutlines( BOARD* aBoard, PLOTTER* aPlotter, LSET aLayerMask,
200 const PCB_PLOT_PARAMS& aPlotOpt );
201
214void BuildPlotFileName( wxFileName* aFilename, const wxString& aOutputDir, const wxString& aSuffix,
215 const wxString& aExtension );
216
217
221const wxString GetGerberProtelExtension( int aLayer );
222
233const wxString GetGerberFileFunctionAttribute( const BOARD* aBoard, int aLayer );
234
250void AddGerberX2Header( PLOTTER* aPlotter, const BOARD* aBoard,
251 bool aUseX1CompatibilityMode = false );
252
270void AddGerberX2Attribute( PLOTTER* aPlotter, const BOARD* aBoard, int aLayer,
271 bool aUseX1CompatibilityMode );
272
273#endif // PCBPLOT_H_
A base class for any item which can be embedded within the BOARD container class, and therefore insta...
Definition: board_item.h:71
Information pertinent to a Pcbnew printed circuit board.
Definition: board.h:270
void PlotDrillMarks()
Draw a drill mark for pads and vias.
void PlotZones(const ZONE *aZone, PCB_LAYER_ID aLayer, const SHAPE_POLY_SET &aPolysList)
LSET m_layerMask
Definition: pcbplot.h:131
void PlotText(const EDA_TEXT *aText, PCB_LAYER_ID aLayer, bool aIsKnockout)
void PlotBoardGraphicItem(const BOARD_ITEM *item)
Plot items like text and graphics but not tracks and footprints.
void plotOneDrillMark(PAD_DRILL_SHAPE_T aDrillShape, const VECTOR2I &aDrillPos, const VECTOR2I &aDrillSize, const VECTOR2I &aPadSize, const EDA_ANGLE &aOrientation, int aSmallDrill)
Helper function to plot a single drill mark.
void SetLayerSet(LSET aLayerMask)
Definition: pcbplot.h:78
void PlotDimension(const PCB_DIMENSION_BASE *aDim)
void PlotPad(const PAD *aPad, const COLOR4D &aColor, OUTLINE_MODE aPlotMode)
Plot a pad.
BOARD * m_board
Definition: pcbplot.h:130
void PlotShape(const PCB_SHAPE *aShape)
PLOTTER * m_plotter
Definition: pcbplot.h:129
COLOR4D getColor(int aLayer) const
White color is special because it cannot be seen on a white paper in B&W mode.
void PlotPcbTarget(const PCB_TARGET *aMire)
void PlotFootprintTextItems(const FOOTPRINT *aFootprint)
int getFineWidthAdj() const
Definition: pcbplot.h:69
BRDITEMS_PLOTTER(PLOTTER *aPlotter, BOARD *aBoard, const PCB_PLOT_PARAMS &aPlotOpts)
Definition: pcbplot.h:58
void PlotFootprintGraphicItems(const FOOTPRINT *aFootprint)
A mix-in class (via multiple inheritance) that handles texts such as labels, parts,...
Definition: eda_text.h:77
A color representation with 4 components: red, green, blue, alpha.
Definition: color4d.h:103
LSEQ is a sequence (and therefore also a set) of PCB_LAYER_IDs.
Definition: layer_ids.h:497
LSET is a set of PCB_LAYER_IDs.
Definition: layer_ids.h:536
Definition: pad.h:59
Abstract dimension API.
Parameters and options when plotting/printing a board.
PLOT_FORMAT GetFormat() const
int GetWidthAdjust() const
Base plotter engine class.
Definition: plotter.h:110
A pure virtual class used to derive REPORTER objects from.
Definition: reporter.h:71
Represent a set of closed polygons.
Handle a list of polygons defining a copper zone.
Definition: zone.h:72
PCB_LAYER_ID
A quick note on layer IDs:
Definition: layer_ids.h:59
OUTLINE_MODE
Definition: outline_mode.h:25
PAD_DRILL_SHAPE_T
The set of pad drill shapes, used with PAD::{Set,Get}DrillShape()
Definition: pad_shapes.h:69
void PlotStandardLayer(BOARD *aBoard, PLOTTER *aPlotter, LSET aLayerMask, const PCB_PLOT_PARAMS &aPlotOpt)
Plot copper or technical layers.
void PlotOneBoardLayer(BOARD *aBoard, PLOTTER *aPlotter, PCB_LAYER_ID aLayer, const PCB_PLOT_PARAMS &aPlotOpt)
Plot one copper or technical layer.
const wxString GetGerberProtelExtension(int aLayer)
Definition: pcbplot.cpp:42
void PlotLayerOutlines(BOARD *aBoard, PLOTTER *aPlotter, LSET aLayerMask, const PCB_PLOT_PARAMS &aPlotOpt)
Plot copper outline of a copper layer.
PLOTTER * StartPlotBoard(BOARD *aBoard, const PCB_PLOT_PARAMS *aPlotOpts, int aLayer, const wxString &aFullFileName, const wxString &aSheetName, const wxString &aSheetPath)
Open a new plotfile using the options (and especially the format) specified in the options and prepar...
void AddGerberX2Header(PLOTTER *aPlotter, const BOARD *aBoard, bool aUseX1CompatibilityMode=false)
Calculate some X2 attributes as defined in the Gerber file format specification J4 (chapter 5) and ad...
Definition: pcbplot.cpp:276
const wxString GetGerberFileFunctionAttribute(const BOARD *aBoard, int aLayer)
Return the "file function" attribute for aLayer, as defined in the Gerber file format specification J...
Definition: pcbplot.cpp:81
void PlotBoardLayers(BOARD *aBoard, PLOTTER *aPlotter, const LSEQ &aLayerSequence, const PCB_PLOT_PARAMS &aPlotOptions)
Plot a sequence of board layer IDs.
void PlotInteractiveLayer(BOARD *aBoard, PLOTTER *aPlotter, const PCB_PLOT_PARAMS &aPlotOpt)
Plot interactive items (hypertext links, properties, etc.).
void AddGerberX2Attribute(PLOTTER *aPlotter, const BOARD *aBoard, int aLayer, bool aUseX1CompatibilityMode)
Calculate some X2 attributes as defined in the Gerber file format specification and add them to the g...
Definition: pcbplot.cpp:342
void BuildPlotFileName(wxFileName *aFilename, const wxString &aOutputDir, const wxString &aSuffix, const wxString &aExtension)
Complete a plot filename.
Definition: pcbplot.cpp:361