1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71
72
73
74
75
76
77
78
79
80
81
82
83
84
85
86
87
88
89
90
91
92
93
94
95
96
97
98
99
100
101
102
103
104
105
106
107
108
109
110
111
112
113
114
115
116
117
118
119
120
121
122
123
124
125
126
127
128
129
130
131
132
133
134
135
136
137
138
139
|
/*
* This program source code file is part of KiCad, a free EDA CAD application.
*
* Copyright (C) 2012 Lorenzo Marcantonio, <l.marcantonio@logossrl.com>
* Copyright (C) 2015 Jean-Pierre Charras, jp.charras at wanadoo.fr
* Copyright The KiCad Developers, see AUTHORS.txt for contributors.
*
* This program is free software; you can redistribute it and/or
* modify it under the terms of the GNU General Public License
* as published by the Free Software Foundation; either version 2
* of the License, or (at your option) any later version.
*
* This program is distributed in the hope that it will be useful,
* but WITHOUT ANY WARRANTY; without even the implied warranty of
* MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the
* GNU General Public License for more details.
*
* You should have received a copy of the GNU General Public License
* along with this program; if not, you may find one here:
* http://www.gnu.org/licenses/old-licenses/gpl-2.0.html
* or you may search the http://www.gnu.org website for the version 2 license,
* or you may write to the Free Software Foundation, Inc.,
* 51 Franklin Street, Fifth Floor, Boston, MA 02110-1301, USA
*/
/**
* @file pcbnew/pcbplot.h
*/
#ifndef PLOTCONTROLLER_H_
#define PLOTCONTROLLER_H_
#include <pcb_plot_params.h>
#include <layer_ids.h>
class PLOTTER;
class BOARD;
class LSEQ;
/**
* Batch plotter state object. Keeps the plot options and handles multiple
* plot requests. Useful in Python scripts.
*/
class PLOT_CONTROLLER
{
public:
/** Batch plotter constructor, nothing interesting here */
PLOT_CONTROLLER( BOARD *aBoard );
/**
* Ensure that the last plot is closed.
*/
~PLOT_CONTROLLER();
/**
* Accessor to the plot parameters and options
*/
PCB_PLOT_PARAMS& GetPlotOptions() { return m_plotOptions; }
void SetLayer( int aLayer ) { m_plotLayer = aLayer; }
int GetLayer() { return m_plotLayer; }
/**
* @return true if a plotter is initialized and can be used.
*/
bool IsPlotOpen() const { return m_plotter != nullptr; }
/**
* Close the current plot, nothing happens if it isn't open.
*/
void ClosePlot();
/** Open a new plotfile; works as a factory for plotter objects/
*
* @param aSuffix is a string added to the base filename (derived from
* the board filename) to identify the plot file.
* @param aFormat is the plot file format identifier.
* @param aSheetName is the text to be displayed in the title block that replaces ${SHEETNAME}
* @param aSheetPath is the text to be displayed in the title block that replaces ${SHEETPATH}
*/
bool OpenPlotfile( const wxString& aSuffix, PLOT_FORMAT aFormat,
const wxString& aSheetName = wxEmptyString,
const wxString& aSheetPath = wxEmptyString );
/**
* Plot a single layer on the current plotfile m_plotLayer is the layer to plot.
*/
bool PlotLayer();
/**
* Plot a sequence of board layer IDs in the given order.
*
* @param aLayerSequence is the sequence of layer IDs to plot.
*
* @return true if the layers plotted correctly othewise false.
*/
bool PlotLayers( const LSEQ& aLayerSequence );
/**
* @return the current plot full filename, set by OpenPlotfile
*/
const wxString GetPlotFileName() { return m_plotFile.GetFullPath(); }
/**
* @return the current plot full filename, set by OpenPlotfile
*/
const wxString GetPlotDirName() { return m_plotFile.GetPathWithSep(); }
/**
* Choose color or bland and white plot mode.
*
* @param aColorMode set to true to activate the plot color mode or false for black and white.
*/
void SetColorMode( bool aColorMode );
/**
* @return true if the current plot color mode is color or false if the current plot color
* mode is black and white.
*/
bool GetColorMode();
PLOTTER* GetPlotter() { return m_plotter; }
private:
int m_plotLayer;
PCB_PLOT_PARAMS m_plotOptions;
/// This is the plotter object; it starts NULL and become instantiated when a plotfile is
// requested
PLOTTER* m_plotter;
BOARD* m_board;
wxFileName m_plotFile;
};
#endif
|
