altium_pcb.h

Go to the documentation of this file.

/*
 * This program source code file is part of KiCad, a free EDA CAD application.
 *
 * Copyright (C) 2019-2020 Thomas Pointhuber <[email protected]>
 * Copyright (C) 2023 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 ALTIUM_PCB_H
#define ALTIUM_PCB_H
 
#include <functional>
#include <layer_ids.h>
#include <vector>
 
#include <altium_parser_pcb.h>
 
 
enum class ALTIUM_PCB_DIR
{
 FILE_HEADER,
 
 ADVANCEDPLACEROPTIONS6,
 ARCS6,
 BOARD6,
 BOARDREGIONS,
 CLASSES6,
 COMPONENTBODIES6,
 COMPONENTS6,
 CONNECTIONS6,
 COORDINATES6,
 DESIGNRULECHECKEROPTIONS6,
 DIFFERENTIALPAIRS6,
 DIMENSIONS6,
 EMBEDDEDBOARDS6,
 EMBEDDEDFONTS6,
 EMBEDDEDS6,
 EXTENDPRIMITIVEINFORMATION,
 FILEVERSIONINFO,
 FILLS6,
 FROMTOS6,
 MODELS,
 MODELSNOEMBED,
 NETS6,
 PADS6,
 PADVIALIBRARY,
 PADVIALIBRARYCACHE,
 PADVIALIBRARYLINKS,
 PINSWAPOPTIONS6,
 PINPAIRSSECTION,
 POLYGONS6,
 REGIONS6,
 RULES6,
 SHAPEBASEDCOMPONENTBODIES6,
 SHAPEBASEDREGIONS6,
 SIGNALCLASSES,
 SMARTUNIONS,
 TEXTS,
 TEXTS6,
 TEXTURES,
 TRACKS6,
 UNIONNAMES,
 UNIQUEIDPRIMITIVEINFORMATION,
 VIAS6,
 WIDESTRINGS6
};
 
 
class BOARD;
class FP_SHAPE;
class PCB_SHAPE;
class FOOTPRINT;
class ZONE;
class PCB_DIM_RADIAL;
class PROGRESS_REPORTER;
 
 
namespace CFB
{
struct COMPOUND_FILE_ENTRY;
} // namespace CFB
 
class ALTIUM_COMPOUND_FILE;
 
// type declaration required for a helper method
class ALTIUM_PCB;
typedef std::function<void( const ALTIUM_COMPOUND_FILE&, const CFB::COMPOUND_FILE_ENTRY* )>
 PARSE_FUNCTION_POINTER_fp;
 
class ALTIUM_PCB
{
public:
 explicit ALTIUM_PCB( BOARD* aBoard, PROGRESS_REPORTER* aProgressReporter,
 const wxString& aLibrary = wxEmptyString,
 const wxString& aFootprintName = wxEmptyString);
 ~ALTIUM_PCB();
 
 void Parse( const ALTIUM_COMPOUND_FILE& aAltiumPcbFile,
 const std::map<ALTIUM_PCB_DIR, std::string>& aFileMapping );
 
 FOOTPRINT* ParseFootprint( ALTIUM_COMPOUND_FILE& altiumLibFile,
 const wxString& aFootprintName );
 
private:
 void checkpoint();
 
 PCB_LAYER_ID GetKicadLayer( ALTIUM_LAYER aAltiumLayer ) const;
 std::vector<PCB_LAYER_ID> GetKicadLayersToIterate( ALTIUM_LAYER aAltiumLayer ) const;
 int GetNetCode( uint16_t aId ) const;
 const ARULE6* GetRule( ALTIUM_RULE_KIND aKind, const wxString& aName ) const;
 const ARULE6* GetRuleDefault( ALTIUM_RULE_KIND aKind ) const;
 
 void ParseFileHeader( const ALTIUM_COMPOUND_FILE& aAltiumPcbFile,
 const CFB::COMPOUND_FILE_ENTRY* aEntry );
 
 // Text Format
 void ParseBoard6Data( const ALTIUM_COMPOUND_FILE& aAltiumPcbFile,
 const CFB::COMPOUND_FILE_ENTRY* aEntry );
 void ParseClasses6Data( const ALTIUM_COMPOUND_FILE& aAltiumPcbFile,
 const CFB::COMPOUND_FILE_ENTRY* aEntry );
 void ParseComponents6Data( const ALTIUM_COMPOUND_FILE& aAltiumPcbFile,
 const CFB::COMPOUND_FILE_ENTRY* aEntry );
 void ParseDimensions6Data( const ALTIUM_COMPOUND_FILE& aAltiumPcbFile,
 const CFB::COMPOUND_FILE_ENTRY* aEntry );
 void ParseModelsData( const ALTIUM_COMPOUND_FILE& aAltiumPcbFile,
 const CFB::COMPOUND_FILE_ENTRY* aEntry,
 const std::vector<std::string>& aRootDir );
 void ParseNets6Data( const ALTIUM_COMPOUND_FILE& aAltiumPcbFile,
 const CFB::COMPOUND_FILE_ENTRY* aEntry );
 void ParsePolygons6Data( const ALTIUM_COMPOUND_FILE& aAltiumPcbFile,
 const CFB::COMPOUND_FILE_ENTRY* aEntry );
 void ParseRules6Data( const ALTIUM_COMPOUND_FILE& aAltiumPcbFile,
 const CFB::COMPOUND_FILE_ENTRY* aEntry );
 
 // Binary Format
 void ParseArcs6Data( const ALTIUM_COMPOUND_FILE& aAltiumPcbFile,
 const CFB::COMPOUND_FILE_ENTRY* aEntry );
 void ConvertArcs6ToPcbShape( const AARC6& aElem, PCB_SHAPE* aShape );
 void ConvertArcs6ToBoardItem( const AARC6& aElem, const int aPrimitiveIndex );
 void ConvertArcs6ToFootprintItem( FOOTPRINT* aFootprint, const AARC6& aElem,
 const int aPrimitiveIndex, const bool aIsBoardImport );
 void ConvertArcs6ToBoardItemOnLayer( const AARC6& aElem, PCB_LAYER_ID aLayer );
 void ConvertArcs6ToFootprintItemOnLayer( FOOTPRINT* aFootprint, const AARC6& aElem,
 PCB_LAYER_ID aLayer );
 void ParseComponentsBodies6Data( const ALTIUM_COMPOUND_FILE& aAltiumPcbFile,
 const CFB::COMPOUND_FILE_ENTRY* aEntry );
 void ParsePads6Data( const ALTIUM_COMPOUND_FILE& aAltiumPcbFile,
 const CFB::COMPOUND_FILE_ENTRY* aEntry );
 void ConvertPads6ToBoardItem( const APAD6& aElem );
 void ConvertPads6ToFootprintItem( FOOTPRINT* aFootprint, const APAD6& aElem );
 void ConvertPads6ToBoardItemOnNonCopper( const APAD6& aElem );
 void ConvertPads6ToFootprintItemOnCopper( FOOTPRINT* aFootprint, const APAD6& aElem );
 void ConvertPads6ToFootprintItemOnNonCopper( FOOTPRINT* aFootprint, const APAD6& aElem );
 void ParseVias6Data( const ALTIUM_COMPOUND_FILE& aAltiumPcbFile,
 const CFB::COMPOUND_FILE_ENTRY* aEntry );
 void ParseTracks6Data( const ALTIUM_COMPOUND_FILE& aAltiumPcbFile,
 const CFB::COMPOUND_FILE_ENTRY* aEntry );
 void ConvertTracks6ToBoardItem( const ATRACK6& aElem, const int aPrimitiveIndex );
 void ConvertTracks6ToFootprintItem( FOOTPRINT* aFootprint, const ATRACK6& aElem,
 const int aPrimitiveIndex, const bool aIsBoardImport );
 void ConvertTracks6ToBoardItemOnLayer( const ATRACK6& aElem, PCB_LAYER_ID aLayer );
 void ConvertTracks6ToFootprintItemOnLayer( FOOTPRINT* aFootprint, const ATRACK6& aElem,
 PCB_LAYER_ID aLayer );
 void ParseTexts6Data( const ALTIUM_COMPOUND_FILE& aAltiumPcbFile,
 const CFB::COMPOUND_FILE_ENTRY* aEntry );
 void ConvertTexts6ToBoardItem( const ATEXT6& aElem );
 void ConvertTexts6ToFootprintItem( FOOTPRINT* aFootprint, const ATEXT6& aElem );
 void ConvertTexts6ToBoardItemOnLayer( const ATEXT6& aElem, PCB_LAYER_ID aLayer );
 void ConvertTexts6ToFootprintItemOnLayer( FOOTPRINT* aFootprint, const ATEXT6& aElem,
 PCB_LAYER_ID aLayer );
 void ConvertTexts6ToEdaTextSettings( const ATEXT6& aElem, EDA_TEXT& aEdaText );
 void ParseFills6Data( const ALTIUM_COMPOUND_FILE& aAltiumPcbFile,
 const CFB::COMPOUND_FILE_ENTRY* aEntry );
 void ConvertFills6ToBoardItem( const AFILL6& aElem );
 void ConvertFills6ToFootprintItem( FOOTPRINT* aFootprint, const AFILL6& aElem,
 const bool aIsBoardImport );
 void ConvertFills6ToBoardItemOnLayer( const AFILL6& aElem, PCB_LAYER_ID aLayer );
 void ConvertFills6ToFootprintItemOnLayer( FOOTPRINT* aFootprint, const AFILL6& aElem,
 PCB_LAYER_ID aLayer );
 void ParseBoardRegionsData( const ALTIUM_COMPOUND_FILE& aAltiumPcbFile,
 const CFB::COMPOUND_FILE_ENTRY* aEntry );
 void ParseShapeBasedRegions6Data( const ALTIUM_COMPOUND_FILE& aAltiumPcbFile,
 const CFB::COMPOUND_FILE_ENTRY* aEntry );
 void ConvertShapeBasedRegions6ToBoardItem( const AREGION6& aElem );
 void ConvertShapeBasedRegions6ToFootprintItem( FOOTPRINT* aFootprint, const AREGION6& aElem,
 const int aPrimitiveIndex );
 void ConvertShapeBasedRegions6ToBoardItemOnLayer( const AREGION6& aElem, PCB_LAYER_ID aLayer );
 void ConvertShapeBasedRegions6ToFootprintItemOnLayer( FOOTPRINT* aFootprint,
 const AREGION6& aElem,
 PCB_LAYER_ID aLayer,
 const int aPrimitiveIndex );
 void ParseExtendedPrimitiveInformationData( const ALTIUM_COMPOUND_FILE& aAltiumPcbFile,
 const CFB::COMPOUND_FILE_ENTRY* aEntry );
 void ParseRegions6Data( const ALTIUM_COMPOUND_FILE& aAltiumPcbFile,
 const CFB::COMPOUND_FILE_ENTRY* aEntry );
 void ParseWideStrings6Data( const ALTIUM_COMPOUND_FILE& aAltiumPcbFile,
 const CFB::COMPOUND_FILE_ENTRY* aEntry );
 
 // Helper Functions
 void HelperParseDimensions6Linear( const ADIMENSION6& aElem );
 void HelperParseDimensions6Radial( const ADIMENSION6& aElem );
 void HelperParseDimensions6Leader( const ADIMENSION6& aElem );
 void HelperParseDimensions6Datum( const ADIMENSION6& aElem );
 void HelperParseDimensions6Center( const ADIMENSION6& aElem );
 
 void HelperParsePad6NonCopper( const APAD6& aElem, PCB_LAYER_ID aLayer, PCB_SHAPE* aShape );
 
 void HelperCreateBoardOutline( const std::vector<ALTIUM_VERTICE>& aVertices );
 
 void HelperSetZoneLayers( ZONE& aZone, const ALTIUM_LAYER aAltiumLayer );
 void HelperSetZoneKeepoutRestrictions( ZONE& aZone, const uint8_t aKeepoutRestrictions );
 void HelperPcpShapeAsBoardKeepoutRegion( const PCB_SHAPE& aShape,
 const ALTIUM_LAYER aAltiumLayer,
 const uint8_t aKeepoutRestrictions );
 void HelperPcpShapeAsFootprintKeepoutRegion( FOOTPRINT* aFootprint, const PCB_SHAPE& aShape,
 const ALTIUM_LAYER aAltiumLayer,
 const uint8_t aKeepoutRestrictions );
 
 std::vector<std::pair<PCB_LAYER_ID, int>>
 HelperGetSolderAndPasteMaskExpansions( const ALTIUM_RECORD aType, const int aPrimitiveIndex,
 const ALTIUM_LAYER aAltiumLayer );
 
 FOOTPRINT* HelperGetFootprint( uint16_t aComponent ) const;
 
 BOARD* m_board;
 std::vector<FOOTPRINT*> m_components;
 std::vector<ZONE*> m_polygons;
 std::vector<PCB_DIM_RADIAL*> m_radialDimensions;
 std::map<wxString, wxString> m_models;
 std::map<uint32_t, wxString> m_unicodeStrings;
 std::vector<int> m_altiumToKicadNetcodes;
 std::map<ALTIUM_LAYER, PCB_LAYER_ID> m_layermap; // used to correctly map copper layers
 std::map<ALTIUM_RULE_KIND, std::vector<ARULE6>> m_rules;
 std::map<ALTIUM_RECORD, std::multimap<int, const AEXTENDED_PRIMITIVE_INFORMATION>>
 m_extendedPrimitiveInformationMaps;
 
 std::map<ALTIUM_LAYER, ZONE*> m_outer_plane;
 
 PROGRESS_REPORTER* m_progressReporter; 
 unsigned m_doneCount;
 unsigned m_lastProgressCount;
 unsigned m_totalCount; 
 
 wxString m_library; 
 wxString m_footprintName; 
 
 int m_highest_pour_index;
};
 
 
#endif //ALTIUM_PCB_H