/****************************************************************/ /* Headers for pins in lib component definitions */ /****************************************************************/ /* Definitions of class LIB_PIN used in component libraries. */ #ifndef CLASS_PIN_H #define CLASS_PIN_H #include "classes_body_items.h" #define TARGET_PIN_DIAM 12 /* Circle diameter drawn at the active end of * pins */ #define DEFAULT_TEXT_SIZE 50 /* Default size for field texts */ #define PART_NAME_LEN 15 /* Maximum length of part name. */ #define PREFIX_NAME_LEN 5 /* Maximum length of prefix (IC, R, SW etc.). */ #define PIN_WIDTH 100 /* Width between 2 pins in internal units. */ #define PIN_LENGTH 300 /* Default Length of each pin to be drawn. */ #if defined(KICAD_GOST) #define INVERT_PIN_RADIUS 20 /* Radius of inverted pin circle. */ #else #define INVERT_PIN_RADIUS 35 /* Radius of inverted pin circle. */ #endif #define CLOCK_PIN_DIM 40 /* Dim of clock pin symbol. */ #define IEEE_SYMBOL_PIN_DIM 40 /* Dim of special pin symbol. */ /** * The component library pin object electrical types used in ERC tests. */ enum ElectricPinType { PIN_INPUT, PIN_OUTPUT, PIN_BIDI, PIN_TRISTATE, PIN_PASSIVE, PIN_UNSPECIFIED, PIN_POWER_IN, PIN_POWER_OUT, PIN_OPENCOLLECTOR, PIN_OPENEMITTER, PIN_NC, /* No connect */ PIN_NMAX /* End of List (no used as pin type) */ }; /* Electrical pin type names. */ extern const wxChar* MsgPinElectricType[]; /* Pin visibility flag bit. */ #define PINNOTDRAW 1 /* Set makes pin invisible */ /** * The component library pin object drawing shapes. */ enum DrawPinShape { NONE = 0, INVERT = 1, CLOCK = 2, LOWLEVEL_IN = 4, LOWLEVEL_OUT = 8 }; /** * The component library pin object orientations. */ enum DrawPinOrient { PIN_RIGHT = 'R', PIN_LEFT = 'L', PIN_UP = 'U', PIN_DOWN = 'D', }; class LIB_PIN : public LIB_DRAW_ITEM { public: int m_PinLen; /* Pin length */ int m_Orient; /* Pin orientation (Up, Down, Left, Right) */ int m_PinShape; /* Bitwise ORed: Pin shape (see enum DrawPinShape) */ int m_PinType; /* Electrical pin properties */ int m_Attributs; /* bit 0 != 0: pin invisible */ long m_PinNum; /* Pin number: 4 ASCII code like "12" or "anod" * or "G6" "12" is stored as "12\0\0" ans does not * depend on endian type*/ wxString m_PinName; int m_PinNumSize; int m_PinNameSize; /* Pin num and Pin name sizes */ /* (Currently Unused) Pin num and Pin name text options: italic/normal * /bold, 0 = default */ char m_PinNumShapeOpt; char m_PinNameShapeOpt; // (Currently Unused) Pin num and Pin name text opt position, 0 = default: char m_PinNumPositionOpt; char m_PinNamePositionOpt; wxPoint m_Pos; /* Position or centre (Arc and Circle) or start * point (segments) */ int m_Width; /* Line width */ public: LIB_PIN(LIB_COMPONENT * aParent); LIB_PIN( const LIB_PIN& aPin ); ~LIB_PIN() { } LIB_PIN* Next() const { return (LIB_PIN*) Pnext; } LIB_PIN* Back() const { return (LIB_PIN*) Pback; } virtual wxString GetClass() const { return wxT( "LIB_PIN" ); } #if defined(DEBUG) void Show( int nestLevel, std::ostream& os ); // virtual override #endif /** * Write pin object to a FILE in "*.lib" format. * * @param aFile The FILE to write to. * @return - true if success writing else false. */ virtual bool Save( FILE* aFile ); virtual bool Load( char* aLine, wxString& aErrorMsg ); /** * Test if the given point is within the bounds of this object. * * @param aRefPos A wxPoint to test * @return - true if a hit, else false */ virtual bool HitTest( const wxPoint& aRefPos ); /** * @param aPosRef - a wxPoint to test * @param aThreshold - max distance to this object (usually the half * thickness of a line) * @param aTransMat - the transform matrix * @return - true if the point aPosRef is near this object */ virtual bool HitTest( wxPoint aPosRef, int aThreshold, const int aTransMat[2][2] ); virtual void DisplayInfo( WinEDA_DrawFrame* frame ); virtual EDA_Rect GetBoundingBox(); wxPoint ReturnPinEndPoint(); int ReturnPinDrawOrient( const int TransMat[2][2] ); /** * Fill a string buffer with pin number. * * Pin numbers are coded as a long or 4 ASCII characters. Used to print * or draw the pin number. * * @param aStringBuffer - the wxString to store the pin num as an unicode * string */ void ReturnPinStringNum( wxString& aStringBuffer ) const; wxString GetNumber() { return ReturnPinStringNum( m_PinNum ); } /** Function ReturnPinStringNum (static function) * Pin num is coded as a long or 4 ascii chars * @param aPinNum = a long containing a pin num * @return aStringBuffer = the wxString to store the pin num as an * unicode string */ static wxString ReturnPinStringNum( long aPinNum ); void SetPinNumFromString( wxString& aBuffer ); /** * Set the pin name. * * This will also all of the pin names marked by EnableEditMode(). * * @param name - New pin name. */ void SetName( const wxString& aName ); /** * Set the /a aSize of the pin name text. * * This will also update the text size of the name of the pins marked * by EnableEditMode(). * * @param aSize - The text size of the pin name in schematic units ( mils ). */ void SetNameTextSize( int aSize ); /** * Set the pin number. * * Others pin numbers marked by EnableEditMode() are not modified * because each pin has its own number * @param aNumber - New pin number. */ void SetNumber( const wxString& aNumber ); /** * Set the size of the pin number text. * * This will also update the text size of the number of the pins marked * by EnableEditMode(). * * @param aSize - The text size of the pin number in schematic * units ( mils ). */ void SetNumberTextSize( int aSize ); /** * Set orientation on the pin. * * This will also update the orientation of the pins marked by * EnableEditMode(). * * @param aOrientation - The orientation of the pin. */ void SetOrientation( int aOrientation ); /** * Set the draw style of the pin. * * This will also update the draw style of the pins marked by * EnableEditMode(). * * @param aStyle - The draw style of the pin. */ void SetDrawStyle( int aStyle ); /** * Set the electrical type of the pin. * * This will also update the electrical type of the pins marked by * EnableEditMode(). * * @param aType - The electrical type of the pin. */ void SetElectricalType( int aType ); /** * Set the pin length. * * This will also update the length of the pins marked by EnableEditMode(). * * @param aLength - The length of the pin in mils. */ void SetLength( int aLength ); /** * Set the pin part number. * * If the pin is changed from not common to common to all parts, any * linked pins will be removed from the parent component. * * @param aPart - Number of the part the pin belongs to. Set to zero to * make pin common to all parts in a multi-part component. */ void SetPartNumber( int aPart ); /** * Set the body style (conversion) of the pin. * * If the pin is changed from not common to common to all body styles, any * linked pins will be removed from the parent component. * * @param conversion - Body style of the pin. Set to zero to make pin * common to all body styles. */ void SetConversion( int aConversion ); /** * Set or clear the visibility flag for the pin. * * This will also update the visibility of the pins marked by * EnableEditMode(). * * @param aVisible - True to make the pin visible or false to hide the pin. */ void SetVisible( bool aVisible ); /** * Enable or clear pin editing mode. * * The pin editing mode marks or unmarks all pins common to this * pin object for further editing. If any of the pin modifcation * methods are called after enabling the editing mode, all pins * marked for editing will have the same attribute changed. The * only case were this is not true making this pin common to all * parts or body styles in the component. See SetCommonToAllParts() * and SetCommonToAllBodyStyles() for more information. * * @params aEnable - True marks all common pins for editing mode. False * clears the editing mode. * @params aEditpinByPin - Enables the edit pin by pin mode. */ void EnableEditMode( bool aEnable, bool aEditPinByPin = false ); /** * Return the visibility status of the draw object. * * @return True if draw object is visible otherwise false. */ bool IsVisible() { return ( m_Attributs & PINNOTDRAW ) == 0; } /** * @return the size of the "pen" that be used to draw or plot this item. */ virtual int GetPenSize(); void Draw( WinEDA_DrawPanel * aPanel, wxDC * aDC, const wxPoint &aOffset, int aColor, int aDrawMode, void* aData, const int aTransformMatrix[2][2] ); void DrawPinSymbol( WinEDA_DrawPanel* aPanel, wxDC* aDC, const wxPoint& aPosition, int aOrientation, int aDrawMode, int aColor = -1 ); void DrawPinTexts( WinEDA_DrawPanel* aPanel, wxDC* aDC, wxPoint& aPosition, int aOrientation, int TextInside, bool DrawPinNum, bool DrawPinName, int aColor, int aDrawMode ); void PlotPinTexts( PLOTTER *aPlotter, wxPoint& aPosition, int aOrientation, int aTextInside, bool aDrawPinNum, bool aDrawPinName, int aWidth ); /** * Get a list of pin orientation names. * * @return List of valid pin orientation names. */ static wxArrayString GetOrientationNames(); /** * Get a list of pin orientation bitmaps for menus and dialogs.. * * @return List of valid pin orientation bitmaps symbols in .xpm format */ static const char*** GetOrientationSymbols(); /** * Get the orientation code by index used to set the pin orientation. * * @param aIndex - The index of the orientation code to look up. * @return Orientation code if index is valid. Returns right * orientation on index error. */ static int GetOrientationCode( int aIndex ); /** * Get the index of the orientation code. * * @param aCode - The orientation code to look up. * @return The index of the orientation code if found. Otherwise, * return wxNOT_FOUND. */ static int GetOrientationCodeIndex( int aCode ); /** * Get a list of pin draw style names. * * @return List of valid pin draw style names. */ static wxArrayString GetStyleNames(); /** * Get a list of pin styles bitmaps for menus and dialogs. * * @return List of valid pin electrical type bitmaps symbols in .xpm format. */ static const char*** GetStyleSymbols(); /** * Get the pin draw style code by index used to set the pin draw style. * * @param aIndex - The index of the pin draw style code to look up. * @return Pin draw style code if index is valid. Returns NONE * style on index error. */ static int GetStyleCode( int aIndex ); /** * Get the index of the pin draw style code. * * @param aCode - The pin draw style code to look up. * @return The index of the pin draw style code if found. Otherwise, * return wxNOT_FOUND. */ static int GetStyleCodeIndex( int aCode ); /** * Get a list of pin electrical type names. * * @return List of valid pin electrical type names. */ static wxArrayString GetElectricalTypeNames(); /** * Get a list of pin electrical bitmaps for menus and dialogs. * * @return List of valid pin electrical type bitmaps symbols in .xpm format */ static const char*** GetElectricalTypeSymbols(); protected: virtual LIB_DRAW_ITEM* DoGenCopy(); /** * Provide the pin draw object specific comparison. * * The sort order is as follows: * - Pin number. * - Pin name, case insensitive compare. * - Pin horizontal (X) position. * - Pin vertical (Y) position. */ virtual int DoCompare( const LIB_DRAW_ITEM& aOther ) const; virtual void DoOffset( const wxPoint& aOffset ); virtual bool DoTestInside( EDA_Rect& aRect ); virtual void DoMove( const wxPoint& aPosition ); virtual wxPoint DoGetPosition() { return m_Pos; } virtual void DoMirrorHorizontal( const wxPoint& aCenter ); virtual void DoPlot( PLOTTER* aPlotter, const wxPoint& aOffset, bool aFill, const int aTransform[2][2] ); virtual int DoGetWidth() { return m_Width; } virtual void DoSetWidth( int aWidth ) { m_Width = aWidth; } }; #endif // CLASS_PIN_H