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 (C) 1992-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 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_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
{
 INCHES,
 MILS,
 MILLIMETRES,
 AUTOMATIC
};
 
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 );
 
 virtual const VECTOR2I& GetStart() const { return m_start; }
 virtual void SetStart( const VECTOR2I& aPoint ) { m_start = aPoint; }
 
 virtual const VECTOR2I& GetEnd() const { return m_end; }
 virtual void SetEnd( const VECTOR2I& aPoint ) { m_end = aPoint; }
 
 VECTOR2I GetPosition() const override { return m_start; }
 void SetPosition( const VECTOR2I& aPos ) override { m_start = aPos; }
 
 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 );
 updateText();
 }
 
 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()
 {
 updateGeometry();
 updateText();
 }
 
 void UpdateUnits()
 {
 SetUnitsMode( GetUnitsMode() );
 updateText();
 }
 
 wxString GetPrefix() const { return m_prefix; }
 void SetPrefix( const wxString& aPrefix );
 
 void ChangePrefix( const wxString& aPrefix )
 {
 SetPrefix( aPrefix );
 updateText();
 }
 
 wxString GetSuffix() const { return m_suffix; }
 void SetSuffix( const wxString& aSuffix );
 
 void ChangeSuffix( const wxString& aSuffix )
 {
 SetSuffix( aSuffix );
 updateText();
 }
 
 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 );
 updateText();
 }
 
 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 );
 updateText();
 }
 
 DIM_PRECISION GetPrecision() const { return m_precision; }
 void SetPrecision( DIM_PRECISION aPrecision ) { m_precision = aPrecision; }
 
 void ChangePrecision( DIM_PRECISION aPrecision )
 {
 SetPrecision( aPrecision );
 updateText();
 }
 
 bool GetSuppressZeroes() const { return m_suppressZeroes; }
 void SetSuppressZeroes( bool aSuppress ) { m_suppressZeroes = aSuppress; }
 
 void ChangeSuppressZeroes( bool aSuppress )
 {
 SetSuppressZeroes( aSuppress );
 updateText();
 }
 
 bool GetKeepTextAligned() const { return m_keepTextAligned; }
 void SetKeepTextAligned( bool aKeepAligned ) { m_keepTextAligned = 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; }
 
 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, bool aFlipLeftRight ) override;
 
 virtual void Mirror( const VECTOR2I& axis_pos, bool aMirrorLeftRight = false );
 
 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;
 
 const BOX2I GetBoundingBox() const override;
 
 std::shared_ptr<SHAPE> GetEffectiveShape( PCB_LAYER_ID aLayer,
 FLASHING aFlash = FLASHING::DEFAULT ) const override;
 
 wxString GetItemDescription( UNITS_PROVIDER* aUnitsProvider ) const override;
 
 const BOX2I ViewBBox() const override;
 
 void ClearRenderCache() 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 BOARD_ITEM& aOther ) 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 );
 
 static OPT_VECTOR2I segPolyIntersection( const SHAPE_POLY_SET& aPoly, const SEG& aSeg,
 bool aStart = true );
 static OPT_VECTOR2I segCircleIntersection( CIRCLE& aCircle, SEG& aSeg, bool aStart = true );
 
 // 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_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; 
};
 
 
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;
 
 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, bool aMirrorLeftRight = false ) 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 );
 updateGeometry();
 }
 
 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 );
 updateGeometry();
 }
 
 double GetAngle() const
 {
 VECTOR2I delta( m_end - m_start );
 
 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;
 
 static inline bool ClassOf( const EDA_ITEM* aItem )
 {
 return aItem && aItem->Type() == PCB_DIM_ORTHOGONAL_T;
 }
 
 EDA_ITEM* Clone() const 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 );
 
 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 );
 updateGeometry();
 }
 
 // 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:
 bool m_isDiameter;
 int m_leaderLength;
};
 
 
class PCB_DIM_LEADER : public PCB_DIMENSION_BASE
{
public:
 PCB_DIM_LEADER( BOARD_ITEM* aParent );
 
 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 );
 updateGeometry();
 }
 
 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 );
 
 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 updateGeometry() override;
};
 
#endif // DIMENSION_H