pcb_dimension.h

Go to the documentation of this file.

/*
 * This program source code file is part of KiCad, a free EDA CAD application.
 *
 * Copyright (C) 2004 Jean-Pierre Charras, [email protected]
 * Copyright The 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, see <https://www.gnu.org/licenses/>.
 */
 
#ifndef PCB_DIMENSION_H
#define PCB_DIMENSION_H
 
 
#include <board_item.h>
#include <pcb_text.h>
#include <geometry/shape.h>
#include <geometry/circle.h>
 
class LINE_READER;
class MSG_PANEL_ITEM;
 
enum class DIM_VALUE_MODE : int;   // defined in constraints/constraint_builder.h
 

enum class DIM_UNITS_FORMAT
{
    NO_SUFFIX,      // 1234.0
    BARE_SUFFIX,    // 1234.0 mm
    PAREN_SUFFIX    // 1234.0 (mm)
};
 
enum class DIM_PRECISION
{
    X = 0,          // 0
    X_X,            // 0.0
    X_XX,           // 0.00
    X_XXX,          // 0.000
    X_XXXX,         // 0.0000
    X_XXXXX,        // 0.00000
    V_VV,           // 0.00 / 0 / 0.0
    V_VVV,          // 0.000 / 0 / 0.00
    V_VVVV,         // 0.0000 / 0.0 / 0.000
    V_VVVVV         // 0.00000 / 0.00 / 0.0000
};

enum class DIM_TEXT_POSITION
{
    OUTSIDE,    
    INLINE,     
    MANUAL      
};

enum class DIM_UNITS_MODE
{
    INCH,       // Do not use IN: it conflicts with a Windows header
    MILS,
    MM,
    AUTOMATIC
};

enum class DIM_ARROW_DIRECTION
{
    INWARD,  
    OUTWARD, 
};

enum class DIM_TEXT_BORDER
{
    NONE,
    RECTANGLE,
    CIRCLE,
    ROUNDRECT
};

class PCB_DIMENSION_BASE : public PCB_TEXT
{
public:
    PCB_DIMENSION_BASE( BOARD_ITEM* aParent, KICAD_T aType = PCB_DIMENSION_T );
 
    void Serialize( google::protobuf::Any &aContainer ) const override;
    bool Deserialize( const google::protobuf::Any &aContainer ) override;

    virtual VECTOR2I GetStart() const;
    virtual void     SetStart( const VECTOR2I& aPoint );
 
    virtual VECTOR2I GetEnd() const;
    virtual void     SetEnd( const VECTOR2I& aPoint );
 
    VECTOR2I GetPosition() const override { return GetStart(); }
    void     SetPosition( const VECTOR2I& aPos ) override { SetStart( aPos ); }
 
    void OnFootprintRescaled( double aRatioX, double aRatioY, double aLinearFactor, const VECTOR2I& aAnchor,
                              const EDA_ANGLE& aParentRotate ) override;
 
    void OnFootprintTransformed() override;
 
    const VECTOR2I& GetLibraryStart() const { return m_start; }
    const VECTOR2I& GetLibraryEnd() const { return m_end; }
 
    bool GetOverrideTextEnabled() const { return m_overrideTextEnabled; }
    void SetOverrideTextEnabled( bool aOverride ) { m_overrideTextEnabled = aOverride; }
 
    wxString GetOverrideText() const { return m_valueString; }
    void SetOverrideText( const wxString& aValue ) { m_valueString = aValue; }
 
    void ChangeOverrideText( const wxString& aValue )
    {
        SetOverrideTextEnabled( true );
        SetOverrideText( aValue );
        Update();
    }

    DIM_VALUE_MODE GetValueMode() const;

    void ChangeValueMode( DIM_VALUE_MODE aMode );

    wxString GetValueFieldText() const;

    void ChangeValueFieldText( const wxString& aText );
 
    int GetMeasuredValue() const { return m_measuredValue; }
 
    // KiCad normally calculates the measured value but some importers need to set it.
    void SetMeasuredValue( int aValue ) { m_measuredValue = aValue; }

    wxString GetValueText() const;

    void Update()
    {
        // Calls updateText internally
        updateGeometry();
    }
 
    void UpdateUnits()
    {
        SetUnitsMode( GetUnitsMode() );
        Update();
    }
 
    wxString GetPrefix() const { return m_prefix; }
    void SetPrefix( const wxString& aPrefix );
 
    void ChangePrefix( const wxString& aPrefix )
    {
        SetPrefix( aPrefix );
        Update();
    }
 
    wxString GetSuffix() const { return m_suffix; }
    void SetSuffix( const wxString& aSuffix );
 
    void ChangeSuffix( const wxString& aSuffix )
    {
        SetSuffix( aSuffix );
        Update();
    }
 
    DIM_ARROW_DIRECTION GetArrowDirection() const { return m_arrowDirection; }
    void                SetArrowDirection( const DIM_ARROW_DIRECTION& aDirection )
    {
        m_arrowDirection = aDirection;
    }
 
    void ChangeArrowDirection( const DIM_ARROW_DIRECTION& aDirection )
    {
        SetArrowDirection( aDirection );
        updateText();
        updateGeometry();
    }
 
    EDA_UNITS GetUnits() const { return m_units; }
    void SetUnits( EDA_UNITS aUnits );
 
    DIM_UNITS_MODE GetUnitsMode() const;
    void SetUnitsMode( DIM_UNITS_MODE aMode );
 
    void ChangeUnitsMode( DIM_UNITS_MODE aMode )
    {
        SetUnitsMode( aMode );
        Update();
    }
 
    void SetAutoUnits( bool aAuto = true ) { m_autoUnits = aAuto; }
 
    DIM_UNITS_FORMAT GetUnitsFormat() const { return m_unitsFormat; }
    void SetUnitsFormat( const DIM_UNITS_FORMAT aFormat ) { m_unitsFormat = aFormat; }
 
    void ChangeUnitsFormat( const DIM_UNITS_FORMAT aFormat )
    {
        SetUnitsFormat( aFormat );
        Update();
    }
 
    DIM_PRECISION GetPrecision() const { return m_precision; }
    void SetPrecision( DIM_PRECISION aPrecision ) { m_precision = aPrecision; }
 
    void ChangePrecision( DIM_PRECISION aPrecision )
    {
        SetPrecision( aPrecision );
        Update();
    }
 
    bool GetSuppressZeroes() const { return m_suppressZeroes; }
    void SetSuppressZeroes( bool aSuppress ) { m_suppressZeroes = aSuppress; }
 
    void ChangeSuppressZeroes( bool aSuppress )
    {
        SetSuppressZeroes( aSuppress );
        Update();
    }
 
    bool GetKeepTextAligned() const { return m_keepTextAligned; }
    void SetKeepTextAligned( bool aKeepAligned ) { m_keepTextAligned = aKeepAligned; }
 
    double GetTextAngleDegreesProp() const { return GetTextAngleDegrees(); }
    void ChangeTextAngleDegrees( double aDegrees );
    void ChangeKeepTextAligned( bool aKeepAligned );
 
    void SetTextPositionMode( DIM_TEXT_POSITION aMode ) { m_textPosition = aMode; }
    DIM_TEXT_POSITION GetTextPositionMode() const { return m_textPosition; }
 
    int GetArrowLength() const { return m_arrowLength; }
    void SetArrowLength( int aLength ) { m_arrowLength = aLength; }
 
    void SetExtensionOffset( int aOffset ) { m_extensionOffset = aOffset; }
    int GetExtensionOffset() const { return m_extensionOffset; }
 
    int GetLineThickness() const        { return m_lineThickness; }
    void SetLineThickness( int aWidth ) { m_lineThickness = aWidth; }
 
    void StyleFromSettings( const BOARD_DESIGN_SETTINGS& settings, bool aCheckSide ) override;

    const std::vector<std::shared_ptr<SHAPE>>& GetShapes() const { return m_shapes; }
 
    // BOARD_ITEM overrides
 
    void Move( const VECTOR2I& offset ) override;
    void Rotate( const VECTOR2I& aRotCentre, const EDA_ANGLE& aAngle ) override;
    void Flip( const VECTOR2I& aCentre, FLIP_DIRECTION aFlipDirection ) override;

    virtual void Mirror( const VECTOR2I& axis_pos, FLIP_DIRECTION aFlipDirection ) override;
 
    void GetMsgPanelInfo( EDA_DRAW_FRAME* aFrame, std::vector<MSG_PANEL_ITEM>& aList ) override;
 
    bool HitTest( const VECTOR2I& aPosition, int aAccuracy ) const override;
    bool HitTest( const BOX2I& aRect, bool aContained, int aAccuracy = 0 ) const override;
    bool HitTest( const SHAPE_LINE_CHAIN& aPoly, bool aContained ) const override;
 
    const BOX2I GetBoundingBox() const override;
 
    std::shared_ptr<SHAPE> GetEffectiveShape( PCB_LAYER_ID aLayer = UNDEFINED_LAYER,
                                              FLASHING aFlash = FLASHING::DEFAULT,
                                              DRC_CONSTRAINT_T aUsage = NULL_CONSTRAINT ) const override;
 
    wxString GetItemDescription( UNITS_PROVIDER* aUnitsProvider, bool aFull ) const override;
 
    const BOX2I ViewBBox() const override;
 
    std::vector<int> ViewGetLayers() const override;
 
    double ViewGetLOD( int aLayer, const KIGFX::VIEW* aView ) const override;
 
    void ClearRenderCache() override;
 
    double GetCoverageArea( int aTextMargin ) const override;
 
    void TransformShapeToPolygon( SHAPE_POLY_SET& aBuffer, PCB_LAYER_ID aLayer, int aClearance,
                                  int aError, ERROR_LOC aErrorLoc,
                                  bool aIgnoreLineWidth = false ) const override;
 
    double Similarity( const BOARD_ITEM& aOther ) const override;
 
    bool operator==( const PCB_DIMENSION_BASE& aOther ) const;
    bool operator==( const BOARD_ITEM& aBoardItem ) const override;
 
#if defined(DEBUG)
    virtual void Show( int nestLevel, std::ostream& os ) const override { ShowDummy( os ); }
#endif
 
protected:

    virtual void updateGeometry() = 0;

    virtual void updateText();
 
    template<typename ShapeType>
    void addShape( const ShapeType& aShape );

    void drawAnArrow( VECTOR2I aStartPoint, EDA_ANGLE anAngle, int aLength );
 
    // Value format
    bool                    m_overrideTextEnabled;   
    wxString                m_valueString;     
    wxString                m_prefix;          
    wxString                m_suffix;          
    EDA_UNITS               m_units;           
    bool                    m_autoUnits;       
    DIM_UNITS_FORMAT        m_unitsFormat;     
    DIM_ARROW_DIRECTION     m_arrowDirection;  
    DIM_PRECISION           m_precision;       
    bool                    m_suppressZeroes;  
 
    // Geometry
    int                     m_lineThickness;    
    int                     m_arrowLength;      
    int                     m_extensionOffset;  
    DIM_TEXT_POSITION       m_textPosition;     
    bool                    m_keepTextAligned;  
 
    // Internal
    int m_measuredValue; 
 
    VECTOR2I m_start; 
    VECTOR2I m_end;   

    std::vector<std::shared_ptr<SHAPE>> m_shapes;
 
    bool       m_inClearRenderCache;      
 
    // a flag to protect against reentrance
    bool m_busy;
};
 


class PCB_DIM_ALIGNED : public PCB_DIMENSION_BASE
{
public:
    PCB_DIM_ALIGNED( BOARD_ITEM* aParent, KICAD_T aType = PCB_DIM_ALIGNED_T );
 
    // Do not create a copy constructor & operator=.
    // The ones generated by the compiler are adequate.
 
    ~PCB_DIM_ALIGNED() = default;
 
    void CopyFrom( const BOARD_ITEM* aOther ) override;
    void Serialize( google::protobuf::Any &aContainer ) const override;
    bool Deserialize( const google::protobuf::Any &aContainer ) override;
 
    static inline bool ClassOf( const EDA_ITEM* aItem )
    {
        return aItem && aItem->Type() == PCB_DIM_ALIGNED_T;
    }
 
    EDA_ITEM* Clone() const override;
 
    void Mirror( const VECTOR2I& axis_pos, FLIP_DIRECTION aFlipDirection ) override;
 
    BITMAPS GetMenuImage() const override;
 
    const VECTOR2I& GetCrossbarStart() const { return m_crossBarStart; }
 
    const VECTOR2I& GetCrossbarEnd() const { return m_crossBarEnd; }

    void SetHeight( int aHeight ) { m_height = aHeight; }
    int GetHeight() const {  return m_height; }
 
    void ChangeHeight( int aHeight )
    {
        SetHeight( aHeight );
        Update();
    }

    void UpdateHeight( const VECTOR2I& aCrossbarStart, const VECTOR2I& aCrossbarEnd );
 
    void SetExtensionHeight( int aHeight ) { m_extensionHeight = aHeight; }
    int GetExtensionHeight() const { return m_extensionHeight; }
 
    void ChangeExtensionHeight( int aHeight )
    {
        SetExtensionHeight( aHeight );
        Update();
    }

    double GetAngle() const
    {
        VECTOR2I delta( GetEnd() - GetStart() );
 
        return atan2( (double)delta.y, (double)delta.x );
    }
 
    wxString GetClass() const override
    {
        return wxT( "PCB_DIM_ALIGNED" );
    }
 
    void GetMsgPanelInfo( EDA_DRAW_FRAME* aFrame, std::vector<MSG_PANEL_ITEM>& aList ) override;
 
protected:
    virtual void swapData( BOARD_ITEM* aImage ) override;
 
    void updateGeometry() override;
 
    void updateText() override;
 
    // Geometry
    int          m_height;           
    int          m_extensionHeight;  
 
    VECTOR2I m_crossBarStart; 
    VECTOR2I m_crossBarEnd;   
 
};
 

class PCB_DIM_ORTHOGONAL : public PCB_DIM_ALIGNED
{
public:
    enum class DIR
    {
        HORIZONTAL, // Aligned with x-axis
        VERTICAL    // Aligned with y-axis
    };
 
    PCB_DIM_ORTHOGONAL( BOARD_ITEM* aParent );
 
    ~PCB_DIM_ORTHOGONAL() = default;
 
    void CopyFrom( const BOARD_ITEM* aOther ) override;
    void Serialize( google::protobuf::Any &aContainer ) const override;
    bool Deserialize( const google::protobuf::Any &aContainer ) override;
 
    static inline bool ClassOf( const EDA_ITEM* aItem )
    {
        return aItem && aItem->Type() == PCB_DIM_ORTHOGONAL_T;
    }
 
    EDA_ITEM* Clone() const override;
 
    void Mirror( const VECTOR2I& axis_pos, FLIP_DIRECTION aFlipDirection ) override;
 
    BITMAPS GetMenuImage() const override;

    void SetOrientation( DIR aOrientation ) { m_orientation = aOrientation; }
    DIR GetOrientation() const { return m_orientation; }
 
    wxString GetClass() const override
    {
        return wxT( "PCB_DIM_ORTHOGONAL" );
    }
    void     Rotate( const VECTOR2I& aRotCentre, const EDA_ANGLE& aAngle ) override;
 
protected:
    void swapData( BOARD_ITEM* aImage ) override;
 
    void updateGeometry() override;
 
    void updateText() override;
 
private:
    // Geometry
    DIR      m_orientation;     
 
};
 

class PCB_DIM_RADIAL : public PCB_DIMENSION_BASE
{
public:
    PCB_DIM_RADIAL( BOARD_ITEM* aParent );
 
    void CopyFrom( const BOARD_ITEM* aOther ) override;
    void Serialize( google::protobuf::Any &aContainer ) const override;
    bool Deserialize( const google::protobuf::Any &aContainer ) override;
 
    static inline bool ClassOf( const EDA_ITEM* aItem )
    {
        return aItem && aItem->Type() == PCB_DIM_RADIAL_T;
    }
 
    EDA_ITEM* Clone() const override;
 
    void SetLeaderLength( int aLength ) { m_leaderLength = aLength; }
    int GetLeaderLength() const { return m_leaderLength; }
 
    void ChangeLeaderLength( int aLength )
    {
        SetLeaderLength( aLength );
        Update();
    }
 
    // Returns the point (c).
    VECTOR2I GetKnee() const;
 
    BITMAPS GetMenuImage() const override;
 
    wxString GetClass() const override
    {
        return wxT( "PCB_DIM_RADIAL" );
    }
 
protected:
    virtual void swapData( BOARD_ITEM* aImage ) override;
 
    void updateText() override;
    void updateGeometry() override;
 
private:
    int  m_leaderLength;
};
 

class PCB_DIM_LEADER : public PCB_DIMENSION_BASE
{
public:
    PCB_DIM_LEADER( BOARD_ITEM* aParent );
 
    void CopyFrom( const BOARD_ITEM* aOther ) override;
    void Serialize( google::protobuf::Any &aContainer ) const override;
    bool Deserialize( const google::protobuf::Any &aContainer ) override;
 
    static inline bool ClassOf( const EDA_ITEM* aItem )
    {
        return aItem && aItem->Type() == PCB_DIM_LEADER_T;
    }
 
    EDA_ITEM* Clone() const override;
 
    BITMAPS GetMenuImage() const override;
 
    wxString GetClass() const override
    {
        return wxT( "PCB_DIM_LEADER" );
    }
 
    void SetTextBorder( DIM_TEXT_BORDER aBorder ) { m_textBorder = aBorder; }
    DIM_TEXT_BORDER GetTextBorder() const { return m_textBorder; }
 
    void ChangeTextBorder( DIM_TEXT_BORDER aBorder )
    {
        SetTextBorder( aBorder );
        Update();
    }
 
    void GetMsgPanelInfo( EDA_DRAW_FRAME* aFrame, std::vector<MSG_PANEL_ITEM>& aList ) override;
 
protected:
    virtual void swapData( BOARD_ITEM* aImage ) override;
 
    void updateText() override;
    void updateGeometry() override;
 
private:
    DIM_TEXT_BORDER m_textBorder;
};
 

class PCB_DIM_CENTER : public PCB_DIMENSION_BASE
{
public:
    PCB_DIM_CENTER( BOARD_ITEM* aParent );
 
    void CopyFrom( const BOARD_ITEM* aOther ) override;
    void Serialize( google::protobuf::Any &aContainer ) const override;
    bool Deserialize( const google::protobuf::Any &aContainer ) override;
 
    static inline bool ClassOf( const EDA_ITEM* aItem )
    {
        return aItem && aItem->Type() == PCB_DIM_CENTER_T;
    }
 
    EDA_ITEM* Clone() const override;
 
    BITMAPS GetMenuImage() const override;
 
    wxString GetClass() const override
    {
        return wxT( "PCB_DIM_CENTER" );
    }
 
    const BOX2I GetBoundingBox() const override;
 
    const BOX2I ViewBBox() const override;
 
protected:
    virtual void swapData( BOARD_ITEM* aImage ) override;
 
    void updateText() override;
    void updateGeometry() override;
};
 
#endif    // DIMENSION_H