altium_parser_sch.h

Go to the documentation of this file.

/*
 * This program source code file is part of KiCad, a free EDA CAD application.
 *
 * Copyright (C) 2020 Thomas Pointhuber <[email protected]>
 * Copyright (C) 2021-2022 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_PARSER_SCH_H
#define ALTIUM_PARSER_SCH_H
 
#include <cstdint>
#include <cstring>
#include <map>
#include <vector>
 
#include <math/vector2d.h>
 
#include <wx/gdicmn.h>
#include <wx/string.h>
 
// this constant specifies a item which is not inside an component
const int ALTIUM_COMPONENT_NONE = -1;
 
class ALTIUM_PARSER;
 
struct ASCH_STORAGE_FILE
{
 wxString filename;
 std::vector<char> data;
 
 explicit ASCH_STORAGE_FILE( ALTIUM_PARSER& aReader );
};
 
struct ASCH_ADDITIONAL_FILE
{
 wxString FileName;
 std::vector<char> Data;
 
 explicit ASCH_ADDITIONAL_FILE( ALTIUM_PARSER& aReader );
};
 
enum class ALTIUM_SCH_RECORD
{
 HEADER = 0,
 COMPONENT = 1,
 PIN = 2,
 IEEE_SYMBOL = 3,
 LABEL = 4,
 BEZIER = 5,
 POLYLINE = 6,
 POLYGON = 7,
 ELLIPSE = 8,
 PIECHART = 9,
 ROUND_RECTANGLE = 10,
 ELLIPTICAL_ARC = 11,
 ARC = 12,
 LINE = 13,
 RECTANGLE = 14,
 SHEET_SYMBOL = 15,
 SHEET_ENTRY = 16,
 POWER_PORT = 17,
 PORT = 18,
 NO_ERC = 22,
 NET_LABEL = 25,
 BUS = 26,
 WIRE = 27,
 TEXT_FRAME = 28,
 JUNCTION = 29,
 IMAGE = 30,
 SHEET = 31,
 SHEET_NAME = 32,
 FILE_NAME = 33,
 DESIGNATOR = 34,
 BUS_ENTRY = 37,
 TEMPLATE = 39,
 PARAMETER = 41,
 WARNING_SIGN = 43,
 IMPLEMENTATION_LIST = 44,
 IMPLEMENTATION = 45,
 RECORD_46 = 46,
 RECORD_47 = 47,
 RECORD_48 = 48,
 NOTE = 209,
 COMPILE_MASK = 211,
 HARNESS_CONNECTOR = 215,
 HARNESS_ENTRY = 216,
 HARNESS_TYPE = 217,
 SIGNAL_HARNESS = 218,
 RECORD_226 = 226,
};
 
 
enum class ASCH_RECORD_ORIENTATION
{
 RIGHTWARDS = 0, // 0
 UPWARDS = 1, // 90
 LEFTWARDS = 2, // 180
 DOWNWARDS = 3 // 270
};
 
 
struct ASCH_SHAPE_INTERFACE
{
 int OwnerIndex;
 int OwnerPartID;
 int OwnerPartDisplayMode;
 
 int LineWidth;
 bool IsSolid;
 
 int Color;
 int AreaColor;
};
 
 
struct ASCH_SYMBOL
{
 int currentpartid;
 int m_indexInSheet;
 wxString libreference;
 wxString sourcelibraryname;
 wxString componentdescription;
 
 int orientation;
 bool isMirrored;
 VECTOR2I location;
 
 int partcount;
 int displaymodecount;
 int displaymode;
 
 explicit ASCH_SYMBOL( const std::map<wxString, wxString>& aProps );
};
 
 
enum class ASCH_PIN_SYMBOL_OUTER
{
 UNKNOWN = -1,
 NO_SYMBOL = 0,
 RIGHT_LEFT_SIGNAL_FLOW = 2,
 ANALOG_SIGNAL_IN = 5,
 NOT_LOGIC_CONNECTION = 6,
 DIGITAL_SIGNAL_IN = 25,
 LEFT_RIGHT_SIGNAL_FLOW = 33,
 BIDI_SIGNAL_FLOW = 34
};
 
 
enum class ASCH_PIN_SYMBOL_INNER
{
 UNKNOWN = -1,
 NO_SYMBOL = 0,
 POSPONED_OUTPUT = 8,
 OPEN_COLLECTOR = 9,
 HIZ = 10,
 HIGH_CURRENT = 11,
 PULSE = 12,
 SCHMITT = 13,
 OPEN_COLLECTOR_PULL_UP = 22,
 OPEN_EMITTER = 23,
 OPEN_EMITTER_PULL_UP = 24,
 SHIFT_LEFT = 30,
 OPEN_OUTPUT = 32
};
 
 
enum class ASCH_PIN_SYMBOL_OUTEREDGE
{
 UNKNOWN = -1,
 NO_SYMBOL = 0,
 NEGATED = 1,
 LOW_INPUT = 4,
 LOW_OUTPUT = 17
};
 
 
enum class ASCH_PIN_SYMBOL_INNEREDGE
{
 UNKNOWN = -1,
 NO_SYMBOL = 0,
 CLOCK = 3,
};
 
 
enum class ASCH_PIN_ELECTRICAL
{
 UNKNOWN = -1,
 
 INPUT = 0,
 BIDI = 1,
 OUTPUT = 2,
 OPEN_COLLECTOR = 3,
 PASSIVE = 4,
 TRISTATE = 5,
 OPEN_EMITTER = 6,
 POWER = 7
};
 
 
struct ASCH_PIN
{
 int ownerindex;
 int ownerpartid;
 int ownerpartdisplaymode;
 
 wxString name;
 wxString text;
 wxString designator;
 
 ASCH_PIN_SYMBOL_OUTER symbolOuter;
 ASCH_PIN_SYMBOL_INNER symbolInner;
 
 ASCH_PIN_SYMBOL_OUTEREDGE symbolOuterEdge;
 ASCH_PIN_SYMBOL_INNEREDGE symbolInnerEdge;
 
 ASCH_PIN_ELECTRICAL electrical;
 ASCH_RECORD_ORIENTATION orientation;
 
 VECTOR2I location;
 int pinlength;
 
 VECTOR2I kicadLocation; // location of pin in KiCad without rounding error
 
 bool showPinName;
 bool showDesignator;
 
 explicit ASCH_PIN( const std::map<wxString, wxString>& aProps );
};
 
 
enum class ASCH_LABEL_JUSTIFICATION
{
 UNKNOWN = -1,
 
 BOTTOM_LEFT = 0,
 BOTTOM_CENTER = 1,
 BOTTOM_RIGHT = 2,
 CENTER_LEFT = 3,
 CENTER_CENTER = 4,
 CENTER_RIGHT = 5,
 TOP_LEFT = 6,
 TOP_CENTER = 7,
 TOP_RIGHT = 8
};
 
 
enum class ASCH_TEXT_FRAME_ALIGNMENT
{
 LEFT = 1,
 CENTER = 2,
 RIGHT = 3
};
 
 
struct ASCH_LABEL
{
 int ownerindex;
 int ownerpartid;
 
 VECTOR2I location;
 
 wxString text;
 
 int fontId;
 bool isMirrored;
 
 ASCH_LABEL_JUSTIFICATION justification;
 ASCH_RECORD_ORIENTATION orientation;
 
 explicit ASCH_LABEL( const std::map<wxString, wxString>& aProps );
};
 
 
struct ASCH_TEXT_FRAME
{
 VECTOR2I Location;
 wxSize Size;
 
 // have both coordinates, for convenience
 VECTOR2I BottomLeft;
 VECTOR2I TopRight;
 
 wxString Text;
 
 bool IsWordWrapped; // to do when kicad supports this
 bool ShowBorder;
 bool IsSolid;
 
 int FontID;
 int TextMargin; // to do when kicad supports this
 int AreaColor;
 int BorderColor;
 
 ASCH_TEXT_FRAME_ALIGNMENT Alignment;
 
 explicit ASCH_TEXT_FRAME( const std::map<wxString, wxString>& aProps );
};
 
 
struct ASCH_NOTE : ASCH_TEXT_FRAME
{
 wxString author;
 
 explicit ASCH_NOTE( const std::map<wxString, wxString>& aProperties );
};
 
 
struct ASCH_BEZIER
{
 int ownerindex;
 int ownerpartid;
 int ownerpartdisplaymode;
 
 std::vector<VECTOR2I> points;
 
 int lineWidth;
 
 explicit ASCH_BEZIER( const std::map<wxString, wxString>& aProps );
};
 
 
enum class ASCH_POLYLINE_LINESTYLE
{
 SOLID = 0,
 DASHED = 1,
 DOTTED = 2,
 DASH_DOTTED = 3
};
 
 
enum class ASCH_SHEET_ENTRY_SIDE
{
 LEFT = 0,
 RIGHT = 1,
 TOP = 2,
 BOTTOM = 3
};
 
 
struct ASCH_POLYLINE
{
 int OwnerIndex;
 int OwnerPartID;
 int OwnerPartDisplayMode;
 
 std::vector<VECTOR2I> Points;
 
 int LineWidth;
 int Color;
 
 ASCH_POLYLINE_LINESTYLE LineStyle;
 
 explicit ASCH_POLYLINE( const std::map<wxString, wxString>& aProps );
};
 
 
struct ASCH_POLYGON : ASCH_SHAPE_INTERFACE
{
 std::vector<VECTOR2I> points;
 
 explicit ASCH_POLYGON( const std::map<wxString, wxString>& aProps );
};
 
 
struct ASCH_ROUND_RECTANGLE : ASCH_SHAPE_INTERFACE
{
 VECTOR2I BottomLeft;
 VECTOR2I TopRight;
 
 wxSize CornerRadius;
 
 bool IsTransparent;
 
 explicit ASCH_ROUND_RECTANGLE( const std::map<wxString, wxString>& aProps );
};
 
 
struct ASCH_ARC
{
 int ownerindex;
 int ownerpartid;
 int ownerpartdisplaymode;
 
 bool m_IsElliptical;
 VECTOR2I m_Center;
 int m_Radius;
 int m_SecondaryRadius;
 double m_StartAngle;
 double m_EndAngle;
 
 int m_LineWidth;
 
 explicit ASCH_ARC( const std::map<wxString, wxString>& aProps );
};
 
 
struct ASCH_ELLIPSE
{
 int OwnerIndex;
 int OwnerPartID;
 
 VECTOR2I Center;
 int Radius;
 double SecondaryRadius;
 
 int AreaColor;
 bool IsSolid;
 bool IsNotAccesible;
 
 explicit ASCH_ELLIPSE( const std::map<wxString, wxString>& aProps );
};
 
 
struct ASCH_LINE
{
 int ownerindex;
 int ownerpartid;
 int ownerpartdisplaymode;
 
 VECTOR2I point1;
 VECTOR2I point2;
 
 int lineWidth;
 
 explicit ASCH_LINE( const std::map<wxString, wxString>& aProps );
};
 
 
struct ASCH_SIGNAL_HARNESS
{
 int OwnerPartID; // always -1, can be safely ignored I think
 
 VECTOR2I Point1;
 VECTOR2I Point2;
 
 std::vector<VECTOR2I> Points;
 
 int Color;
 int IndexInSheet;
 int LineWidth;
 
 explicit ASCH_SIGNAL_HARNESS( const std::map<wxString, wxString>& aProps );
};
 
 
struct ASCH_HARNESS_CONNECTOR
{
 int OwnerPartID; // always -1, can be safely ignored I think
 
 VECTOR2I Location;
 wxSize Size;
 
 int AreaColor;
 int Color;
 int IndexInSheet; // Keeps increasing nicely
 int LineWidth;
 //int locationX; // keep just in case
 //int locationY;
 int LocationPrimaryConnectionPosition;
 //int xSize; // keep just in case
 //int ySize;
 
 explicit ASCH_HARNESS_CONNECTOR( const std::map<wxString, wxString>& aProps );
};
 
 
struct ASCH_HARNESS_ENTRY
{
 // Completely random, mostly this entry exists, but not always, should not be used!
 // int ownerindex;
 
 int OwnerPartID; // always -1, can be safely ignored I think
 
 int AreaColor;
 int Color;
 int DistanceFromTop;
 int IndexInSheet;
 int TextColor;
 int TextFontID;
 int TextStyle;
 
 bool OwnerIndexAdditionalList; // what is that?
 
 wxString Name;
 ASCH_SHEET_ENTRY_SIDE Side;
 
 explicit ASCH_HARNESS_ENTRY( const std::map<wxString, wxString>& aProps );
};
 
 
struct ASCH_HARNESS_TYPE
{
 //int ownerindex; // use SCH_ALTIUM_PLUGIN::m_harnessEntryParent instead!
 int OwnerPartID; // Always -1, presumably safe to remuve
 
 int Color;
 int IndexInSheet;
 int FontID;
 
 bool IsHidden;
 bool OwnerIndexAdditionalList; // what is that?
 
 VECTOR2I Location;
 
 wxString Text;
 
 explicit ASCH_HARNESS_TYPE( const std::map<wxString, wxString>& aProps );
};
 
 
struct ASCH_RECTANGLE : ASCH_SHAPE_INTERFACE
{
 VECTOR2I BottomLeft;
 VECTOR2I TopRight;
 
 bool IsTransparent;
 
 explicit ASCH_RECTANGLE( const std::map<wxString, wxString>& aProps );
};
 
 
struct ASCH_SHEET_SYMBOL
{
 VECTOR2I location;
 wxSize size;
 
 bool isSolid;
 
 int color;
 int areacolor;
 
 explicit ASCH_SHEET_SYMBOL( const std::map<wxString, wxString>& aProps );
};
 
 
enum class ASCH_PORT_IOTYPE
{
 UNSPECIFIED = 0,
 OUTPUT = 1,
 INPUT = 2,
 BIDI = 3,
};
 
 
enum class ASCH_PORT_STYLE
{
 NONE_HORIZONTAL = 0,
 LEFT = 1,
 RIGHT = 2,
 LEFT_RIGHT = 3,
 NONE_VERTICAL = 4,
 TOP = 5,
 BOTTOM = 6,
 TOP_BOTTOM = 7
};
 
 
struct ASCH_SHEET_ENTRY
{
 int ownerindex;
 int ownerpartid;
 
 int distanceFromTop;
 
 ASCH_SHEET_ENTRY_SIDE side;
 ASCH_PORT_IOTYPE iotype;
 ASCH_PORT_STYLE style;
 
 wxString name;
 
 explicit ASCH_SHEET_ENTRY( const std::map<wxString, wxString>& aProps );
};
 
 
enum class ASCH_POWER_PORT_STYLE
{
 UNKNOWN = -1,
 
 CIRCLE = 0,
 ARROW = 1,
 BAR = 2,
 WAVE = 3,
 POWER_GROUND = 4,
 SIGNAL_GROUND = 5,
 EARTH = 6,
 GOST_ARROW = 7,
 GOST_POWER_GROUND = 8,
 GOST_EARTH = 9,
 GOST_BAR = 10
};
 
 
struct ASCH_POWER_PORT
{
 int ownerpartid;
 
 wxString text;
 bool showNetName;
 
 VECTOR2I location;
 ASCH_RECORD_ORIENTATION orientation;
 ASCH_POWER_PORT_STYLE style;
 
 explicit ASCH_POWER_PORT( const std::map<wxString, wxString>& aProps );
};
 
 
struct ASCH_PORT
{
 int OwnerPartID;
 
 wxString Name;
 wxString HarnessType;
 
 VECTOR2I Location;
 int Width;
 int Height;
 int AreaColor;
 int Color;
 int TextColor;
 int FontID;
 
 ASCH_TEXT_FRAME_ALIGNMENT Alignment;
 
 ASCH_PORT_IOTYPE IOtype;
 ASCH_PORT_STYLE Style;
 
 explicit ASCH_PORT( const std::map<wxString, wxString>& aProps );
};
 
 
struct ASCH_NO_ERC
{
 VECTOR2I location;
 
 bool isActive;
 bool suppressAll;
 
 explicit ASCH_NO_ERC( const std::map<wxString, wxString>& aProps );
};
 
 
struct ASCH_NET_LABEL
{
 wxString text;
 
 VECTOR2I location;
 
 ASCH_RECORD_ORIENTATION orientation;
 
 explicit ASCH_NET_LABEL( const std::map<wxString, wxString>& aProps );
};
 
 
struct ASCH_BUS
{
 int indexinsheet;
 int lineWidth;
 
 std::vector<VECTOR2I> points;
 
 explicit ASCH_BUS( const std::map<wxString, wxString>& aProps );
};
 
 
struct ASCH_WIRE
{
 int indexinsheet;
 int lineWidth;
 
 std::vector<VECTOR2I> points;
 
 explicit ASCH_WIRE( const std::map<wxString, wxString>& aProps );
};
 
 
struct ASCH_JUNCTION
{
 int ownerpartid;
 
 VECTOR2I location;
 
 explicit ASCH_JUNCTION( const std::map<wxString, wxString>& aProps );
};
 
 
struct ASCH_IMAGE
{
 int indexinsheet;
 int ownerindex;
 int ownerpartid;
 
 wxString filename;
 VECTOR2I location;
 VECTOR2I corner;
 
 bool embedimage;
 bool keepaspect;
 
 explicit ASCH_IMAGE( const std::map<wxString, wxString>& aProps );
};
 
 
struct ASCH_SHEET_FONT
{
 wxString FontName;
 
 int Size;
 int Rotation;
 int AreaColor;
 
 bool Italic;
 bool Bold;
 bool Underline;
 
 explicit ASCH_SHEET_FONT( const std::map<wxString, wxString>& aProps, int aId );
};
 
 
enum class ASCH_SHEET_SIZE
{
 UNKNOWN = -1, // use A4
 
 A4 = 0, // 1150 × 760
 A3 = 1, // 1550 × 1110
 A2 = 2, // 2230 × 1570
 A1 = 3, // 3150 × 2230
 A0 = 4, // 4460 × 3150
 A = 5, // 950 × 750
 B = 6, // 1500 × 950
 C = 7, // 2000 × 1500
 D = 8, // 3200 × 2000
 E = 9, // 4200 × 3200
 LETTER = 10, // 1100 × 850
 LEGAL = 11, // 1400 × 850
 TABLOID = 12, // 1700 × 1100
 ORCAD_A = 13, // 990 × 790
 ORCAD_B = 14, // 1540 × 990
 ORCAD_C = 15, // 2060 × 1560
 ORCAD_D = 16, // 3260 × 2060
 ORCAD_E = 17 // 4280 × 3280
};
 
VECTOR2I ASchSheetGetSize( ASCH_SHEET_SIZE aSheetSize );
 
 
enum class ASCH_SHEET_WORKSPACEORIENTATION
{
 LANDSCAPE = 0,
 PORTRAIT = 1
};
 
 
struct ASCH_SHEET
{
 std::vector<ASCH_SHEET_FONT> fonts;
 
 ASCH_SHEET_SIZE sheetSize;
 ASCH_SHEET_WORKSPACEORIENTATION sheetOrientation;
 
 explicit ASCH_SHEET( const std::map<wxString, wxString>& aProps );
};
 
 
struct ASCH_SHEET_NAME
{
 int ownerindex;
 int ownerpartid;
 
 wxString text;
 
 ASCH_RECORD_ORIENTATION orientation;
 VECTOR2I location;
 
 bool isHidden;
 
 explicit ASCH_SHEET_NAME( const std::map<wxString, wxString>& aProps );
};
 
 
struct ASCH_FILE_NAME
{
 int ownerindex;
 int ownerpartid;
 
 wxString text;
 
 ASCH_RECORD_ORIENTATION orientation;
 VECTOR2I location;
 
 bool isHidden;
 
 explicit ASCH_FILE_NAME( const std::map<wxString, wxString>& aProps );
};
 
 
struct ASCH_DESIGNATOR
{
 int ownerindex;
 int ownerpartid;
 
 wxString name;
 wxString text;
 
 ASCH_RECORD_ORIENTATION orientation;
 ASCH_LABEL_JUSTIFICATION justification;
 VECTOR2I location;
 
 explicit ASCH_DESIGNATOR( const std::map<wxString, wxString>& aProps );
};
 
 
struct ASCH_IMPLEMENTATION
{
 int ownerindex;
 
 wxString name;
 wxString type;
 wxString libname;
 
 bool isCurrent;
 
 explicit ASCH_IMPLEMENTATION( const std::map<wxString, wxString>& aProps );
};
 
 
struct ASCH_IMPLEMENTATION_LIST
{
 int ownerindex;
 explicit ASCH_IMPLEMENTATION_LIST( const std::map<wxString, wxString>& aProps );
};
 
 
struct ASCH_BUS_ENTRY
{
 VECTOR2I location;
 VECTOR2I corner;
 
 explicit ASCH_BUS_ENTRY( const std::map<wxString, wxString>& aProps );
};
 
 
struct ASCH_PARAMETER
{
 int ownerindex;
 int ownerpartid;
 
 VECTOR2I location;
 ASCH_LABEL_JUSTIFICATION justification;
 ASCH_RECORD_ORIENTATION orientation;
 
 wxString name;
 wxString text;
 
 bool isHidden;
 bool isMirrored;
 bool isShowName;
 
 explicit ASCH_PARAMETER( const std::map<wxString, wxString>& aProps );
};
 
#endif //ALTIUM_PARSER_SCH_H