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
47namespace KIFONT
48{
49class FONT;
50class METRICS;
51}
52
53
54// Define min and max reasonable values for plot/print scale
55#define PLOT_MIN_SCALE 0.01
56#define PLOT_MAX_SCALE 100.0
57
58
59
60// A helper class to plot board items
62{
63public:
64 BRDITEMS_PLOTTER( PLOTTER* aPlotter, BOARD* aBoard, const PCB_PLOT_PARAMS& aPlotOpts ) :
65 PCB_PLOT_PARAMS( aPlotOpts ),
66 m_plotter( aPlotter ),
67 m_board( aBoard )
68 { }
69
75 int getFineWidthAdj() const
76 {
77 if( GetFormat() == PLOT_FORMAT::POST )
78 return GetWidthAdjust();
79 else
80 return 0;
81 }
82
83 // Basic functions to plot a board item
84 void SetLayerSet( LSET aLayerMask ) { m_layerMask = aLayerMask; }
85 void PlotFootprintGraphicItems( const FOOTPRINT* aFootprint );
86 void PlotFootprintTextItems( const FOOTPRINT* aFootprint );
87
88 void PlotDimension( const PCB_DIMENSION_BASE* aDim );
89 void PlotPcbTarget( const PCB_TARGET* aMire );
90 void PlotZone( const ZONE* aZone, PCB_LAYER_ID aLayer, const SHAPE_POLY_SET& aPolysList );
91 void PlotText( const EDA_TEXT* aText, PCB_LAYER_ID aLayer, bool aIsKnockout,
92 const KIFONT::METRICS& aFontMetrics );
93 void PlotShape( const PCB_SHAPE* aShape );
94
101 void PlotPad( const PAD* aPad, const COLOR4D& aColor, OUTLINE_MODE aPlotMode );
102
106 void PlotBoardGraphicItem( const BOARD_ITEM* item );
107
114 void PlotDrillMarks();
115
124 COLOR4D getColor( int aLayer ) const;
125
126private:
132 void plotOneDrillMark( PAD_DRILL_SHAPE_T aDrillShape, const VECTOR2I& aDrillPos,
133 const VECTOR2I& aDrillSize, const VECTOR2I& aPadSize,
134 const EDA_ANGLE& aOrientation, int aSmallDrill );
135
139};
140
141
142PLOTTER* StartPlotBoard( BOARD* aBoard, const PCB_PLOT_PARAMS* aPlotOpts, int aLayer,
143 const wxString& aFullFileName, const wxString& aSheetName,
144 const wxString& aSheetPath );
145
154void PlotBoardLayers( BOARD* aBoard, PLOTTER* aPlotter, const LSEQ& aLayerSequence,
155 const PCB_PLOT_PARAMS& aPlotOptions );
156
160void PlotInteractiveLayer( BOARD* aBoard, PLOTTER* aPlotter, const PCB_PLOT_PARAMS& aPlotOpt );
161
172void PlotOneBoardLayer( BOARD* aBoard, PLOTTER* aPlotter, PCB_LAYER_ID aLayer,
173 const PCB_PLOT_PARAMS& aPlotOpt );
174
195void PlotStandardLayer( BOARD* aBoard, PLOTTER* aPlotter, LSET aLayerMask,
196 const PCB_PLOT_PARAMS& aPlotOpt );
197
206void PlotLayerOutlines( BOARD* aBoard, PLOTTER* aPlotter, LSET aLayerMask,
207 const PCB_PLOT_PARAMS& aPlotOpt );
208
221void BuildPlotFileName( wxFileName* aFilename, const wxString& aOutputDir, const wxString& aSuffix,
222 const wxString& aExtension );
223
224
228const wxString GetGerberProtelExtension( int aLayer );
229
240const wxString GetGerberFileFunctionAttribute( const BOARD* aBoard, int aLayer );
241
257void AddGerberX2Header( PLOTTER* aPlotter, const BOARD* aBoard,
258 bool aUseX1CompatibilityMode = false );
259
277void AddGerberX2Attribute( PLOTTER* aPlotter, const BOARD* aBoard, int aLayer,
278 bool aUseX1CompatibilityMode );
279
280#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:77
Information pertinent to a Pcbnew printed circuit board.
Definition: board.h:276
void PlotDrillMarks()
Draw a drill mark for pads and vias.
void PlotZone(const ZONE *aZone, PCB_LAYER_ID aLayer, const SHAPE_POLY_SET &aPolysList)
LSET m_layerMask
Definition: pcbplot.h:138
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:84
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:137
void PlotShape(const PCB_SHAPE *aShape)
PLOTTER * m_plotter
Definition: pcbplot.h:136
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:75
void PlotText(const EDA_TEXT *aText, PCB_LAYER_ID aLayer, bool aIsKnockout, const KIFONT::METRICS &aFontMetrics)
BRDITEMS_PLOTTER(PLOTTER *aPlotter, BOARD *aBoard, const PCB_PLOT_PARAMS &aPlotOpts)
Definition: pcbplot.h:64
void PlotFootprintGraphicItems(const FOOTPRINT *aFootprint)
A mix-in class (via multiple inheritance) that handles texts such as labels, parts,...
Definition: eda_text.h:80
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:556
Definition: pad.h:58
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:104
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:60
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