#include <sch_screen.h>

Inheritance diagram for SCH_SCREEN:

Public Member Functions
	SCH_SCREEN (EDA_ITEM *aParent=nullptr)

	~SCH_SCREEN ()

SCHEMATIC *	Schematic () const

EE_RTREE &	Items ()
	Gets the full RTree, usually for iterating. More...

const EE_RTREE &	Items () const

bool	IsEmpty () const

bool	HasItems (KICAD_T aItemType) const

bool	HasSheets () const

virtual wxString	GetClass () const override
	Return the class name. More...

void	SetFileFormatVersionAtLoad (int aVersion)

int	GetFileFormatVersionAtLoad () const

const PAGE_INFO &	GetPageSettings () const

void	SetPageSettings (const PAGE_INFO &aPageSettings)

void	SetFileName (const wxString &aFileName)
	Set the file name for this screen to aFileName. More...

const wxString &	GetFileName () const

void	SetFileReadOnly (bool aIsReadOnly)

bool	IsReadOnly () const

void	SetFileExists (bool aFileExists)

bool	FileExists () const

const VECTOR2I &	GetAuxOrigin () const

void	SetAuxOrigin (const VECTOR2I &aPosition)

const TITLE_BLOCK &	GetTitleBlock () const

void	SetTitleBlock (const TITLE_BLOCK &aTitleBlock)

void	DecRefCount ()

void	IncRefCount ()

int	GetRefCount () const

void	SetConnectivityDirty ()

std::vector< SCH_SHEET_PATH > &	GetClientSheetPaths ()
	Return the number of times this screen is used. More...

void	Append (SCH_ITEM *aItem, bool aUpdateLibSymbol=true)

void	Append (SCH_SCREEN *aScreen)
	Copy the contents of aScreen into this SCH_SCREEN object. More...

void	Clear (bool aFree=true)
	Delete all draw items and clears the project settings. More...

void	FreeDrawList ()
	Free all the items from the schematic associated with the screen. More...

SCH_ITEM *	GetItem (const VECTOR2I &aPosition, int aAccuracy=0, KICAD_T aType=SCH_LOCATE_ANY_T) const
	Check aPosition within a distance of aAccuracy for items of type aFilter. More...

void	UpdateSymbolLinks (REPORTER *aReporter=nullptr)
	Initialize the LIB_SYMBOL reference for each SCH_SYMBOL found in this schematic from the project SYMBOL_LIB_TABLE. More...

void	UpdateLocalLibSymbolLinks ()
	Initialize the LIB_SYMBOL reference for each SCH_SYMBOL found in this schematic with the local project library symbols. More...

void	Print (const RENDER_SETTINGS *aSettings)
	Print all the items in the screen to aDC. More...

void	Plot (PLOTTER *aPlotter) const
	Plot all the schematic objects to aPlotter. More...

bool	Remove (SCH_ITEM *aItem, bool aUpdateLibSymbol=true)
	Remove aItem from the schematic associated with this screen. More...

void	Update (SCH_ITEM *aItem, bool aUpdateLibSymbol=true)
	Update aItem's bounding box in the tree. More...

void	DeleteItem (SCH_ITEM *aItem)
	Removes aItem from the linked list and deletes the object. More...

bool	CheckIfOnDrawList (const SCH_ITEM *aItem) const

void	TestDanglingEnds (const SCH_SHEET_PATH aPath=nullptr, std::function< void(SCH_ITEM )> *aChangedHandler=nullptr) const
	Test all of the connectable objects in the schematic for unused connection points. More...

std::set< SCH_ITEM * >	MarkConnections (SCH_LINE *aSegment, bool aSecondPass)
	Return all wires and junctions connected to aSegment which are not connected any symbol pin. More...

void	ClearDrawingState ()
	Clear the state flags of all the items in the screen. More...

size_t	CountConnectedItems (const VECTOR2I &aPos, bool aTestJunctions) const

bool	IsJunction (const VECTOR2I &aPosition) const
	Test if a junction is required for the items at aPosition on the screen. More...

bool	IsExplicitJunction (const VECTOR2I &aPosition) const
	Indicates that a junction dot is necessary at the given location. More...

bool	IsExplicitJunctionNeeded (const VECTOR2I &aPosition) const
	Indicates that a junction dot is necessary at the given location, and does not yet exist. More...

TEXT_SPIN_STYLE	GetLabelOrientationForPoint (const VECTOR2I &aPosition, TEXT_SPIN_STYLE aDefaultOrientation, const SCH_SHEET_PATH *aSheet) const

bool	IsExplicitJunctionAllowed (const VECTOR2I &aPosition) const
	Indicates that a juction dot may be placed at the given location. More...

bool	IsTerminalPoint (const VECTOR2I &aPosition, int aLayer) const
	Test if aPosition is a connection point on aLayer. More...

LIB_PIN *	GetPin (const VECTOR2I &aPosition, SCH_SYMBOL **aSymbol=nullptr, bool aEndPointOnly=false) const
	Test the screen for a symbol pin item at aPosition. More...

SCH_SHEET_PIN *	GetSheetPin (const VECTOR2I &aPosition) const
	Test the screen if aPosition is a sheet label object. More...

void	ClearAnnotation (SCH_SHEET_PATH *aSheetPath, bool aResetPrefix)
	Clear the annotation for the symbols in aSheetPath on the screen. More...

void	EnsureAlternateReferencesExist ()
	For screens shared by many sheetpaths (complex hierarchies): to be able to clear or modify any reference related sharing this screen (i.e. More...

void	GetHierarchicalItems (std::vector< SCH_ITEM * > *aItems) const
	Add all schematic sheet and symbol objects in the screen to aItems. More...

void	GetSheets (std::vector< SCH_ITEM * > *aItems) const
	Similar to Items().OfType( SCH_SHEET_T ), but return the sheets in a deterministic order (L-R, T-B) for sheet numbering. More...

SCH_LINE *	GetLine (const VECTOR2I &aPosition, int aAccuracy=0, int aLayer=LAYER_NOTES, SCH_LINE_TEST_T aSearchType=ENTIRE_LENGTH_T) const
	Return a line item located at aPosition. More...

SCH_LINE *	GetWire (const VECTOR2I &aPosition, int aAccuracy=0, SCH_LINE_TEST_T aSearchType=ENTIRE_LENGTH_T) const

SCH_LINE *	GetBus (const VECTOR2I &aPosition, int aAccuracy=0, SCH_LINE_TEST_T aSearchType=ENTIRE_LENGTH_T) const

std::vector< SCH_LINE * >	GetBusesAndWires (const VECTOR2I &aPosition, bool aIgnoreEndpoints=false) const
	Return buses and wires passing through aPosition. More...

std::vector< VECTOR2I >	GetConnections () const
	Collect a unique list of all possible connection points in the schematic. More...

std::vector< VECTOR2I >	GetNeededJunctions (const std::deque< EDA_ITEM * > &aItems) const
	Return the unique set of points belonging to aItems where a junction is needed. More...

SCH_LABEL_BASE *	GetLabel (const VECTOR2I &aPosition, int aAccuracy=0) const
	Return a label item located at aPosition. More...

std::map< wxString, LIB_SYMBOL * > &	GetLibSymbols ()
	Fetch a list of unique LIB_SYMBOL object pointers required to properly render each SCH_SYMBOL in this schematic. More...

const std::map< wxString, LIB_SYMBOL * > &	GetLibSymbols () const

void	AddLibSymbol (LIB_SYMBOL *aLibSymbol)
	Add aLibSymbol to the library symbol map. More...

void	AddBusAlias (std::shared_ptr< BUS_ALIAS > aAlias)
	Add a bus alias definition (and transfers ownership of the pointer). More...

void	ClearBusAliases ()
	Remove all bus alias definitions. More...

std::set< std::shared_ptr< BUS_ALIAS > >	GetBusAliases () const
	Return a list of bus aliases defined in this screen. More...

const std::vector< SCH_SYMBOL_INSTANCE > &	GetSymbolInstances () const

const std::vector< SCH_SHEET_INSTANCE > &	GetSheetInstances () const

const KIID &	GetUuid () const

void	AssignNewUuid ()

void	SetLegacySymbolInstanceData ()
	Update the symbol value and footprint instance data for legacy designs. More...

void	FixLegacyPowerSymbolMismatches ()
	Fix legacy power symbols that have mismatched value text fields and invisible power pin names. More...

bool	AllSymbolDefaultInstancesNotSet ()
	Check all symbol default instance to see if they are not set yet. More...

void	MigrateSimModels ()
	Migrate any symbols having V6 simulation models to their V7 equivalents. More...

void	InitDataPoints (const VECTOR2I &aPageSizeInternalUnits)

void	SetContentModified (bool aModified=true)

bool	IsContentModified () const

int	GetPageCount () const

void	SetPageCount (int aPageCount)

int	GetVirtualPageNumber () const

void	SetVirtualPageNumber (int aPageNumber)

const wxString &	GetPageNumber () const

void	SetPageNumber (const wxString &aPageNumber)

KICAD_T	Type () const
	Returns the type of object. More...

EDA_ITEM *	GetParent () const

virtual void	SetParent (EDA_ITEM *aParent)

bool	IsModified () const

bool	IsNew () const

bool	IsMoving () const

bool	IsSelected () const

bool	IsEntered () const

bool	IsBrightened () const

bool	IsRollover () const

void	SetSelected ()

void	SetBrightened ()

void	ClearSelected ()

void	ClearBrightened ()

void	SetModified ()

int	GetState (EDA_ITEM_FLAGS type) const

void	SetState (EDA_ITEM_FLAGS type, bool state)

EDA_ITEM_FLAGS	GetStatus () const

void	SetStatus (EDA_ITEM_FLAGS aStatus)

void	SetFlags (EDA_ITEM_FLAGS aMask)

void	XorFlags (EDA_ITEM_FLAGS aMask)

void	ClearFlags (EDA_ITEM_FLAGS aMask=EDA_ITEM_ALL_FLAGS)

EDA_ITEM_FLAGS	GetFlags () const

bool	HasFlag (EDA_ITEM_FLAGS aFlag) const

EDA_ITEM_FLAGS	GetEditFlags () const

void	ClearTempFlags ()

void	ClearEditFlags ()

virtual bool	RenderAsBitmap (double aWorldScale) const

void	SetIsShownAsBitmap (bool aBitmap)

bool	IsShownAsBitmap () const

virtual bool	IsType (const std::vector< KICAD_T > &aScanTypes) const
	Check whether the item is one of the listed types. More...

void	SetForceVisible (bool aEnable)
	Set and clear force visible flag used to force the item to be drawn even if it's draw attribute is set to not visible. More...

bool	IsForceVisible () const

virtual void	GetMsgPanelInfo (EDA_DRAW_FRAME *aFrame, std::vector< MSG_PANEL_ITEM > &aList)
	Populate aList of MSG_PANEL_ITEM objects with it's internal state for display purposes. More...

virtual wxString	GetFriendlyName () const

virtual bool	HitTest (const VECTOR2I &aPosition, int aAccuracy=0) const
	Test if aPosition is inside or on the boundary of this item. More...

virtual bool	HitTest (const BOX2I &aRect, bool aContained, int aAccuracy=0) const
	Test if aRect intersects this item. More...

virtual const BOX2I	GetBoundingBox () const
	Return the orthogonal bounding box of this object for display purposes. More...

virtual VECTOR2I	GetPosition () const

virtual void	SetPosition (const VECTOR2I &aPos)

virtual const VECTOR2I	GetFocusPosition () const
	Similar to GetPosition, but allows items to return their visual center rather than their anchor. More...

virtual VECTOR2I	GetSortPosition () const
	Return the coordinates that should be used for sorting this element visually compared to other elements. More...

virtual EDA_ITEM *	Clone () const
	Create a duplicate of this item with linked list members set to NULL. More...

virtual INSPECT_RESULT	Visit (INSPECTOR inspector, void *testData, const std::vector< KICAD_T > &aScanTypes)
	May be re-implemented for each derived class in order to handle all the types given by its member data. More...

wxString	GetTypeDesc () const
	Return a translated description of the type for this EDA_ITEM for display in user facing messages. More...

virtual wxString	GetItemDescription (UNITS_PROVIDER *aUnitsProvider) const
	Return a user-visible description string of this item. More...

virtual BITMAPS	GetMenuImage () const
	Return a pointer to an image to be used in menus. More...

virtual bool	Matches (const EDA_SEARCH_DATA &aSearchData, void *aAuxData) const
	Compare the item against the search criteria in aSearchData. More...

virtual bool	Replace (const EDA_SEARCH_DATA &aSearchData, void *aAuxData=nullptr)
	Perform a text replace using the find and replace criteria in aSearchData on items that support text find and replace. More...

virtual bool	IsReplaceable () const
	Override this method in any derived object that supports test find and replace. More...

bool	operator< (const EDA_ITEM &aItem) const
	Test if another item is less than this object. More...

virtual const BOX2I	ViewBBox () const override
	Return the bounding box of the item covering all its layers. More...

virtual void	ViewGetLayers (int aLayers[], int &aCount) const override
	Return the all the layers within the VIEW the object is painted on. More...

virtual void	ViewDraw (int aLayer, VIEW *aView) const
	Draw the parts of the object belonging to layer aLayer. More...

virtual double	ViewGetLOD (int aLayer, VIEW *aView) const
	Return the level of detail (LOD) of the item. More...

VIEW_ITEM_DATA *	viewPrivData () const

void	ClearViewPrivData ()

bool	Set (PROPERTY_BASE *aProperty, wxAny &aValue)

template<typename T >
bool	Set (PROPERTY_BASE *aProperty, T aValue)

template<typename T >
bool	Set (const wxString &aProperty, T aValue)

wxAny	Get (PROPERTY_BASE *aProperty) const

template<typename T >
T	Get (PROPERTY_BASE *aProperty) const

template<typename T >
std::optional< T >	Get (const wxString &aProperty) const

Static Public Member Functions
static bool	ClassOf (const EDA_ITEM *aItem)

template<class T >
static INSPECT_RESULT	IterateForward (std::deque< T > &aList, INSPECTOR inspector, void *testData, const std::vector< KICAD_T > &scanTypes)
	This changes first parameter to avoid the DList and use the main queue instead. More...

template<class T >
static INSPECT_RESULT	IterateForward (std::vector< T > &aList, INSPECTOR inspector, void *testData, const std::vector< KICAD_T > &scanTypes)
	Change first parameter to avoid the DList and use std::vector instead. More...

static bool	Replace (const EDA_SEARCH_DATA &aSearchData, wxString &aText)
	Perform a text replace on aText using the find and replace criteria in aSearchData on items that support text find and replace. More...

static bool	Sort (const EDA_ITEM aLeft, const EDA_ITEM aRight)
	Helper function to be used by the C++ STL sort algorithm for sorting a STL container of EDA_ITEM pointers. More...

Public Attributes
double	m_LastZoomLevel
	last value for the zoom level, useful in Eeschema when changing the current displayed sheet to reuse the same zoom level when back to the sheet using this screen More...

VECTOR2I	m_DrawOrg
	offsets for drawing the circuit on the screen More...

VECTOR2D	m_LocalOrigin
	Relative Screen cursor coordinate (on grid) in user units. More...

VECTOR2I	m_StartVisu
	Coordinates in drawing units of the current view position (upper left corner of device) More...

bool	m_Center
	Center on screen. More...

VECTOR2D	m_ScrollCenter
	Current scroll center point in logical units. More...

const KIID	m_Uuid

Static Public Attributes
static wxString	m_DrawingSheetFileName
	the name of the drawing sheet file, or empty to use the default drawing sheet More...

Protected Member Functions
bool	Matches (const wxString &aText, const EDA_SEARCH_DATA &aSearchData) const
	Compare aText against search criteria in aSearchData. More...

Protected Attributes
int	m_pageCount
	The number of BASE_SCREEN objects in this design. More...

int	m_virtualPageNumber
	An integer based page number used for printing a range of pages. More...

wxString	m_pageNumber
	A user defined string page number used for printing and plotting. More...

EDA_ITEM_FLAGS	m_status

EDA_ITEM *	m_parent
	Linked list: Link (parent struct) More...

bool	m_forceVisible

EDA_ITEM_FLAGS	m_flags

Private Member Functions
bool	doIsJunction (const VECTOR2I &aPosition, bool aBreakCrossings, bool aHasExplicitJunctionDot, bool aHasBusEntry) const

void	clearLibSymbols ()

size_t	getLibSymbolNameMatches (const SCH_SYMBOL &aSymbol, std::vector< wxString > &aMatches)
	Return a list of potential library symbol matches for aSymbol. More...

Private Attributes
friend	SCH_EDIT_FRAME

friend	SCH_SEXPR_PARSER

friend	SCH_SEXPR_PLUGIN

friend	SCH_ALTIUM_PLUGIN

wxString	m_fileName

int	m_fileFormatVersionAtLoad

int	m_refCount

std::vector< SCH_SHEET_PATH >	m_clientSheetPathList
	The list of sheet paths sharing this screen. More...

PAGE_INFO	m_paper

TITLE_BLOCK	m_titles

VECTOR2I	m_aux_origin

EE_RTREE	m_rtree

int	m_modification_sync

bool	m_zoomInitialized

bool	m_isReadOnly
	Read only status of the screen file. More...

bool	m_fileExists

std::set< std::shared_ptr< BUS_ALIAS > >	m_aliases
	List of bus aliases stored in this screen. More...

std::map< wxString, LIB_SYMBOL * >	m_libSymbols
	Library symbols required for this schematic. More...

std::vector< SCH_SYMBOL_INSTANCE >	m_symbolInstances
	The list of symbol instances loaded from the schematic file. More...

std::vector< SCH_SHEET_INSTANCE >	m_sheetInstances

KIID	m_uuid
	A unique identifier for each schematic file. More...

bool	m_flagModified
	Indicates current drawing has been modified. More...

KICAD_T	m_structType
	Run time identification, keep private so it can never be changed after a ctor sets it. More...

VIEW_ITEM_DATA *	m_viewPrivData

Detailed Description

Definition at line 91 of file sch_screen.h.

Constructor & Destructor Documentation

◆ SCH_SCREEN()

SCH_SCREEN::SCH_SCREEN ( EDA_ITEM * aParent = nullptr )

Definition at line 66 of file sch_screen.cpp.

 :
 BASE_SCREEN( aParent, SCH_SCREEN_T ),
 m_fileFormatVersionAtLoad( 0 ),
 m_paper( wxT( "A4" ) ),
 m_isReadOnly( false ),
 m_fileExists( false )
{
 m_modification_sync = 0;
 m_refCount = 0;
 m_zoomInitialized = false;
 m_LastZoomLevel = 1.0;
 
 // Suitable for schematic only. For symbol_editor and viewlib, must be set to true
 m_Center = false;
 
 InitDataPoints( m_paper.GetSizeIU( schIUScale.IU_PER_MILS ) );
}

References PAGE_INFO::GetSizeIU(), BASE_SCREEN::InitDataPoints(), EDA_IU_SCALE::IU_PER_MILS, BASE_SCREEN::m_Center, m_LastZoomLevel, m_modification_sync, m_paper, m_refCount, m_zoomInitialized, and schIUScale.

◆ ~SCH_SCREEN()

SCH_SCREEN::~SCH_SCREEN ( )

Definition at line 85 of file sch_screen.cpp.

{
 clearLibSymbols();
 FreeDrawList();
}

References clearLibSymbols(), and FreeDrawList().

Member Function Documentation

◆ AddBusAlias()

void SCH_SCREEN::AddBusAlias ( std::shared_ptr< BUS_ALIAS > aAlias )

Add a bus alias definition (and transfers ownership of the pointer).

Definition at line 1557 of file sch_screen.cpp.

{
 m_aliases.insert( aAlias );
}

References m_aliases.

Referenced by CADSTAR_SCH_ARCHIVE_LOADER::loadBusses(), SCH_LEGACY_PLUGIN::LoadContent(), and SCH_SEXPR_PARSER::parseBusAlias().

◆ AddLibSymbol()

void SCH_SCREEN::AddLibSymbol ( LIB_SYMBOL * aLibSymbol )

Add aLibSymbol to the library symbol map.

The symbol is mapped to the result of LIB_ID::Format(). If a symbol is already mapped, the existing symbol is replaced with aLibSymbol. The screen object takes ownership of the pointer.

Parameters

aLibSymbol A pointer the LIB_SYMBOL to be added to the symbol map.

Definition at line 1539 of file sch_screen.cpp.

{
 wxCHECK( aLibSymbol, /* void */ );
 
 wxString libSymbolName = aLibSymbol->GetLibId().Format().wx_str();
 
 auto it = m_libSymbols.find( libSymbolName );
 
 if( it != m_libSymbols.end() )
 {
 delete it->second;
 m_libSymbols.erase( it );
 }
 
 m_libSymbols[libSymbolName] = aLibSymbol;
}

References LIB_ID::Format(), LIB_SYMBOL::GetLibId(), m_libSymbols, and UTF8::wx_str().

Referenced by SCH_SEXPR_PARSER::ParseSchematic().

◆ AllSymbolDefaultInstancesNotSet()

bool SCH_SCREEN::AllSymbolDefaultInstancesNotSet ( )

Check all symbol default instance to see if they are not set yet.

◆ Append() [1/2]

void SCH_SCREEN::Append	(	SCH_ITEM *	aItem,
		bool	aUpdateLibSymbol = `true`
	)

Definition at line 145 of file sch_screen.cpp.

{
 if( aItem->Type() != SCH_SHEET_PIN_T && aItem->Type() != SCH_FIELD_T )
 {
 // Ensure the item can reach the SCHEMATIC through this screen
 aItem->SetParent( this );
 
 if( aItem->Type() == SCH_SYMBOL_T && aUpdateLibSymbol )
 {
 SCH_SYMBOL* symbol = static_cast<SCH_SYMBOL*>( aItem );
 
 if( symbol->GetLibSymbolRef() )
 {
 symbol->GetLibSymbolRef()->GetDrawItems().sort();
 
 auto it = m_libSymbols.find( symbol->GetSchSymbolLibraryName() );
 
 if( it == m_libSymbols.end() || !it->second )
 {
 m_libSymbols[symbol->GetSchSymbolLibraryName()] =
 new LIB_SYMBOL( *symbol->GetLibSymbolRef() );
 }
 else
 {
 // The original library symbol may have changed since the last time
 // it was added to the schematic. If it has changed, then a new name
 // must be created for the library symbol list to prevent all of the
 // other schematic symbols referencing that library symbol from changing.
 LIB_SYMBOL* foundSymbol = it->second;
 
 foundSymbol->GetDrawItems().sort();
 
 if( *foundSymbol != *symbol->GetLibSymbolRef() )
 {
 wxString newName;
 std::vector<wxString> matches;
 
 getLibSymbolNameMatches( *symbol, matches );
 foundSymbol = nullptr;
 
 for( const wxString& libSymbolName : matches )
 {
 it = m_libSymbols.find( libSymbolName );
 
 if( it == m_libSymbols.end() )
 continue;
 
 foundSymbol = it->second;
 
 wxCHECK2( foundSymbol, continue );
 
 if( *foundSymbol == *symbol->GetLibSymbolRef() )
 {
 newName = libSymbolName;
 break;
 }
 
 foundSymbol = nullptr;
 }
 
 if( !foundSymbol )
 {
 int cnt = 1;
 
 newName.Printf( wxT( "%s_%d" ),
 symbol->GetLibId().GetUniStringLibItemName(),
 cnt );
 
 while( m_libSymbols.find( newName ) != m_libSymbols.end() )
 {
 cnt += 1;
  newName.Printf( wxT( "%s_%d" ),
 symbol->GetLibId().GetUniStringLibItemName(),
 cnt );
 }
 }
 
 // Update the schematic symbol library link as this symbol only exists
 // in the schematic.
 symbol->SetSchSymbolLibraryName( newName );
 
 if( !foundSymbol )
 {
 // Update the schematic symbol library link as this symbol does not
 // exist in any symbol library.
 LIB_ID newLibId( wxEmptyString, newName );
 LIB_SYMBOL* newLibSymbol = new LIB_SYMBOL( *symbol->GetLibSymbolRef() );
 
 newLibSymbol->SetLibId( newLibId );
 newLibSymbol->SetName( newName );
 symbol->SetLibSymbol( newLibSymbol->Flatten().release() );
 m_libSymbols[newName] = newLibSymbol;
 }
 }
 }
 }
 }
 
 m_rtree.insert( aItem );
 --m_modification_sync;
 }
}

References LIB_SYMBOL::Flatten(), LIB_SYMBOL::GetDrawItems(), SCH_SYMBOL::GetLibId(), getLibSymbolNameMatches(), SCH_SYMBOL::GetLibSymbolRef(), SCH_SYMBOL::GetSchSymbolLibraryName(), LIB_ID::GetUniStringLibItemName(), EE_RTREE::insert(), m_libSymbols, m_modification_sync, m_rtree, SCH_FIELD_T, SCH_SHEET_PIN_T, SCH_SYMBOL_T, LIB_SYMBOL::SetLibId(), SCH_SYMBOL::SetLibSymbol(), LIB_SYMBOL::SetName(), EDA_ITEM::SetParent(), SCH_SYMBOL::SetSchSymbolLibraryName(), MULTIVECTOR< T, FIRST_TYPE_VAL, LAST_TYPE_VAL >::sort(), and EDA_ITEM::Type().

◆ Append() [2/2]

void SCH_SCREEN::Append ( SCH_SCREEN * aScreen )

Copy the contents of aScreen into this SCH_SCREEN object.

Warning: The contents of Screen cannot contain any duplicate sheet names or any hierarchy recursion issues or bad things will happen.

Parameters

aScreen is the screen to append to this one.

Returns: false if there are any duplicate sheet names or any hierarchy recursion issues the calling this method or KiCad will crash.

Definition at line 249 of file sch_screen.cpp.

{
 wxCHECK_RET( aScreen, "Invalid screen object." );
 
 // No need to descend the hierarchy. Once the top level screen is copied, all of its
 // children are copied as well.
 for( SCH_ITEM* aItem : aScreen->m_rtree )
 Append( aItem );
 
 aScreen->Clear( false );
}

References Append(), Clear(), and m_rtree.

◆ AssignNewUuid()

void SCH_SCREEN::AssignNewUuid ( )

inline

Definition at line 528 of file sch_screen.h.

528{ m_uuid = KIID(); }

KIID

Definition: kiid.h:48

SCH_SCREEN::m_uuid

KIID m_uuid

A unique identifier for each schematic file.

Definition: sch_screen.h:648

References m_uuid.

Referenced by SCH_EDIT_FRAME::SaveProject().

◆ CheckIfOnDrawList()

bool SCH_SCREEN::CheckIfOnDrawList ( const SCH_ITEM * aItem ) const

Definition at line 370 of file sch_screen.cpp.

{
 return m_rtree.contains( aItem, true );
}

References EE_RTREE::contains(), and m_rtree.

Referenced by SCH_EDIT_FRAME::AddItemToScreenAndUndoList().

◆ ClassOf()

bool SCH_SCREEN::ClassOf ( const EDA_ITEM * aItem )

static

Definition at line 139 of file sch_screen.cpp.

{
 return aItem && SCH_SCREEN_T == aItem->Type();
}

References SCH_SCREEN_T, and EDA_ITEM::Type().

◆ Clear()

void SCH_SCREEN::Clear ( bool aFree = true )

Delete all draw items and clears the project settings.

Definition at line 262 of file sch_screen.cpp.

{
 if( aFree )
 {
 FreeDrawList();
 clearLibSymbols();
 }
 else
 {
 m_rtree.clear();
 }
 
 // Clear the project settings
 m_virtualPageNumber = m_pageCount = 1;
 
 m_titles.Clear();
}

References EE_RTREE::clear(), TITLE_BLOCK::Clear(), clearLibSymbols(), FreeDrawList(), BASE_SCREEN::m_pageCount, m_rtree, m_titles, and BASE_SCREEN::m_virtualPageNumber.

Referenced by Append(), SCH_EDIT_FRAME::doCloseWindow(), and SCH_EDITOR_CONTROL::Paste().

◆ ClearAnnotation()

void SCH_SCREEN::ClearAnnotation	(	SCH_SHEET_PATH *	aSheetPath,
		bool	aResetPrefix
	)

Clear the annotation for the symbols in aSheetPath on the screen.

Parameters

[in]	aSheetPath	The sheet path of the symbol annotation to clear. If NULL then the entire hierarchy is cleared.
[in]	aResetPrefix	The annotation prefix ('R', 'U', etc.) should be reset to the symbol library prefix.

Definition at line 1293 of file sch_screen.cpp.

{
 
 for( SCH_ITEM* item : Items().OfType( SCH_SYMBOL_T ) )
 {
 SCH_SYMBOL* symbol = static_cast<SCH_SYMBOL*>( item );
 
 symbol->ClearAnnotation( aSheetPath, aResetPrefix );
 }
}

References SCH_SYMBOL::ClearAnnotation(), Items(), and SCH_SYMBOL_T.

Referenced by SCH_SCREENS::ClearAnnotationOfNewSheetPaths(), and SCH_EDIT_TOOL::Properties().

◆ ClearBrightened()

void EDA_ITEM::ClearBrightened ( )

inlineinherited

Definition at line 119 of file eda_item.h.

119{ ClearFlags( BRIGHTENED ); }

EDA_ITEM::ClearFlags

void ClearFlags(EDA_ITEM_FLAGS aMask=EDA_ITEM_ALL_FLAGS)

Definition: eda_item.h:141

BRIGHTENED

#define BRIGHTENED

item is drawn with a bright contour

Definition: eda_item_flags.h:65

References BRIGHTENED, and EDA_ITEM::ClearFlags().

Referenced by SCH_EDIT_FRAME::FocusOnItem(), PCB_BASE_FRAME::FocusOnItems(), EE_SELECTION_TOOL::unhighlight(), PL_SELECTION_TOOL::unhighlight(), PCB_SELECTION_TOOL::unhighlightInternal(), and SCH_EDITOR_CONTROL::UpdateNetHighlighting().

◆ ClearBusAliases()

void SCH_SCREEN::ClearBusAliases ( )

inline

Remove all bus alias definitions.

Definition at line 503 of file sch_screen.h.

 {
 m_aliases.clear();
 }

References m_aliases.

◆ ClearDrawingState()

void SCH_SCREEN::ClearDrawingState ( )

Clear the state flags of all the items in the screen.

Definition at line 1206 of file sch_screen.cpp.

{
 for( SCH_ITEM* item : Items() )
 item->ClearTempFlags();
}

References Items().

Referenced by SCH_EDIT_FRAME::OpenProjectFiles(), and EE_SELECTION_TOOL::SelectConnection().

◆ ClearEditFlags()

void EDA_ITEM::ClearEditFlags ( )

inlineinherited

Definition at line 158 of file eda_item.h.

 {
 ClearFlags( GetEditFlags() );
 }

References EDA_ITEM::ClearFlags(), and EDA_ITEM::GetEditFlags().

Referenced by BOARD::Add(), FOOTPRINT::Add(), SCH_EDIT_FRAME::AddItemToScreenAndUndoList(), SCH_DRAWING_TOOLS::DrawShape(), SYMBOL_EDITOR_DRAWING_TOOLS::DrawShape(), SCH_LINE_WIRE_BUS_TOOL::finishSegments(), PL_DRAWING_TOOLS::PlaceItem(), SCH_DRAWING_TOOLS::PlaceSymbol(), SCH_EDIT_FRAME::PutDataInPreviousState(), PCB_BASE_EDIT_FRAME::saveCopyInUndoList(), and SYMBOL_EDITOR_DRAWING_TOOLS::TwoClickPlace().

◆ ClearFlags()

void EDA_ITEM::ClearFlags ( EDA_ITEM_FLAGS aMask = EDA_ITEM_ALL_FLAGS )

inlineinherited

Definition at line 141 of file eda_item.h.

141{ m_flags &= ~aMask; }

EDA_ITEM::m_flags

EDA_ITEM_FLAGS m_flags

Definition: eda_item.h:498

References EDA_ITEM::m_flags.

Referenced by FOOTPRINT_VIEWER_FRAME::AddFootprintToPCB(), PNS_KICAD_IFACE::AddItem(), SCH_EDIT_FRAME::AddItemToScreenAndUndoList(), SCH_MOVE_TOOL::AlignElements(), SCH_EDIT_TOOL::BreakWire(), FOOTPRINT::BuildCourtyardCaches(), EDA_ITEM::ClearBrightened(), EDA_ITEM::ClearEditFlags(), EDA_ITEM::ClearSelected(), EDA_ITEM::ClearTempFlags(), SCH_EDIT_FRAME::ConvertPart(), SYMBOL_EDITOR_EDIT_TOOL::Copy(), FOOTPRINT_EDITOR_CONTROL::CreateFootprint(), SYMBOL_EDITOR_PIN_TOOL::CreateImagePins(), MICROWAVE_TOOL::createMicrowaveInductor(), DIALOG_PAD_PROPERTIES::DIALOG_PAD_PROPERTIES(), BOARD_COMMIT::dirtyIntersectingZones(), PCB_TOOL_BASE::doInteractiveItemPlacement(), KIGFX::SCH_PAINTER::draw(), SCH_ITEM::Duplicate(), SYMBOL_EDITOR_EDIT_TOOL::Duplicate(), PCB_EDIT_FRAME::ExchangeFootprint(), PCB_SELECTION_TOOL::ExitGroup(), SYMBOL_EDIT_FRAME::GetSymbolFromRedoList(), SYMBOL_EDIT_FRAME::GetSymbolFromUndoList(), FOOTPRINT_EDITOR_CONTROL::ImportFootprint(), DRC_INTERACTIVE_COURTYARD_CLEARANCE::Init(), EE_COLLECTOR::Inspect(), FOOTPRINT_EDIT_FRAME::LoadFootprintFromBoard(), FOOTPRINT_EDIT_FRAME::LoadFootprintFromLibrary(), FOOTPRINT_EDITOR_CONTROL::NewFootprint(), DIALOG_SYMBOL_PROPERTIES::OnUnitChoice(), FOOTPRINT_EDIT_FRAME::OpenProjectFiles(), PCB_BASE_FRAME::PlaceFootprint(), SYMBOL_EDITOR_PIN_TOOL::PlacePin(), BOARD_COMMIT::Push(), PCB_SELECTION_TOOL::RebuildSelection(), PAD_TOOL::RecombinePad(), SCH_EDIT_TOOL::RepeatDrawItem(), SYMBOL_EDIT_FRAME::RollbackSymbolFromUndo(), DRC_TEST_PROVIDER_DISALLOW::Run(), FOOTPRINT_EDIT_FRAME::SaveFootprintToBoard(), SCH_SEXPR_PLUGIN_CACHE::savePin(), EE_SELECTION_TOOL::selectMultiple(), SCH_EDIT_FRAME::SelectUnit(), EDA_ITEM::SetIsShownAsBitmap(), BOARD_COMMIT::Stage(), DIALOG_SYMBOL_PROPERTIES::TransferDataFromWindow(), SCH_DRAWING_TOOLS::TwoClickPlace(), and EE_SELECTION_TOOL::unhighlight().

◆ clearLibSymbols()

void SCH_SCREEN::clearLibSymbols ( )

private

Definition at line 101 of file sch_screen.cpp.

{
 for( const std::pair<const wxString, LIB_SYMBOL*>& libSymbol : m_libSymbols )
 delete libSymbol.second;
 
 m_libSymbols.clear();
}

References m_libSymbols.

Referenced by Clear(), UpdateSymbolLinks(), and ~SCH_SCREEN().

◆ ClearSelected()

void EDA_ITEM::ClearSelected ( )

inlineinherited

Definition at line 118 of file eda_item.h.

118{ ClearFlags( SELECTED ); }

SELECTED

#define SELECTED

Item was manually selected by the user.

Definition: eda_item_flags.h:47

References EDA_ITEM::ClearFlags(), and SELECTED.

Referenced by PCB_POINT_EDITOR::addCorner(), EDIT_TOOL::Duplicate(), ARRAY_CREATOR::Invoke(), LIB_SYMBOL::LIB_SYMBOL(), EE_TOOL_BASE< T >::saveCopyInUndoList(), SCH_DRAWING_TOOLS::TwoClickPlace(), EE_SELECTION_TOOL::unhighlight(), PL_SELECTION_TOOL::unhighlight(), PCB_SELECTION_TOOL::unhighlightInternal(), and GERBVIEW_SELECTION_TOOL::unselectVisually().

◆ ClearTempFlags()

void EDA_ITEM::ClearTempFlags ( )

inlineinherited

Definition at line 153 of file eda_item.h.

 {
 ClearFlags( CANDIDATE | SELECTED_BY_DRAG | IS_LINKED | SKIP_STRUCT );
 }

References CANDIDATE, EDA_ITEM::ClearFlags(), IS_LINKED, SELECTED_BY_DRAG, and SKIP_STRUCT.

Referenced by PCB_EDIT_FRAME::OpenProjectFiles(), and SCH_EDIT_FRAME::PutDataInPreviousState().

◆ ClearViewPrivData()

void KIGFX::VIEW_ITEM::ClearViewPrivData ( )

inlineinherited

Definition at line 143 of file view_item.h.

 {
 m_viewPrivData = nullptr;
 }

References KIGFX::VIEW_ITEM::m_viewPrivData.

Referenced by KIGFX::VIEW::OnDestroy().

◆ Clone()

EDA_ITEM * EDA_ITEM::Clone ( ) const

virtualinherited

Create a duplicate of this item with linked list members set to NULL.

The default version will return NULL in release builds and likely crash the program. In debug builds, a warning message indicating the derived class has not implemented cloning. This really should be a pure virtual function. Due to the fact that there are so many objects derived from EDA_ITEM, the decision was made to return NULL until all the objects derived from EDA_ITEM implement cloning. Once that happens, this function should be made pure.

Returns: A clone of the item.

Reimplemented in LIB_FIELD, LIB_PIN, LIB_SHAPE, LIB_TEXT, LIB_TEXTBOX, SCH_BITMAP, SCH_BUS_WIRE_ENTRY, SCH_BUS_BUS_ENTRY, SCH_FIELD, SCH_JUNCTION, SCH_LABEL, SCH_DIRECTIVE_LABEL, SCH_GLOBALLABEL, SCH_HIERLABEL, SCH_LINE, SCH_MARKER, SCH_NO_CONNECT, SCH_PIN, SCH_SHAPE, SCH_SHEET, SCH_SHEET_PIN, SCH_SYMBOL, SCH_TEXT, SCH_TEXTBOX, KIGFX::ORIGIN_VIEWITEM, PCB_GROUP, FOOTPRINT, FP_SHAPE, FP_TEXT, FP_TEXTBOX, NETINFO_ITEM, PAD, PCB_BITMAP, PCB_DIM_ALIGNED, PCB_DIM_ORTHOGONAL, PCB_DIM_RADIAL, PCB_DIM_LEADER, PCB_DIM_CENTER, PCB_MARKER, PCB_SHAPE, PCB_TARGET, PCB_TEXT, PCB_TEXTBOX, PCB_TRACK, PCB_ARC, PCB_VIA, ZONE, and FP_ZONE.

Definition at line 82 of file eda_item.cpp.

{
 wxCHECK_MSG( false, nullptr, wxT( "Clone not implemented in derived class " ) + GetClass() +
 wxT( ". Bad programmer!" ) );
}

References EDA_ITEM::GetClass().

Referenced by SCH_EDIT_FRAME::AddCopyForRepeatItem(), BOARD_ITEM::Duplicate(), SCH_ITEM::Duplicate(), SYMBOL_EDITOR_EDIT_TOOL::Duplicate(), LIB_SYMBOL::LIB_SYMBOL(), BOARD_COMMIT::makeImage(), new_clone(), LIB_SYMBOL::operator=(), SYMBOL_EDITOR_EDIT_TOOL::Paste(), SCH_LIB_PLUGIN_CACHE::removeSymbol(), PCB_BASE_EDIT_FRAME::saveCopyInUndoList(), CLIPBOARD_IO::SaveSelection(), LIB_SYMBOL::SetConversion(), LIB_SYMBOL::SetUnitCount(), SCH_DRAWING_TOOLS::SingleClickPlace(), SCH_DRAWING_TOOLS::TwoClickPlace(), and SYMBOL_EDITOR_DRAWING_TOOLS::TwoClickPlace().

◆ CountConnectedItems()

size_t SCH_SCREEN::CountConnectedItems	(	const VECTOR2I &	aPos,
		bool	aTestJunctions
	)		const

Definition at line 1279 of file sch_screen.cpp.

{
 size_t count = 0;
 
 for( const SCH_ITEM* item : Items().Overlapping( aPos ) )
 {
 if( ( item->Type() != SCH_JUNCTION_T || aTestJunctions ) && item->IsConnected( aPos ) )
 count++;
 }
 
 return count;
}

References Items(), and SCH_JUNCTION_T.

◆ DecRefCount()

void SCH_SCREEN::DecRefCount ( )

Definition at line 124 of file sch_screen.cpp.

{
 wxCHECK_RET( m_refCount != 0, wxT( "Screen reference count already zero. Bad programmer!" ) );
 m_refCount--;
}

References m_refCount.

Referenced by SCH_SHEET::SetScreen(), and SCH_SHEET::~SCH_SHEET().

◆ DeleteItem()

void SCH_SCREEN::DeleteItem ( SCH_ITEM * aItem )

Removes aItem from the linked list and deletes the object.

If aItem is a schematic sheet label, it is removed from the screen associated with the sheet that contains the label to be deleted.

Parameters

[in] aItem The schematic object to be deleted from the screen.

Definition at line 345 of file sch_screen.cpp.

{
 wxCHECK_RET( aItem, wxT( "Cannot delete invalid item from screen." ) );
 
 // Markers are not saved in the file, no need to flag as modified.
 // TODO: Maybe we should have a listing somewhere of items that aren't saved?
 if( aItem->Type() != SCH_MARKER_T )
 SetContentModified();
 
 Remove( aItem );
 
 if( aItem->Type() == SCH_SHEET_PIN_T )
 {
 // This structure is attached to a sheet, get the parent sheet object.
 SCH_SHEET_PIN* sheetPin = (SCH_SHEET_PIN*) aItem;
 SCH_SHEET* sheet = sheetPin->GetParent();
 wxCHECK_RET( sheet, wxT( "Sheet pin parent not properly set, bad programmer!" ) );
 sheet->RemovePin( sheetPin );
 return;
 }
 
 delete aItem;
}

References SCH_SHEET_PIN::GetParent(), Remove(), SCH_SHEET::RemovePin(), SCH_MARKER_T, SCH_SHEET_PIN_T, BASE_SCREEN::SetContentModified(), and EDA_ITEM::Type().

◆ doIsJunction()

bool SCH_SCREEN::doIsJunction	(	const VECTOR2I &	aPosition,
		bool	aBreakCrossings,
		bool *	aHasExplicitJunctionDot,
		bool *	aHasBusEntry
	)		const

private

Definition at line 716 of file sch_screen.cpp.

{
 enum layers { WIRES = 0, BUSES };
 
 *aHasExplicitJunctionDot = false;
 *aHasBusEntry = false;
 
 bool breakLines[ 2 ] = { false };
 std::unordered_set<int> exitAngles[ 2 ];
 std::vector<const SCH_LINE*> midPointLines[ 2 ];
 
 // A pin at 90° still shouldn't match a line at 90° so just give pins unique numbers
 int uniqueAngle = 10000;
 
 for( const SCH_ITEM* item : Items().Overlapping( aPosition ) )
 {
 if( item->GetEditFlags() & STRUCT_DELETED )
 continue;
 
 switch( item->Type() )
 {
 case SCH_JUNCTION_T:
 if( item->HitTest( aPosition, -1 ) )
 *aHasExplicitJunctionDot = true;
 
 break;
 
 case SCH_LINE_T:
 {
 const SCH_LINE* line = static_cast<const SCH_LINE*>( item );
 int layer;
 
 if( line->GetStartPoint() == line->GetEndPoint() )
 break;
 else if( line->GetLayer() == LAYER_WIRE )
 layer = WIRES;
 else if( line->GetLayer() == LAYER_BUS )
 layer = BUSES;
 else
 break;
 
 if( line->IsConnected( aPosition ) )
 {
 breakLines[ layer ] = true;
 exitAngles[ layer ].insert( line->GetAngleFrom( aPosition ) );
 }
 else if( line->HitTest( aPosition, -1 ) )
 {
 if( aBreakCrossings )
 breakLines[ layer ] = true;
 
 // Defer any line midpoints until we know whether or not we're breaking them
 midPointLines[ layer ].push_back( line );
 }
 }
 break;
 
 case SCH_BUS_WIRE_ENTRY_T:
 if( item->IsConnected( aPosition ) )
 {
 breakLines[ BUSES ] = true;
 exitAngles[ BUSES ].insert( uniqueAngle++ );
 breakLines[ WIRES ] = true;
 exitAngles[ WIRES ].insert( uniqueAngle++ );
 *aHasBusEntry = true;
 }
 
 break;
 
 case SCH_SYMBOL_T:
 case SCH_SHEET_T:
 if( item->IsConnected( aPosition ) )
 {
 breakLines[ WIRES ] = true;
 exitAngles[ WIRES ].insert( uniqueAngle++ );
 }
 
 break;
 
 default:
 break;
 }
 }
 
 for( int layer : { WIRES, BUSES } )
 {
 if( breakLines[ layer ] )
 {
 for( const SCH_LINE* line : midPointLines[ layer ] )
 {
 exitAngles[ layer ].insert( line->GetAngleFrom( aPosition ) );
 exitAngles[ layer ].insert( line->GetReverseAngleFrom( aPosition ) );
 }
 }
 }
 
 return exitAngles[ WIRES ].size() >= 3 || exitAngles[ BUSES ].size() >= 3;
}

References SCH_LINE::GetAngleFrom(), SCH_LINE::GetEndPoint(), SCH_ITEM::GetLayer(), SCH_LINE::GetStartPoint(), SCH_LINE::HitTest(), SCH_ITEM::IsConnected(), Items(), LAYER_BUS, LAYER_WIRE, SCH_BUS_WIRE_ENTRY_T, SCH_JUNCTION_T, SCH_LINE_T, SCH_SHEET_T, SCH_SYMBOL_T, and STRUCT_DELETED.

Referenced by IsExplicitJunction(), IsExplicitJunctionAllowed(), IsExplicitJunctionNeeded(), and IsJunction().

◆ EnsureAlternateReferencesExist()

void SCH_SCREEN::EnsureAlternateReferencesExist ( )

For screens shared by many sheetpaths (complex hierarchies): to be able to clear or modify any reference related sharing this screen (i.e.

the list of symbols), an entry for each screen path must exist. This function creates missing entries, using as default reference the current reference field and unit number Note: m_clientSheetPathList must be up to date ( built by SCH_SCREENS::BuildClientSheetPathList() )

Definition at line 1305 of file sch_screen.cpp.

{
 if( GetClientSheetPaths().size() <= 1 ) // No need for alternate reference
 return;
 
 for( SCH_ITEM* item : Items().OfType( SCH_SYMBOL_T ) )
 {
 SCH_SYMBOL* symbol = static_cast<SCH_SYMBOL*>( item );
 
 // Add (when not existing) all sheet path entries
 for( const SCH_SHEET_PATH& sheet : GetClientSheetPaths() )
 symbol->AddSheetPathReferenceEntryIfMissing( sheet.Path() );
 }
}

References SCH_SYMBOL::AddSheetPathReferenceEntryIfMissing(), GetClientSheetPaths(), Items(), and SCH_SYMBOL_T.

Referenced by SCH_SCREENS::ClearAnnotationOfNewSheetPaths().

◆ FileExists()

bool SCH_SCREEN::FileExists ( ) const

inline

Definition at line 150 of file sch_screen.h.

150{ return m_fileExists; }

References m_fileExists.

Referenced by SCH_EDIT_FRAME::updateTitle().

◆ FixLegacyPowerSymbolMismatches()

void SCH_SCREEN::FixLegacyPowerSymbolMismatches ( )

Fix legacy power symbols that have mismatched value text fields and invisible power pin names.

Definition at line 1579 of file sch_screen.cpp.

{
 for( SCH_ITEM* item : Items().OfType( SCH_SYMBOL_T ) )
 {
 SCH_SYMBOL* symbol = static_cast<SCH_SYMBOL*>( item );
 
 // Fix pre-8.0 legacy power symbols with invisible pins
 // that have mismatched pin names and value fields
 if( symbol->GetLibSymbolRef()
 && symbol->GetLibSymbolRef()->IsPower()
 && symbol->GetAllLibPins().size() > 0
 && symbol->GetAllLibPins()[0]->IsGlobalPower()
 && !symbol->GetAllLibPins()[0]->IsVisible() )
 {
 symbol->SetValueFieldText( symbol->GetAllLibPins()[0]->GetName() );
 }
 }
}

References SCH_SYMBOL::GetAllLibPins(), SCH_SYMBOL::GetLibSymbolRef(), Items(), SCH_SYMBOL_T, and SCH_SYMBOL::SetValueFieldText().

◆ FreeDrawList()

void SCH_SCREEN::FreeDrawList ( )

Free all the items from the schematic associated with the screen.

This does not delete any sub hierarchies.

Definition at line 281 of file sch_screen.cpp.

{
 // We don't know which order we will encounter dependent items (e.g. pins or fields), so
 // we store the items to be deleted until we've fully cleared the tree before deleting
 std::vector<SCH_ITEM*> delete_list;
 
 std::copy_if( m_rtree.begin(), m_rtree.end(), std::back_inserter( delete_list ),
 []( SCH_ITEM* aItem )
 {
 return ( aItem->Type() != SCH_SHEET_PIN_T && aItem->Type() != SCH_FIELD_T );
 } );
 
 m_rtree.clear();
 
 for( SCH_ITEM* item : delete_list )
 delete item;
}

References EE_RTREE::begin(), EE_RTREE::clear(), EE_RTREE::end(), and m_rtree.

Referenced by Clear(), and ~SCH_SCREEN().

◆ Get() [1/3]

template<typename T >

std::optional< T > INSPECTABLE::Get ( const wxString & aProperty ) const

inlineinherited

Definition at line 104 of file inspectable.h.

 {
 PROPERTY_MANAGER& propMgr = PROPERTY_MANAGER::Instance();
 TYPE_ID thisType = TYPE_HASH( *this );
 PROPERTY_BASE* prop = propMgr.GetProperty( thisType, aProperty );
 std::optional<T> ret;
 
 if( prop )
 {
 const void* object = propMgr.TypeCast( this, thisType, prop->OwnerHash() );
 
 if( object )
 ret = prop->get<T>( object );
 }
 
 return ret;
 }

References PROPERTY_BASE::get(), PROPERTY_MANAGER::GetProperty(), PROPERTY_MANAGER::Instance(), PROPERTY_BASE::OwnerHash(), TYPE_HASH, and PROPERTY_MANAGER::TypeCast().

◆ Get() [2/3]

wxAny INSPECTABLE::Get ( PROPERTY_BASE * aProperty ) const

inlineinherited

Definition at line 84 of file inspectable.h.

 {
 PROPERTY_MANAGER& propMgr = PROPERTY_MANAGER::Instance();
 const void* object = propMgr.TypeCast( this, TYPE_HASH( *this ), aProperty->OwnerHash() );
 return object ? aProperty->getter( object ) : wxAny();
 }

References PROPERTY_BASE::getter(), PROPERTY_MANAGER::Instance(), PROPERTY_BASE::OwnerHash(), TYPE_HASH, and PROPERTY_MANAGER::TypeCast().

Referenced by BOOST_AUTO_TEST_CASE(), CLASS_D_DESC::CLASS_D_DESC(), EDA_SHAPE_DESC::EDA_SHAPE_DESC(), PROPERTIES_PANEL::getItemValue(), PCB_EXPR_VAR_REF::GetValue(), and PAD_DESC::PAD_DESC().

◆ Get() [3/3]

template<typename T >

T INSPECTABLE::Get ( PROPERTY_BASE * aProperty ) const

inlineinherited

Definition at line 92 of file inspectable.h.

 {
 PROPERTY_MANAGER& propMgr = PROPERTY_MANAGER::Instance();
 const void* object = propMgr.TypeCast( this, TYPE_HASH( *this ), aProperty->OwnerHash() );
 
 if( !object )
 throw std::runtime_error( "Could not cast INSPECTABLE to the requested type" );
 
 return aProperty->get<T>( object );
 }

References PROPERTY_BASE::get(), PROPERTY_MANAGER::Instance(), PROPERTY_BASE::OwnerHash(), TYPE_HASH, and PROPERTY_MANAGER::TypeCast().

◆ GetAuxOrigin()

const VECTOR2I & SCH_SCREEN::GetAuxOrigin ( ) const

inline

Definition at line 152 of file sch_screen.h.

152{ return m_aux_origin; }

SCH_SCREEN::m_aux_origin

VECTOR2I m_aux_origin

Definition: sch_screen.h:605

References m_aux_origin.

◆ GetBoundingBox()

const BOX2I EDA_ITEM::GetBoundingBox ( ) const

virtualinherited

Return the orthogonal bounding box of this object for display purposes.

This box should be an enclosing perimeter for visible components of this object, and the units should be in the pcb or schematic coordinate system. It is OK to overestimate the size by a few counts.

Reimplemented in LIB_FIELD, LIB_ITEM, LIB_PIN, LIB_SHAPE, LIB_SYMBOL, LIB_TEXT, SCH_BITMAP, SCH_BUS_ENTRY_BASE, SCH_FIELD, SCH_JUNCTION, SCH_LABEL_BASE, SCH_LINE, SCH_MARKER, SCH_NO_CONNECT, SCH_PIN, SCH_SHAPE, SCH_SHEET, SCH_SYMBOL, SCH_TEXT, GBR_LAYOUT, GERBER_DRAW_ITEM, DS_DRAW_ITEM_LINE, DS_DRAW_ITEM_POLYPOLYGONS, DS_DRAW_ITEM_RECT, DS_DRAW_ITEM_PAGE, DS_DRAW_ITEM_TEXT, DS_DRAW_ITEM_BITMAP, PCB_GROUP, BOARD, FOOTPRINT, FP_TEXT, NETINFO_ITEM, PAD, PCB_BITMAP, PCB_DIMENSION_BASE, PCB_DIM_CENTER, PCB_MARKER, PCB_SHAPE, PCB_TARGET, PCB_TEXT, PCB_TRACK, ZONE, and DS_DRAW_ITEM_BASE.

Definition at line 74 of file eda_item.cpp.

{
 // return a zero-sized box per default. derived classes should override
 // this
 return BOX2I( VECTOR2I( 0, 0 ), VECTOR2I( 0, 0 ) );
}

Referenced by CADSTAR_SCH_ARCHIVE_LOADER::applyTextSettings(), CN_ITEM::BBox(), SCH_EDIT_TOOL::ChangeTextType(), TEST_BOARD_ITEM_FIXTURE::CompareItems(), TEST_EE_ITEM_FIXTURE::CompareItems(), EE_RTREE::contains(), BOARD_COMMIT::dirtyIntersectingZones(), KIGFX::SCH_PAINTER::draw(), KIGFX::PCB_PAINTER::Draw(), SCH_DRAWING_TOOLS::DrawSheet(), enclosedByAreaFunc(), PCB_SELECTION_TOOL::FindItem(), SCH_FIND_REPLACE_TOOL::FindNext(), LIB_ITEM::GetBoundingBox(), GetBoundingBoxes(), BOARD_ITEM::GetCenter(), SCH_MOVE_TOOL::getConnectedDragItems(), SCH_MOVE_TOOL::getConnectedItems(), EE_SELECTION_TOOL::GuessSelectionCandidates(), EE_RTREE::insert(), intersectsAreaFunc(), MarkConnections(), SCH_EDIT_TOOL::Mirror(), DRC_RTREE::QueryColliding(), EE_RTREE::remove(), SCH_EDIT_TOOL::Rotate(), DRC_TEST_PROVIDER_COPPER_CLEARANCE::testItemAgainstZone(), DRC_TEST_PROVIDER_PHYSICAL_CLEARANCE::testItemAgainstZones(), DRC_TEST_PROVIDER_SOLDER_MASK::testMaskBridges(), GERBVIEW_SELECTION::ViewBBox(), and EDA_ITEM::ViewBBox().

◆ GetBus()

SCH_LINE * SCH_SCREEN::GetBus	(	const VECTOR2I &	aPosition,
		int	aAccuracy = `0`,
		SCH_LINE_TEST_T	aSearchType = `ENTIRE_LENGTH_T`
	)		const

inline

Definition at line 435 of file sch_screen.h.

 {
 return GetLine( aPosition, aAccuracy, LAYER_BUS, aSearchType );
 }

References GetLine(), and LAYER_BUS.

Referenced by IsTerminalPoint(), and CONNECTION_GRAPH::updateItemConnectivity().

◆ GetBusAliases()

std::set< std::shared_ptr< BUS_ALIAS > > SCH_SCREEN::GetBusAliases ( ) const

inline

Return a list of bus aliases defined in this screen.

Definition at line 511 of file sch_screen.h.

 {
 return m_aliases;
 }

References m_aliases.

Referenced by SCH_SEXPR_PLUGIN::Format(), and SCH_LEGACY_PLUGIN::Format().

◆ GetBusesAndWires()

std::vector< SCH_LINE * > SCH_SCREEN::GetBusesAndWires	(	const VECTOR2I &	aPosition,
		bool	aIgnoreEndpoints = `false`
	)		const

Return buses and wires passing through aPosition.

Parameters

aPosition	Position to search for
aIgnoreEndpoints	If true, ignore wires/buses with end points matching aPosition

Returns: Buses and wires

Definition at line 1416 of file sch_screen.cpp.

{
 std::vector<SCH_LINE*> retVal;
 
 for( SCH_ITEM* item : Items().Overlapping( SCH_LINE_T, aPosition ) )
 {
 if( item->IsType( { SCH_ITEM_LOCATE_WIRE_T, SCH_ITEM_LOCATE_BUS_T } ) )
 {
 SCH_LINE* wire = static_cast<SCH_LINE*>( item );
 
 if( aIgnoreEndpoints && wire->IsEndPoint( aPosition ) )
 continue;
 
 if( IsPointOnSegment( wire->GetStartPoint(), wire->GetEndPoint(), aPosition ) )
 retVal.push_back( wire );
 }
 }
 
 return retVal;
}

References SCH_LINE::GetEndPoint(), SCH_LINE::GetStartPoint(), SCH_LINE::IsEndPoint(), IsPointOnSegment(), Items(), and SCH_LINE_T.

Referenced by SCH_EDIT_FRAME::BreakSegments(), and SCHEMATIC::FixupJunctions().

◆ GetClass()

virtual wxString SCH_SCREEN::GetClass ( ) const

inlineoverridevirtual

Return the class name.

Returns: wxString

Reimplemented from BASE_SCREEN.

Definition at line 123 of file sch_screen.h.

 {
 return wxT( "SCH_SCREEN" );
 }

◆ GetClientSheetPaths()

std::vector< SCH_SHEET_PATH > & SCH_SCREEN::GetClientSheetPaths ( )

inline

Return the number of times this screen is used.

In the legacy file formats: if this screen is used only once (not a complex hierarchy) the reference field can be used to store the symbol reference. If this screen is used more than once (a complex hierarchy), then symbols must have a full alternate reference management via sheet paths.

In the new schematic file format, all instance data is stored in the root sheet even for simple hierarchies.

Returns: the sheet paths sharing this screen.

Definition at line 178 of file sch_screen.h.

 {
 return m_clientSheetPathList;
 }

References m_clientSheetPathList.

Referenced by SCH_SCREENS::BuildClientSheetPathList(), EnsureAlternateReferencesExist(), and SCH_EDIT_FRAME::SaveProject().

◆ GetConnections()

std::vector< VECTOR2I > SCH_SCREEN::GetConnections ( ) const

Collect a unique list of all possible connection points in the schematic.

Returns: vector of connections

Definition at line 1439 of file sch_screen.cpp.

{
 std::vector<VECTOR2I> retval;
 
 for( SCH_ITEM* item : Items() )
 {
 // Avoid items that are changing
 if( !( item->GetEditFlags() & ( IS_MOVING | IS_DELETED ) ) )
 {
 std::vector<VECTOR2I> pts = item->GetConnectionPoints();
 retval.insert( retval.end(), pts.begin(), pts.end() );
 }
 }
 
 // We always have some overlapping connection points. Drop duplicates here
 std::sort( retval.begin(), retval.end(),
 []( const VECTOR2I& a, const VECTOR2I& b ) -> bool
 {
 return a.x < b.x || ( a.x == b.x && a.y < b.y );
 } );
 retval.erase( std::unique( retval.begin(), retval.end() ), retval.end() );
 
 return retval;
}

References IS_DELETED, IS_MOVING, and Items().

Referenced by SCH_LINE_WIRE_BUS_TOOL::finishSegments(), and GetNeededJunctions().

◆ GetEditFlags()

EDA_ITEM_FLAGS EDA_ITEM::GetEditFlags ( ) const

inlineinherited

Definition at line 145 of file eda_item.h.

 {
 constexpr int mask =
 ( IS_NEW | IS_PASTED | IS_MOVING | IS_BROKEN | IS_CHANGED | STRUCT_DELETED );
 
 return m_flags & mask;
 }

References IS_BROKEN, IS_CHANGED, IS_MOVING, IS_NEW, IS_PASTED, EDA_ITEM::m_flags, and STRUCT_DELETED.

◆ GetFileFormatVersionAtLoad()

int SCH_SCREEN::GetFileFormatVersionAtLoad ( ) const

inline

Definition at line 129 of file sch_screen.h.

129{ return m_fileFormatVersionAtLoad; }

References m_fileFormatVersionAtLoad.

Referenced by EESCHEMA_HELPERS::LoadSchematic(), SCH_EDIT_FRAME::LoadSheetFromFile(), SCH_EDIT_FRAME::OpenProjectFiles(), and SCH_SEXPR_PARSER::parseSchSheetInstances().

◆ GetFileName()

const wxString & SCH_SCREEN::GetFileName ( void ) const

inline

Definition at line 144 of file sch_screen.h.

144{ return m_fileName; }

SCH_SCREEN::m_fileName

wxString m_fileName

Definition: sch_screen.h:589

References m_fileName.

Referenced by SCH_EDIT_FRAME::canCloseWindow(), SCH_EDIT_FRAME::checkForNoFullyDefinedLibIds(), SCH_EDIT_FRAME::CheckSheetForRecursion(), SCH_EDIT_FRAME::CreateArchiveLibraryCacheFile(), KIGFX::SCH_VIEW::DisplaySheet(), SCH_EDIT_FRAME::doAutoSave(), SCHEMATIC::GetFileName(), DIALOG_PLOT_SCHEMATIC::getOutputPath(), SCH_LEGACY_PLUGIN::loadHeader(), SCH_SEXPR_PLUGIN::loadHierarchy(), SCH_EDIT_FRAME::LoadSheetFromFile(), NETLIST_EXPORTER_XML::makeDesignHeader(), SCH_SHEET_PATH::MakeFilePathRelativeToParentSheet(), DIALOG_SHEET_PROPERTIES::onSheetFilenameChanged(), SCH_EDITOR_CONTROL::Paste(), SCH_SHEET_PATH::PathHumanReadable(), SCH_PLOTTER::plotOneSheetDXF(), SCH_PLOTTER::plotOneSheetHpgl(), SCH_PLOTTER::plotOneSheetPDF(), SCH_PLOTTER::plotOneSheetPS(), SCH_PLOTTER::plotOneSheetSVG(), SCH_PRINTOUT::PrintPage(), SCH_EDIT_FRAME::SaveProject(), SCH_EDIT_FRAME::saveProjectSettings(), SCH_EDIT_FRAME::saveSchematicFile(), SCH_SHEET::SearchHierarchy(), DIALOG_SHEET_PROPERTIES::TransferDataFromWindow(), SCH_EDIT_FRAME::updateAutoSaveFile(), and SCH_EDIT_FRAME::updateTitle().

◆ GetFlags()

EDA_ITEM_FLAGS EDA_ITEM::GetFlags ( ) const

inlineinherited

Definition at line 142 of file eda_item.h.

142{ return m_flags; }

References EDA_ITEM::m_flags.

Referenced by BACK_ANNOTATE::applyChangelist(), BuildBoardPolygonOutlines(), collidesWithArea(), ConvertOutlineToPolygon(), SCH_EDIT_FRAME::ConvertPart(), BOARD_COMMIT::dirtyIntersectingZones(), PL_EDIT_TOOL::DoDelete(), PCB_TOOL_BASE::doInteractiveItemPlacement(), KIGFX::PCB_PAINTER::draw(), KIGFX::SCH_PAINTER::draw(), DRC_ENGINE::EvalRules(), PCB_SELECTION_TOOL::FilterCollectorForHierarchy(), LIB_SYMBOL::LIB_SYMBOL(), BOARD_INSPECTION_TOOL::makeDRCEngine(), CONVERT_TOOL::makePolysFromChainedSegs(), DIALOG_DRC::OnDRCItemSelected(), DIALOG_FOOTPRINT_CHECKER::OnSelectItem(), DIALOG_SYMBOL_PROPERTIES::OnUnitChoice(), LIB_SYMBOL::operator=(), BOARD_COMMIT::Push(), PAD_TOOL::RecombinePad(), BOARD::Remove(), FOOTPRINT::Remove(), SCH_EDIT_FRAME::SaveCopyInUndoList(), SCH_EDIT_FRAME::SelectUnit(), DS_DATA_ITEM::SyncDrawItems(), DS_DATA_ITEM_POLYGONS::SyncDrawItems(), DS_DATA_ITEM_BITMAP::SyncDrawItems(), CONNECTIVITY_DATA::TestTrackEndpointDangling(), and DIALOG_SYMBOL_PROPERTIES::TransferDataFromWindow().

◆ GetFocusPosition()

virtual const VECTOR2I EDA_ITEM::GetFocusPosition ( ) const

inlinevirtualinherited

Similar to GetPosition, but allows items to return their visual center rather than their anchor.

Reimplemented in BOARD, PCB_SHAPE, and PCB_TRACK.

Definition at line 256 of file eda_item.h.

256{ return GetPosition(); }

EDA_ITEM::GetPosition

virtual VECTOR2I GetPosition() const

Definition: eda_item.h:249

References EDA_ITEM::GetPosition().

Referenced by SCH_EDIT_FRAME::FocusOnItem().

◆ GetFriendlyName()

wxString EDA_ITEM::GetFriendlyName ( ) const

virtualinherited

Reimplemented in PCB_SHAPE, PCB_TRACK, and ZONE.

Definition at line 310 of file eda_item.cpp.

{
 return GetTypeDesc();
}

References EDA_ITEM::GetTypeDesc().

Referenced by PROPERTIES_PANEL::rebuildProperties().

◆ GetHierarchicalItems()

void SCH_SCREEN::GetHierarchicalItems ( std::vector< SCH_ITEM * > * aItems ) const

Add all schematic sheet and symbol objects in the screen to aItems.

Parameters

[out] aItems Hierarchical item list to fill.

Definition at line 1321 of file sch_screen.cpp.

{
 for( SCH_ITEM* item : Items() )
 {
 if( item->IsType( { SCH_SYMBOL_T, SCH_SHEET_T, SCH_LABEL_LOCATE_ANY_T } ) )
 aItems->push_back( item );
 }
}

References Items().

◆ GetItem()

SCH_ITEM * SCH_SCREEN::GetItem	(	const VECTOR2I &	aPosition,
		int	aAccuracy = `0`,
		KICAD_T	aType = `SCH_LOCATE_ANY_T`
	)		const

Check aPosition within a distance of aAccuracy for items of type aFilter.

Parameters

[in]	aPosition	Position in drawing units.
	aAccuracy	The maximum distance within Position to check for an item.
	aType	The type of item to find.

Returns: The item found that meets the search criteria or NULL if none found.

Definition at line 376 of file sch_screen.cpp.

{
 BOX2I bbox;
 bbox.SetOrigin( aPosition );
 bbox.Inflate( aAccuracy );
 
 for( SCH_ITEM* item : Items().Overlapping( aType, bbox ) )
 {
 if( item->HitTest( aPosition, aAccuracy ) )
 return item;
 }
 
 return nullptr;
}

References BOX2< Vec >::Inflate(), Items(), and BOX2< Vec >::SetOrigin().

Referenced by SCH_EDIT_TOOL::DoDelete(), IsTerminalPoint(), MarkConnections(), and SCH_DRAWING_TOOLS::SingleClickPlace().

◆ GetItemDescription()

wxString EDA_ITEM::GetItemDescription ( UNITS_PROVIDER * aUnitsProvider ) const

virtualinherited

Return a user-visible description string of this item.

This description is used in disambiguation menus, the message panel, ERC/DRC reports, etc.

The default version of this function raises an assertion in the debug mode and returns a string to indicate that it was not overridden to provide the object specific text.

Returns: The menu text string.

Reimplemented in LIB_FIELD, LIB_PIN, LIB_SHAPE, LIB_TEXT, LIB_TEXTBOX, SCH_BITMAP, SCH_BUS_WIRE_ENTRY, SCH_BUS_BUS_ENTRY, SCH_FIELD, SCH_JUNCTION, SCH_LABEL, SCH_DIRECTIVE_LABEL, SCH_GLOBALLABEL, SCH_HIERLABEL, SCH_LINE, SCH_MARKER, SCH_NO_CONNECT, SCH_PIN, SCH_SHAPE, SCH_SHEET, DELETED_SHEET_ITEM, SCH_SHEET_PIN, SCH_SYMBOL, SCH_TEXT, SCH_TEXTBOX, GERBER_DRAW_ITEM, DELETED_BOARD_ITEM, DS_DRAW_ITEM_LINE, DS_DRAW_ITEM_POLYPOLYGONS, DS_DRAW_ITEM_RECT, DS_DRAW_ITEM_PAGE, DS_DRAW_ITEM_TEXT, DS_DRAW_ITEM_BITMAP, PCB_GROUP, BOARD, FOOTPRINT, FP_SHAPE, FP_TEXT, FP_TEXTBOX, PAD, PCB_BITMAP, PCB_DIMENSION_BASE, PCB_MARKER, PCB_SHAPE, PCB_TARGET, PCB_TEXT, PCB_TEXTBOX, PCB_TRACK, PCB_VIA, and ZONE.

Definition at line 108 of file eda_item.cpp.

{
 wxFAIL_MSG( wxT( "GetItemDescription() was not overridden for schematic item type " ) +
 GetClass() );
 
 return wxString( wxT( "Undefined item description for " ) + GetClass() );
}

References EDA_ITEM::GetClass().

Referenced by CONNECTION_GRAPH::collectAllDriverValues(), DIALOG_GROUP_PROPERTIES::DoAddMember(), SELECTION_TOOL::doSelectionMenu(), DRC_ENGINE::EvalRules(), BOARD_INSPECTION_TOOL::getItemDescription(), PCB_MARKER::GetMsgPanelInfo(), ERC_TREE_MODEL::GetValue(), RC_TREE_MODEL::GetValue(), RC_ITEM::ShowReport(), DIALOG_POSITION_RELATIVE::updateAnchorInfo(), and PCB_CONTROL::UpdateMessagePanel().

◆ GetLabel()

SCH_LABEL_BASE * SCH_SCREEN::GetLabel	(	const VECTOR2I &	aPosition,
		int	aAccuracy = `0`
	)		const

Return a label item located at aPosition.

Parameters

[in]	aPosition	The VECTOR2I to test for label items.
	aAccuracy	Amount to inflate the item hit test bounding box.

Returns: The SCH_LABEL_BASE* of the label item found or nullptr.

Definition at line 1515 of file sch_screen.cpp.

{
 for( SCH_ITEM* item : Items().Overlapping( aPosition, aAccuracy ) )
 {
 switch( item->Type() )
 {
 case SCH_LABEL_T:
 case SCH_GLOBAL_LABEL_T:
 case SCH_HIER_LABEL_T:
 case SCH_DIRECTIVE_LABEL_T:
 if( item->HitTest( aPosition, aAccuracy ) )
 return static_cast<SCH_LABEL_BASE*>( item );
 
 break;
 
 default:
 ;
 }
 }
 
 return nullptr;
}

References Items(), SCH_DIRECTIVE_LABEL_T, SCH_GLOBAL_LABEL_T, SCH_HIER_LABEL_T, and SCH_LABEL_T.

Referenced by IsTerminalPoint().

◆ GetLabelOrientationForPoint()

TEXT_SPIN_STYLE SCH_SCREEN::GetLabelOrientationForPoint	(	const VECTOR2I &	aPosition,
		TEXT_SPIN_STYLE	aDefaultOrientation,
		const SCH_SHEET_PATH *	aSheet
	)		const

Definition at line 487 of file sch_screen.cpp.

{
 auto ret = aDefaultOrientation;
 for( SCH_ITEM* item : Items().Overlapping( aPosition ) )
 {
 if( item->GetEditFlags() & STRUCT_DELETED )
 continue;
 
 switch( item->Type() )
 {
 case SCH_BUS_WIRE_ENTRY_T:
 {
 auto busEntry = static_cast<const SCH_BUS_WIRE_ENTRY*>( item );
 if( busEntry->m_connected_bus_item )
 {
 // bus connected, take the bus direction into consideration ony if it is
 // vertical or horizontal
 auto bus = static_cast<const SCH_LINE*>( busEntry->m_connected_bus_item );
 if( bus->Angle().AsDegrees() == 90.0 )
 {
 // bus is vertical -> label shall be horizontal and
 // shall be placed to the side where the bus entry is
 if( aPosition.x < bus->GetPosition().x )
 ret = TEXT_SPIN_STYLE::LEFT;
 else if( aPosition.x > bus->GetPosition().x )
 ret = TEXT_SPIN_STYLE::RIGHT;
 }
 else if( bus->Angle().AsDegrees() == 0.0 )
 {
 // bus is horizontal -> label shall be vertical and
 // shall be placed to the side where the bus entry is
 if( aPosition.y < bus->GetPosition().y )
 ret = TEXT_SPIN_STYLE::UP;
 else if( aPosition.y > bus->GetPosition().y )
 ret = TEXT_SPIN_STYLE::BOTTOM;
 }
 }
 }
 break;
 
 case SCH_LINE_T:
 {
 auto line = static_cast<const SCH_LINE*>( item );
 // line angles goes between -90 and 90 degrees, but normalize
 auto angle = line->Angle().Normalize90().AsDegrees();
 
 if( -45 < angle && angle <= 45 )
 {
 if( line->GetStartPoint().x <= line->GetEndPoint().x )
 {
 ret = line->GetEndPoint() == aPosition ? TEXT_SPIN_STYLE::RIGHT
 : TEXT_SPIN_STYLE::LEFT;
 }
 else
 {
 ret = line->GetEndPoint() == aPosition ? TEXT_SPIN_STYLE::LEFT
 : TEXT_SPIN_STYLE::RIGHT;
 }
 }
 else
 {
 if( line->GetStartPoint().y <= line->GetEndPoint().y )
 {
 ret = line->GetEndPoint() == aPosition ? TEXT_SPIN_STYLE::BOTTOM
 : TEXT_SPIN_STYLE::UP;
 }
 else
 {
 ret = line->GetEndPoint() == aPosition ? TEXT_SPIN_STYLE::UP
 : TEXT_SPIN_STYLE::BOTTOM;
 }
 }
 }
 break;
 
 case SCH_SYMBOL_T:
 {
 SCH_SYMBOL* symbol = static_cast<SCH_SYMBOL*>( item );
 
 for( SCH_PIN* pin : symbol->GetPins( aSheet ) )
 {
 if( pin->GetPosition() == aPosition )
 {
 if( pin->GetOrientation() == PIN_RIGHT )
 {
 ret = TEXT_SPIN_STYLE::LEFT;
 }
 else if( pin->GetOrientation() == PIN_LEFT )
 {
 ret = TEXT_SPIN_STYLE::RIGHT;
 }
 else if( pin->GetOrientation() == PIN_UP )
 {
 ret = TEXT_SPIN_STYLE::BOTTOM;
 }
 else if( pin->GetOrientation() == PIN_DOWN )
 {
 ret = TEXT_SPIN_STYLE::UP;
 }
 
 switch( static_cast<SYMBOL_ORIENTATION_T>(
 symbol->GetOrientation() & ( ~( SYM_MIRROR_X | SYM_MIRROR_Y ) ) ) )
 {
 case SYM_ROTATE_CLOCKWISE:
 case SYM_ORIENT_90:
 if( ret == TEXT_SPIN_STYLE::UP )
 ret = TEXT_SPIN_STYLE::LEFT;
 else if( ret == TEXT_SPIN_STYLE::BOTTOM )
 ret = TEXT_SPIN_STYLE::RIGHT;
 else if( ret == TEXT_SPIN_STYLE::LEFT )
 ret = TEXT_SPIN_STYLE::BOTTOM;
 else if( ret == TEXT_SPIN_STYLE::RIGHT )
 ret = TEXT_SPIN_STYLE::UP;
 
 if( symbol->GetOrientation() & SYM_MIRROR_X )
 {
 if( ret == TEXT_SPIN_STYLE::UP )
 ret = TEXT_SPIN_STYLE::BOTTOM;
 else if( ret == TEXT_SPIN_STYLE::BOTTOM )
 ret = TEXT_SPIN_STYLE::UP;
 }
 
 if( symbol->GetOrientation() & SYM_MIRROR_Y )
 {
 if( ret == TEXT_SPIN_STYLE::LEFT )
 ret = TEXT_SPIN_STYLE::RIGHT;
 else if( ret == TEXT_SPIN_STYLE::RIGHT )
 ret = TEXT_SPIN_STYLE::LEFT;
 }
 break;
 case SYM_ROTATE_COUNTERCLOCKWISE:
 case SYM_ORIENT_270:
 if( ret == TEXT_SPIN_STYLE::UP )
 ret = TEXT_SPIN_STYLE::RIGHT;
 else if( ret == TEXT_SPIN_STYLE::BOTTOM )
 ret = TEXT_SPIN_STYLE::LEFT;
 else if( ret == TEXT_SPIN_STYLE::LEFT )
 ret = TEXT_SPIN_STYLE::UP;
 else if( ret == TEXT_SPIN_STYLE::RIGHT )
 ret = TEXT_SPIN_STYLE::BOTTOM;
 
 if( symbol->GetOrientation() & SYM_MIRROR_X )
 {
 if( ret == TEXT_SPIN_STYLE::UP )
 ret = TEXT_SPIN_STYLE::BOTTOM;
 else if( ret == TEXT_SPIN_STYLE::BOTTOM )
 ret = TEXT_SPIN_STYLE::UP;
 }
 
 if( symbol->GetOrientation() & SYM_MIRROR_Y )
 {
 if( ret == TEXT_SPIN_STYLE::LEFT )
 ret = TEXT_SPIN_STYLE::RIGHT;
 else if( ret == TEXT_SPIN_STYLE::RIGHT )
 ret = TEXT_SPIN_STYLE::LEFT;
 }
 break;
 case SYM_ORIENT_180:
 if( ret == TEXT_SPIN_STYLE::UP )
 ret = TEXT_SPIN_STYLE::BOTTOM;
  else if( ret == TEXT_SPIN_STYLE::BOTTOM )
 ret = TEXT_SPIN_STYLE::UP;
 else if( ret == TEXT_SPIN_STYLE::LEFT )
 ret = TEXT_SPIN_STYLE::RIGHT;
 else if( ret == TEXT_SPIN_STYLE::RIGHT )
 ret = TEXT_SPIN_STYLE::LEFT;
 
 if( symbol->GetOrientation() & SYM_MIRROR_X )
 {
 if( ret == TEXT_SPIN_STYLE::UP )
 ret = TEXT_SPIN_STYLE::BOTTOM;
 else if( ret == TEXT_SPIN_STYLE::BOTTOM )
 ret = TEXT_SPIN_STYLE::UP;
 }
 
 if( symbol->GetOrientation() & SYM_MIRROR_Y )
 {
 if( ret == TEXT_SPIN_STYLE::LEFT )
 ret = TEXT_SPIN_STYLE::RIGHT;
 else if( ret == TEXT_SPIN_STYLE::RIGHT )
 ret = TEXT_SPIN_STYLE::LEFT;
 }
 break;
 case SYM_ORIENT_0:
 case SYM_NORMAL:
 default:
 if( symbol->GetOrientation() & SYM_MIRROR_X )
 {
 if( ret == TEXT_SPIN_STYLE::UP )
 ret = TEXT_SPIN_STYLE::BOTTOM;
 else if( ret == TEXT_SPIN_STYLE::BOTTOM )
 ret = TEXT_SPIN_STYLE::UP;
 }
 
 if( symbol->GetOrientation() & SYM_MIRROR_Y )
 {
 if( ret == TEXT_SPIN_STYLE::LEFT )
 ret = TEXT_SPIN_STYLE::RIGHT;
 else if( ret == TEXT_SPIN_STYLE::RIGHT )
 ret = TEXT_SPIN_STYLE::LEFT;
 }
 break;
 }
 
 break;
 }
 }
 }
 break;
 default: break;
 }
 }
 return ret;
}

References PNS::angle(), TEXT_SPIN_STYLE::BOTTOM, SCH_SYMBOL::GetOrientation(), SCH_SYMBOL::GetPins(), Items(), TEXT_SPIN_STYLE::LEFT, pin, PIN_DOWN, PIN_LEFT, PIN_RIGHT, PIN_UP, TEXT_SPIN_STYLE::RIGHT, SCH_BUS_WIRE_ENTRY_T, SCH_LINE_T, SCH_SYMBOL_T, STRUCT_DELETED, SYM_MIRROR_X, SYM_MIRROR_Y, SYM_NORMAL, SYM_ORIENT_0, SYM_ORIENT_180, SYM_ORIENT_270, SYM_ORIENT_90, SYM_ROTATE_CLOCKWISE, SYM_ROTATE_COUNTERCLOCKWISE, TEXT_SPIN_STYLE::UP, VECTOR2< T >::x, and VECTOR2< T >::y.

Referenced by SCH_EDIT_FRAME::AutoRotateItem().

◆ getLibSymbolNameMatches()

size_t SCH_SCREEN::getLibSymbolNameMatches	(	const SCH_SYMBOL &	aSymbol,
		std::vector< wxString > &	aMatches
	)

private

Return a list of potential library symbol matches for aSymbol.

When and existing library symbol named with the full LIB_ID object is found, there may be more potential matches if the SCH_SCREEN::Append() method need to create an alternate symbol due to differences from the original symbol. This process creates a new library symbol name by adding a "_#" suffix to the existing LIB_ID item name.

Parameters

[in]	aSymbol	is the schematic symbol to search for potential library symbol matches.
[out]	aMatches	contains library cache names of all of the potential matches.

Returns: the number of potential matches found for aSymbol.

Definition at line 1599 of file sch_screen.cpp.

{
 wxString searchName = aSymbol.GetLibId().GetUniStringLibId();
 
 if( m_libSymbols.find( searchName ) != m_libSymbols.end() )
 aMatches.emplace_back( searchName );
 
 searchName = aSymbol.GetLibId().GetUniStringLibItemName() + wxS( "_" );
 
 long tmp;
 wxString suffix;
 
 for( auto pair : m_libSymbols )
 {
 if( pair.first.StartsWith( searchName, &suffix ) && suffix.ToLong( &tmp ) )
 aMatches.emplace_back( pair.first );
 }
 
 return aMatches.size();
}

References SCH_SYMBOL::GetLibId(), LIB_ID::GetUniStringLibId(), LIB_ID::GetUniStringLibItemName(), and m_libSymbols.

Referenced by Append().

◆ GetLibSymbols() [1/2]

std::map< wxString, LIB_SYMBOL * > & SCH_SCREEN::GetLibSymbols ( )

inline

Fetch a list of unique LIB_SYMBOL object pointers required to properly render each SCH_SYMBOL in this schematic.

Returns: The list of unique LIB_SYMBOL object pointers.

Definition at line 481 of file sch_screen.h.

481{ return m_libSymbols; }

References m_libSymbols.

Referenced by SCH_EDIT_FRAME::CommonSettingsChanged(), NETLIST_EXPORTER_BASE::findNextSymbol(), SCH_SEXPR_PLUGIN::Format(), SCH_EDIT_FRAME::HardRedraw(), and SCH_EDITOR_CONTROL::Paste().

◆ GetLibSymbols() [2/2]

const std::map< wxString, LIB_SYMBOL * > & SCH_SCREEN::GetLibSymbols ( ) const

inline

Definition at line 482 of file sch_screen.h.

482{ return m_libSymbols; }

References m_libSymbols.

◆ GetLine()

SCH_LINE * SCH_SCREEN::GetLine	(	const VECTOR2I &	aPosition,
		int	aAccuracy = `0`,
		int	aLayer = `LAYER_NOTES`,
		SCH_LINE_TEST_T	aSearchType = `ENTIRE_LENGTH_T`
	)		const

Return a line item located at aPosition.

Parameters

[in]	aPosition	The VECTOR2I to test for a line item.
	aAccuracy	Amount to inflate the item hit test bounding box.
	aLayer	The layer the line is drawn upon.
	aSearchType	Additional line test criteria.

Returns: The SCH_LINE* of the wire item found at aPosition or NULL if item not found.

Definition at line 1379 of file sch_screen.cpp.

{
 // an accuracy of 0 had problems with rounding errors; use at least 1
 aAccuracy = std::max( aAccuracy, 1 );
 
 for( SCH_ITEM* item : Items().Overlapping( aPosition, aAccuracy ) )
 {
 if( item->Type() != SCH_LINE_T )
 continue;
 
 if( item->GetLayer() != aLayer )
 continue;
 
 if( !item->HitTest( aPosition, aAccuracy ) )
 continue;
 
 switch( aSearchType )
 {
 case ENTIRE_LENGTH_T:
 return (SCH_LINE*) item;
 
 case EXCLUDE_END_POINTS_T:
 if( !( (SCH_LINE*) item )->IsEndPoint( aPosition ) )
 return (SCH_LINE*) item;
 break;
 
 case END_POINTS_ONLY_T:
 if( ( (SCH_LINE*) item )->IsEndPoint( aPosition ) )
 return (SCH_LINE*) item;
 }
 }
 
 return nullptr;
}

References END_POINTS_ONLY_T, ENTIRE_LENGTH_T, EXCLUDE_END_POINTS_T, Items(), and SCH_LINE_T.

Referenced by GetBus(), GetWire(), and IsTerminalPoint().

◆ GetMenuImage()

BITMAPS EDA_ITEM::GetMenuImage ( ) const

virtualinherited

Return a pointer to an image to be used in menus.

The default version returns the right arrow image. Override this function to provide object specific menu images.

Returns: The menu image associated with the item.

Reimplemented in LIB_FIELD, LIB_PIN, LIB_SHAPE, LIB_TEXT, LIB_TEXTBOX, SCH_BITMAP, SCH_BUS_WIRE_ENTRY, SCH_BUS_BUS_ENTRY, SCH_FIELD, SCH_JUNCTION, SCH_LABEL, SCH_GLOBALLABEL, SCH_HIERLABEL, SCH_LINE, SCH_MARKER, SCH_NO_CONNECT, SCH_SHAPE, SCH_SHEET, SCH_SHEET_PIN, SCH_SYMBOL, SCH_TEXT, SCH_TEXTBOX, GERBER_DRAW_ITEM, PCB_GROUP, FOOTPRINT, FP_SHAPE, FP_TEXT, FP_TEXTBOX, PAD, PCB_BITMAP, PCB_DIM_ALIGNED, PCB_DIM_ORTHOGONAL, PCB_DIM_RADIAL, PCB_DIM_LEADER, PCB_DIM_CENTER, PCB_MARKER, PCB_SHAPE, PCB_TARGET, PCB_TEXT, PCB_TEXTBOX, PCB_TRACK, PCB_VIA, and ZONE.

Definition at line 269 of file eda_item.cpp.

{
 return BITMAPS::dummy_item;
}

References dummy_item.

Referenced by SELECTION_TOOL::doSelectionMenu().

◆ GetMsgPanelInfo()

virtual void EDA_ITEM::GetMsgPanelInfo	(	EDA_DRAW_FRAME *	aFrame,
		std::vector< MSG_PANEL_ITEM > &	aList
	)

inlinevirtualinherited

Populate aList of MSG_PANEL_ITEM objects with it's internal state for display purposes.

Parameters

aList is the list to populate.

Reimplemented in LIB_FIELD, LIB_ITEM, LIB_PIN, LIB_SHAPE, LIB_TEXT, LIB_TEXTBOX, SCH_BITMAP, SCH_BUS_ENTRY_BASE, SCH_FIELD, SCH_LABEL_BASE, SCH_LINE, SCH_MARKER, SCH_PIN, SCH_SHAPE, SCH_SHEET, SCH_SYMBOL, SCH_TEXT, SCH_TEXTBOX, GERBER_DRAW_ITEM, DS_DRAW_ITEM_BASE, PCB_GROUP, BOARD, FOOTPRINT, FP_SHAPE, FP_TEXT, FP_TEXTBOX, NETINFO_ITEM, PAD, PCB_BITMAP, PCB_DIMENSION_BASE, PCB_DIM_ALIGNED, PCB_DIM_LEADER, PCB_MARKER, PCB_SHAPE, PCB_TARGET, PCB_TEXT, PCB_TEXTBOX, PCB_TRACK, PCB_VIA, and ZONE.

Definition at line 209 of file eda_item.h.

210 {

211 }

Referenced by SCH_SHAPE::GetMsgPanelInfo(), EDA_DRAW_FRAME::SetMsgPanel(), EE_INSPECTION_TOOL::UpdateMessagePanel(), GERBVIEW_CONTROL::UpdateMessagePanel(), PL_EDITOR_CONTROL::UpdateMessagePanel(), PCB_CONTROL::UpdateMessagePanel(), and FOOTPRINT_WIZARD_FRAME::UpdateMsgPanel().

◆ GetNeededJunctions()

std::vector< VECTOR2I > SCH_SCREEN::GetNeededJunctions ( const std::deque< EDA_ITEM * > & aItems ) const

Return the unique set of points belonging to aItems where a junction is needed.

Parameters

aItems List of objects to check

Returns: Points where a junction is needed

Definition at line 1465 of file sch_screen.cpp.

{
 std::vector<VECTOR2I> pts;
 std::vector<VECTOR2I> connections = GetConnections();
 
 for( const EDA_ITEM* edaItem : aItems )
 {
 const SCH_ITEM* item = dynamic_cast<const SCH_ITEM*>( edaItem );
 
 if( !item || !item->IsConnectable() )
 continue;
 
 std::vector<VECTOR2I> new_pts = item->GetConnectionPoints();
 pts.insert( pts.end(), new_pts.begin(), new_pts.end() );
 
 // If the item is a line, we also add any connection points from the rest of the schematic
 // that terminate on the line after it is moved.
 if( item->Type() == SCH_LINE_T )
 {
 SCH_LINE* line = (SCH_LINE*) item;
 
 for( const VECTOR2I& pt : connections )
 {
 if( IsPointOnSegment( line->GetStartPoint(), line->GetEndPoint(), pt ) )
 pts.push_back( pt );
 }
 }
 }
 
 // We always have some overlapping connection points. Drop duplicates here
 std::sort( pts.begin(), pts.end(),
 []( const VECTOR2I& a, const VECTOR2I& b ) -> bool
 {
 return a.x < b.x || ( a.x == b.x && a.y < b.y );
 } );
 
 pts.erase( unique( pts.begin(), pts.end() ), pts.end() );
 
 // We only want the needed junction points, remove all the others
 pts.erase( std::remove_if( pts.begin(), pts.end(),
 [this]( const VECTOR2I& a ) -> bool
 {
 return !IsExplicitJunctionNeeded( a );
 } ),
 pts.end() );
 
 return pts;
}

References SCH_ITEM::GetConnectionPoints(), GetConnections(), SCH_LINE::GetEndPoint(), SCH_LINE::GetStartPoint(), SCH_ITEM::IsConnectable(), IsPointOnSegment(), SCH_LINE_T, and EDA_ITEM::Type().

Referenced by SCH_LINE_WIRE_BUS_TOOL::AddJunctionsIfNeeded(), and SCHEMATIC::FixupJunctions().

◆ GetPageCount()

int BASE_SCREEN::GetPageCount ( ) const

inlineinherited

Definition at line 72 of file base_screen.h.

72{ return m_pageCount; }

References BASE_SCREEN::m_pageCount.

Referenced by KIGFX::SCH_VIEW::DisplaySheet(), SCH_LEGACY_PLUGIN::Format(), DIALOG_EESCHEMA_PAGE_SETTINGS::onTransferDataToWindow(), SCH_PLOTTER::plotOneSheetDXF(), SCH_PLOTTER::plotOneSheetHpgl(), SCH_PLOTTER::plotOneSheetPDF(), SCH_PLOTTER::plotOneSheetPS(), SCH_PLOTTER::plotOneSheetSVG(), EDA_DRAW_FRAME::PrintDrawingSheet(), PCB_EDIT_FRAME::SetPageSettings(), and DIALOG_PAGES_SETTINGS::UpdateDrawingSheetExample().

◆ GetPageNumber()

const wxString & BASE_SCREEN::GetPageNumber ( ) const

inherited

Definition at line 71 of file base_screen.cpp.

{
 static wxString pageNumber;
 
 if( m_pageNumber.IsEmpty() )
 pageNumber.Printf( wxS( "%d" ), m_virtualPageNumber );
 else
 pageNumber = m_pageNumber;
 
 return pageNumber;
}

References BASE_SCREEN::m_pageNumber, and BASE_SCREEN::m_virtualPageNumber.

Referenced by KIGFX::SCH_VIEW::DisplaySheet(), SCH_PLOTTER::plotOneSheetDXF(), SCH_PLOTTER::plotOneSheetHpgl(), SCH_PLOTTER::plotOneSheetPDF(), SCH_PLOTTER::plotOneSheetPS(), SCH_PLOTTER::plotOneSheetSVG(), EDA_DRAW_FRAME::PrintDrawingSheet(), PCB_EDIT_FRAME::SetPageSettings(), and DIALOG_PAGES_SETTINGS::UpdateDrawingSheetExample().

◆ GetPageSettings()

const PAGE_INFO & SCH_SCREEN::GetPageSettings ( ) const

inline

◆ GetParent()

EDA_ITEM * EDA_ITEM::GetParent ( void ) const

inlineinherited

Definition at line 99 of file eda_item.h.

99{ return m_parent; }

EDA_ITEM::m_parent

EDA_ITEM * m_parent

Linked list: Link (parent struct)

Definition: eda_item.h:496

References EDA_ITEM::m_parent.

Referenced by SCH_EDIT_FRAME::AddItemToScreenAndUndoList(), SCH_EDIT_TOOL::AutoplaceFields(), DIALOG_SCH_FIELD_PROPERTIES::DIALOG_SCH_FIELD_PROPERTIES(), SCH_EDITOR_CONTROL::doCopy(), EDIT_TOOL::doMoveSelection(), KIGFX::SCH_PAINTER::draw(), SCH_EDIT_TOOL::editFieldText(), SCH_PIN::GetDefaultNetName(), SCH_FIELD::GetFieldColor(), getInferredSymbols(), SCH_PIN::GetParentSymbol(), EE_SELECTION_TOOL::highlight(), highlightNet(), SCH_FIELD::HitTest(), SCH_PIN::IsStacked(), CADSTAR_SCH_ARCHIVE_LOADER::loadNets(), SCH_EDIT_TOOL::Mirror(), SCH_MOVE_TOOL::moveItem(), DIALOG_SCH_FIELD_PROPERTIES::onScintillaCharAdded(), BOARD_COMMIT::parentObject(), DIALOG_GLOBAL_EDIT_TEXT_AND_GRAPHICS::processItem(), PCB_SELECTION_TOOL::RebuildSelection(), SCH_BASE_FRAME::RefreshZoomDependentItems(), SCH_FIND_REPLACE_TOOL::ReplaceAll(), SCH_EDIT_TOOL::Rotate(), EE_TOOL_BASE< T >::saveCopyInUndoList(), SCH_ITEM::Schematic(), Schematic(), SCH_SHEET::SearchHierarchy(), PCB_SELECTION_TOOL::select(), BOARD_COMMIT::Stage(), DIALOG_SYMBOL_FIELDS_TABLE::TransferDataToWindow(), EE_SELECTION_TOOL::unhighlight(), DIALOG_SCH_FIELD_PROPERTIES::UpdateField(), EE_TOOL_BASE< T >::updateItem(), and SCH_BASE_FRAME::UpdateItem().

◆ GetPin()

LIB_PIN * SCH_SCREEN::GetPin	(	const VECTOR2I &	aPosition,
		SCH_SYMBOL **	aSymbol = `nullptr`,
		bool	aEndPointOnly = `false`
	)		const

Test the screen for a symbol pin item at aPosition.

Parameters

[in]	aPosition	Position to test.
[out]	aSymbol	The symbol if a pin was found, otherwise NULL.
	aEndPointOnly	Set to true to test if aPosition is the connection point of the pin.

Returns: The pin item if found, otherwise NULL.

Definition at line 1213 of file sch_screen.cpp.

{
 SCH_SYMBOL* candidate = nullptr;
 LIB_PIN* pin = nullptr;
 
 for( SCH_ITEM* item : Items().Overlapping( SCH_SYMBOL_T, aPosition ) )
 {
 candidate = static_cast<SCH_SYMBOL*>( item );
 
 if( aEndPointOnly )
 {
 pin = nullptr;
 
 if( !candidate->GetLibSymbolRef() )
 continue;
 
 std::vector<LIB_PIN*> pins;
 candidate->GetLibPins( pins );
 
 for( LIB_PIN* test_pin : pins )
 {
 if( candidate->GetPinPhysicalPosition( test_pin ) == aPosition )
 {
 pin = test_pin;
 break;
 }
 }
 
 if( pin )
 break;
 }
 else
 {
 pin = (LIB_PIN*) candidate->GetDrawItem( aPosition, LIB_PIN_T );
 
 if( pin )
 break;
 }
 }
 
 if( pin && aSymbol )
 *aSymbol = candidate;
 
 return pin;
}

References SCH_SYMBOL::GetDrawItem(), SCH_SYMBOL::GetLibPins(), SCH_SYMBOL::GetLibSymbolRef(), SCH_SYMBOL::GetPinPhysicalPosition(), Items(), LIB_PIN_T, pin, and SCH_SYMBOL_T.

Referenced by IsTerminalPoint().

◆ GetPosition()

virtual VECTOR2I EDA_ITEM::GetPosition ( ) const

inlinevirtualinherited

Reimplemented in LIB_FIELD, LIB_PIN, LIB_SHAPE, LIB_TEXT, SCH_BITMAP, SCH_BUS_ENTRY_BASE, SCH_FIELD, SCH_JUNCTION, SCH_LINE, SCH_MARKER, SCH_NO_CONNECT, SCH_PIN, SCH_SHAPE, SCH_SHEET, SCH_SYMBOL, SCH_TEXT, GERBER_DRAW_ITEM, DELETED_BOARD_ITEM, DS_DRAW_ITEM_LINE, DS_DRAW_ITEM_POLYPOLYGONS, DS_DRAW_ITEM_RECT, DS_DRAW_ITEM_PAGE, DS_DRAW_ITEM_TEXT, DS_DRAW_ITEM_BITMAP, KIGFX::ORIGIN_VIEWITEM, PCB_GROUP, BOARD, FOOTPRINT, FP_TEXT, NETINFO_ITEM, PAD, PCB_BITMAP, PCB_DIMENSION_BASE, PCB_MARKER, PCB_SHAPE, PCB_TARGET, PCB_TEXT, PCB_TRACK, PCB_ARC, PCB_VIA, and ZONE.

Definition at line 249 of file eda_item.h.

249{ return VECTOR2I(); }

Referenced by SCH_MOVE_TOOL::AlignElements(), SCH_EDITOR_CONTROL::AssignNetclass(), SCH_EDIT_TOOL::ChangeTextType(), TEST_BOARD_ITEM_FIXTURE::CompareItems(), TEST_EE_ITEM_FIXTURE::CompareItems(), PCB_GRID_HELPER::computeAnchors(), EE_GRID_HELPER::computeAnchors(), CONVERT_TOOL::CreatePolys(), SCH_EDIT_FRAME::DeleteJunction(), EDIT_TOOL::doMoveSelection(), KIGFX::PCB_PAINTER::draw(), CONNECTION_GRAPH::ercCheckBusToBusConflicts(), CONNECTION_GRAPH::ercCheckBusToNetConflicts(), CONNECTION_GRAPH::ercCheckMultipleDrivers(), CONNECTION_GRAPH::ercCheckNetclassConflicts(), CONNECTION_GRAPH::ercCheckNoConnects(), PCB_SELECTION_TOOL::FindItem(), GERBVIEW_SELECTION::GetCenter(), EDA_ITEM::GetFocusPosition(), getMinDist(), SCH_FIELD::GetParentPosition(), EDA_ITEM::GetSortPosition(), PCB_SELECTION::GetTopLeftItem(), EE_SELECTION::GetTopLeftItem(), BOARD_ITEM::GetX(), BOARD_ITEM::GetY(), SCH_MOVE_TOOL::Main(), SCH_EDIT_TOOL::Mirror(), SYMBOL_EDITOR_EDIT_TOOL::Mirror(), EDIT_TOOL::MoveExact(), SCH_FIND_REPLACE_TOOL::nextMatch(), DIALOG_MIGRATE_BUSES::onItemSelected(), BOARD::cmp_items::operator()(), SCH_ITEM::operator<(), SCH_EDITOR_CONTROL::Paste(), PL_EDIT_TOOL::Paste(), PCB_CONTROL::placeBoardItems(), POSITION_RELATIVE_TOOL::PositionRelative(), BACK_ANNOTATE::processNetNameChange(), PCB_BASE_EDIT_FRAME::PutDataInPreviousState(), SCH_EDIT_TOOL::RepeatDrawItem(), SCH_EDIT_TOOL::Rotate(), SYMBOL_EDITOR_EDIT_TOOL::Rotate(), test::DRC_TEST_PROVIDER_DIFF_PAIR_COUPLING::Run(), DRC_TEST_PROVIDER_TEXT_DIMS::Run(), RC_ITEM::ShowReport(), SCH_EDIT_TOOL::Swap(), DRC_TEST_PROVIDER_PHYSICAL_CLEARANCE::testShapeLineChain(), DRC_TEST_PROVIDER_MISC::testTextVars(), TransformItem(), DIALOG_POSITION_RELATIVE::UpdateAnchor(), EDIT_TOOL::updateModificationPoint(), and PL_EDIT_TOOL::updateModificationPoint().

◆ GetRefCount()

int SCH_SCREEN::GetRefCount ( ) const

inline

Definition at line 161 of file sch_screen.h.

161{ return m_refCount; }

References m_refCount.

Referenced by SCH_SHEET::GetScreenCount(), SCH_SHEET::SetScreen(), and SCH_SHEET::~SCH_SHEET().

◆ GetSheetInstances()

const std::vector< SCH_SHEET_INSTANCE > & SCH_SCREEN::GetSheetInstances ( ) const

inline

Definition at line 521 of file sch_screen.h.

 {
 return m_sheetInstances;
 }

References m_sheetInstances.

Referenced by EESCHEMA_HELPERS::LoadSchematic(), and SCH_EDITOR_CONTROL::setClipboardInstances().

◆ GetSheetPin()

SCH_SHEET_PIN * SCH_SCREEN::GetSheetPin ( const VECTOR2I & aPosition ) const

Test the screen if aPosition is a sheet label object.

Parameters

[in] aPosition The position to test.

Returns: The sheet label object if found otherwise NULL.

Definition at line 1261 of file sch_screen.cpp.

{
 SCH_SHEET_PIN* sheetPin = nullptr;
 
 for( SCH_ITEM* item : Items().Overlapping( SCH_SHEET_T, aPosition ) )
 {
 SCH_SHEET* sheet = static_cast<SCH_SHEET*>( item );
 
 sheetPin = sheet->GetPin( aPosition );
 
 if( sheetPin )
 break;
 }
 
 return sheetPin;
}

References SCH_SHEET::GetPin(), Items(), and SCH_SHEET_T.

Referenced by IsTerminalPoint().

◆ GetSheets()

void SCH_SCREEN::GetSheets ( std::vector< SCH_ITEM * > * aItems ) const

Similar to Items().OfType( SCH_SHEET_T ), but return the sheets in a deterministic order (L-R, T-B) for sheet numbering.

Definition at line 1331 of file sch_screen.cpp.

{
 for( SCH_ITEM* item : Items().OfType( SCH_SHEET_T ) )
 aItems->push_back( item );
 
 std::sort( aItems->begin(), aItems->end(),
 []( EDA_ITEM* a, EDA_ITEM* b ) -> bool
 {
 if( a->GetPosition().x == b->GetPosition().x )
 {
 // Ensure deterministic sort
 if( a->GetPosition().y == b->GetPosition().y )
  return a->m_Uuid < b->m_Uuid;
 
 return a->GetPosition().y < b->GetPosition().y;
 }
 else
 {
 return a->GetPosition().x < b->GetPosition().x;
 }
 } );
}

References Items(), and SCH_SHEET_T.

Referenced by SCH_EDIT_FRAME::AnnotateSymbols(), HIERARCHY_PANE::buildHierarchyTree(), SCH_SHEET_LIST::BuildSheetList(), SCH_EDIT_FRAME::CheckAnnotate(), and SCH_EDIT_FRAME::DeleteAnnotation().

◆ GetSortPosition()

virtual VECTOR2I EDA_ITEM::GetSortPosition ( ) const

inlinevirtualinherited

Return the coordinates that should be used for sorting this element visually compared to other elements.

For instance, for lines the midpoint might be a better sorting point than either end.

Returns: X,Y coordinate of the sort point

Reimplemented in SCH_LINE.

Definition at line 265 of file eda_item.h.

265{ return GetPosition(); }

References EDA_ITEM::GetPosition().

◆ GetState()

int EDA_ITEM::GetState ( EDA_ITEM_FLAGS type ) const

inlineinherited

Definition at line 123 of file eda_item.h.

 {
 return m_status & type;
 }

References EDA_ITEM::m_status.

◆ GetStatus()

EDA_ITEM_FLAGS EDA_ITEM::GetStatus ( ) const

inlineinherited

Definition at line 136 of file eda_item.h.

136{ return m_status; }

References EDA_ITEM::m_status.

◆ GetSymbolInstances()

const std::vector< SCH_SYMBOL_INSTANCE > & SCH_SCREEN::GetSymbolInstances ( ) const

inline

Definition at line 516 of file sch_screen.h.

 {
 return m_symbolInstances;
 }

References m_symbolInstances.

Referenced by EESCHEMA_HELPERS::LoadSchematic(), SCH_EDIT_FRAME::LoadSheetFromFile(), and SCH_EDITOR_CONTROL::setClipboardInstances().

◆ GetTitleBlock()

const TITLE_BLOCK & SCH_SCREEN::GetTitleBlock ( ) const

inline

Definition at line 155 of file sch_screen.h.

155{ return m_titles; }

References m_titles.

Referenced by SCH_PLOTTER::createPDFFile(), KIGFX::SCH_VIEW::DisplaySheet(), SCH_SEXPR_PLUGIN::Format(), SCH_LEGACY_PLUGIN::Format(), SCH_SHEET::GetContextualTextVars(), SCHEMATIC::GetContextualTextVars(), SCH_BASE_FRAME::GetTitleBlock(), NETLIST_EXPORTER_XML::makeDesignHeader(), SCH_PLOTTER::plotOneSheetDXF(), SCH_PLOTTER::plotOneSheetHpgl(), SCH_PLOTTER::plotOneSheetPDF(), SCH_PLOTTER::plotOneSheetPS(), SCH_PLOTTER::plotOneSheetSVG(), and SCH_SHEET::ResolveTextVar().

◆ GetTypeDesc()

wxString EDA_ITEM::GetTypeDesc ( ) const

inherited

Return a translated description of the type for this EDA_ITEM for display in user facing messages.

Definition at line 301 of file eda_item.cpp.

{
 //@see EDA_ITEM_DESC for definition of ENUM_MAP<KICAD_T>
 wxString typeDescr = ENUM_MAP<KICAD_T>::Instance().ToString( Type() );
 
 return wxGetTranslation( typeDescr );
}

References ENUM_MAP< T >::Instance(), and EDA_ITEM::Type().

Referenced by PCB_GROUP::AddItem(), EDIT_TOOL::doMoveSelection(), and EDA_ITEM::GetFriendlyName().

◆ GetUuid()

const KIID & SCH_SCREEN::GetUuid ( ) const

inline

Definition at line 526 of file sch_screen.h.

526{ return m_uuid; }

References m_uuid.

Referenced by SCH_EDIT_FRAME::CreateScreens(), SCH_ALTIUM_PLUGIN::Load(), SCH_EAGLE_PLUGIN::Load(), SCH_LEGACY_PLUGIN::loadHierarchy(), SCH_LEGACY_PLUGIN::loadSymbol(), SCH_SEXPR_PARSER::ParseSchematic(), and SCH_EDIT_FRAME::SaveProject().

◆ GetVirtualPageNumber()

int BASE_SCREEN::GetVirtualPageNumber ( ) const

inlineinherited

Definition at line 75 of file base_screen.h.

75{ return m_virtualPageNumber; }

References BASE_SCREEN::m_virtualPageNumber.

Referenced by KIGFX::SCH_VIEW::DisplaySheet(), SCH_LEGACY_PLUGIN::Format(), DIALOG_EESCHEMA_PAGE_SETTINGS::onTransferDataToWindow(), SCH_PLOTTER::plotOneSheetDXF(), SCH_PLOTTER::plotOneSheetHpgl(), SCH_PLOTTER::plotOneSheetPDF(), SCH_PLOTTER::plotOneSheetPS(), SCH_PLOTTER::plotOneSheetSVG(), EDA_DRAW_FRAME::PrintDrawingSheet(), and DIALOG_PAGES_SETTINGS::UpdateDrawingSheetExample().

◆ GetWire()

SCH_LINE * SCH_SCREEN::GetWire	(	const VECTOR2I &	aPosition,
		int	aAccuracy = `0`,
		SCH_LINE_TEST_T	aSearchType = `ENTIRE_LENGTH_T`
	)		const

inline

Definition at line 429 of file sch_screen.h.

 {
 return GetLine( aPosition, aAccuracy, LAYER_WIRE, aSearchType );
 }

References GetLine(), and LAYER_WIRE.

Referenced by IsTerminalPoint().

◆ HasFlag()

bool EDA_ITEM::HasFlag ( EDA_ITEM_FLAGS aFlag ) const

inlineinherited

Definition at line 143 of file eda_item.h.

143{ return ( m_flags & aFlag ) == aFlag; }

References EDA_ITEM::m_flags.

Referenced by GRAPHICS_CLEANER::cleanupShapes(), SCH_EDIT_TOOL::DoDelete(), KIGFX::SCH_PAINTER::draw(), SCH_MOVE_TOOL::getConnectedDragItems(), SCH_MOVE_TOOL::getConnectedItems(), FOOTPRINT::IsConflicting(), ZONE::IsConflicting(), SCH_MOVE_TOOL::Main(), MarkConnections(), SCH_MOVE_TOOL::moveItem(), SCH_MOVE_TOOL::orthoLineDrag(), SYMBOL_EDITOR_PIN_TOOL::PlacePin(), BOARD_COMMIT::Push(), SCH_EDIT_TOOL::Rotate(), EE_TOOL_BASE< T >::saveCopyInUndoList(), and EE_SELECTION_TOOL::selectMultiple().

◆ HasItems()

bool SCH_SCREEN::HasItems ( KICAD_T aItemType ) const

Definition at line 131 of file sch_screen.cpp.

{
 EE_RTREE::EE_TYPE sheets = m_rtree.OfType( aItemType );
 
 return sheets.begin() != sheets.end();
}

References EE_RTREE::EE_TYPE::begin(), EE_RTREE::EE_TYPE::end(), m_rtree, and EE_RTREE::OfType().

Referenced by HasSheets().

◆ HasSheets()

bool SCH_SCREEN::HasSheets ( ) const

inline

Definition at line 119 of file sch_screen.h.

119{ return HasItems( SCH_SHEET_T ); }

SCH_SCREEN::HasItems

bool HasItems(KICAD_T aItemType) const

Definition: sch_screen.cpp:131

References HasItems(), and SCH_SHEET_T.

◆ HitTest() [1/2]

virtual bool EDA_ITEM::HitTest	(	const BOX2I &	aRect,
		bool	aContained,
		int	aAccuracy = `0`
	)		const

inlinevirtualinherited

Test if aRect intersects this item.

Parameters

aRect	A reference to a BOX2I object containing the rectangle to test.
aContained	Set to true to test for containment instead of an intersection.
aAccuracy	Increase aRect by this amount.

Returns: True if aRect contains or intersects the item bounding box.

Reimplemented in LIB_ITEM, LIB_PIN, LIB_SHAPE, LIB_TEXT, LIB_TEXTBOX, SCH_BITMAP, SCH_BUS_ENTRY_BASE, SCH_FIELD, SCH_JUNCTION, SCH_LABEL_BASE, SCH_LINE, SCH_NO_CONNECT, SCH_PIN, SCH_SHAPE, SCH_SHEET, SCH_SYMBOL, SCH_TEXT, SCH_TEXTBOX, DS_DRAW_ITEM_BASE, DS_DRAW_ITEM_POLYPOLYGONS, DS_DRAW_ITEM_RECT, DS_DRAW_ITEM_TEXT, DS_DRAW_ITEM_BITMAP, PCB_GROUP, FOOTPRINT, FP_TEXT, FP_TEXTBOX, PAD, PCB_BITMAP, PCB_DIMENSION_BASE, PCB_SHAPE, PCB_TARGET, PCB_TEXT, PCB_TEXTBOX, PCB_TRACK, PCB_VIA, PCB_ARC, ZONE, and GERBER_DRAW_ITEM.

Definition at line 235 of file eda_item.h.

 {
 return false; // derived classes should override this function
 }

◆ HitTest() [2/2]

virtual bool EDA_ITEM::HitTest	(	const VECTOR2I &	aPosition,
		int	aAccuracy = `0`
	)		const

inlinevirtualinherited

Test if aPosition is inside or on the boundary of this item.

Parameters

aPosition	A reference to a VECTOR2I object containing the coordinates to test.
aAccuracy	Increase the item bounding box by this amount.

Returns: True if aPosition is within the item bounding box.

Reimplemented in RATSNEST_VIEW_ITEM, SCH_SHEET, FP_TEXT, FP_TEXTBOX, PCB_DIMENSION_BASE, PCB_TEXT, PCB_TEXTBOX, LIB_FIELD, LIB_ITEM, LIB_PIN, LIB_SHAPE, LIB_TEXT, LIB_TEXTBOX, SCH_BITMAP, SCH_BUS_ENTRY_BASE, SCH_FIELD, SCH_JUNCTION, SCH_LABEL_BASE, SCH_LINE, SCH_MARKER, SCH_NO_CONNECT, SCH_PIN, SCH_SHAPE, SCH_SHEET_PIN, SCH_SYMBOL, SCH_TEXT, SCH_TEXTBOX, DS_DRAW_ITEM_BASE, DS_DRAW_ITEM_LINE, DS_DRAW_ITEM_POLYPOLYGONS, DS_DRAW_ITEM_RECT, DS_DRAW_ITEM_PAGE, DS_DRAW_ITEM_TEXT, DS_DRAW_ITEM_BITMAP, PCB_GROUP, FOOTPRINT, PAD, PCB_BITMAP, PCB_MARKER, PCB_SHAPE, PCB_TARGET, PCB_TRACK, PCB_ARC, PCB_VIA, ZONE, and GERBER_DRAW_ITEM.

Definition at line 222 of file eda_item.h.

 {
 return false; // derived classes should override this function
 }

Referenced by PCB_GRID_HELPER::AlignToNearestPad(), PL_SELECTION_TOOL::guessSelectionCandidates(), EE_SELECTION_TOOL::GuessSelectionCandidates(), LIB_ITEM::HitTest(), DS_DRAW_ITEM_BASE::HitTest(), EE_COLLECTOR::Inspect(), GERBER_COLLECTOR::Inspect(), GENERAL_COLLECTOR::Inspect(), PCB_SELECTION_TOOL::selectionContains(), and PCB_SELECTION_TOOL::selectMultiple().

◆ IncRefCount()

void SCH_SCREEN::IncRefCount ( )

Definition at line 118 of file sch_screen.cpp.

{
 m_refCount++;
}

References m_refCount.

Referenced by SCH_SHEET::SCH_SHEET(), and SCH_SHEET::SetScreen().

◆ InitDataPoints()

void BASE_SCREEN::InitDataPoints ( const VECTOR2I & aPageSizeInternalUnits )

inherited

Definition at line 46 of file base_screen.cpp.

{
 if( m_Center )
 {
 m_DrawOrg.x = -aPageSizeIU.x / 2;
 m_DrawOrg.y = -aPageSizeIU.y / 2;
 }
 else
 {
 m_DrawOrg.x = 0;
 m_DrawOrg.y = 0;
 }
 
 m_LocalOrigin = { 0, 0 };
}

References BASE_SCREEN::m_Center, BASE_SCREEN::m_DrawOrg, BASE_SCREEN::m_LocalOrigin, VECTOR2< T >::x, and VECTOR2< T >::y.

Referenced by BASE_SCREEN::BASE_SCREEN(), FOOTPRINT_EDIT_FRAME::Clear_Pcb(), PCB_EDIT_FRAME::Clear_Pcb(), SCH_SCREEN(), PL_EDITOR_FRAME::SetPageSettings(), GERBVIEW_FRAME::SetPageSettings(), and PCB_BASE_FRAME::SetPageSettings().

◆ IsBrightened()

bool EDA_ITEM::IsBrightened ( ) const

inlineinherited

Definition at line 108 of file eda_item.h.

108{ return m_flags & BRIGHTENED; }

References BRIGHTENED, and EDA_ITEM::m_flags.

Referenced by KIGFX::SCH_PAINTER::draw(), KIGFX::PCB_PAINTER::draw(), KIGFX::GERBVIEW_PAINTER::draw(), SCH_FIND_REPLACE_TOOL::FindNext(), SCH_EDIT_FRAME::FocusOnItem(), KIGFX::DS_RENDER_SETTINGS::GetColor(), KIGFX::PCB_RENDER_SETTINGS::GetColor(), KIGFX::SCH_PAINTER::getLineWidth(), KIGFX::SCH_PAINTER::setDeviceColors(), SCH_FIND_REPLACE_TOOL::UpdateFind(), and SCH_EDITOR_CONTROL::UpdateNetHighlighting().

◆ IsContentModified()

bool BASE_SCREEN::IsContentModified ( ) const

inlineinherited

Definition at line 60 of file base_screen.h.

60{ return m_flagModified; }

BASE_SCREEN::m_flagModified

bool m_flagModified

Indicates current drawing has been modified.

Definition: base_screen.h:132

References BASE_SCREEN::m_flagModified.

Referenced by SCH_EDIT_FRAME::doAutoSave(), PCB_EDIT_FRAME::ExportSpecctraFile(), FP_TREE_SYNCHRONIZING_ADAPTER::GetAttr(), FP_TREE_SYNCHRONIZING_ADAPTER::GetValue(), PL_EDITOR_FRAME::IsContentModified(), FOOTPRINT_EDIT_FRAME::IsContentModified(), PCB_EDIT_FRAME::IsContentModified(), SCH_SHEET_LIST::IsModified(), and SCH_EDIT_FRAME::updateAutoSaveFile().

◆ IsEmpty()

bool SCH_SCREEN::IsEmpty ( ) const

inline

Definition at line 112 of file sch_screen.h.

 {
 return m_rtree.empty();
 }

References EE_RTREE::empty(), and m_rtree.

◆ IsEntered()

bool EDA_ITEM::IsEntered ( ) const

inlineinherited

Definition at line 107 of file eda_item.h.

107{ return m_flags & ENTERED; }

ENTERED

#define ENTERED

indicates a group has been entered

Definition: eda_item_flags.h:72

References ENTERED, and EDA_ITEM::m_flags.

Referenced by KIGFX::PCB_PAINTER::draw().

◆ IsExplicitJunction()

bool SCH_SCREEN::IsExplicitJunction ( const VECTOR2I & aPosition ) const

Indicates that a junction dot is necessary at the given location.

See IsJunctionNeeded for more info.

Definition at line 468 of file sch_screen.cpp.

{
 bool hasExplicitJunction;
 bool hasBusEntry;
 bool isJunction = doIsJunction( aPosition, false, &hasExplicitJunction, &hasBusEntry );
 
 return isJunction && !hasBusEntry;
}

References doIsJunction().

Referenced by SCH_EDIT_TOOL::DoDelete(), and SCH_EDIT_FRAME::SchematicCleanUp().

◆ IsExplicitJunctionAllowed()

bool SCH_SCREEN::IsExplicitJunctionAllowed ( const VECTOR2I & aPosition ) const

Indicates that a juction dot may be placed at the given location.

See IsJunctionNeeded for more info.

Definition at line 705 of file sch_screen.cpp.

{
 bool hasExplicitJunction;
 bool hasBusEntry;
 bool isJunction = doIsJunction( aPosition, true, &hasExplicitJunction, &hasBusEntry );
 
 return isJunction && !hasBusEntry;
}

References doIsJunction().

Referenced by SCH_DRAWING_TOOLS::SingleClickPlace().

◆ IsExplicitJunctionNeeded()

bool SCH_SCREEN::IsExplicitJunctionNeeded ( const VECTOR2I & aPosition ) const

Indicates that a junction dot is necessary at the given location, and does not yet exist.

See IsJunctionNeeded for more info.

Definition at line 478 of file sch_screen.cpp.

{
 bool hasExplicitJunction;
 bool hasBusEntry;
 bool isJunction = doIsJunction( aPosition, false, &hasExplicitJunction, &hasBusEntry );
 
 return isJunction && !hasBusEntry && !hasExplicitJunction;
}

References doIsJunction().

Referenced by SCH_EDIT_FRAME::AddItemToScreenAndUndoList(), SCH_LINE_WIRE_BUS_TOOL::finishSegments(), and SCH_MOVE_TOOL::Main().

◆ IsForceVisible()

bool EDA_ITEM::IsForceVisible ( ) const

inlineinherited

Definition at line 201 of file eda_item.h.

201{ return m_forceVisible; }

EDA_ITEM::m_forceVisible

bool m_forceVisible

Definition: eda_item.h:497

References EDA_ITEM::m_forceVisible.

Referenced by KIGFX::SCH_PAINTER::draw(), and SCH_FIELD::Print().

◆ IsJunction()

bool SCH_SCREEN::IsJunction ( const VECTOR2I & aPosition ) const

Test if a junction is required for the items at aPosition on the screen.

Note that this coule be either an implied junction (bus entry) or an explicit junction (dot).

A junction is required at aPosition if one of the following criteria is satisfied:

One wire midpoint and one or more wire endpoints.
Three or more wire endpoints.
One wire midpoint and a symbol pin.
Two or more wire endpoints and a symbol pin.
One bus midpoint or endpoint and a bus entry.

Parameters

[in] aPosition The position to test.

Returns: True if a junction is required at aPosition.

Definition at line 458 of file sch_screen.cpp.

{
 bool hasExplicitJunction;
 bool hasBusEntry;
 bool isJunction = doIsJunction( aPosition, false, &hasExplicitJunction, &hasBusEntry );
 
 return isJunction;
}

References doIsJunction().

Referenced by SCH_LINE::MergeOverlap().

◆ IsModified()

bool EDA_ITEM::IsModified ( ) const

inlineinherited

Definition at line 102 of file eda_item.h.

102{ return m_flags & IS_CHANGED; }

References IS_CHANGED, and EDA_ITEM::m_flags.

Referenced by PCB_EDIT_FRAME::OpenProjectFiles().

◆ IsMoving()

bool EDA_ITEM::IsMoving ( ) const

inlineinherited

Definition at line 104 of file eda_item.h.

104{ return m_flags & IS_MOVING; }

References IS_MOVING, and EDA_ITEM::m_flags.

Referenced by SCH_EDIT_FRAME::AddItemToScreenAndUndoList(), SCH_EDIT_TOOL::AutoplaceFields(), LIB_PIN::CalcEdit(), KIGFX::SCH_PAINTER::draw(), SYMBOL_EDITOR_EDIT_TOOL::Duplicate(), SCH_EDIT_TOOL::Mirror(), SYMBOL_EDITOR_EDIT_TOOL::Mirror(), PCB_BASE_FRAME::PlaceFootprint(), SCH_EDIT_TOOL::Rotate(), SYMBOL_EDITOR_EDIT_TOOL::Rotate(), and SCH_EDIT_TOOL::Swap().

◆ IsNew()

bool EDA_ITEM::IsNew ( ) const

inlineinherited

Definition at line 103 of file eda_item.h.

103{ return m_flags & IS_NEW; }

References IS_NEW, and EDA_ITEM::m_flags.

Referenced by SCH_EDIT_FRAME::AddItemToScreenAndUndoList(), SCH_EDIT_TOOL::ChangeTextType(), SCH_EDIT_TOOL::ConvertDeMorgan(), EDIT_TOOL::DragArcTrack(), KIGFX::SCH_PAINTER::draw(), SYMBOL_EDITOR_EDIT_TOOL::Duplicate(), SYMBOL_EDITOR_PIN_TOOL::EditPinProperties(), SCH_MOVE_TOOL::getConnectedDragItems(), DIALOG_PIN_PROPERTIES::getSyncPinsMessage(), SYMBOL_EDITOR_DRAWING_TOOLS::Init(), SCH_LINE_WIRE_BUS_TOOL::IsDrawingLineWireOrBus(), EE_POINT_EDITOR::Main(), SCH_MOVE_TOOL::Main(), SYMBOL_EDITOR_MOVE_TOOL::Main(), PL_EDIT_TOOL::Main(), PL_POINT_EDITOR::Main(), EDIT_TOOL::MoveExact(), PCB_BASE_FRAME::PlaceFootprint(), SYMBOL_EDITOR_PIN_TOOL::PlacePin(), DIALOG_LABEL_PROPERTIES::TransferDataFromWindow(), DIALOG_SHAPE_PROPERTIES::TransferDataFromWindow(), DIALOG_SHEET_PIN_PROPERTIES::TransferDataFromWindow(), DIALOG_SHEET_PROPERTIES::TransferDataFromWindow(), and DIALOG_SHEET_PROPERTIES::TransferDataToWindow().

◆ IsReadOnly()

bool SCH_SCREEN::IsReadOnly ( ) const

inline

Definition at line 147 of file sch_screen.h.

147{ return m_isReadOnly; }

References m_isReadOnly.

Referenced by SCH_EDIT_FRAME::updateTitle().

◆ IsReplaceable()

virtual bool EDA_ITEM::IsReplaceable ( ) const

inlinevirtualinherited

Override this method in any derived object that supports test find and replace.

Returns: True if the item has replaceable text that can be modified using the find and replace dialog.

Reimplemented in LIB_TEXTBOX, SCH_FIELD, SCH_LABEL, SCH_SHEET, SCH_SHEET_PIN, SCH_SYMBOL, SCH_TEXT, and SCH_TEXTBOX.

Definition at line 420 of file eda_item.h.

420{ return false; }

Referenced by EDA_ITEM::Matches().

◆ IsRollover()

bool EDA_ITEM::IsRollover ( ) const

inlineinherited

Definition at line 110 of file eda_item.h.

 {
 return ( m_flags & ( IS_ROLLOVER | IS_MOVING ) ) == IS_ROLLOVER;
 }

References IS_MOVING, IS_ROLLOVER, and EDA_ITEM::m_flags.

Referenced by KIGFX::SCH_PAINTER::draw().

◆ IsSelected()

bool EDA_ITEM::IsSelected ( ) const

inlineinherited

Definition at line 106 of file eda_item.h.

106{ return m_flags & SELECTED; }

References EDA_ITEM::m_flags, and SELECTED.

◆ IsShownAsBitmap()

bool EDA_ITEM::IsShownAsBitmap ( ) const

inlineinherited

Definition at line 173 of file eda_item.h.

173{ return m_flags & IS_SHOWN_AS_BITMAP; }

IS_SHOWN_AS_BITMAP

#define IS_SHOWN_AS_BITMAP

Definition: eda_item_flags.h:54

References IS_SHOWN_AS_BITMAP, and EDA_ITEM::m_flags.

◆ IsTerminalPoint()

bool SCH_SCREEN::IsTerminalPoint	(	const VECTOR2I &	aPosition,
		int	aLayer
	)		const

Test if aPosition is a connection point on aLayer.

Parameters

[in]	aPosition	Position to test.
	aLayer	The layer type to test against. Valid layer types are LAYER_NOTES, LAYER_BUS, and LAYER_WIRE.

Returns: True if Position is a connection point on aLayer.

Definition at line 817 of file sch_screen.cpp.

{
 wxCHECK_MSG( aLayer == LAYER_NOTES || aLayer == LAYER_BUS || aLayer == LAYER_WIRE, false,
 wxT( "Invalid layer type passed to SCH_SCREEN::IsTerminalPoint()." ) );
 
 SCH_SHEET_PIN* sheetPin;
 SCH_LABEL_BASE* label;
 
 switch( aLayer )
 {
 case LAYER_BUS:
 if( GetBus( aPosition ) )
 return true;
 
 sheetPin = GetSheetPin( aPosition );
 
 if( sheetPin && sheetPin->IsConnected( aPosition ) )
 return true;
 
 label = GetLabel( aPosition );
 
 if( label && label->IsConnected( aPosition ) )
 return true;
 
 break;
 
 case LAYER_NOTES:
 if( GetLine( aPosition ) )
 return true;
 
 break;
 
 case LAYER_WIRE:
 if( GetItem( aPosition, 1, SCH_BUS_WIRE_ENTRY_T) )
 return true;
 
 if( GetItem( aPosition, 1, SCH_JUNCTION_T ) )
 return true;
 
 if( GetPin( aPosition, nullptr, true ) )
 return true;
 
 if( GetWire( aPosition ) )
 return true;
 
 label = GetLabel( aPosition, 1 );
 
 if( label && label->IsConnected( aPosition ) )
 return true;
 
 sheetPin = GetSheetPin( aPosition );
 
 if( sheetPin && sheetPin->IsConnected( aPosition ) )
 return true;
 
 break;
 
 default:
 break;
 }
 
 return false;
}

References GetBus(), GetItem(), GetLabel(), GetLine(), GetPin(), GetSheetPin(), GetWire(), SCH_ITEM::IsConnected(), LAYER_BUS, LAYER_NOTES, LAYER_WIRE, SCH_BUS_WIRE_ENTRY_T, and SCH_JUNCTION_T.

Referenced by SCH_LINE_WIRE_BUS_TOOL::doDrawSegments(), and SCH_ALTIUM_PLUGIN::ParsePort().

◆ IsType()

virtual bool EDA_ITEM::IsType ( const std::vector< KICAD_T > & aScanTypes ) const

inlinevirtualinherited

Check whether the item is one of the listed types.

Parameters

aScanTypes List of item types

Returns: true if the item type is contained in the list aScanTypes

Reimplemented in SCH_FIELD, SCH_ITEM, SCH_LABEL_BASE, SCH_LINE, FP_SHAPE, FP_TEXT, FP_TEXTBOX, PAD, PCB_DIMENSION_BASE, PCB_SHAPE, PCB_TEXT, PCB_TEXTBOX, and PCB_VIA.

Definition at line 181 of file eda_item.h.

 {
 for( KICAD_T scanType : aScanTypes )
 {
 if( scanType == SCH_LOCATE_ANY_T || scanType == m_structType )
 return true;
 }
 
 return false;
 }

References EDA_ITEM::m_structType, and SCH_LOCATE_ANY_T.

Referenced by SCH_EDIT_TOOL::AutoplaceFields(), ROUTER_TOOL::CanInlineDrag(), DIALOG_SCH_FIELD_PROPERTIES::DIALOG_SCH_FIELD_PROPERTIES(), SCH_FIELD::GetCanonicalName(), KIGFX::SCH_PAINTER::getLineWidth(), SCH_FIELD::GetName(), KIGFX::SCH_PAINTER::getRenderColor(), SCH_FIELD::GetShownText(), SCH_LINE_WIRE_BUS_TOOL::IsDrawingBus(), SCH_LINE_WIRE_BUS_TOOL::IsDrawingLine(), SCH_LINE_WIRE_BUS_TOOL::IsDrawingWire(), SCH_ITEM::IsType(), FP_TEXT::IsType(), FP_TEXTBOX::IsType(), PAD::IsType(), PCB_DIMENSION_BASE::IsType(), PCB_SHAPE::IsType(), PCB_TEXT::IsType(), PCB_TEXTBOX::IsType(), PCB_VIA::IsType(), EE_POINT_EDITOR::Main(), PL_POINT_EDITOR::Main(), CONVERT_TOOL::makePolysFromChainedSegs(), EE_SELECTION_TOOL::RequestSelection(), SCH_FIELD::SetId(), SCH_BASE_FRAME::UpdateItem(), and EDA_ITEM::Visit().

◆ Items() [1/2]

EE_RTREE & SCH_SCREEN::Items ( )

inline

Gets the full RTree, usually for iterating.

N.B. The iteration order of the RTree is not readily apparent and will change if/when you add or move items and the RTree is re-balanced. Any exposure of the RTree contents to the user MUST be sorted before being presented. See SCH_SEXPR_PLUGIN::Format() or SCH_EDITOR_CONTROL::nextMatch() for examples.

Returns: Complete RTree of the screen's items

Definition at line 109 of file sch_screen.h.

109{ return m_rtree; }

References m_rtree.

Referenced by SCH_EAGLE_PLUGIN::addBusEntries(), SCH_MOVE_TOOL::AlignElements(), SCH_SHEET_LIST::AnnotatePowerSymbols(), SCH_EDIT_FRAME::AutoRotateItem(), SCH_EDIT_FRAME::BreakSegmentsOnJunctions(), CONNECTION_GRAPH::buildConnectionGraph(), SCH_SCREENS::buildScreenList(), SCH_SCREENS::ChangeSymbolLibNickname(), SCH_SHEET::CleanupSheet(), ClearAnnotation(), ClearDrawingState(), EE_COLLECTOR::Collect(), SCH_EDIT_FRAME::CommonSettingsChanged(), CountConnectedItems(), SCH_SHEET::CountSheets(), SCH_EDIT_FRAME::DeleteJunction(), SCH_EDIT_FRAME::DisplayCurrentSheet(), KIGFX::SCH_VIEW::DisplaySheet(), doIsJunction(), EnsureAlternateReferencesExist(), CONNECTION_GRAPH::ercCheckHierSheets(), SCH_SHEET_LIST::FillItemMap(), findItemsFromSyncSelection(), SCH_EDITOR_CONTROL::FindSymbolAndItem(), SCH_LINE_WIRE_BUS_TOOL::finishSegments(), FixLegacyPowerSymbolMismatches(), SCHEMATIC::FixupJunctions(), SCH_SEXPR_PLUGIN::Format(), SCH_LEGACY_PLUGIN::Format(), GetBusesAndWires(), SCH_MOVE_TOOL::getConnectedDragItems(), SCH_MOVE_TOOL::getConnectedItems(), GetConnections(), SCH_EDIT_FRAME::GetDocumentExtents(), GetHierarchicalItems(), GetItem(), GetLabel(), GetLabelOrientationForPoint(), GetLine(), GetPin(), AUTOPLACER::getPossibleCollisions(), getSheetBbox(), SCH_LINE_WIRE_BUS_TOOL::getSheetPin(), GetSheetPin(), GetSheets(), SCH_EDIT_FRAME::HardRedraw(), SCH_SHEET::HasUndefinedPins(), SCH_DRAWING_TOOLS::importHierLabel(), SCH_EDIT_TOOL::Init(), CADSTAR_SCH_ARCHIVE_LOADER::Load(), SCH_SEXPR_PLUGIN::loadHierarchy(), SCH_LEGACY_PLUGIN::loadHierarchy(), KI_TEST::LoadHierarchy(), SCH_EAGLE_PLUGIN::loadSheet(), SCH_SHEET::LocatePathOfScreen(), SCH_MOVE_TOOL::Main(), EDIT_POINTS_FACTORY::Make(), NETLIST_EXPORTER_XML::makeSymbols(), MarkConnections(), MigrateSimModels(), SCH_EAGLE_PLUGIN::moveLabels(), SCH_FIND_REPLACE_TOOL::nextMatch(), DIALOG_SHEET_PIN_PROPERTIES::onComboBox(), DIALOG_ERC::OnERCItemRClick(), SCH_ALTIUM_PLUGIN::ParseAltiumSch(), SCH_EDITOR_CONTROL::Paste(), Plot(), Print(), DIALOG_CHANGE_SYMBOLS::processMatchingSymbols(), EE_SELECTION_TOOL::RebuildSelection(), SCH_EDIT_FRAME::RefreshOperatingPointDisplay(), DIALOG_SYMBOL_REMAP::remapSymbolsToLibTable(), Remove(), SCH_EDITOR_CONTROL::RepairSchematic(), SCH_EDIT_FRAME::SaveProject(), SCH_EDIT_FRAME::SchematicCleanUp(), SCH_SHEET::SearchHierarchy(), SetConnectivityDirty(), SetLegacySymbolInstanceData(), SCH_EDIT_FRAME::setupUIConditions(), SCH_SHEET::SymbolCount(), TestDanglingEnds(), ERC_TESTER::TestDuplicateSheetNames(), DIALOG_ERC::testErc(), ERC_TESTER::TestTextVars(), DIALOG_GLOBAL_EDIT_TEXT_AND_GRAPHICS::TransferDataFromWindow(), DIALOG_SHEET_PROPERTIES::TransferDataFromWindow(), DIALOG_SHEET_PIN_PROPERTIES::TransferDataToWindow(), SCH_LINE_WIRE_BUS_TOOL::TrimOverLappingWires(), SCH_EDIT_FRAME::TrimWire(), SCH_DRAWING_TOOLS::TwoClickPlace(), DIALOG_CHANGE_SYMBOLS::updateFieldsList(), SCH_FIND_REPLACE_TOOL::UpdateFind(), UpdateLocalLibSymbolLinks(), SCH_EDITOR_CONTROL::UpdateNetHighlighting(), SCH_EDITOR_CONTROL::updatePastedSheet(), SCH_SHEET_LIST::UpdateSymbolInstanceData(), UpdateSymbolLinks(), and NETLIST_EXPORTER_ORCADPCB2::WriteNetlist().

◆ Items() [2/2]

const EE_RTREE & SCH_SCREEN::Items ( ) const

inline

Definition at line 110 of file sch_screen.h.

110{ return m_rtree; }

References m_rtree.

◆ IterateForward() [1/2]

template<class T >

static INSPECT_RESULT EDA_ITEM::IterateForward	(	std::deque< T > &	aList,
		INSPECTOR	inspector,
		void *	testData,
		const std::vector< KICAD_T > &	scanTypes
	)

inlinestaticinherited

This changes first parameter to avoid the DList and use the main queue instead.

Definition at line 302 of file eda_item.h.

 {
 for( const auto& it : aList )
 {
 if( static_cast<EDA_ITEM*>( it )->Visit( inspector,
 testData,
 scanTypes ) == INSPECT_RESULT::QUIT )
 {
 return INSPECT_RESULT::QUIT;
 }
 }
 
 return INSPECT_RESULT::CONTINUE;
 }

References CONTINUE, QUIT, and EDA_ITEM::Visit().

Referenced by GERBER_FILE_IMAGE::Visit().

◆ IterateForward() [2/2]

template<class T >

static INSPECT_RESULT EDA_ITEM::IterateForward	(	std::vector< T > &	aList,
		INSPECTOR	inspector,
		void *	testData,
		const std::vector< KICAD_T > &	scanTypes
	)

inlinestaticinherited

Change first parameter to avoid the DList and use std::vector instead.

Definition at line 322 of file eda_item.h.

 {
 for( const auto& it : aList )
 {
 if( static_cast<EDA_ITEM*>( it )->Visit( inspector,
 testData,
 scanTypes ) == INSPECT_RESULT::QUIT )
 {
 return INSPECT_RESULT::QUIT;
 }
 }
 
 return INSPECT_RESULT::CONTINUE;
 }

References CONTINUE, QUIT, and EDA_ITEM::Visit().

◆ MarkConnections()

std::set< SCH_ITEM * > SCH_SCREEN::MarkConnections	(	SCH_LINE *	aSegment,
		bool	aSecondPass
	)

Return all wires and junctions connected to aSegment which are not connected any symbol pin.

Parameters

aSegment The segment to test for connections.

Definition at line 392 of file sch_screen.cpp.

{
#define PROCESSED CANDIDATE // Don't use SKIP_STRUCT; IsConnected() returns false if it's set.
 
 std::set<SCH_ITEM*> retval;
 std::stack<SCH_LINE*> to_search;
 
 wxCHECK_MSG( aSegment && aSegment->Type() == SCH_LINE_T, retval, wxT( "Invalid pointer." ) );
 
 to_search.push( aSegment );
 
 while( !to_search.empty() )
 {
 SCH_ITEM* item = to_search.top();
 to_search.pop();
 
 if( item->HasFlag( PROCESSED ) )
 continue;
 
 item->SetFlags( PROCESSED );
 
 for( SCH_ITEM* candidate : Items().Overlapping( SCH_LINE_T, item->GetBoundingBox() ) )
 {
 SCH_LINE* line = static_cast<SCH_LINE*>( candidate );
 
 if( line->HasFlag( PROCESSED ) )
 continue;
 
 // Skip connecting lines on different layers (e.g. buses)
 if( item->GetLayer() != line->GetLayer() )
 continue;
 
 for( VECTOR2I pt : { line->GetStartPoint(), line->GetEndPoint() } )
 {
 if( item->IsConnected( pt ) )
 {
 SCH_ITEM* junction = GetItem( pt, 0, SCH_JUNCTION_T );
 SCH_ITEM* pin = GetItem( pt, 0, SCH_PIN_T );
 
 if( item->IsSelected() && aSecondPass )
 {
 if( junction )
 retval.insert( junction );
 
 retval.insert( line );
 to_search.push( line );
 }
 else if( !junction && !pin )
 {
 retval.insert( line );
 to_search.push( line );
 }
 
 break;
 }
 }
 }
 }
 
 for( SCH_ITEM* item : Items() )
 item->ClearTempFlags();
 
 return retval;
}

References EDA_ITEM::GetBoundingBox(), SCH_LINE::GetEndPoint(), GetItem(), SCH_ITEM::GetLayer(), SCH_LINE::GetStartPoint(), EDA_ITEM::HasFlag(), SCH_ITEM::IsConnected(), EDA_ITEM::IsSelected(), Items(), pin, PROCESSED, SCH_JUNCTION_T, SCH_LINE_T, SCH_PIN_T, EDA_ITEM::SetFlags(), and EDA_ITEM::Type().

Referenced by EE_SELECTION_TOOL::SelectConnection().

◆ Matches() [1/2]

virtual bool EDA_ITEM::Matches	(	const EDA_SEARCH_DATA &	aSearchData,
		void *	aAuxData
	)		const

inlinevirtualinherited

Compare the item against the search criteria in aSearchData.

The base class returns false since many of the objects derived from EDA_ITEM do not have any text to search.

Parameters

aSearchData	A reference to a wxFindReplaceData object containing the search criteria.
aAuxData	A pointer to optional data required for the search or NULL if not used.

Returns: True if the item's text matches the search criteria in aSearchData.

Reimplemented in SCH_MARKER, LIB_TEXTBOX, SCH_FIELD, SCH_LABEL_BASE, SCH_PIN, SCH_SHEET, SCH_SHEET_PIN, SCH_SYMBOL, SCH_TEXT, SCH_TEXTBOX, FP_TEXT, FP_TEXTBOX, NETINFO_ITEM, PCB_MARKER, PCB_TEXT, PCB_TEXTBOX, and ZONE.

Definition at line 382 of file eda_item.h.

 {
 return false;
 }

Referenced by SCH_DRAWING_TOOLS::DrawShape(), SYMBOL_EDITOR_DRAWING_TOOLS::DrawShape(), SCH_FIND_REPLACE_TOOL::HasMatch(), SCH_MARKER::Matches(), LIB_TEXTBOX::Matches(), SCH_FIELD::Matches(), SCH_LABEL_BASE::Matches(), SCH_PIN::Matches(), SCH_SHEET_PIN::Matches(), SCH_TEXT::Matches(), SCH_TEXTBOX::Matches(), FP_TEXT::Matches(), FP_TEXTBOX::Matches(), NETINFO_ITEM::Matches(), PCB_MARKER::Matches(), PCB_TEXT::Matches(), PCB_TEXTBOX::Matches(), ZONE::Matches(), SCH_DRAWING_TOOLS::TwoClickPlace(), SYMBOL_EDITOR_DRAWING_TOOLS::TwoClickPlace(), and SCH_FIND_REPLACE_TOOL::UpdateFind().

◆ Matches() [2/2]

bool EDA_ITEM::Matches	(	const wxString &	aText,
		const EDA_SEARCH_DATA &	aSearchData
	)		const

protectedinherited

Compare aText against search criteria in aSearchData.

This is a helper function for simplify derived class logic.

Parameters

aText	A reference to a wxString object containing the string to test.
aSearchData	The criteria to search against.

Returns: True if aText matches the search criteria in aSearchData.

Definition at line 117 of file eda_item.cpp.

{
 wxString text = aText;
 wxString searchText = aSearchData.findString;
 
 // Don't match if searching for replaceable item and the item doesn't support text replace.
 if( aSearchData.searchAndReplace && !IsReplaceable() )
 return false;
 
 if( !aSearchData.matchCase )
 {
 text.MakeUpper();
 searchText.MakeUpper();
 }
 
 if( aSearchData.matchMode == EDA_SEARCH_MATCH_MODE::WHOLEWORD )
 {
 int ii = 0;
 
 while( ii < (int) text.length() )
 {
 int next = text.find( searchText, ii );
 
 if( next == wxNOT_FOUND )
 return false;
 
 ii = next;
 next += searchText.length();
 
 bool startOK = ( ii == 0 || !wxIsalnum( text.GetChar( ii - 1 ) ) );
 bool endOK = ( next == (int) text.length() || !wxIsalnum( text.GetChar( next ) ) );
 
 if( startOK && endOK )
  return true;
 else
 ii++;
 }
 
 return false;
 }
 else if( aSearchData.matchMode == EDA_SEARCH_MATCH_MODE::WILDCARD )
 {
 return text.Matches( searchText );
 }
 else
 {
 return text.Find( searchText ) != wxNOT_FOUND;
 }
}

References EDA_SEARCH_DATA::findString, EDA_ITEM::IsReplaceable(), EDA_SEARCH_DATA::matchCase, EDA_SEARCH_DATA::matchMode, next(), EDA_SEARCH_DATA::searchAndReplace, text, WHOLEWORD, and WILDCARD.

◆ MigrateSimModels()

void SCH_SCREEN::MigrateSimModels ( )

Migrate any symbols having V6 simulation models to their V7 equivalents.

Definition at line 2032 of file sch_screen.cpp.

{
 LOCALE_IO toggle;
 
 // V6 schematics may specify model names in Value fields, which we don't do in V7.
 // Migrate by adding an equivalent model for these symbols.
 
 for( SCH_ITEM* item : Items().OfType( SCH_SYMBOL_T ) )
 {
 SCH_SYMBOL* symbol = static_cast<SCH_SYMBOL*>( item );
 SIM_MODEL::MigrateSimModel<SCH_SYMBOL, SCH_FIELD>( *symbol, &Schematic()->Prj() );
 }
}

References Items(), Prj(), SCH_SYMBOL_T, and Schematic().

Referenced by SCH_EDIT_FRAME::LoadSheetFromFile(), and SCH_EDITOR_CONTROL::Paste().

◆ operator<()

bool EDA_ITEM::operator< ( const EDA_ITEM & aItem ) const

inherited

Test if another item is less than this object.

Parameters

aItem - Item to compare against.

Returns: - True if aItem is less than the item.

Definition at line 231 of file eda_item.cpp.

{
 wxFAIL_MSG( wxString::Format( wxT( "Less than operator not defined for item type %s." ),
 GetClass() ) );
 
 return false;
}

References Format(), and EDA_ITEM::GetClass().

◆ Plot()

void SCH_SCREEN::Plot ( PLOTTER * aPlotter ) const

Plot all the schematic objects to aPlotter.

Note: This function is useful only for schematic. The library editor and library viewer do not use a draw list and therefore plots nothing.

Parameters

[in] aPlotter The plotter object to plot to.

Sort to ensure plot-order consistency with screen drawing

Definition at line 1113 of file sch_screen.cpp.

{
 // Ensure links are up to date, even if a library was reloaded for some reason:
 std::vector<SCH_ITEM*> junctions;
 std::vector<SCH_ITEM*> bitmaps;
 std::vector<SCH_SYMBOL*> symbols;
 std::vector<SCH_ITEM*> other;
 
 for( SCH_ITEM* item : Items() )
 {
 if( item->IsMoving() )
 continue;
 
 if( item->Type() == SCH_JUNCTION_T )
 junctions.push_back( item );
 else if( item->Type() == SCH_BITMAP_T )
 bitmaps.push_back( item );
 else
 other.push_back( item );
 
 // Where the symbols overlap each other, we need to plot the text items a second
 // time to get them on top of the overlapping element. This collection is in addition
 // to the symbols already collected in `other`
 if( item->Type() == SCH_SYMBOL_T )
 {
 for( SCH_ITEM* sym : m_rtree.Overlapping( SCH_SYMBOL_T, item->GetBoundingBox() ) )
 {
 if( sym != item )
 {
 symbols.push_back( static_cast<SCH_SYMBOL*>( item ) );
 break;
 }
 }
 }
 }
 
 std::sort( other.begin(), other.end(),
 []( const SCH_ITEM* a, const SCH_ITEM* b )
 {
 if( a->Type() == b->Type() )
 return a->GetLayer() > b->GetLayer();
 
 return a->Type() > b->Type();
 } );
 
 int defaultPenWidth = aPlotter->RenderSettings()->GetDefaultPenWidth();
 constexpr bool background = true;
 
 // Bitmaps are drawn first to ensure they are in the background
 // This is particularly important for the wxPostscriptDC (used in *nix printers) as
 // the bitmap PS command clears the screen
 for( const SCH_ITEM* item : bitmaps )
 {
 aPlotter->SetCurrentLineWidth( std::max( item->GetPenWidth(), defaultPenWidth ) );
 item->Plot( aPlotter, background );
 }
 
 for( const SCH_ITEM* item : other )
 {
 aPlotter->SetCurrentLineWidth( std::max( item->GetPenWidth(), defaultPenWidth ) );
 item->Plot( aPlotter, background );
 }
 
 for( const SCH_ITEM* item : other )
 {
 aPlotter->SetCurrentLineWidth( std::max( item->GetPenWidth(), defaultPenWidth ) );
 item->Plot( aPlotter, !background );
 }
 
 // After plotting the symbols as a group above (in `other`), we need to overplot the pins
 // and symbols to ensure that they are always visible
 for( const SCH_SYMBOL* sym :symbols )
 {
 aPlotter->SetCurrentLineWidth( std::max( sym->GetPenWidth(), defaultPenWidth ) );
 
 for( SCH_FIELD field : sym->GetFields() )
 field.Plot( aPlotter, false );
 
 sym->PlotPins( aPlotter );
 
 if( sym->GetDNP() )
 sym->PlotDNP( aPlotter );
 }
 
 for( const SCH_ITEM* item : junctions )
 {
 aPlotter->SetCurrentLineWidth( std::max( item->GetPenWidth(), defaultPenWidth ) );
 item->Plot( aPlotter, !background );
 }
}

References KIGFX::RENDER_SETTINGS::GetDefaultPenWidth(), Items(), m_rtree, EE_RTREE::Overlapping(), PLOTTER::RenderSettings(), SCH_BITMAP_T, SCH_JUNCTION_T, SCH_SYMBOL_T, and PLOTTER::SetCurrentLineWidth().

Referenced by SCH_PLOTTER::plotOneSheetDXF(), SCH_PLOTTER::plotOneSheetHpgl(), SCH_PLOTTER::plotOneSheetPDF(), SCH_PLOTTER::plotOneSheetPS(), and SCH_PLOTTER::plotOneSheetSVG().

◆ Print()

void SCH_SCREEN::Print ( const RENDER_SETTINGS * aSettings )

Print all the items in the screen to aDC.

Note: This function is useful only for schematic. The library editor and library viewer do not use a draw list and therefore draws nothing.

Sort to ensure plot-order consistency with screen drawing

Definition at line 1069 of file sch_screen.cpp.

{
 // Ensure links are up to date, even if a library was reloaded for some reason:
 std::vector<SCH_ITEM*> junctions;
 std::vector<SCH_ITEM*> bitmaps;
 std::vector<SCH_ITEM*> other;
 
 for( SCH_ITEM* item : Items() )
 {
 if( item->IsMoving() )
 continue;
 
 if( item->Type() == SCH_JUNCTION_T )
 junctions.push_back( item );
 else if( item->Type() == SCH_BITMAP_T )
 bitmaps.push_back( item );
 else
 other.push_back( item );
 }
 
 std::stable_sort( other.begin(), other.end(),
 []( const SCH_ITEM* a, const SCH_ITEM* b )
 {
 if( a->Type() == b->Type() )
 return a->GetLayer() > b->GetLayer();
 
 return a->Type() < b->Type();
 } );
 
 for( SCH_ITEM* item : bitmaps )
 item->Print( aSettings, VECTOR2I( 0, 0 ) );
 
 for( SCH_ITEM* item : other )
 item->PrintBackground( aSettings, VECTOR2I( 0, 0 ) );
 
 for( SCH_ITEM* item : other )
 item->Print( aSettings, VECTOR2I( 0, 0 ) );
 
 for( SCH_ITEM* item : junctions )
 item->Print( aSettings, VECTOR2I( 0, 0 ) );
}

References Items(), SCH_BITMAP_T, and SCH_JUNCTION_T.

Referenced by SCH_EDIT_FRAME::PrintPage(), and SCH_PRINTOUT::PrintPage().

◆ Remove()

bool SCH_SCREEN::Remove	(	SCH_ITEM *	aItem,
		bool	aUpdateLibSymbol = `true`
	)

Remove aItem from the schematic associated with this screen.

Note: The removed item is not deleted. It is only unlinked from the item list.

Parameters

[in]	aItem	Item to be removed from schematic.
	aUpdateLibSymbol	removes the library symbol as required when true.

Returns: True if we successfully removed the item

Definition at line 307 of file sch_screen.cpp.

{
 bool retv = m_rtree.remove( aItem );
 
 // Check if the library symbol for the removed schematic symbol is still required.
 if( retv && aItem->Type() == SCH_SYMBOL_T && aUpdateLibSymbol )
 {
 SCH_SYMBOL* removedSymbol = static_cast<SCH_SYMBOL*>( aItem );
 
 bool removeUnusedLibSymbol = true;
 
 for( SCH_ITEM* item : Items().OfType( SCH_SYMBOL_T ) )
 {
 SCH_SYMBOL* symbol = static_cast<SCH_SYMBOL*>( item );
 
 if( removedSymbol->GetSchSymbolLibraryName() == symbol->GetSchSymbolLibraryName() )
 {
 removeUnusedLibSymbol = false;
 break;
 }
 }
 
 if( removeUnusedLibSymbol )
 {
 auto it = m_libSymbols.find( removedSymbol->GetSchSymbolLibraryName() );
 
 if( it != m_libSymbols.end() )
 {
 delete it->second;
 m_libSymbols.erase( it );
 }
 }
 }
 
 return retv;
}

References SCH_SYMBOL::GetSchSymbolLibraryName(), Items(), m_libSymbols, m_rtree, EE_RTREE::OfType(), EE_RTREE::remove(), SCH_SYMBOL_T, and EDA_ITEM::Type().

Referenced by SCH_SHEET_LIST::BuildSheetList(), DeleteItem(), DIALOG_SHEET_PROPERTIES::onSheetFilenameChanged(), DIALOG_CHANGE_SYMBOLS::processSymbols(), DIALOG_SYMBOL_PROPERTIES::TransferDataFromWindow(), Update(), and UpdateSymbolLinks().

◆ RenderAsBitmap()

virtual bool EDA_ITEM::RenderAsBitmap ( double aWorldScale ) const

inlinevirtualinherited

Reimplemented in SCH_ITEM.

Definition at line 163 of file eda_item.h.

163{ return false; }

◆ Replace() [1/2]

virtual bool EDA_ITEM::Replace	(	const EDA_SEARCH_DATA &	aSearchData,
		void *	aAuxData = `nullptr`
	)

inlinevirtualinherited

Perform a text replace using the find and replace criteria in aSearchData on items that support text find and replace.

This function must be overridden for items that support text replace.

Parameters

aSearchData	A reference to a wxFindReplaceData object containing the search and replace criteria.
aAuxData	A pointer to optional data required for the search or NULL if not used.

Returns: True if the item text was modified, otherwise false.

Reimplemented in LIB_TEXTBOX, SCH_LABEL_BASE, SCH_PIN, SCH_TEXT, SCH_TEXTBOX, SCH_FIELD, and SCH_SHEET_PIN.

Definition at line 409 of file eda_item.h.

 {
 return false;
 }

◆ Replace() [2/2]

bool EDA_ITEM::Replace	(	const EDA_SEARCH_DATA &	aSearchData,
		wxString &	aText
	)

staticinherited

Perform a text replace on aText using the find and replace criteria in aSearchData on items that support text find and replace.

Parameters

aSearchData	A reference to a wxFindReplaceData object containing the search and replace criteria.
aText	A reference to a wxString object containing the text to be replaced.

Returns: True if aText was modified, otherwise false.

Definition at line 168 of file eda_item.cpp.

{
 wxString text = aText;
 wxString searchText = aSearchData.findString;
 wxString result;
 bool replaced = false;
 
 if( !aSearchData.matchCase )
 {
 text = text.Upper();
 searchText = searchText.Upper();
 }
 
 int ii = 0;
 
 while( ii < (int) text.length() )
 {
 int next = text.find( searchText, ii );
 
 if( next == wxNOT_FOUND )
 {
 result += aText.Mid( ii, wxString::npos );
 break;
 }
 
 if( next > ii )
 result += aText.Mid( ii, next - ii );
 
 ii = next;
 next += searchText.length();
 
 bool startOK;
 bool endOK;
 
 if( aSearchData.matchMode == EDA_SEARCH_MATCH_MODE::WHOLEWORD )
 {
 startOK = ( ii == 0 || !wxIsalnum( text.GetChar( ii - 1 ) ) );
 endOK = ( next == (int) text.length() || !wxIsalnum( text.GetChar( next ) ) );
 }
 else
 {
 startOK = true;
 endOK = true;
 }
 
 if( startOK && endOK )
 {
 result += aSearchData.replaceString;
 replaced = true;
 ii = next;
 }
 else
 {
 result += aText.GetChar( ii );
 ii++;
 }
 }
 
 aText = result;
 return replaced;
}

References EDA_SEARCH_DATA::findString, EDA_SEARCH_DATA::matchCase, EDA_SEARCH_DATA::matchMode, next(), EDA_SEARCH_DATA::replaceString, text, and WHOLEWORD.

Referenced by EDA_TEXT::Replace(), SCH_FIELD::Replace(), SCH_FIND_REPLACE_TOOL::ReplaceAll(), and SCH_FIND_REPLACE_TOOL::ReplaceAndFindNext().

◆ Schematic()

SCHEMATIC * SCH_SCREEN::Schematic ( ) const

Definition at line 92 of file sch_screen.cpp.

{
 wxCHECK_MSG( GetParent() && GetParent()->Type() == SCHEMATIC_T, nullptr,
 wxT( "SCH_SCREEN must have a SCHEMATIC parent!" ) );
 
 return static_cast<SCHEMATIC*>( GetParent() );
}

References EDA_ITEM::GetParent(), SCHEMATIC_T, and EDA_ITEM::Type().

Referenced by SCH_SCREENS::BuildClientSheetPathList(), SCH_SCREENS::ClearAnnotationOfNewSheetPaths(), KIGFX::SCH_VIEW::DisplaySheet(), MigrateSimModels(), SCH_PLOTTER::plotOneSheetDXF(), SCH_PLOTTER::plotOneSheetHpgl(), SCH_PLOTTER::plotOneSheetPDF(), SCH_PLOTTER::plotOneSheetPS(), SCH_PLOTTER::plotOneSheetSVG(), SCH_PRINTOUT::PrintPage(), RESCUER::RESCUER(), SCH_SHEET_PATH::TestForRecursion(), UpdateSymbolLinks(), and SCH_SCREENS::UpdateSymbolLinks().

◆ Set() [1/3]

template<typename T >

bool INSPECTABLE::Set	(	const wxString &	aProperty,
		T	aValue
	)

inlineinherited

Definition at line 66 of file inspectable.h.

 {
 PROPERTY_MANAGER& propMgr = PROPERTY_MANAGER::Instance();
 TYPE_ID thisType = TYPE_HASH( *this );
 PROPERTY_BASE* prop = propMgr.GetProperty( thisType, aProperty );
 void* object = nullptr;
 
 if( prop )
 {
 object = propMgr.TypeCast( this, thisType, prop->OwnerHash() );
 
 if( object )
 prop->set<T>( object, aValue );
 }
 
 return object != nullptr;
 }

References PROPERTY_MANAGER::GetProperty(), PROPERTY_MANAGER::Instance(), PROPERTY_BASE::OwnerHash(), PROPERTY_BASE::set(), TYPE_HASH, and PROPERTY_MANAGER::TypeCast().

◆ Set() [2/3]

template<typename T >

bool INSPECTABLE::Set	(	PROPERTY_BASE *	aProperty,
		T	aValue
	)

inlineinherited

Definition at line 54 of file inspectable.h.

 {
 PROPERTY_MANAGER& propMgr = PROPERTY_MANAGER::Instance();
 void* object = propMgr.TypeCast( this, TYPE_HASH( *this ), aProperty->OwnerHash() );
 
 if( object )
 aProperty->set<T>( object, aValue );
 
 return object != nullptr;
 }

References PROPERTY_MANAGER::Instance(), PROPERTY_BASE::OwnerHash(), PROPERTY_BASE::set(), TYPE_HASH, and PROPERTY_MANAGER::TypeCast().

◆ Set() [3/3]

bool INSPECTABLE::Set	(	PROPERTY_BASE *	aProperty,
		wxAny &	aValue
	)

inlineinherited

Definition at line 42 of file inspectable.h.

 {
 PROPERTY_MANAGER& propMgr = PROPERTY_MANAGER::Instance();
 void* object = propMgr.TypeCast( this, TYPE_HASH( *this ), aProperty->OwnerHash() );
 
 if( object )
 aProperty->setter( object, aValue );
 
 return object != nullptr;
 }

References PROPERTY_MANAGER::Instance(), PROPERTY_BASE::OwnerHash(), PROPERTY_BASE::setter(), TYPE_HASH, and PROPERTY_MANAGER::TypeCast().

Referenced by PCB_PROPERTIES_PANEL::valueChanged().

◆ SetAuxOrigin()

void SCH_SCREEN::SetAuxOrigin ( const VECTOR2I & aPosition )

inline

Definition at line 153 of file sch_screen.h.

153{ m_aux_origin = aPosition; }

References m_aux_origin.

◆ SetBrightened()

void EDA_ITEM::SetBrightened ( )

inlineinherited

Definition at line 116 of file eda_item.h.

116{ SetFlags( BRIGHTENED ); }

References BRIGHTENED, and EDA_ITEM::SetFlags().

Referenced by KIGFX::SCH_PAINTER::draw(), SCH_EDIT_FRAME::FocusOnItem(), PCB_BASE_FRAME::FocusOnItems(), EE_SELECTION_TOOL::highlight(), PL_SELECTION_TOOL::highlight(), PCB_SELECTION_TOOL::highlightInternal(), and SCH_EDITOR_CONTROL::UpdateNetHighlighting().

◆ SetConnectivityDirty()

void SCH_SCREEN::SetConnectivityDirty ( )

Definition at line 1062 of file sch_screen.cpp.

{
 for( SCH_ITEM* item : Items() )
 item->SetConnectivityDirty( true );
}

References Items().

◆ SetContentModified()

void BASE_SCREEN::SetContentModified ( bool aModified = true )

inlineinherited

Definition at line 59 of file base_screen.h.

59{ m_flagModified = aModified; }

References BASE_SCREEN::m_flagModified.

Referenced by SCH_EDIT_FRAME::AddItemToScreenAndUndoList(), SCH_SHEET_LIST::BuildSheetList(), FOOTPRINT_EDIT_FRAME::Clear_Pcb(), PCB_EDIT_FRAME::Clear_Pcb(), SYMBOL_LIBRARY_MANAGER::ClearLibraryModified(), FOOTPRINT_EDIT_FRAME::ClearModify(), SCH_SHEET_LIST::ClearModifyStatus(), FOOTPRINT_EDITOR_CONTROL::CreateFootprint(), DeleteItem(), SCH_EDIT_FRAME::doAutoSave(), PCB_EDIT_FRAME::doAutoSave(), PCB_EDIT_FRAME::ExportSpecctraFile(), PL_EDITOR_FRAME::Files_io(), PCB_EDIT_FRAME::Files_io_from_id(), SCH_EDIT_FRAME::importFile(), SCH_EDIT_FRAME::InitSheet(), PL_EDITOR_FRAME::LoadDrawingSheetFile(), FOOTPRINT_EDIT_FRAME::LoadFootprintFromBoard(), FOOTPRINT_EDIT_FRAME::LoadFootprintFromLibrary(), SCH_LEGACY_PLUGIN::loadSymbol(), FOOTPRINT_EDITOR_CONTROL::NewFootprint(), SCH_EDIT_FRAME::OnModify(), SYMBOL_EDIT_FRAME::OnModify(), PCB_BASE_FRAME::OnModify(), PL_EDITOR_FRAME::OnModify(), PL_EDITOR_FRAME::OnNewDrawingSheet(), SCH_EDIT_FRAME::OpenProjectFiles(), FOOTPRINT_EDIT_FRAME::OpenProjectFiles(), PCB_EDIT_FRAME::OpenProjectFiles(), SCH_SEXPR_PARSER::parseSchSheetInstances(), DIALOG_SYMBOL_REMAP::remapSymbolsToLibTable(), FOOTPRINT_EDIT_FRAME::RevertFootprint(), SYMBOL_EDIT_FRAME::Save(), SYMBOL_EDIT_FRAME::saveCurrentSymbol(), PL_EDITOR_FRAME::SaveDrawingSheetFile(), PCB_EDIT_FRAME::SavePcbFile(), SCH_EDIT_FRAME::saveSchematicFile(), DIALOG_PAGES_SETTINGS::TransferDataFromWindow(), and SYMBOL_LIBRARY_MANAGER::UpdateSymbol().

◆ SetFileExists()

void SCH_SCREEN::SetFileExists ( bool aFileExists )

inline

Definition at line 149 of file sch_screen.h.

149{ m_fileExists = aFileExists; }

References m_fileExists.

Referenced by SCH_SEXPR_PLUGIN::loadHierarchy(), SCH_LEGACY_PLUGIN::loadHierarchy(), SCH_LEGACY_PLUGIN::Save(), and SCH_SEXPR_PLUGIN::Save().

◆ SetFileFormatVersionAtLoad()

void SCH_SCREEN::SetFileFormatVersionAtLoad ( int aVersion )

inline

Definition at line 128 of file sch_screen.h.

128{ m_fileFormatVersionAtLoad = aVersion; }

References m_fileFormatVersionAtLoad.

Referenced by SCH_SEXPR_PARSER::ParseSchematic().

◆ SetFileName()

void SCH_SCREEN::SetFileName ( const wxString & aFileName )

Set the file name for this screen to aFileName.

Note: Screen file names must be absolute or empty. Absolute file names do not have to exist yet in the case of a new schematic file but file names cannot be relative.

Parameters

aFileName is the absolute file name and path of the screen.

Definition at line 110 of file sch_screen.cpp.

{
 wxASSERT( aFileName.IsEmpty() || wxIsAbsolutePath( aFileName ) );
 
 m_fileName = aFileName;
}

References m_fileName.

Referenced by SCH_EDIT_FRAME::CreateScreens(), SCH_EDIT_FRAME::importFile(), SCH_EDIT_FRAME::InitSheet(), SCH_ALTIUM_PLUGIN::Load(), CADSTAR_SCH_ARCHIVE_PLUGIN::Load(), SCH_EAGLE_PLUGIN::Load(), SCH_SEXPR_PLUGIN::loadHierarchy(), SCH_LEGACY_PLUGIN::loadHierarchy(), KI_TEST::LoadHierarchy(), SCH_EAGLE_PLUGIN::loadSchematic(), SCH_EAGLE_PLUGIN::loadSheet(), CADSTAR_SCH_ARCHIVE_LOADER::loadSheetAndChildSheets(), CADSTAR_SCH_ARCHIVE_LOADER::loadSheets(), DIALOG_SHEET_PROPERTIES::onSheetFilenameChanged(), SCH_EDIT_FRAME::OpenProjectFiles(), SCH_ALTIUM_PLUGIN::ParseAltiumSch(), SCH_ALTIUM_PLUGIN::ParseHarnessType(), SCH_EDIT_FRAME::SaveProject(), and DIALOG_SHEET_PROPERTIES::TransferDataFromWindow().

◆ SetFileReadOnly()

void SCH_SCREEN::SetFileReadOnly ( bool aIsReadOnly )

inline

Definition at line 146 of file sch_screen.h.

146{ m_isReadOnly = aIsReadOnly; }

References m_isReadOnly.

Referenced by SCH_SEXPR_PLUGIN::loadHierarchy(), and SCH_LEGACY_PLUGIN::loadHierarchy().

◆ SetFlags()

void EDA_ITEM::SetFlags ( EDA_ITEM_FLAGS aMask )

inlineinherited

Definition at line 139 of file eda_item.h.

139{ m_flags |= aMask; }

References EDA_ITEM::m_flags.

◆ SetForceVisible()

void EDA_ITEM::SetForceVisible ( bool aEnable )

inlineinherited

Set and clear force visible flag used to force the item to be drawn even if it's draw attribute is set to not visible.

Parameters

aEnable True forces the item to be drawn. False uses the item's visibility setting to determine if the item is to be drawn.

Definition at line 199 of file eda_item.h.

199{ m_forceVisible = aEnable; }

References EDA_ITEM::m_forceVisible.

Referenced by SCH_FIND_REPLACE_TOOL::FindNext(), and SCH_FIND_REPLACE_TOOL::UpdateFind().

◆ SetIsShownAsBitmap()

void EDA_ITEM::SetIsShownAsBitmap ( bool aBitmap )

inlineinherited

Definition at line 165 of file eda_item.h.

 {
 if( aBitmap )
 SetFlags( IS_SHOWN_AS_BITMAP );
 else
 ClearFlags( IS_SHOWN_AS_BITMAP );
 }

References EDA_ITEM::ClearFlags(), IS_SHOWN_AS_BITMAP, and EDA_ITEM::SetFlags().

◆ SetLegacySymbolInstanceData()

void SCH_SCREEN::SetLegacySymbolInstanceData ( )

Update the symbol value and footprint instance data for legacy designs.

Definition at line 1563 of file sch_screen.cpp.

{
 for( SCH_ITEM* item : Items().OfType( SCH_SYMBOL_T ) )
 {
 SCH_SYMBOL* symbol = static_cast<SCH_SYMBOL*>( item );
 
 // Add missing value and footprint instance data for legacy schematics.
 for( const SCH_SYMBOL_INSTANCE& instance : symbol->GetInstanceReferences() )
 {
 symbol->AddHierarchicalReference( instance.m_Path, instance.m_Reference,
 instance.m_Unit );
 }
 }
}

References SCH_SYMBOL::AddHierarchicalReference(), SCH_SYMBOL::GetInstanceReferences(), Items(), and SCH_SYMBOL_T.

Referenced by SCH_SEXPR_PARSER::ParseSchematic().

◆ SetModified()

void EDA_ITEM::SetModified ( )

inherited

Definition at line 64 of file eda_item.cpp.

{
 SetFlags( IS_CHANGED );
 
 // If this a child object, then the parent modification state also needs to be set.
 if( m_parent )
 m_parent->SetModified();
}

References IS_CHANGED, EDA_ITEM::m_parent, EDA_ITEM::SetFlags(), and EDA_ITEM::SetModified().

Referenced by SYMBOL_EDITOR_PIN_TOOL::EditPinProperties(), LEGACY_PLUGIN::loadZONE_CONTAINER(), SCH_LINE::Move(), SCH_SYMBOL::Move(), SCH_LINE::MoveEnd(), SCH_LINE::MoveStart(), LIB_PIN::MoveTo(), PCB_EDIT_FRAME::OpenProjectFiles(), ALTIUM_PCB::Parse(), SCH_ALTIUM_PLUGIN::ParseFileHeader(), PCB_PARSER::parseZONE(), LIB_SYMBOL::RemoveDrawItem(), SCH_SYMBOL::SetConvert(), SCH_SYMBOL::SetLibId(), EDA_ITEM::SetModified(), LIB_FIELD::SetName(), SCH_SYMBOL::SetTransform(), and SCH_SYMBOL::SetUnit().

◆ SetPageCount()

void BASE_SCREEN::SetPageCount ( int aPageCount )

inherited

Definition at line 63 of file base_screen.cpp.

{
 wxCHECK( aPageCount > 0, /* void */ );
 
 m_pageCount = aPageCount;
}

References BASE_SCREEN::m_pageCount.

Referenced by SCH_LEGACY_PLUGIN::loadPageSettings(), and SCHEMATIC::SetSheetNumberAndCount().

◆ SetPageNumber()

void BASE_SCREEN::SetPageNumber ( const wxString & aPageNumber )

inlineinherited

Definition at line 79 of file base_screen.h.

79{ m_pageNumber = aPageNumber; }

References BASE_SCREEN::m_pageNumber.

Referenced by SCH_EDIT_FRAME::CreateScreens(), SCH_EDIT_TOOL::EditPageNumber(), HIERARCHY_PANE::onRightClick(), and SCHEMATIC::SetSheetNumberAndCount().

◆ SetPageSettings()

void SCH_SCREEN::SetPageSettings ( const PAGE_INFO & aPageSettings )

inline

Definition at line 132 of file sch_screen.h.

132{ m_paper = aPageSettings; }

References m_paper.

Referenced by SYMBOL_EDITOR_CONTROL::ExportSymbolAsSVG(), CADSTAR_SCH_ARCHIVE_LOADER::Load(), SCH_LEGACY_PLUGIN::loadPageSettings(), SCH_EAGLE_PLUGIN::loadSheet(), SCH_SEXPR_PARSER::ParseSchematic(), SCH_ALTIUM_PLUGIN::ParseSheet(), and SCH_BASE_FRAME::SetPageSettings().

◆ SetParent()

virtual void EDA_ITEM::SetParent ( EDA_ITEM * aParent )

inlinevirtualinherited

Reimplemented in LIB_SYMBOL.

Definition at line 100 of file eda_item.h.

100{ m_parent = aParent; }

References EDA_ITEM::m_parent.

◆ SetPosition()

virtual void EDA_ITEM::SetPosition ( const VECTOR2I & aPos )

inlinevirtualinherited

Reimplemented in DELETED_SHEET_ITEM, DELETED_BOARD_ITEM, PCB_GROUP, PCB_VIA, LIB_PIN, SCH_SHAPE, GERBER_DRAW_ITEM, DS_DRAW_ITEM_LINE, DS_DRAW_ITEM_POLYPOLYGONS, DS_DRAW_ITEM_RECT, DS_DRAW_ITEM_PAGE, DS_DRAW_ITEM_TEXT, DS_DRAW_ITEM_BITMAP, BOARD, FOOTPRINT, FP_TEXT, NETINFO_ITEM, PAD, PCB_DIMENSION_BASE, PCB_MARKER, PCB_SHAPE, PCB_TARGET, PCB_TEXT, PCB_TRACK, PCB_ARC, ZONE, LIB_ITEM, LIB_SHAPE, SCH_BITMAP, SCH_BUS_ENTRY_BASE, SCH_FIELD, SCH_JUNCTION, SCH_LINE, SCH_MARKER, SCH_NO_CONNECT, SCH_PIN, SCH_SHEET, SCH_SHEET_PIN, SCH_SYMBOL, SCH_TEXT, KIGFX::ORIGIN_VIEWITEM, and PCB_BITMAP.

Definition at line 250 of file eda_item.h.

250{};

Referenced by EDIT_TOOL::doMoveSelection(), BOARD_EDITOR_CONTROL::DoSetDrillOrigin(), PCB_CONTROL::DoSetGridOrigin(), DRAWING_TOOL::DrawVia(), PL_DRAWING_TOOLS::PlaceItem(), BOARD_ITEM::SetX(), BOARD_ITEM::SetY(), SCH_DRAWING_TOOLS::SingleClickPlace(), SCH_EDIT_TOOL::Swap(), and SCH_DRAWING_TOOLS::TwoClickPlace().

◆ SetSelected()

void EDA_ITEM::SetSelected ( )

inlineinherited

Definition at line 115 of file eda_item.h.

115{ SetFlags( SELECTED ); }

References SELECTED, and EDA_ITEM::SetFlags().

Referenced by PANEL_EESCHEMA_COLOR_SETTINGS::createPreviewItems(), KIGFX::SCH_PAINTER::draw(), EE_SELECTION_TOOL::highlight(), PL_SELECTION_TOOL::highlight(), PCB_SELECTION_TOOL::highlightInternal(), SCH_LINE::MergeOverlap(), DS_PROXY_UNDO_ITEM::Restore(), EE_TOOL_BASE< T >::saveCopyInUndoList(), and GERBVIEW_SELECTION_TOOL::selectVisually().

◆ SetState()

void EDA_ITEM::SetState	(	EDA_ITEM_FLAGS	type,
		bool	state
	)

inlineinherited

Definition at line 128 of file eda_item.h.

 {
 if( state )
 m_status |= type; // state = ON or OFF
 else
 m_status &= ~type;
 }

References EDA_ITEM::m_status.

Referenced by LEGACY_PLUGIN::loadTrackList(), and TRACKS_CLEANER::mergeCollinearSegments().

◆ SetStatus()

void EDA_ITEM::SetStatus ( EDA_ITEM_FLAGS aStatus )

inlineinherited

Definition at line 137 of file eda_item.h.

137{ m_status = aStatus; }

References EDA_ITEM::m_status.

Referenced by BOARD_NETLIST_UPDATER::UpdateNetlist().

◆ SetTitleBlock()

void SCH_SCREEN::SetTitleBlock ( const TITLE_BLOCK & aTitleBlock )

inline

Definition at line 157 of file sch_screen.h.

157{ m_titles = aTitleBlock; }

References m_titles.

Referenced by SCH_LEGACY_PLUGIN::loadPageSettings(), SCH_ALTIUM_PLUGIN::ParseFileHeader(), SCH_SEXPR_PARSER::ParseSchematic(), and SCH_BASE_FRAME::SetTitleBlock().

◆ SetVirtualPageNumber()

void BASE_SCREEN::SetVirtualPageNumber ( int aPageNumber )

inlineinherited

Definition at line 76 of file base_screen.h.

76{ m_virtualPageNumber = aPageNumber; }

References BASE_SCREEN::m_virtualPageNumber.

Referenced by SCH_LEGACY_PLUGIN::loadPageSettings(), PL_EDITOR_FRAME::PrintPage(), PLEDITOR_PRINTOUT::PrintPage(), SCH_EDIT_FRAME::SaveProject(), and SCHEMATIC::SetSheetNumberAndCount().

◆ Sort()

static bool EDA_ITEM::Sort	(	const EDA_ITEM *	aLeft,
		const EDA_ITEM *	aRight
	)

inlinestaticinherited

Helper function to be used by the C++ STL sort algorithm for sorting a STL container of EDA_ITEM pointers.

Parameters

aLeft	The left hand item to compare.
aRight	The right hand item to compare.

Returns: True if aLeft is less than aRight.

Definition at line 438 of file eda_item.h.

438{ return *aLeft < *aRight; }

◆ TestDanglingEnds()

void SCH_SCREEN::TestDanglingEnds	(	const SCH_SHEET_PATH *	aPath = `nullptr`,
		std::function< void(SCH_ITEM )>	aChangedHandler = `nullptr`
	)		const

Test all of the connectable objects in the schematic for unused connection points.

Parameters

aPath	is a sheet path to pass to UpdateDanglingState if desired.
aChangedHandler	is an optional callback to make on each changed item.

Definition at line 1355 of file sch_screen.cpp.

{
 std::vector<DANGLING_END_ITEM> endPoints;
 
 for( SCH_ITEM* item : Items() )
 {
 if( item->IsConnectable() )
 {
 endPoints.clear();
 
 for( SCH_ITEM* overlapping : Items().Overlapping( item->GetBoundingBox() ) )
 overlapping->GetEndPoints( endPoints );
 
 if( item->UpdateDanglingState( endPoints, aPath ) )
 {
 if( aChangedHandler )
 (*aChangedHandler)( item );
 }
 }
 }
}

References Items().

Referenced by SCH_EDIT_FRAME::importFile(), SCH_EDIT_FRAME::TestDanglingEnds(), and SCH_MOVE_TOOL::trimDanglingLines().

◆ Type()

KICAD_T EDA_ITEM::Type ( ) const

inlineinherited

Returns the type of object.

This attribute should never be changed after a ctor sets it, so there is no public "setter" method.

Returns: the type of object.

Definition at line 97 of file eda_item.h.

97{ return m_structType; }

References EDA_ITEM::m_structType.

◆ Update()

void SCH_SCREEN::Update	(	SCH_ITEM *	aItem,
		bool	aUpdateLibSymbol = `true`
	)

Update aItem's bounding box in the tree.

Parameters

[in]	aItem	Item that needs to be updated.
	aUpdateLibSymbol	removes the library symbol as required when true.

Definition at line 300 of file sch_screen.cpp.

{
 if( Remove( aItem, aUpdateLibSymbol ) )
 Append( aItem, aUpdateLibSymbol );
}

References Append(), and Remove().

Referenced by CADSTAR_SCH_ARCHIVE_LOADER::Load(), SCH_EAGLE_PLUGIN::loadSheet(), SCH_DRAWING_TOOLS::PlaceSymbol(), SCH_EDIT_FRAME::RecalculateConnections(), SCHEMATIC::RecomputeIntersheetRefs(), SCH_SHEET_PATH::UpdateAllScreenReferences(), and SCH_BASE_FRAME::UpdateItem().

◆ UpdateLocalLibSymbolLinks()

void SCH_SCREEN::UpdateLocalLibSymbolLinks ( )

Initialize the LIB_SYMBOL reference for each SCH_SYMBOL found in this schematic with the local project library symbols.

Definition at line 1036 of file sch_screen.cpp.

{
 std::vector<SCH_SYMBOL*> symbols;
 
 for( SCH_ITEM* item : Items().OfType( SCH_SYMBOL_T ) )
 symbols.push_back( static_cast<SCH_SYMBOL*>( item ) );
 
 for( SCH_SYMBOL* symbol : symbols )
 {
 // Changing the symbol may adjust the bbox of the symbol; remove and reinsert it afterwards.
 m_rtree.remove( symbol );
 
 auto it = m_libSymbols.find( symbol->GetSchSymbolLibraryName() );
 
 LIB_SYMBOL* libSymbol = nullptr;
 
 if( it != m_libSymbols.end() )
 libSymbol = new LIB_SYMBOL( *it->second );
 
 symbol->SetLibSymbol( libSymbol );
 
 m_rtree.insert( symbol );
 }
}

References EE_RTREE::insert(), Items(), m_libSymbols, m_rtree, EE_RTREE::remove(), and SCH_SYMBOL_T.

Referenced by SCH_SEXPR_PARSER::ParseSchematic().

◆ UpdateSymbolLinks()

void SCH_SCREEN::UpdateSymbolLinks ( REPORTER * aReporter = nullptr )

Initialize the LIB_SYMBOL reference for each SCH_SYMBOL found in this schematic from the project SYMBOL_LIB_TABLE.

Symbol library links are set using the symbol library table and will fall back to the cache only if the cache is loaded. The cache should only be loaded when opening legacy schematic files.

Note: This should only be called when the user specifically requests all library symbol links to be updated or when the legacy schematic is opened for the last time. All subsequent schematic loads with the new s-expression will contain the library symbols and should call UpdateLocalLibSymbolLinks.

Parameters

[in] aReporter Optional REPORTER object to write status and error messages into.

Definition at line 882 of file sch_screen.cpp.

{
 wxCHECK_RET( Schematic(), "Cannot call SCH_SCREEN::UpdateSymbolLinks with no SCHEMATIC" );
 
 wxString msg;
 std::unique_ptr< LIB_SYMBOL > libSymbol;
 std::vector<SCH_SYMBOL*> symbols;
 SYMBOL_LIB_TABLE* libs = Schematic()->Prj().SchSymbolLibTable();
 
 // This will be a nullptr if an s-expression schematic is loaded.
 SYMBOL_LIBS* legacyLibs = Schematic()->Prj().SchLibs();
 
 for( SCH_ITEM* item : Items().OfType( SCH_SYMBOL_T ) )
  symbols.push_back( static_cast<SCH_SYMBOL*>( item ) );
 
 // Remove them from the R tree. There bounding box size may change.
 for( SCH_SYMBOL* symbol : symbols )
 Remove( symbol );
 
 // Clear all existing symbol links.
 clearLibSymbols();
 
 for( SCH_SYMBOL* symbol : symbols )
 {
 LIB_SYMBOL* tmp = nullptr;
 libSymbol.reset();
 
 // If the symbol is already in the internal library, map the symbol to it.
 auto it = m_libSymbols.find( symbol->GetSchSymbolLibraryName() );
 
 if( ( it != m_libSymbols.end() ) )
 {
 if( aReporter )
 {
 msg.Printf( _( "Setting schematic symbol '%s %s' library identifier to '%s'." ),
 symbol->GetField( REFERENCE_FIELD )->GetText(),
 symbol->GetField( VALUE_FIELD )->GetText(),
 UnescapeString( symbol->GetLibId().Format() ) );
 aReporter->ReportTail( msg, RPT_SEVERITY_INFO );
 }
 
 // Internal library symbols are already flattened so just make a copy.
 symbol->SetLibSymbol( new LIB_SYMBOL( *it->second ) );
 continue;
 }
 
 if( !symbol->GetLibId().IsValid() )
 {
 if( aReporter )
 {
 msg.Printf( _( "Schematic symbol reference '%s' library identifier is not valid. "
 "Unable to link library symbol." ),
 UnescapeString( symbol->GetLibId().Format() ) );
 aReporter->ReportTail( msg, RPT_SEVERITY_WARNING );
 }
 
 continue;
 }
 
 // LIB_TABLE_BASE::LoadSymbol() throws an IO_ERROR if the library nickname
 // is not found in the table so check if the library still exists in the table
 // before attempting to load the symbol.
 if( !libs->HasLibrary( symbol->GetLibId().GetLibNickname() ) && !legacyLibs )
 {
 if( aReporter )
 {
 msg.Printf( _( "Symbol library '%s' not found and no fallback cache library "
 "available. Unable to link library symbol." ),
 symbol->GetLibId().GetLibNickname().wx_str() );
 aReporter->ReportTail( msg, RPT_SEVERITY_WARNING );
 }
 
 continue;
 }
 
 if( libs->HasLibrary( symbol->GetLibId().GetLibNickname() ) )
 {
 try
 {
 tmp = libs->LoadSymbol( symbol->GetLibId() );
 }
 catch( const IO_ERROR& ioe )
 {
 if( aReporter )
 {
 msg.Printf( _( "I/O error %s resolving library symbol %s" ), ioe.What(),
 UnescapeString( symbol->GetLibId().Format() ) );
 aReporter->ReportTail( msg, RPT_SEVERITY_ERROR );
 }
 }
 }
 
 if( !tmp && legacyLibs && legacyLibs->GetLibraryCount() )
 {
 SYMBOL_LIB& legacyCacheLib = legacyLibs->back();
 
  // It better be the cache library.
 wxCHECK2( legacyCacheLib.IsCache(), continue );
 
 wxString id = symbol->GetLibId().Format();
 
 id.Replace( ':', '_' );
 
 if( aReporter )
 {
 msg.Printf( _( "Falling back to cache to set symbol '%s:%s' link '%s'." ),
 symbol->GetField( REFERENCE_FIELD )->GetText(),
 symbol->GetField( VALUE_FIELD )->GetText(),
 UnescapeString( id ) );
 aReporter->ReportTail( msg, RPT_SEVERITY_WARNING );
 }
 
 tmp = legacyCacheLib.FindSymbol( id );
 }
 
 if( tmp )
 {
 // We want a full symbol not just the top level child symbol.
 libSymbol = tmp->Flatten();
 libSymbol->SetParent();
 
 m_libSymbols.insert( { symbol->GetSchSymbolLibraryName(),
 new LIB_SYMBOL( *libSymbol.get() ) } );
 
 if( aReporter )
 {
 msg.Printf( _( "Setting schematic symbol '%s %s' library identifier to '%s'." ),
 symbol->GetField( REFERENCE_FIELD )->GetText(),
 symbol->GetField( VALUE_FIELD )->GetText(),
 UnescapeString( symbol->GetLibId().Format() ) );
 aReporter->ReportTail( msg, RPT_SEVERITY_INFO );
 }
 }
 else
 {
 if( aReporter )
 {
 msg.Printf( _( "No library symbol found for schematic symbol '%s %s'." ),
 symbol->GetField( REFERENCE_FIELD )->GetText(),
 symbol->GetField( VALUE_FIELD )->GetText() );
 aReporter->ReportTail( msg, RPT_SEVERITY_ERROR );
 }
 }
 
 symbol->SetLibSymbol( libSymbol.release() );
 }
 
 // Changing the symbol may adjust the bbox of the symbol. This re-inserts the
 // item with the new bbox
 for( SCH_SYMBOL* symbol : symbols )
 Append( symbol );
}

References _, Append(), clearLibSymbols(), SYMBOL_LIB::FindSymbol(), LIB_SYMBOL::Flatten(), SYMBOL_LIBS::GetLibraryCount(), LIB_TABLE::HasLibrary(), SYMBOL_LIB::IsCache(), Items(), SYMBOL_LIB_TABLE::LoadSymbol(), m_libSymbols, SCHEMATIC::Prj(), REFERENCE_FIELD, Remove(), REPORTER::ReportTail(), RPT_SEVERITY_ERROR, RPT_SEVERITY_INFO, RPT_SEVERITY_WARNING, SCH_SYMBOL_T, Schematic(), UnescapeString(), VALUE_FIELD, and IO_ERROR::What().

Referenced by SCH_EDITOR_CONTROL::ExportSymbolsToLibrary().

◆ ViewBBox()

const BOX2I EDA_ITEM::ViewBBox ( ) const

overridevirtualinherited

Return the bounding box of the item covering all its layers.

Returns: the current bounding box.

Implements KIGFX::VIEW_ITEM.

Reimplemented in LIB_PIN, SCH_PIN, GERBER_DRAW_ITEM, DS_PROXY_VIEW_ITEM, KIGFX::ORIGIN_VIEWITEM, KIGFX::PREVIEW::ARC_ASSISTANT, KIGFX::PREVIEW::CENTRELINE_RECT_ITEM, KIGFX::PREVIEW::POLYGON_ITEM, KIGFX::PREVIEW::RULER_ITEM, KIGFX::PREVIEW::SELECTION_AREA, KIGFX::PREVIEW::TWO_POINT_ASSISTANT, EDIT_POINTS, FOOTPRINT, FP_TEXT, PAD, PCB_DIMENSION_BASE, PCB_DIM_CENTER, PCB_MARKER, PCB_SHAPE, PCB_TRACK, RATSNEST_VIEW_ITEM, ROUTER_PREVIEW_ITEM, and MY_DRAWING.

Definition at line 254 of file eda_item.cpp.

{
 // Basic fallback
 return GetBoundingBox();
}

References EDA_ITEM::GetBoundingBox().

Referenced by EDIT_TOOL::doMoveSelection(), GERBVIEW_FRAME::GetDocumentExtents(), EDIT_TOOL::Rotate(), PCB_DIMENSION_BASE::ViewBBox(), and PCB_SHAPE::ViewBBox().

◆ ViewDraw()

virtual void KIGFX::VIEW_ITEM::ViewDraw	(	int	aLayer,
		VIEW *	aView
	)		const

inlinevirtualinherited

Draw the parts of the object belonging to layer aLayer.

An alternative way for drawing objects if there is no #PAINTER assigned for the view or if the PAINTER doesn't know how to paint this particular implementation of VIEW_ITEM. The preferred way of drawing is to design an appropriate PAINTER object, the method below is intended only for quick hacks and debugging purposes.

Parameters

aLayer	is the current drawing layer.
aView	is a pointer to the VIEW device we are drawing on.

Reimplemented in DS_PROXY_VIEW_ITEM, KIGFX::PREVIEW::SIMPLE_OVERLAY_ITEM, EDIT_POINTS, RATSNEST_VIEW_ITEM, ROUTER_PREVIEW_ITEM, MY_DRAWING, KIGFX::PREVIEW::ARC_ASSISTANT, KIGFX::PREVIEW::RULER_ITEM, KIGFX::PREVIEW::SELECTION_AREA, KIGFX::PREVIEW::TWO_POINT_ASSISTANT, KIGFX::ORIGIN_VIEWITEM, KIGFX::VIEW_GROUP, and KIGFX::VIEW_OVERLAY.

Definition at line 106 of file view_item.h.

107 {}

Referenced by KIGFX::VIEW::draw(), and KIGFX::VIEW::updateItemGeometry().

◆ ViewGetLayers()

void EDA_ITEM::ViewGetLayers	(	int	aLayers[],
		int &	aCount
	)		const

overridevirtualinherited

Return the all the layers within the VIEW the object is painted on.

For instance, a PAD spans zero or more copper layers and a few technical layers. ViewDraw() or PAINTER::Draw() is repeatedly called for each of the layers returned by ViewGetLayers(), depending on the rendering order.

Parameters

aLayers[]	is the output layer index array.
aCount	is the number of layer indices in aLayers[].

Implements KIGFX::VIEW_ITEM.

Reimplemented in LIB_FIELD, LIB_ITEM, LIB_PIN, LIB_SHAPE, LIB_SYMBOL, LIB_TEXT, LIB_TEXTBOX, SCH_BITMAP, SCH_BUS_ENTRY_BASE, SCH_ITEM, SCH_JUNCTION, SCH_LABEL_BASE, SCH_GLOBALLABEL, SCH_LINE, SCH_MARKER, SCH_NO_CONNECT, SCH_PIN, SCH_SHAPE, SCH_SHEET, SCH_SYMBOL, SCH_TEXT, GERBER_DRAW_ITEM, BOARD_ITEM, DS_DRAW_ITEM_BASE, DS_PROXY_VIEW_ITEM, KIGFX::ORIGIN_VIEWITEM, PCB_GROUP, KIGFX::PREVIEW::ARC_ASSISTANT, KIGFX::PREVIEW::RULER_ITEM, KIGFX::PREVIEW::SIMPLE_OVERLAY_ITEM, KIGFX::PREVIEW::TWO_POINT_ASSISTANT, EDIT_POINTS, FOOTPRINT, FP_TEXT, FP_TEXTBOX, PAD, PCB_BITMAP, PCB_MARKER, PCB_TRACK, PCB_VIA, RATSNEST_VIEW_ITEM, ROUTER_PREVIEW_ITEM, ZONE, and MY_DRAWING.

Definition at line 261 of file eda_item.cpp.

{
 // Basic fallback
 aCount = 1;
 aLayers[0] = 0;
}

◆ ViewGetLOD()

virtual double KIGFX::VIEW_ITEM::ViewGetLOD	(	int	aLayer,
		VIEW *	aView
	)		const

inlinevirtualinherited

Return the level of detail (LOD) of the item.

A level of detail is the minimal VIEW scale that is sufficient for an item to be shown on a given layer.

Parameters

aLayer	is the current drawing layer.
aView	is a pointer to the VIEW device we are drawing on.

Returns: the level of detail. 0 always show the item, because the actual zoom level (or VIEW scale) is always > 0

Reimplemented in SCH_LINE, GERBER_DRAW_ITEM, PCB_GROUP, FOOTPRINT, FP_SHAPE, FP_TEXT, FP_TEXTBOX, PAD, PCB_BITMAP, PCB_SHAPE, PCB_TEXT, PCB_TEXTBOX, PCB_TRACK, PCB_VIA, ZONE, and FP_ZONE.

Definition at line 132 of file view_item.h.

 {
 // By default always show the item
 return 0.0;
 }

Referenced by PNS_KICAD_IFACE::IsItemVisible(), KIGFX::VIEW::DRAW_ITEM_VISITOR::operator()(), EE_GRID_HELPER::queryVisible(), and PCB_GRID_HELPER::queryVisible().

◆ viewPrivData()

VIEW_ITEM_DATA * KIGFX::VIEW_ITEM::viewPrivData ( ) const

inlineinherited

◆ Visit()

INSPECT_RESULT EDA_ITEM::Visit	(	INSPECTOR	inspector,
		void *	testData,
		const std::vector< KICAD_T > &	aScanTypes
	)

virtualinherited

May be re-implemented for each derived class in order to handle all the types given by its member data.

Implementations should call inspector->Inspect() on types in aScanTypes, and may use IterateForward() to do so on lists of such data.

Parameters

inspector	An INSPECTOR instance to use in the inspection.
testData	Arbitrary data used by the inspector.
aScanTypes	Which KICAD_T types are of interest and the order in which they should be processed.

Returns: #SEARCH_RESULT SEARCH_QUIT if the Iterator is to stop the scan, else #SCAN_CONTINUE, and determined by the inspector.

Reimplemented in PCB_GROUP, LIB_SYMBOL, SCH_SHEET, SCH_SYMBOL, GBR_LAYOUT, GERBER_DRAW_ITEM, GERBER_FILE_IMAGE, FOOTPRINT, PCB_TRACK, SCH_LABEL_BASE, and BOARD.

Definition at line 91 of file eda_item.cpp.

{
#if 0 && defined(DEBUG)
 std::cout << GetClass().mb_str() << ' ';
#endif
 
 if( IsType( aScanTypes ) )
 {
 if( INSPECT_RESULT::QUIT == inspector( this, testData ) )
 return INSPECT_RESULT::QUIT;
 }
 
 return INSPECT_RESULT::CONTINUE;
}

References CONTINUE, EDA_ITEM::GetClass(), EDA_ITEM::IsType(), and QUIT.

Referenced by PCB_TYPE_COLLECTOR::Collect(), PCB_LAYER_COLLECTOR::Collect(), GENERAL_COLLECTOR::Collect(), GERBER_COLLECTOR::Collect(), EDA_ITEM::IterateForward(), and PCB_BASE_FRAME::UpdateUserUnits().

◆ XorFlags()

void EDA_ITEM::XorFlags ( EDA_ITEM_FLAGS aMask )

inlineinherited

Definition at line 140 of file eda_item.h.

140{ m_flags ^= aMask; }

References EDA_ITEM::m_flags.

Referenced by EE_SELECTION_TOOL::selectMultiple().

Member Data Documentation

◆ m_aliases

std::set< std::shared_ptr< BUS_ALIAS > > SCH_SCREEN::m_aliases

private

List of bus aliases stored in this screen.

Definition at line 620 of file sch_screen.h.

Referenced by AddBusAlias(), ClearBusAliases(), and GetBusAliases().

◆ m_aux_origin

VECTOR2I SCH_SCREEN::m_aux_origin

private

Definition at line 605 of file sch_screen.h.

Referenced by GetAuxOrigin(), and SetAuxOrigin().

◆ m_Center

bool BASE_SCREEN::m_Center

inherited

Center on screen.

If true (0.0) is centered on screen coordinates can be < 0 and > 0 except for schematics. false: when coordinates can only be >= 0 (schematics).

Definition at line 96 of file base_screen.h.

Referenced by BASE_SCREEN::BASE_SCREEN(), BASE_SCREEN::InitDataPoints(), SCH_SCREEN(), and SYMBOL_VIEWER_FRAME::SYMBOL_VIEWER_FRAME().

◆ m_clientSheetPathList

std::vector<SCH_SHEET_PATH> SCH_SCREEN::m_clientSheetPathList

private

The list of sheet paths sharing this screen.

Used in some annotation calculations to update alternate references.

Note: a screen having a m_refCount = 1 (only one sheet path using it) can have many sheet paths sharing this screen if it is inside another sheet having many instances.

Definition at line 600 of file sch_screen.h.

Referenced by GetClientSheetPaths().

◆ m_DrawingSheetFileName

wxString BASE_SCREEN::m_DrawingSheetFileName

staticinherited

the name of the drawing sheet file, or empty to use the default drawing sheet

Definition at line 85 of file base_screen.h.

Referenced by PL_EDITOR_FRAME::GetCurrentFileName(), SCH_EDIT_FRAME::importFile(), SCH_EDIT_FRAME::LoadProjectSettings(), PCB_EDIT_FRAME::LoadProjectSettings(), BOARD_EDITOR_CONTROL::PageSettings(), SCH_EDITOR_CONTROL::PageSetup(), DIALOG_PAGES_SETTINGS::SavePageSettings(), PCB_EDIT_FRAME::SaveProjectLocalSettings(), SCH_EDIT_FRAME::saveProjectSettings(), PL_EDITOR_FRAME::SetCurrentFileName(), and DIALOG_PAGES_SETTINGS::TransferDataToWindow().

◆ m_DrawOrg

VECTOR2I BASE_SCREEN::m_DrawOrg

inherited

offsets for drawing the circuit on the screen

Definition at line 88 of file base_screen.h.

Referenced by SCH_EDIT_FRAME::DrawCurrentSheetToClipboard(), BASE_SCREEN::InitDataPoints(), PLEDITOR_PRINTOUT::PrintPage(), and SCH_PRINTOUT::PrintPage().

◆ m_fileExists

bool SCH_SCREEN::m_fileExists

private

Definition at line 617 of file sch_screen.h.

Referenced by FileExists(), and SetFileExists().

◆ m_fileFormatVersionAtLoad

int SCH_SCREEN::m_fileFormatVersionAtLoad

private

Definition at line 590 of file sch_screen.h.

Referenced by GetFileFormatVersionAtLoad(), and SetFileFormatVersionAtLoad().

◆ m_fileName

wxString SCH_SCREEN::m_fileName

private

Definition at line 589 of file sch_screen.h.

Referenced by GetFileName(), and SetFileName().

◆ m_flagModified

bool BASE_SCREEN::m_flagModified

privateinherited

Indicates current drawing has been modified.

Definition at line 132 of file base_screen.h.

Referenced by BASE_SCREEN::BASE_SCREEN(), BASE_SCREEN::IsContentModified(), and BASE_SCREEN::SetContentModified().

◆ m_flags

EDA_ITEM_FLAGS EDA_ITEM::m_flags

protectedinherited

Definition at line 498 of file eda_item.h.

Referenced by EDA_ITEM::ClearFlags(), LIB_TEXT::Clone(), DS_DRAW_ITEM_BASE::DS_DRAW_ITEM_BASE(), EDA_ITEM::GetEditFlags(), EDA_ITEM::GetFlags(), PCB_TRACK::GetMsgPanelInfoBase_Common(), SCH_LINE::GetSelectedPoints(), EDA_ITEM::HasFlag(), LIB_ITEM::HitTest(), LIB_SHAPE::HitTest(), LIB_TEXT::HitTest(), SCH_JUNCTION::HitTest(), SCH_LINE::HitTest(), SCH_SYMBOL::HitTest(), LIB_PIN::HitTest(), SCH_PIN::HitTest(), ZONE::InitDataFromSrcInCopyCtor(), EDA_ITEM::IsBrightened(), SCH_ITEM::IsConnected(), EDA_ITEM::IsEntered(), EDA_ITEM::IsModified(), EDA_ITEM::IsMoving(), EDA_ITEM::IsNew(), EDA_ITEM::IsRollover(), EDA_ITEM::IsSelected(), EDA_ITEM::IsShownAsBitmap(), SCH_LINE::MirrorHorizontally(), SCH_LINE::MirrorVertically(), EDA_ITEM::operator=(), SCH_LINE::Rotate(), EDA_ITEM::SetFlags(), PCB_SHAPE::swapData(), PCB_BITMAP::swapData(), and EDA_ITEM::XorFlags().

◆ m_forceVisible

bool EDA_ITEM::m_forceVisible

protectedinherited

Definition at line 497 of file eda_item.h.

Referenced by ZONE::InitDataFromSrcInCopyCtor(), EDA_ITEM::IsForceVisible(), EDA_ITEM::operator=(), EDA_ITEM::SetForceVisible(), PCB_SHAPE::swapData(), and PCB_BITMAP::swapData().

◆ m_isReadOnly

bool SCH_SCREEN::m_isReadOnly

private

Read only status of the screen file.

Flag to indicate the file associated with this screen has been created.

Definition at line 614 of file sch_screen.h.

Referenced by IsReadOnly(), and SetFileReadOnly().

◆ m_LastZoomLevel

double SCH_SCREEN::m_LastZoomLevel

last value for the zoom level, useful in Eeschema when changing the current displayed sheet to reuse the same zoom level when back to the sheet using this screen

Definition at line 586 of file sch_screen.h.

Referenced by SCH_NAVIGATE_TOOL::changeSheet(), SCH_EDIT_FRAME::OnPageSettingsChange(), SCH_EDITOR_CONTROL::Revert(), and SCH_SCREEN().

◆ m_libSymbols

std::map<wxString, LIB_SYMBOL*> SCH_SCREEN::m_libSymbols

private

Library symbols required for this schematic.

Definition at line 623 of file sch_screen.h.

Referenced by AddLibSymbol(), Append(), clearLibSymbols(), getLibSymbolNameMatches(), GetLibSymbols(), Remove(), UpdateLocalLibSymbolLinks(), and UpdateSymbolLinks().

◆ m_LocalOrigin

VECTOR2D BASE_SCREEN::m_LocalOrigin

inherited

Relative Screen cursor coordinate (on grid) in user units.

(coordinates from last reset position)

Definition at line 90 of file base_screen.h.

Referenced by DRAWING_TOOL::drawShape(), BASE_SCREEN::InitDataPoints(), EDIT_TOOL::MoveExact(), COMMON_TOOLS::ResetLocalCoords(), SCH_BASE_FRAME::UpdateStatusBar(), GERBVIEW_FRAME::UpdateStatusBar(), PCB_BASE_FRAME::UpdateStatusBar(), and PL_EDITOR_FRAME::UpdateStatusBar().

◆ m_modification_sync

int SCH_SCREEN::m_modification_sync

private

Definition at line 608 of file sch_screen.h.

Referenced by Append(), and SCH_SCREEN().

◆ m_pageCount

int BASE_SCREEN::m_pageCount

protectedinherited

The number of BASE_SCREEN objects in this design.

This currently only has meaning for SCH_SCREEN objects because PCB_SCREEN object are limited to a single file. The count is virtual because SCH_SCREEN objects can be used more than once so the screen (page) count can be more than the number of screen objects.

Definition at line 111 of file base_screen.h.

Referenced by BASE_SCREEN::BASE_SCREEN(), Clear(), BASE_SCREEN::GetPageCount(), and BASE_SCREEN::SetPageCount().

◆ m_pageNumber

wxString BASE_SCREEN::m_pageNumber

protectedinherited

A user defined string page number used for printing and plotting.

This currently only has meaning for SCH_SCREEN objects because PCB_SCREEN object are limited to a single file. This must be set before displaying, printing, or plotting the current sheet. If empty, the m_virtualPageNumber value is converted to a string.

Definition at line 129 of file base_screen.h.

Referenced by BASE_SCREEN::GetPageNumber(), and BASE_SCREEN::SetPageNumber().

◆ m_paper

PAGE_INFO SCH_SCREEN::m_paper

private

Definition at line 603 of file sch_screen.h.

Referenced by GetPageSettings(), SCH_SCREEN(), and SetPageSettings().

◆ m_parent

EDA_ITEM* EDA_ITEM::m_parent

protectedinherited

Linked list: Link (parent struct)

Definition at line 496 of file eda_item.h.

Referenced by LIB_TEXT::Clone(), LIB_FIELD::Copy(), SCH_FIELD::DoHypertextAction(), FP_TEXT::FP_TEXT(), SCH_FIELD::GetBoundingBox(), SCH_FIELD::GetCanonicalName(), SCH_FIELD::GetDrawRotation(), FP_TEXT::GetDrawRotation(), SCH_FIELD::GetMenuImage(), FP_SHAPE::GetMsgPanelInfo(), FP_TEXT::GetMsgPanelInfo(), PAD::GetMsgPanelInfo(), PCB_DIMENSION_BASE::GetMsgPanelInfo(), SCH_FIELD::GetName(), LIB_ITEM::GetParent(), SCH_SHEET_PIN::GetParent(), BOARD_ITEM::GetParent(), EDA_ITEM::GetParent(), PAD::GetParent(), FP_SHAPE::GetParentAsString(), FP_TEXT::GetParentAsString(), FP_TEXTBOX::GetParentAsString(), PAD::GetParentAsString(), SCH_FIELD::GetParentPosition(), SCH_FIELD::GetPosition(), SCH_FIELD::GetShownText(), LIB_FIELD::HitTest(), SCH_FIELD::IsHypertext(), SCH_FIELD::IsReplaceable(), SCH_PIN::IsStacked(), SCH_FIELD::Matches(), EDA_ITEM::operator=(), LIB_FIELD::operator=(), PAD::PAD(), SCH_FIELD::Plot(), SCH_FIELD::Print(), SCH_FIELD::Replace(), SCH_LABEL_BASE::ResolveTextVar(), SCH_SYMBOL::SCH_SYMBOL(), FP_SHAPE::SetDrawCoord(), FP_TEXT::SetDrawCoord(), PAD::SetDrawCoord(), SCH_FIELD::SetId(), FP_SHAPE::SetLocalCoord(), FP_TEXT::SetLocalCoord(), PAD::SetLocalCoord(), EDA_ITEM::SetModified(), EDA_ITEM::SetParent(), SCH_FIELD::SetPosition(), PCB_SHAPE::swapData(), and PCB_BITMAP::swapData().

◆ m_refCount

int SCH_SCREEN::m_refCount

private

Definition at line 591 of file sch_screen.h.

Referenced by DecRefCount(), GetRefCount(), IncRefCount(), and SCH_SCREEN().

◆ m_rtree

EE_RTREE SCH_SCREEN::m_rtree

private

Definition at line 606 of file sch_screen.h.

Referenced by Append(), CheckIfOnDrawList(), Clear(), FreeDrawList(), HasItems(), IsEmpty(), Items(), Plot(), Remove(), and UpdateLocalLibSymbolLinks().

◆ m_ScrollCenter

VECTOR2D BASE_SCREEN::m_ScrollCenter

inherited

Current scroll center point in logical units.

Definition at line 100 of file base_screen.h.

Referenced by EDA_DRAW_PANEL_GAL::DoRePaint(), and DIALOG_ERC::OnERCItemSelected().

◆ m_sheetInstances

std::vector<SCH_SHEET_INSTANCE> SCH_SCREEN::m_sheetInstances

private

Definition at line 640 of file sch_screen.h.

Referenced by GetSheetInstances(), SCH_ALTIUM_PLUGIN::Load(), SCH_SEXPR_PARSER::parseSchSheetInstances(), and SCH_ALTIUM_PLUGIN::ParseSheetSymbol().

◆ m_StartVisu

VECTOR2I BASE_SCREEN::m_StartVisu

inherited

Coordinates in drawing units of the current view position (upper left corner of device)

Definition at line 93 of file base_screen.h.

Referenced by SCH_EDIT_FRAME::DrawCurrentSheetToClipboard(), PLEDITOR_PRINTOUT::PrintPage(), SCH_PRINTOUT::PrintPage(), and DIALOG_FIND::search().

◆ m_status

EDA_ITEM_FLAGS EDA_ITEM::m_status

protectedinherited

Definition at line 495 of file eda_item.h.

Referenced by EDA_ITEM::GetState(), EDA_ITEM::GetStatus(), EDA_ITEM::operator=(), EDA_ITEM::SetState(), EDA_ITEM::SetStatus(), PCB_SHAPE::swapData(), and PCB_BITMAP::swapData().

◆ m_structType

KICAD_T EDA_ITEM::m_structType

privateinherited

Run time identification, keep private so it can never be changed after a ctor sets it.

See comment near SetType() regarding virtual functions.

Definition at line 505 of file eda_item.h.

Referenced by EDA_ITEM::IsType(), EDA_ITEM::operator=(), and EDA_ITEM::Type().

◆ m_symbolInstances

std::vector<SCH_SYMBOL_INSTANCE> SCH_SCREEN::m_symbolInstances

private

The list of symbol instances loaded from the schematic file.

This list is only used to as temporary storage when the schematic file is loaded. If the screen is the root sheet, then this information is used to update the SCH_SYMBOL instance reference and unit information after the entire schematic is loaded and is never used again. If this screen is not the root sheet, then the schematic file is the root sheet of another project and this information is saved unchanged back to the schematic file.

Warning: Under no circumstances is this information to be modified or used after the schematic file is loaded. It is read only and it is only written to non-root schematic files.

Definition at line 639 of file sch_screen.h.

Referenced by GetSymbolInstances(), and SCH_SEXPR_PARSER::parseSchSymbolInstances().

◆ m_titles

TITLE_BLOCK SCH_SCREEN::m_titles

private

Definition at line 604 of file sch_screen.h.

Referenced by Clear(), GetTitleBlock(), and SetTitleBlock().

◆ m_uuid

KIID SCH_SCREEN::m_uuid

private

A unique identifier for each schematic file.

As of right now, this only has meaning for the root schematic. In the future, it may be useful to detect unexpected hierarchy changes.

Definition at line 648 of file sch_screen.h.

Referenced by AssignNewUuid(), SCH_SEXPR_PLUGIN::Format(), GetUuid(), and SCH_SEXPR_PARSER::ParseSchematic().

◆ m_Uuid

const KIID EDA_ITEM::m_Uuid

inherited

Definition at line 492 of file eda_item.h.

◆ m_viewPrivData

VIEW_ITEM_DATA* KIGFX::VIEW_ITEM::m_viewPrivData

privateinherited

Definition at line 151 of file view_item.h.

Referenced by KIGFX::VIEW::Add(), KIGFX::VIEW_ITEM::ClearViewPrivData(), KIGFX::VIEW_ITEM::viewPrivData(), and KIGFX::VIEW_ITEM::~VIEW_ITEM().

◆ m_virtualPageNumber

int BASE_SCREEN::m_virtualPageNumber

protectedinherited

An integer based page number used for printing a range of pages.

This page number is set before printing and plotting because page numbering does not reflect the actual page number in complex hiearachies in SCH_SCREEN objects.

Definition at line 119 of file base_screen.h.

Referenced by BASE_SCREEN::BASE_SCREEN(), Clear(), BASE_SCREEN::GetPageNumber(), BASE_SCREEN::GetVirtualPageNumber(), and BASE_SCREEN::SetVirtualPageNumber().

◆ m_zoomInitialized

bool SCH_SCREEN::m_zoomInitialized

private

Definition at line 611 of file sch_screen.h.

Referenced by SCH_EDIT_FRAME::DisplayCurrentSheet(), SCH_EDIT_FRAME::initScreenZoom(), and SCH_SCREEN().

◆ SCH_ALTIUM_PLUGIN

friend SCH_SCREEN::SCH_ALTIUM_PLUGIN

private

Definition at line 559 of file sch_screen.h.

◆ SCH_EDIT_FRAME

friend SCH_SCREEN::SCH_EDIT_FRAME

private

Definition at line 556 of file sch_screen.h.

◆ SCH_SEXPR_PARSER

friend SCH_SCREEN::SCH_SEXPR_PARSER

private

Definition at line 557 of file sch_screen.h.

◆ SCH_SEXPR_PLUGIN

friend SCH_SCREEN::SCH_SEXPR_PLUGIN

private

Definition at line 558 of file sch_screen.h.

The documentation for this class was generated from the following files:

Public Member Functions

Static Public Member Functions

Public Attributes

Static Public Attributes

Protected Member Functions

Protected Attributes

Private Member Functions

Private Attributes

Detailed Description

Constructor & Destructor Documentation

◆ SCH_SCREEN()

◆ ~SCH_SCREEN()

Member Function Documentation

◆ AddBusAlias()

◆ AddLibSymbol()

◆ AllSymbolDefaultInstancesNotSet()

◆ Append() [1/2]

◆ Append() [2/2]

◆ AssignNewUuid()

◆ CheckIfOnDrawList()

◆ ClassOf()

◆ Clear()

◆ ClearAnnotation()

◆ ClearBrightened()

◆ ClearBusAliases()

◆ ClearDrawingState()

◆ ClearEditFlags()

◆ ClearFlags()

◆ clearLibSymbols()

◆ ClearSelected()

◆ ClearTempFlags()

◆ ClearViewPrivData()

◆ Clone()

◆ CountConnectedItems()

◆ DecRefCount()

◆ DeleteItem()

◆ doIsJunction()

◆ EnsureAlternateReferencesExist()

◆ FileExists()

◆ FixLegacyPowerSymbolMismatches()

◆ FreeDrawList()

◆ Get() [1/3]

◆ Get() [2/3]

◆ Get() [3/3]

◆ GetAuxOrigin()

◆ GetBoundingBox()

◆ GetBus()

◆ GetBusAliases()

◆ GetBusesAndWires()

◆ GetClass()

◆ GetClientSheetPaths()

◆ GetConnections()

◆ GetEditFlags()

◆ GetFileFormatVersionAtLoad()

◆ GetFileName()

◆ GetFlags()

◆ GetFocusPosition()

◆ GetFriendlyName()

◆ GetHierarchicalItems()

◆ GetItem()

◆ GetItemDescription()

◆ GetLabel()

◆ GetLabelOrientationForPoint()

◆ getLibSymbolNameMatches()

◆ GetLibSymbols() [1/2]

◆ GetLibSymbols() [2/2]

◆ GetLine()

◆ GetMenuImage()

◆ GetMsgPanelInfo()

◆ GetNeededJunctions()

◆ GetPageCount()

◆ GetPageNumber()

◆ GetPageSettings()

◆ GetParent()

◆ GetPin()

◆ GetPosition()

◆ GetRefCount()

◆ GetSheetInstances()

◆ GetSheetPin()

◆ GetSheets()