sch_item.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) 2004-2024 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 SCH_ITEM_H
#define SCH_ITEM_H
 
#include <unordered_map>
#include <unordered_set>
#include <map>
#include <set>
 
#include <eda_item.h>
#include <sch_sheet_path.h>
#include <netclass.h>
#include <stroke_params.h>
#include <layer_ids.h>
#include <sch_render_settings.h>
#include <plotters/plotter.h>
 
class CONNECTION_GRAPH;
class SCH_CONNECTION;
class SCH_SHEET_PATH;
class SCHEMATIC;
class SYMBOL;
class LINE_READER;
class SCH_EDIT_FRAME;
class SCH_RULE_AREA;
struct SCH_PLOT_OPTS;
 
namespace KIFONT
{
class METRICS;
}
 
 
enum BODY_STYLE : int
{
 BASE = 1,
 DEMORGAN = 2
};
 
 
#define MINIMUM_SELECTION_DISTANCE 2 // Minimum selection distance in mils
 
 
enum FIELDS_AUTOPLACED
{
 FIELDS_AUTOPLACED_NO = 0,
 FIELDS_AUTOPLACED_AUTO,
 FIELDS_AUTOPLACED_MANUAL
};
 
 
enum DANGLING_END_T
{
 DANGLING_END_UNKNOWN = 0,
 WIRE_END,
 BUS_END,
 JUNCTION_END,
 PIN_END,
 LABEL_END,
 BUS_ENTRY_END,
 WIRE_ENTRY_END,
 SHEET_LABEL_END,
 NO_CONNECT_END,
};
 
 
class DANGLING_END_ITEM
{
public:
 DANGLING_END_ITEM( DANGLING_END_T aType, EDA_ITEM* aItem, const VECTOR2I& aPosition )
 {
 m_item = aItem;
 m_type = aType;
 m_pos = aPosition;
 m_parent = aItem;
 }
 
 DANGLING_END_ITEM( DANGLING_END_T aType, EDA_ITEM* aItem, const VECTOR2I& aPosition,
 const EDA_ITEM* aParent )
 {
 m_item = aItem;
 m_type = aType;
 m_pos = aPosition;
 m_parent = aParent;
 }
 
 bool operator==( const DANGLING_END_ITEM& aB ) const
 {
 return GetItem() == aB.GetItem()
 && GetPosition() == aB.GetPosition()
 && GetType() == aB.GetType()
 && GetParent() == aB.GetParent();
 }
 
 bool operator<( const DANGLING_END_ITEM& rhs ) const
 {
 return( m_pos.x < rhs.m_pos.x || ( m_pos.x == rhs.m_pos.x && m_pos.y < rhs.m_pos.y )
 || ( m_pos == rhs.m_pos && m_item < rhs.m_item ) );
 }
 
 VECTOR2I GetPosition() const { return m_pos; }
 EDA_ITEM* GetItem() const { return m_item; }
 const EDA_ITEM* GetParent() const { return m_parent; }
 DANGLING_END_T GetType() const { return m_type; }
 
private:
 EDA_ITEM* m_item; 
 VECTOR2I m_pos; 
 DANGLING_END_T m_type; 
 const EDA_ITEM* m_parent; 
};
 
 
class DANGLING_END_ITEM_HELPER
{
public:
 static std::vector<DANGLING_END_ITEM>::iterator
 get_lower_pos( std::vector<DANGLING_END_ITEM>& aItemListByPos, const VECTOR2I& aPos );
 
 static std::vector<DANGLING_END_ITEM>::iterator
 get_lower_type( std::vector<DANGLING_END_ITEM>& aItemListByType, const DANGLING_END_T& aType );
 
 static void sort_dangling_end_items( std::vector<DANGLING_END_ITEM>& aItemListByType,
 std::vector<DANGLING_END_ITEM>& aItemListByPos );
};
 
typedef std::vector<SCH_ITEM*> SCH_ITEM_VEC;
 
 
class SCH_ITEM : public EDA_ITEM
{
public:
 SCH_ITEM( EDA_ITEM* aParent, KICAD_T aType, int aUnit = 0, int aBodyStyle = 0 );
 
 SCH_ITEM( const SCH_ITEM& aItem );
 
 SCH_ITEM& operator=( const SCH_ITEM& aPin );
 
 virtual ~SCH_ITEM();
 
 wxString GetClass() const override
 {
 return wxT( "SCH_ITEM" );
 }
 
 bool IsType( const std::vector<KICAD_T>& aScanTypes ) const override
 {
 if( EDA_ITEM::IsType( aScanTypes ) )
 return true;
 
 for( KICAD_T scanType : aScanTypes )
 {
 if( scanType == SCH_ITEM_LOCATE_WIRE_T && m_layer == LAYER_WIRE )
 return true;
 
 if ( scanType == SCH_ITEM_LOCATE_BUS_T && m_layer == LAYER_BUS )
 return true;
 
 if ( scanType == SCH_ITEM_LOCATE_GRAPHIC_LINE_T
 && Type() == SCH_LINE_T && m_layer == LAYER_NOTES )
 {
 return true;
 }
 }
 
 return false;
 }
 
 virtual void SwapData( SCH_ITEM* aItem );
 
 void SwapFlags( SCH_ITEM* aItem );
 
 SCH_ITEM* Duplicate( bool doClone = false ) const;
 
 static wxString GetUnitDescription( int aUnit );
 static wxString GetBodyStyleDescription( int aBodyStyle );
 
 virtual void SetUnit( int aUnit ) { m_unit = aUnit; }
 int GetUnit() const { return m_unit; }
 
 virtual void SetBodyStyle( int aBodyStyle ) { m_bodyStyle = aBodyStyle; }
 int GetBodyStyle() const { return m_bodyStyle; }
 
 void SetPrivate( bool aPrivate ) { m_private = aPrivate; }
 bool IsPrivate() const { return m_private; }
 
 virtual void SetExcludedFromSim( bool aExclude ) { }
 virtual bool GetExcludedFromSim() const { return false; }
 
 virtual bool IsMovableFromAnchorPoint() const { return true; }
 
 VECTOR2I& GetStoredPos() { return m_storedPos; }
 void SetStoredPos( const VECTOR2I& aPos ) { m_storedPos = aPos; }
 
 SCHEMATIC* Schematic() const;
 
 const SYMBOL* GetParentSymbol() const;
 SYMBOL* GetParentSymbol();
 
 virtual bool IsLocked() const { return false; }
 virtual void SetLocked( bool aLocked ) {}
 
 virtual bool IsHypertext() const { return false; }
 
 virtual void DoHypertextAction( EDA_DRAW_FRAME* aFrame ) const { }
 
 SCH_LAYER_ID GetLayer() const { return m_layer; }
 void SetLayer( SCH_LAYER_ID aLayer ) { m_layer = aLayer; }
 
 void ViewGetLayers( int aLayers[], int& aCount ) const override;
 
 virtual int GetPenWidth() const { return 0; }
 
 int GetEffectivePenWidth( const SCH_RENDER_SETTINGS* aSettings ) const;
 
 const wxString& GetDefaultFont() const;
 
 const KIFONT::METRICS& GetFontMetrics() const;
 
 bool RenderAsBitmap( double aWorldScale ) const override;
 
 virtual double Similarity( const SCH_ITEM& aItem ) const
 {
 wxCHECK_MSG( false, 0.0, wxT( "Similarity not implemented in " ) + GetClass() );
 }
 
 double SimilarityBase( const SCH_ITEM& aItem ) const
 {
 double similarity = 1.0;
 
 if( m_unit != aItem.m_unit )
 similarity *= 0.9;
 
 if( m_bodyStyle != aItem.m_bodyStyle )
 similarity *= 0.9;
 
 if( m_private != aItem.m_private )
 similarity *= 0.9;
 
 return similarity;
 }
 
 virtual void Move( const VECTOR2I& aMoveVector )
 {
 wxCHECK_MSG( false, /*void*/, wxT( "Move not implemented in " ) + GetClass() );
 }
 
 virtual void MirrorHorizontally( int aCenter )
 {
 wxCHECK_MSG( false, /*void*/, wxT( "MirrorHorizontally not implemented in " ) + GetClass() );
 }
 
 virtual void MirrorVertically( int aCenter )
 {
 wxCHECK_MSG( false, /*void*/, wxT( "MirrorVertically not implemented in " ) + GetClass() );
 }
 
 virtual void Rotate( const VECTOR2I& aCenter, bool aRotateCCW )
 {
 wxCHECK_MSG( false, /*void*/, wxT( "Rotate not implemented in " ) + GetClass() );
 }
 
 virtual void BeginEdit( const VECTOR2I& aPosition ) {}
 
 virtual bool ContinueEdit( const VECTOR2I& aPosition ) { return false; }
 
 virtual void EndEdit( bool aClosed = false ) {}
 
 virtual void CalcEdit( const VECTOR2I& aPosition ) {}
 
 virtual void GetEndPoints( std::vector< DANGLING_END_ITEM >& aItemList ) {}
 
 virtual bool UpdateDanglingState( std::vector<DANGLING_END_ITEM>& aItemListByType,
 std::vector<DANGLING_END_ITEM>& aItemListByPos,
 const SCH_SHEET_PATH* aSheet = nullptr )
 {
 return false;
 }
 
 virtual bool IsDangling() const { return false; }
 
 virtual bool CanConnect( const SCH_ITEM* aItem ) const { return m_layer == aItem->GetLayer(); }
 
 virtual bool IsConnectable() const { return false; }
 
 virtual bool IsPointClickableAnchor( const VECTOR2I& aPos ) const { return false; }
 
 virtual std::vector<VECTOR2I> GetConnectionPoints() const { return {}; }
 
 bool IsConnected( const VECTOR2I& aPoint ) const;
 
 SCH_CONNECTION* Connection( const SCH_SHEET_PATH* aSheet = nullptr ) const;
 
 const SCH_ITEM_VEC& ConnectedItems( const SCH_SHEET_PATH& aPath );
 
 void AddConnectionTo( const SCH_SHEET_PATH& aPath, SCH_ITEM* aItem );
 
 void ClearConnectedItems( const SCH_SHEET_PATH& aPath );
 
 SCH_CONNECTION* InitializeConnection( const SCH_SHEET_PATH& aPath, CONNECTION_GRAPH* aGraph );
 
 SCH_CONNECTION* GetOrInitConnection( const SCH_SHEET_PATH& aPath, CONNECTION_GRAPH* aGraph );
 
 virtual bool ConnectionPropagatesTo( const EDA_ITEM* aItem ) const { return true; }
 
 bool IsConnectivityDirty() const { return m_connectivity_dirty; }
 
 void SetConnectivityDirty( bool aDirty = true ) { m_connectivity_dirty = aDirty; }
 
 virtual bool HasConnectivityChanges( const SCH_ITEM* aItem,
 const SCH_SHEET_PATH* aInstance = nullptr ) const
 {
 return false;
 }
 
 void SetConnectionGraph( CONNECTION_GRAPH* aGraph );
 
 virtual bool HasCachedDriverName() const { return false; }
 virtual const wxString& GetCachedDriverName() const;
 
 virtual void SetLastResolvedState( const SCH_ITEM* aItem ) { }
 
 std::shared_ptr<NETCLASS> GetEffectiveNetClass( const SCH_SHEET_PATH* aSheet = nullptr ) const;
 
 FIELDS_AUTOPLACED GetFieldsAutoplaced() const { return m_fieldsAutoplaced; }
 
 void SetFieldsAutoplaced() { m_fieldsAutoplaced = FIELDS_AUTOPLACED_AUTO; }
 void ClearFieldsAutoplaced() { m_fieldsAutoplaced = FIELDS_AUTOPLACED_NO; }
 
 void AutoAutoplaceFields( SCH_SCREEN* aScreen )
 {
 if( GetFieldsAutoplaced() )
 AutoplaceFields( aScreen, GetFieldsAutoplaced() == FIELDS_AUTOPLACED_MANUAL );
 }
 
 virtual void AutoplaceFields( SCH_SCREEN* aScreen, bool aManual ) { }
 
 virtual void RunOnChildren( const std::function<void( SCH_ITEM* )>& aFunction ) { }
 
 virtual void ClearCaches();
 
 virtual bool HasLineStroke() const { return false; }
 
 virtual STROKE_PARAMS GetStroke() const { wxCHECK( false, STROKE_PARAMS() ); }
 
 virtual void SetStroke( const STROKE_PARAMS& aStroke ) { wxCHECK( false, /* void */ ); }
 
 virtual void Print( const SCH_RENDER_SETTINGS* aSettings, int aUnit, int aBodyStyle,
 const VECTOR2I& aOffset, bool aForceNoFill, bool aDimmed )
 {
 wxCHECK_MSG( false, /*void*/, wxT( "Print not implemented in " ) + GetClass() );
 }
 
 virtual void PrintBackground( const SCH_RENDER_SETTINGS* aSettings, int aUnit, int aBodyStyle,
 const VECTOR2I& aOffset, bool aDimmed )
 {
 wxCHECK_MSG( false, /*void*/, wxT( "PrintBackground not implemented in " ) + GetClass() );
 }
 
 virtual void Plot( PLOTTER* aPlotter, bool aBackground, const SCH_PLOT_OPTS& aPlotOpts,
 int aUnit, int aBodyStyle, const VECTOR2I& aOffset, bool aDimmed)
 {
 wxCHECK_MSG( false, /*void*/, wxT( "Plot not implemented in " ) + GetClass() );
 }
 
 void ClearRuleAreasCache() { m_rule_areas_cache.clear(); }
 
 void AddRuleAreaToCache( SCH_RULE_AREA* aRuleArea ) { m_rule_areas_cache.insert( aRuleArea ); }
 
 const std::unordered_set<SCH_RULE_AREA*>& GetRuleAreaCache() const
 {
 return m_rule_areas_cache;
 }
 
 enum COMPARE_FLAGS : int
 {
 UNIT = 0x01,
 EQUALITY = 0x02,
 ERC = 0x04,
 SKIP_TST_POS = 0x08
 };
 
 virtual bool operator==( const SCH_ITEM& aOther ) const;
 
 virtual bool operator<( const SCH_ITEM& aItem ) const;
 
protected:
 SCH_RENDER_SETTINGS* getRenderSettings( PLOTTER* aPlotter ) const
 {
 return static_cast<SCH_RENDER_SETTINGS*>( aPlotter->RenderSettings() );
 }
 
 struct cmp_items
 {
 bool operator()( const SCH_ITEM* aFirst, const SCH_ITEM* aSecond ) const;
 };
 
 void getSymbolEditorMsgPanelInfo( EDA_DRAW_FRAME* aFrame, std::vector<MSG_PANEL_ITEM>& aList );
 
 virtual int compare( const SCH_ITEM& aOther, int aCompareFlags = 0 ) const;
 
private:
 friend class CONNECTION_GRAPH;
 
 virtual bool doIsConnected( const VECTOR2I& aPosition ) const { return false; }
 
protected:
 SCH_LAYER_ID m_layer;
 int m_unit; // set to 0 if common to all units
 int m_bodyStyle; // set to 0 if common to all body styles
 bool m_private; // only shown in Symbol Editor
 FIELDS_AUTOPLACED m_fieldsAutoplaced; // indicates status of field autoplacement
 VECTOR2I m_storedPos; // temp variable used in some move commands to store
 // an initial position of the item or mouse cursor
 
 std::map<SCH_SHEET_PATH, SCH_ITEM_VEC, SHEET_PATH_CMP> m_connected_items;
 
 std::unordered_map<SCH_SHEET_PATH, SCH_CONNECTION*> m_connection_map;
 
 bool m_connectivity_dirty;
 
 std::unordered_set<SCH_RULE_AREA*> m_rule_areas_cache;
 
private:
 friend class LIB_SYMBOL;
};
 
#ifndef SWIG
DECLARE_ENUM_TO_WXANY( SCH_LAYER_ID );
#endif
 
#endif /* SCH_ITEM_H */