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 (C) 2012-2024 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
30#ifndef _PCBNEW_PARSER_H_
31#define _PCBNEW_PARSER_H_
32
33#include <core/wx_stl_compat.h>
34#include <hashtables.h>
35#include <layer_ids.h> // PCB_LAYER_ID
36#include <lset.h>
37#include <pcb_lexer.h>
38#include <kiid.h>
39#include <math/box2.h>
40#include <string_any_map.h>
41
42#include <chrono>
43#include <unordered_map>
44
45
46class PCB_ARC;
47class BOARD;
48class BOARD_ITEM;
50class PAD;
53class PCB_SHAPE;
55class EDA_TEXT;
56class PCB_TEXT;
57class PCB_TRACK;
58class PCB_TABLE;
59class PCB_TABLECELL;
60class FOOTPRINT;
61class PCB_GROUP;
62class PCB_TARGET;
63class PCB_VIA;
64class ZONE;
65class FP_3DMODEL;
67struct LAYER;
70
71
76class PCB_IO_KICAD_SEXPR_PARSER : public PCB_LEXER
77{
78public:
79
80 typedef std::unordered_map< std::string, PCB_LAYER_ID > LAYER_ID_MAP;
81 typedef std::unordered_map< std::string, LSET > LSET_MAP;
82 typedef std::unordered_map< wxString, KIID > KIID_MAP;
83
85 std::function<bool( wxString, int, wxString, wxString )> aQueryUserCallback,
86 PROGRESS_REPORTER* aProgressReporter = nullptr, unsigned aLineCount = 0 ) :
87 PCB_LEXER( aReader ),
88 m_board( aAppendToMe ),
89 m_appendToExisting( aAppendToMe != nullptr ),
90 m_progressReporter( aProgressReporter ),
91 m_lastProgressTime( std::chrono::steady_clock::now() ),
92 m_lineCount( aLineCount ),
93 m_queryUserCallback( std::move( aQueryUserCallback ) )
94 {
95 init();
96 }
97
98 // ~PCB_IO_KICAD_SEXPR_PARSER() {}
99
100 BOARD_ITEM* Parse();
101
108 FOOTPRINT* parseFOOTPRINT( wxArrayString* aInitialComments = nullptr );
109
114 {
115 return m_tooRecent;
116 }
117
122 wxString GetRequiredVersion();
123
128 bool IsValidBoardHeader();
129
130private:
131
132 // Group membership info refers to other Uuids in the file.
133 // We don't want to rely on group declarations being last in the file, so
134 // we store info about the group declarations here during parsing and then resolve
135 // them into BOARD_ITEM* after we've parsed the rest of the file.
137 {
138 virtual ~GROUP_INFO() = default; // Make polymorphic
139
141 wxString name;
142 bool locked;
144 std::vector<KIID> memberUuids;
145 };
146
148 {
150 wxString genType;
152 };
153
156 inline int getNetCode( int aNetCode )
157 {
158 if( ( aNetCode >= 0 ) && ( aNetCode < (int) m_netCodes.size() ) )
159 return m_netCodes[aNetCode];
160
161 return aNetCode;
162 }
163
172 void pushValueIntoMap( int aIndex, int aValue );
173
180 void init();
181
182 void checkpoint();
183
191 void createOldLayerMapping( std::unordered_map< std::string, std::string >& aMap );
192
197 void skipCurrent();
198
199 void parseHeader();
200 void parseGeneralSection();
201 void parsePAGE_INFO();
202 void parseTITLE_BLOCK();
203
204 void parseLayers();
205 void parseLayer( LAYER* aLayer );
206
207 void parseBoardStackup();
208
209 void parseSetup();
210 void parseDefaults( BOARD_DESIGN_SETTINGS& aSettings );
211 void parseDefaultTextDims( BOARD_DESIGN_SETTINGS& aSettings, int aLayer );
212 void parseNETINFO_ITEM();
213 void parseNETCLASS();
214
216
217 void parseTextBoxContent( PCB_TEXTBOX* aTextBox );
218
220 PCB_TEXT* parsePCB_TEXT( BOARD_ITEM* aParent, PCB_TEXT* aBaseText = nullptr );
221 void parsePCB_TEXT_effects( PCB_TEXT* aText, PCB_TEXT* aBaseText = nullptr );
227
228 // Parse a footprint, but do not replace PARSE_ERROR with FUTURE_FORMAT_ERROR automatically.
229 FOOTPRINT* parseFOOTPRINT_unchecked( wxArrayString* aInitialComments = nullptr );
230
231 PAD* parsePAD( FOOTPRINT* aParent = nullptr );
232
233 // Parse only the (option ...) inside a pad description
234 bool parsePAD_option( PAD* aPad );
235 void parsePadstack( PAD* aPad );
236
237 PCB_ARC* parseARC();
240 void parseViastack( PCB_VIA* aVia );
243 BOARD* parseBOARD();
244 void parseGROUP_members( GROUP_INFO& aGroupInfo );
245 void parseGROUP( BOARD_ITEM* aParent );
246 void parseGENERATOR( BOARD_ITEM* aParent );
247
248 // Parse a board, but do not replace PARSE_ERROR with FUTURE_FORMAT_ERROR automatically.
250
260 LSET lookUpLayerSet( const LSET_MAP& aMap );
261
270
279
289
301
302 void parseXY( int* aX, int* aY );
303
304 void parseMargins( int& aLeft, int& aTop, int& aRight, int& aBottom );
305
306 std::pair<wxString, wxString> parseBoardProperty();
307
316
323 void parseEDA_TEXT( EDA_TEXT* aText );
324
332
333 void parseTenting( PADSTACK& aPadstack );
334
336
345 int parseBoardUnits();
346
347 int parseBoardUnits( const char* aExpected );
348
349 inline int parseBoardUnits( PCB_KEYS_T::T aToken )
350 {
351 return parseBoardUnits( GetTokenText( aToken ) );
352 }
353
354 inline int parseInt()
355 {
356 return (int)strtol( CurText(), nullptr, 10 );
357 }
358
359 inline int parseInt( const char* aExpected )
360 {
361 NeedNUMBER( aExpected );
362 return parseInt();
363 }
364
365 inline long parseHex()
366 {
367 NextTok();
368 return strtol( CurText(), nullptr, 16 );
369 }
370
371 bool parseBool();
372
383 bool parseMaybeAbsentBool( bool aDefaultValue );
384
385 /*
386 * @return if m_appendToExisting, returns new KIID(), otherwise returns CurStr() as KIID.
387 */
389
394 void resolveGroups( BOARD_ITEM* aParent );
395
397 using TIMEOUT = std::chrono::milliseconds;
398
400 using CLOCK = std::chrono::steady_clock;
401
403 using TIME_PT = std::chrono::time_point<CLOCK>;
404
408 std::set<wxString> m_undefinedLayers;
409 std::vector<int> m_netCodes;
414
417
420
423 unsigned m_lineCount;
424
425 std::map<EDA_TEXT*, std::tuple<wxString, bool, bool>> m_fontTextMap;
426
427 std::vector<GROUP_INFO> m_groupInfos;
428 std::vector<GENERATOR_INFO> m_generatorInfos;
429
430 std::function<bool( wxString aTitle, int aIcon, wxString aMsg, wxString aAction )> m_queryUserCallback;
431};
432
433
434#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:80
Information pertinent to a Pcbnew printed circuit board.
Definition: board.h:290
A mix-in class (via multiple inheritance) that handles texts such as labels, parts,...
Definition: eda_text.h:79
Definition: kiid.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:36
A PADSTACK defines the characteristics of a single or multi-layer pad, in the IPC sense of the word.
Definition: padstack.h:118
Definition: pad.h:54
Abstract dimension API.
A set of BOARD_ITEMs (i.e., without duplicates).
Definition: pcb_group.h:52
Read a Pcbnew s-expression formatted LINE_READER object and returns the appropriate BOARD_ITEM object...
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
PROGRESS_REPORTER * m_progressReporter
optional; may be nullptr
void createOldLayerMapping(std::unordered_map< std::string, std::string > &aMap)
Create a mapping from the (short-lived) bug where layer names were translated.
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 parseGROUP(BOARD_ITEM *aParent)
std::map< EDA_TEXT *, std::tuple< wxString, bool, bool > > m_fontTextMap
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.
void parseTenting(PADSTACK &aPadstack)
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.
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...
Handle a list of polygons defining a copper zone.
Definition: zone.h:73
PCB_LAYER_ID
A quick note on layer IDs:
Definition: layer_ids.h:60
STL namespace.
Container to hold information pertinent to a layer of a BOARD.
Definition: board.h:169
Convert net code using the mapping table if available, otherwise returns unchanged net code if < 0 or...