pcb_parser.h

Go to the documentation of this file.

/*
 * This program source code file is part of KiCad, a free EDA CAD application.
 *
 * Copyright (C) 2012 CERN
 * Copyright (C) 2012-2021 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
 */

#ifndef _PCBNEW_PARSER_H_
#define _PCBNEW_PARSER_H_

#include <convert_to_biu.h> // IU_PER_MM
#include <core/wx_stl_compat.h>
#include <hashtables.h>
#include <layer_ids.h> // PCB_LAYER_ID
#include <pcb_lexer.h>
#include <kiid.h>

#include <chrono>
#include <unordered_map>


class PCB_ARC;
class BOARD;
class BOARD_ITEM;
class BOARD_ITEM_CONTAINER;
class PAD;
class BOARD_DESIGN_SETTINGS;
class PCB_DIMENSION_BASE;
class PCB_SHAPE;
class EDA_TEXT;
class FP_SHAPE;
class FP_TEXT;
class PCB_TEXT;
class PCB_TRACK;
class FOOTPRINT;
class PCB_GROUP;
class PCB_TARGET;
class PCB_VIA;
class ZONE;
class FP_3DMODEL;
class SHAPE_LINE_CHAIN;
struct LAYER;
class PROGRESS_REPORTER;


class PCB_PARSER : public PCB_LEXER
{
public:
 PCB_PARSER( LINE_READER* aReader = nullptr ) :
 PCB_LEXER( aReader ),
 m_board( nullptr ),
 m_resetKIIDs( false ),
 m_progressReporter( nullptr ),
 m_lineReader( nullptr ),
 m_lastProgressTime( std::chrono::steady_clock::now() ),
 m_lineCount( 0 )
 {
 init();
 }

 // ~PCB_PARSER() {}

 LINE_READER* SetLineReader( LINE_READER* aReader )
 {
 LINE_READER* ret = PopReader();
 PushReader( aReader );
 return ret;
 }

 void SetBoard( BOARD* aBoard )
 {
 init();
 m_board = aBoard;

 if( aBoard != nullptr )
 m_resetKIIDs = true;
 }

 void SetProgressReporter( PROGRESS_REPORTER* aProgressReporter, const LINE_READER* aLineReader,
 unsigned aLineCount )
 {
 m_progressReporter = aProgressReporter;
 m_lineReader = aLineReader;
  m_lastProgressTime = std::chrono::steady_clock::now();
 m_lineCount = aLineCount;
 }

 BOARD_ITEM* Parse();

 FOOTPRINT* parseFOOTPRINT( wxArrayString* aInitialComments = nullptr );

 bool IsTooRecent()
 {
 return m_tooRecent;
 }

 wxString GetRequiredVersion();

private:
 inline int getNetCode( int aNetCode )
 {
 if( ( aNetCode >= 0 ) && ( aNetCode < (int) m_netCodes.size() ) )
 return m_netCodes[aNetCode];

 return aNetCode;
 }

 void pushValueIntoMap( int aIndex, int aValue );

 void init();

 void checkpoint();

 void createOldLayerMapping( std::unordered_map< std::string, std::string >& aMap );

 void skipCurrent();

 void parseHeader();
 void parseGeneralSection();
 void parsePAGE_INFO();
 void parseTITLE_BLOCK();

 void parseLayers();
 void parseLayer( LAYER* aLayer );

 void parseBoardStackup();

 void parseSetup();
 void parseDefaults( BOARD_DESIGN_SETTINGS& aSettings );
 void parseDefaultTextDims( BOARD_DESIGN_SETTINGS& aSettings, int aLayer );
 void parseNETINFO_ITEM();
 void parseNETCLASS();

 PCB_SHAPE* parsePCB_SHAPE();
 PCB_TEXT* parsePCB_TEXT();
 PCB_DIMENSION_BASE* parseDIMENSION();

 // Parse a footprint, but do not replace PARSE_ERROR with FUTURE_FORMAT_ERROR automatically.
 FOOTPRINT* parseFOOTPRINT_unchecked( wxArrayString* aInitialComments = nullptr );

 FP_TEXT* parseFP_TEXT();
 FP_SHAPE* parseFP_SHAPE();
 PAD* parsePAD( FOOTPRINT* aParent = nullptr );

 // Parse only the (option ...) inside a pad description
 bool parsePAD_option( PAD* aPad );

 PCB_ARC* parseARC();
 PCB_TRACK* parsePCB_TRACK();
 PCB_VIA* parsePCB_VIA();
 ZONE* parseZONE( BOARD_ITEM_CONTAINER* aParent );
 PCB_TARGET* parsePCB_TARGET();
 BOARD* parseBOARD();
 void parseGROUP( BOARD_ITEM* aParent );

 // Parse a board, but do not replace PARSE_ERROR with FUTURE_FORMAT_ERROR automatically.
 BOARD* parseBOARD_unchecked();

 template<class T, class M>
 T lookUpLayer( const M& aMap );

 PCB_LAYER_ID parseBoardItemLayer();

 LSET parseBoardItemLayersAsMask();

 wxPoint parseXY();

 void parseXY( int* aX, int* aY );

 std::pair<wxString, wxString> parseProperty();

 void parseOutlinePoints( SHAPE_LINE_CHAIN& aPoly );

 void parseEDA_TEXT( EDA_TEXT* aText );

 FP_3DMODEL* parse3DModel();

 double parseDouble();

 inline double parseDouble( const char* aExpected )
 {
 NeedNUMBER( aExpected );
 return parseDouble();
 }

 inline double parseDouble( PCB_KEYS_T::T aToken )
 {
 return parseDouble( GetTokenText( aToken ) );
 }

 double parseAngle() { return parseDouble() * 10.0; }

 inline double parseAngle( const char* aExpected )
 {
 return parseDouble( aExpected ) * 10.0;
 }

 int parseBoardUnits();

 int parseBoardUnits( const char* aExpected );

 inline int parseBoardUnits( PCB_KEYS_T::T aToken )
 {
 return parseBoardUnits( GetTokenText( aToken ) );
 }

 inline int parseInt()
 {
 return (int)strtol( CurText(), nullptr, 10 );
 }

 inline int parseInt( const char* aExpected )
 {
 NeedNUMBER( aExpected );
 return parseInt();
 }

 inline long parseHex()
 {
 NextTok();
 return strtol( CurText(), nullptr, 16 );
 }

 bool parseBool();

 /*
 * @return if m_resetKIIDs, returns new KIID(), otherwise returns CurStr() as KIID.
 */
 KIID CurStrToKIID();

 void resolveGroups( BOARD_ITEM* aParent );

 typedef std::unordered_map< std::string, PCB_LAYER_ID > LAYER_ID_MAP;
 typedef std::unordered_map< std::string, LSET > LSET_MAP;
 typedef std::unordered_map< wxString, KIID > KIID_MAP;

 using TIMEOUT = std::chrono::milliseconds;

 using CLOCK = std::chrono::steady_clock;

 using TIME_PT = std::chrono::time_point<CLOCK>;

 BOARD* m_board;
 LAYER_ID_MAP m_layerIndices; 
 LSET_MAP m_layerMasks; 
 std::set<wxString> m_undefinedLayers; 
 std::vector<int> m_netCodes; 
 bool m_tooRecent; 
 int m_requiredVersion; 
 bool m_resetKIIDs; 

 KIID_MAP m_resetKIIDMap;

 bool m_showLegacyZoneWarning;

 PROGRESS_REPORTER* m_progressReporter; 
 const LINE_READER* m_lineReader; 
 TIME_PT m_lastProgressTime; 
 unsigned m_lineCount; 

 // Group membership info refers to other Uuids in the file.
 // We don't want to rely on group declarations being last in the file, so
 // we store info about the group declarations here during parsing and then resolve
 // them into BOARD_ITEM* after we've parsed the rest of the file.
 struct GROUP_INFO
 {
 BOARD_ITEM* parent;
 wxString name;
 bool locked;
 KIID uuid;
 std::vector<KIID> memberUuids;
 };

 std::vector<GROUP_INFO> m_groupInfos;
};


#endif // _PCBNEW_PARSER_H_