KiCad PCB EDA Suite
Loading...
Searching...
No Matches
pcb_io_kicad_sexpr_parser.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) 2012 CERN
5 * Copyright The KiCad Developers, see AUTHORS.txt for contributors.
6 *
7 * This program is free software; you can redistribute it and/or
8 * modify it under the terms of the GNU General Public License
9 * as published by the Free Software Foundation; either version 2
10 * of the License, or (at your option) any later version.
11 *
12 * This program is distributed in the hope that it will be useful,
13 * but WITHOUT ANY WARRANTY; without even the implied warranty of
14 * MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the
15 * GNU General Public License for more details.
16 *
17 * You should have received a copy of the GNU General Public License
18 * along with this program; if not, you may find one here:
19 * http://www.gnu.org/licenses/old-licenses/gpl-2.0.html
20 * or you may search the http://www.gnu.org website for the version 2 license,
21 * or you may write to the Free Software Foundation, Inc.,
22 * 51 Franklin Street, Fifth Floor, Boston, MA 02110-1301, USA
23 */
24
29
30#ifndef _PCBNEW_PARSER_H_
31#define _PCBNEW_PARSER_H_
32
33#include <core/wx_stl_compat.h>
34#include <hashtables.h>
35#include <lib_id.h>
36#include <layer_ids.h> // PCB_LAYER_ID
37#include <lset.h>
38#include <pcb_lexer.h>
39#include <kiid.h>
40#include <math/box2.h>
41#include <string_any_map.h>
42
43#include <chrono>
44#include <unordered_map>
45
46
47class PCB_ARC;
48class BOARD;
49class BOARD_ITEM;
51class PAD;
54class PCB_SHAPE;
56class EDA_TEXT;
57class PCB_TEXT;
58class PCB_TRACK;
59class PCB_TABLE;
60class PCB_TABLECELL;
61class FOOTPRINT;
62class PCB_GROUP;
63class PCB_POINT;
64class PCB_TARGET;
65class PCB_VIA;
66class ZONE;
67class FP_3DMODEL;
69struct LAYER;
72
73
78class PCB_IO_KICAD_SEXPR_PARSER : public PCB_LEXER
79{
80public:
81
82 typedef std::unordered_map< std::string, PCB_LAYER_ID > LAYER_ID_MAP;
83 typedef std::unordered_map< std::string, LSET > LSET_MAP;
84 typedef std::unordered_map< wxString, KIID > KIID_MAP;
85
87 std::function<bool( wxString, int, wxString, wxString )> aQueryUserCallback,
88 PROGRESS_REPORTER* aProgressReporter = nullptr, unsigned aLineCount = 0 ) :
89 PCB_LEXER( aReader ),
90 m_board( aAppendToMe ),
91 m_appendToExisting( aAppendToMe != nullptr ),
92 m_progressReporter( aProgressReporter ),
93 m_lastProgressTime( std::chrono::steady_clock::now() ),
94 m_lineCount( aLineCount ),
95 m_queryUserCallback( std::move( aQueryUserCallback ) )
96 {
97 init();
98 }
99
100 // ~PCB_IO_KICAD_SEXPR_PARSER() {}
101
102 BOARD_ITEM* Parse();
103
110 FOOTPRINT* parseFOOTPRINT( wxArrayString* aInitialComments = nullptr );
111
116 {
117 return m_tooRecent;
118 }
119
124 wxString GetRequiredVersion();
125
130 bool IsValidBoardHeader();
131
132private:
133
134 // Group membership info refers to other Uuids in the file.
135 // We don't want to rely on group declarations being last in the file, so
136 // we store info about the group declarations here during parsing and then resolve
137 // them into BOARD_ITEM* after we've parsed the rest of the file.
139 {
140 virtual ~GROUP_INFO() = default; // Make polymorphic
141
143 wxString name;
144 bool locked;
147 std::vector<KIID> memberUuids;
148 };
149
156
159 inline int getNetCode( int aNetCode )
160 {
161 if( ( aNetCode >= 0 ) && ( aNetCode < (int) m_netCodes.size() ) )
162 return m_netCodes[aNetCode];
163
164 return aNetCode;
165 }
166
175 void pushValueIntoMap( int aIndex, int aValue );
176
183 void init();
184
185 void checkpoint();
186
194 void createOldLayerMapping( std::unordered_map< std::string, std::string >& aMap );
195
200 void skipCurrent();
201
202 void parseHeader();
203 void parseGeneralSection();
204 void parsePAGE_INFO();
205 void parseTITLE_BLOCK();
206
207 void parseLayers();
208 void parseLayer( LAYER* aLayer );
209
210 void parseBoardStackup();
211
212 void parseSetup();
213 void parseDefaults( BOARD_DESIGN_SETTINGS& aSettings );
214 void parseDefaultTextDims( BOARD_DESIGN_SETTINGS& aSettings, int aLayer );
215 void parseNETINFO_ITEM();
216 void parseNETCLASS();
217
219
220 void parseTextBoxContent( PCB_TEXTBOX* aTextBox );
221
223 PCB_TEXT* parsePCB_TEXT( BOARD_ITEM* aParent, PCB_TEXT* aBaseText = nullptr );
224 void parsePCB_TEXT_effects( PCB_TEXT* aText, PCB_TEXT* aBaseText = nullptr );
230
231 // Parse a footprint, but do not replace PARSE_ERROR with FUTURE_FORMAT_ERROR automatically.
232 FOOTPRINT* parseFOOTPRINT_unchecked( wxArrayString* aInitialComments = nullptr );
233 void parseFootprintStackup( FOOTPRINT& aFootprint );
234
235 PAD* parsePAD( FOOTPRINT* aParent = nullptr );
236
237 // Parse only the (option ...) inside a pad description
238 bool parsePAD_option( PAD* aPad );
239 void parsePadstack( PAD* aPad );
240
241 PCB_ARC* parseARC();
244 void parseViastack( PCB_VIA* aVia );
248 BOARD* parseBOARD();
249 void parseGROUP_members( GROUP_INFO& aGroupInfo );
250 void parseGROUP( BOARD_ITEM* aParent );
251 void parseGENERATOR( BOARD_ITEM* aParent );
252
253 // Parse a board, but do not replace PARSE_ERROR with FUTURE_FORMAT_ERROR automatically.
255
265 LSET lookUpLayerSet( const LSET_MAP& aMap );
266
275
284
294
306
307 void parseXY( int* aX, int* aY );
308
309 void parseMargins( int& aLeft, int& aTop, int& aRight, int& aBottom );
310
311 void parseZoneDefaults( ZONE_SETTINGS& aZoneSettings );
312
313 void parseZoneLayerProperty( std::map<PCB_LAYER_ID, ZONE_LAYER_PROPERTIES>& aProperties );
314
315 std::pair<wxString, wxString> parseBoardProperty();
316
325
332 void parseEDA_TEXT( EDA_TEXT* aText );
333
341
343
351
352 int parseBoardUnits();
353
354 int parseBoardUnits( const char* aExpected );
355
356 inline int parseBoardUnits( PCB_KEYS_T::T aToken )
357 {
358 return parseBoardUnits( GetTokenText( aToken ) );
359 }
360
361 inline int parseInt()
362 {
363 return (int)strtol( CurText(), nullptr, 10 );
364 }
365
366 inline int parseInt( const char* aExpected )
367 {
368 NeedNUMBER( aExpected );
369 return parseInt();
370 }
371
372 inline long parseHex()
373 {
374 NextTok();
375 return strtol( CurText(), nullptr, 16 );
376 }
377
378 bool parseBool();
379
380 std::optional<bool> parseOptBool();
381
392 bool parseMaybeAbsentBool( bool aDefaultValue );
393
394 std::pair<std::optional<bool>, std::optional<bool>>
395 parseFrontBackOptBool( bool aLegacy = false );
396
397 /*
398 * @return if m_appendToExisting, returns new KIID(), otherwise returns CurStr() as KIID.
399 */
401
406 void resolveGroups( BOARD_ITEM* aParent );
407
409 using TIMEOUT = std::chrono::milliseconds;
410
412 using CLOCK = std::chrono::steady_clock;
413
415 using TIME_PT = std::chrono::time_point<CLOCK>;
416
420 std::set<wxString> m_undefinedLayers;
421 std::vector<int> m_netCodes;
426
429
432
435 unsigned m_lineCount;
436
437 std::vector<GROUP_INFO> m_groupInfos;
438 std::vector<GENERATOR_INFO> m_generatorInfos;
439
440 std::function<bool( wxString aTitle, int aIcon, wxString aMsg, wxString aAction )> m_queryUserCallback;
441};
442
443
444#endif // _PCBNEW_PARSER_H_
Container for design settings for a BOARD object.
Abstract interface for BOARD_ITEMs capable of storing other items inside.
A base class for any item which can be embedded within the BOARD container class, and therefore insta...
Definition board_item.h:79
Information pertinent to a Pcbnew printed circuit board.
Definition board.h:317
A mix-in class (via multiple inheritance) that handles texts such as labels, parts,...
Definition eda_text.h:79
Definition kiid.h:49
A logical library item identifier and consists of various portions much like a URI.
Definition lib_id.h:49
An abstract class from which implementation specific LINE_READERs may be derived to read single lines...
Definition richio.h:93
LSET is a set of PCB_LAYER_IDs.
Definition lset.h:37
Definition pad.h:54
Abstract dimension API.
A set of BOARD_ITEMs (i.e., without duplicates).
Definition pcb_group.h:53
wxString m_generatorVersion
Set to the generator version this board requires.
PCB_TABLECELL * parsePCB_TABLECELL(BOARD_ITEM *aParent)
std::unordered_map< std::string, PCB_LAYER_ID > LAYER_ID_MAP
std::vector< int > m_netCodes
net codes mapping for boards being loaded
void parseOutlinePoints(SHAPE_LINE_CHAIN &aPoly)
Parses possible outline points and stores them into aPoly.
std::set< wxString > m_undefinedLayers
set of layers not defined in layers section
void parseZoneLayerProperty(std::map< PCB_LAYER_ID, ZONE_LAYER_PROPERTIES > &aProperties)
PROGRESS_REPORTER * m_progressReporter
optional; may be nullptr
void parseFootprintStackup(FOOTPRINT &aFootprint)
void createOldLayerMapping(std::unordered_map< std::string, std::string > &aMap)
Create a mapping from the (short-lived) bug where layer names were translated.
void parseZoneDefaults(ZONE_SETTINGS &aZoneSettings)
std::unordered_map< std::string, LSET > LSET_MAP
void parseEDA_TEXT(EDA_TEXT *aText)
Parse the common settings for any object derived from EDA_TEXT.
int parseInt(const char *aExpected)
bool m_tooRecent
true if version parses as later than supported
PCB_LAYER_ID lookUpLayer(const LAYER_ID_MAP &aMap)
Parse the current token for the layer definition of a BOARD_ITEM object.
PCB_REFERENCE_IMAGE * parsePCB_REFERENCE_IMAGE(BOARD_ITEM *aParent)
LAYER_ID_MAP m_layerIndices
map layer name to it's index
void parseTextBoxContent(PCB_TEXTBOX *aTextBox)
FOOTPRINT * parseFOOTPRINT(wxArrayString *aInitialComments=nullptr)
void pushValueIntoMap(int aIndex, int aValue)
Add aValue value in netcode mapping (m_netCodes) at aIndex.
std::chrono::steady_clock CLOCK
The type of the time stamps.
void init()
Clear and re-establish m_layerMap with the default layer names.
void skipCurrent()
Skip the current token level, i.e search for the RIGHT parenthesis which closes the current descripti...
void parseMargins(int &aLeft, int &aTop, int &aRight, int &aBottom)
PCB_LAYER_ID parseBoardItemLayer()
Parse the layer definition of a BOARD_ITEM object.
LSET parseLayersForCuItemWithSoldermask()
Parse the layers definition of a BOARD_ITEM object that has a single copper layer and optional solder...
void parseGENERATOR(BOARD_ITEM *aParent)
std::chrono::milliseconds TIMEOUT
The clock used for the timestamp (guaranteed to be monotonic).
LSET parseBoardItemLayersAsMask()
Parse the layers definition of a BOARD_ITEM object.
std::pair< std::optional< bool >, std::optional< bool > > parseFrontBackOptBool(bool aLegacy=false)
void resolveGroups(BOARD_ITEM *aParent)
Called after parsing a footprint definition or board to build the group membership lists.
void parseDefaultTextDims(BOARD_DESIGN_SETTINGS &aSettings, int aLayer)
std::vector< GROUP_INFO > m_groupInfos
ZONE * parseZONE(BOARD_ITEM_CONTAINER *aParent)
PCB_TABLE * parsePCB_TABLE(BOARD_ITEM *aParent)
std::vector< GENERATOR_INFO > m_generatorInfos
int parseBoardUnits(PCB_KEYS_T::T aToken)
PCB_TEXTBOX * parsePCB_TEXTBOX(BOARD_ITEM *aParent)
std::chrono::time_point< CLOCK > TIME_PT
PCB_TEXT * parsePCB_TEXT(BOARD_ITEM *aParent, PCB_TEXT *aBaseText=nullptr)
unsigned m_lineCount
for progress reporting
VECTOR2I parseXY()
Parse a coordinate pair (xy X Y) in board units (mm).
void parseTEARDROP_PARAMETERS(TEARDROP_PARAMETERS *tdParams)
int m_requiredVersion
set to the KiCad format version this board requires
PAD * parsePAD(FOOTPRINT *aParent=nullptr)
std::function< bool(wxString aTitle, int aIcon, wxString aMsg, wxString aAction)> m_queryUserCallback
FOOTPRINT * parseFOOTPRINT_unchecked(wxArrayString *aInitialComments=nullptr)
void parseRenderCache(EDA_TEXT *text)
Parse the render cache for any object derived from EDA_TEXT.
TIME_PT m_lastProgressTime
for progress reporting
void parseGROUP_members(GROUP_INFO &aGroupInfo)
bool IsTooRecent()
Return whether a version number, if any was parsed, was too recent.
bool IsValidBoardHeader()
Partially parse the input and check if it matches expected header.
std::pair< wxString, wxString > parseBoardProperty()
LSET_MAP m_layerMasks
map layer names to their masks
bool parseMaybeAbsentBool(bool aDefaultValue)
Parses a boolean flag inside a list that existed before boolean normalization.
int parseBoardUnits()
Parse the current token as an ASCII numeric string with possible leading whitespace into a double pre...
std::unordered_map< wxString, KIID > KIID_MAP
PCB_DIMENSION_BASE * parseDIMENSION(BOARD_ITEM *aParent)
LSET lookUpLayerSet(const LSET_MAP &aMap)
PCB_IO_KICAD_SEXPR_PARSER(LINE_READER *aReader, BOARD *aAppendToMe, std::function< bool(wxString, int, wxString, wxString)> aQueryUserCallback, PROGRESS_REPORTER *aProgressReporter=nullptr, unsigned aLineCount=0)
bool m_appendToExisting
reading into an existing board; reset UUIDs
void parsePCB_TEXT_effects(PCB_TEXT *aText, PCB_TEXT *aBaseText=nullptr)
PCB_SHAPE * parsePCB_SHAPE(BOARD_ITEM *aParent)
void parseDefaults(BOARD_DESIGN_SETTINGS &aSettings)
wxString GetRequiredVersion()
Return a string representing the version of KiCad required to open this file.
A PCB_POINT is a 0-dimensional point that is used to mark a position on a PCB, or more usually a foot...
Definition pcb_point.h:43
Object to handle a bitmap image that can be inserted in a PCB.
A progress reporter interface for use in multi-threaded environments.
Represent a polyline containing arcs as well as line segments: A chain of connected line and/or arc s...
A name/value tuple with unique names and wxAny values.
TEARDROP_PARAMETARS is a helper class to handle parameters needed to build teardrops for a board thes...
ZONE_SETTINGS handles zones parameters.
Handle a list of polygons defining a copper zone.
Definition zone.h:74
#define LAYER(n, l)
PCB_LAYER_ID
A quick note on layer IDs:
Definition layer_ids.h:60
STL namespace.
Convert net code using the mapping table if available, otherwise returns unchanged net code if < 0 or...
VECTOR2< int32_t > VECTOR2I
Definition vector2d.h:695