Handle access to a stack of flattened SCH_SHEET objects by way of a path for creating a flattened schematic hierarchy. More...

#include <sch_sheet_path.h>

Public Member Functions
	SCH_SHEET_PATH ()

	SCH_SHEET_PATH (const SCH_SHEET_PATH &aOther)

SCH_SHEET_PATH &	operator= (const SCH_SHEET_PATH &aOther)

SCH_SHEET_PATH	operator+ (const SCH_SHEET_PATH &aOther)

	~SCH_SHEET_PATH ()=default

SCH_SHEET *	at (size_t aIndex) const
	Forwarded method from std::vector. More...

void	clear ()
	Forwarded method from std::vector. More...

bool	empty () const
	Forwarded method from std::vector. More...

void	pop_back ()
	Forwarded method from std::vector. More...

void	push_back (SCH_SHEET *aSheet)
	Forwarded method from std::vector. More...

size_t	size () const
	Forwarded method from std::vector. More...

std::vector< SCH_SHEET * >::iterator	erase (std::vector< SCH_SHEET * >::const_iterator aPosition)

void	Rehash ()

size_t	GetCurrentHash () const

void	SetVirtualPageNumber (int aPageNumber)
	Set the sheet instance virtual page number. More...

int	GetVirtualPageNumber () const

void	SetPageNumber (const wxString &aPageNumber)
	Set the sheet instance user definable page number. More...

wxString	GetPageNumber () const

const SCH_SHEET *	GetSheet (unsigned aIndex) const

bool	IsFullPath () const

int	Cmp (const SCH_SHEET_PATH &aSheetPathToTest) const
	Compare if this is the same sheet path as aSheetPathToTest. More...

int	ComparePageNum (const SCH_SHEET_PATH &aSheetPathToTest) const
	Compare sheets by their page number. More...

bool	IsContainedWithin (const SCH_SHEET_PATH &aSheetPathToTest) const
	Check if this path is contained inside aSheetPathToTest. More...

SCH_SHEET *	Last () const
	Return a pointer to the last SCH_SHEET of the list. More...

SCH_SCREEN *	LastScreen ()

SCH_SCREEN *	LastScreen () const

SCH_ITEM *	GetItem (const KIID &aID) const
	Fetch a SCH_ITEM by ID. More...

wxString	PathAsString () const
	Return the path of time stamps which do not changes even when editing sheet parameters. More...

KIID_PATH	Path () const
	Get the sheet path as an KIID_PATH. More...

wxString	PathHumanReadable (bool aUseShortRootName=true, bool aStripTrailingSeparator=false) const
	Return the sheet path in a human readable form made from the sheet names. More...

void	UpdateAllScreenReferences () const
	Update all the symbol references for this sheet path. More...

void	AppendSymbol (SCH_REFERENCE_LIST &aReferences, SCH_SYMBOL *aSymbol, bool aIncludePowerSymbols=true, bool aForceIncludeOrphanSymbols=false) const
	Append a SCH_REFERENCE object to aReferences based on aSymbol. More...

void	GetSymbols (SCH_REFERENCE_LIST &aReferences, bool aIncludePowerSymbols=true, bool aForceIncludeOrphanSymbols=false) const
	Adds SCH_REFERENCE object to aReferences for each symbol in the sheet. More...

void	AppendMultiUnitSymbol (SCH_MULTI_UNIT_REFERENCE_MAP &aRefList, SCH_SYMBOL *aSymbol, bool aIncludePowerSymbols=true) const
	Append a SCH_REFERENCE_LIST object to aRefList based on aSymbol, storing same-reference set of multi-unit parts together. More...

void	GetMultiUnitSymbols (SCH_MULTI_UNIT_REFERENCE_MAP &aRefList, bool aIncludePowerSymbols=true) const
	Add a SCH_REFERENCE_LIST object to aRefList for each same-reference set of multi-unit parts in the sheet. More...

bool	TestForRecursion (const wxString &aSrcFileName, const wxString &aDestFileName)
	Test the SCH_SHEET_PATH file names to check adding the sheet stored in the file aSrcFileName to the sheet stored in file aDestFileName will cause a sheet path recursion. More...

void	MakeFilePathRelativeToParentSheet ()
	Make the sheet file name relative to its parent sheet. More...

void	AddNewSymbolInstances (const SCH_SHEET_PATH &aPrefixSheetPath)
	Attempt to add new symbol instances for all symbols in this sheet path prefixed with aPrefixSheetPath. More...

void	RemoveSymbolInstances (const SCH_SHEET_PATH &aPrefixSheetPath)

bool	operator== (const SCH_SHEET_PATH &d1) const

bool	operator!= (const SCH_SHEET_PATH &d1) const

bool	operator< (const SCH_SHEET_PATH &d1) const

Protected Attributes
std::vector< SCH_SHEET * >	m_sheets

size_t	m_current_hash

int	m_virtualPageNumber

std::map< std::pair< wxString, wxString >, bool >	m_recursion_test_cache
	Page numbers are maintained by the sheet load order. More...

Private Member Functions
void	initFromOther (const SCH_SHEET_PATH &aOther)

Detailed Description

Handle access to a stack of flattened SCH_SHEET objects by way of a path for creating a flattened schematic hierarchy.

The SCH_SHEET objects are stored in a list from first (usually the root sheet) to a given sheet in last position. The last sheet is usually the sheet we want to select or reach (which is what the function Last() returns). Others sheets constitute the "path" from the first to the last sheet.

Definition at line 140 of file sch_sheet_path.h.

Constructor & Destructor Documentation

◆ SCH_SHEET_PATH() [1/2]

SCH_SHEET_PATH::SCH_SHEET_PATH ( )

Definition at line 107 of file sch_sheet_path.cpp.

{
 m_virtualPageNumber = 1;
 m_current_hash = 0;
}

References m_current_hash, and m_virtualPageNumber.

◆ SCH_SHEET_PATH() [2/2]

SCH_SHEET_PATH::SCH_SHEET_PATH ( const SCH_SHEET_PATH & aOther )

Definition at line 114 of file sch_sheet_path.cpp.

{
 initFromOther( aOther );
}

References initFromOther().

◆ ~SCH_SHEET_PATH()

SCH_SHEET_PATH::~SCH_SHEET_PATH ( )

default

Member Function Documentation

◆ AddNewSymbolInstances()

void SCH_SHEET_PATH::AddNewSymbolInstances ( const SCH_SHEET_PATH & aPrefixSheetPath )

Attempt to add new symbol instances for all symbols in this sheet path prefixed with aPrefixSheetPath.

The new symbol instance data will be assigned by the following criteria:

If the instance data can be found for this sheet path, use the instance data.
If the instance data cannot be found for this sheet path and the instance data cache for the symbol is not empty, use the first instance data in the cache.
If the cache is empty and the library symbol link is valid, set the instance data from the library symbol.
If all else fails, set the reference to "U?", the unit to 1, and everything else to an empty string.

Definition at line 556 of file sch_sheet_path.cpp.

{
 SCH_SHEET_PATH newSheetPath( aPrefixSheetPath );
 SCH_SHEET_PATH currentSheetPath( *this );
 
 // Prefix the new hierarchical path.
 newSheetPath = newSheetPath + currentSheetPath;
 
 for( SCH_ITEM* item : LastScreen()->Items().OfType( SCH_SYMBOL_T ) )
 {
 SCH_SYMBOL* symbol = static_cast<SCH_SYMBOL*>( item );
 
 wxCHECK2( symbol, continue );
 
 SCH_SYMBOL_INSTANCE newSymbolInstance;
 
 if( symbol->GetInstance( newSymbolInstance, Path(), true ) )
 {
 // Use an existing symbol instance for this path if it exists.
 newSymbolInstance.m_Path = newSheetPath.Path();
 symbol->AddHierarchicalReference( newSymbolInstance );
 }
 else if( !symbol->GetInstanceReferences().empty() )
 {
 // Use the first symbol instance if any symbol instance data exists.
 newSymbolInstance = symbol->GetInstanceReferences()[0];
 newSymbolInstance.m_Path = newSheetPath.Path();
 symbol->AddHierarchicalReference( newSymbolInstance );
 }
 else
 {
 // Fall back to the last saved symbol field and unit settings if there is no
 // instance data.
 newSymbolInstance.m_Path = newSheetPath.Path();
 newSymbolInstance.m_Reference = symbol->GetField( REFERENCE_FIELD )->GetText();
 newSymbolInstance.m_Unit = symbol->GetUnit();
 symbol->AddHierarchicalReference( newSymbolInstance );
 }
 }
}

References SCH_SYMBOL::AddHierarchicalReference(), SCH_SYMBOL::GetField(), SCH_SYMBOL::GetInstance(), SCH_SYMBOL::GetInstanceReferences(), EDA_TEXT::GetText(), SCH_SYMBOL::GetUnit(), LastScreen(), SCH_SYMBOL_INSTANCE::m_Path, SCH_SYMBOL_INSTANCE::m_Reference, SCH_SYMBOL_INSTANCE::m_Unit, Path(), REFERENCE_FIELD, and SCH_SYMBOL_T.

Referenced by SCH_SHEET_LIST::AddNewSymbolInstances().

◆ AppendMultiUnitSymbol()

void SCH_SHEET_PATH::AppendMultiUnitSymbol	(	SCH_MULTI_UNIT_REFERENCE_MAP &	aRefList,
		SCH_SYMBOL *	aSymbol,
		bool	aIncludePowerSymbols = `true`
	)		const

Append a SCH_REFERENCE_LIST object to aRefList based on aSymbol, storing same-reference set of multi-unit parts together.

The map key for each element will be the reference designator.

Parameters

aRefList	Map of reference designators to reference lists
aSymbol	A symbol to add to aRefList
aIncludePowerSymbols	Set to false to only get normal symbols.

Definition at line 414 of file sch_sheet_path.cpp.

{
 // Skip pseudo-symbols, which have a reference starting with #. This mainly
 // affects power symbols.
 if( !aIncludePowerSymbols && aSymbol->GetRef( this )[0] == wxT( '#' ) )
 return;
 
 LIB_SYMBOL* symbol = aSymbol->GetLibSymbolRef().get();
 
 if( symbol && symbol->GetUnitCount() > 1 )
 {
 SCH_REFERENCE schReference = SCH_REFERENCE( aSymbol, symbol, *this );
 schReference.SetSheetNumber( m_virtualPageNumber );
 wxString reference_str = schReference.GetRef();
 
 // Never lock unassigned references
 if( reference_str[reference_str.Len() - 1] == '?' )
 return;
 
 aRefList[reference_str].AddItem( schReference );
 }
}

References SCH_SYMBOL::GetLibSymbolRef(), SCH_REFERENCE::GetRef(), SCH_SYMBOL::GetRef(), LIB_SYMBOL::GetUnitCount(), m_virtualPageNumber, and SCH_REFERENCE::SetSheetNumber().

Referenced by SCH_EDIT_FRAME::AnnotateSymbols(), GetMultiUnitSymbols(), and TEST_SCH_REFERENCE_LIST_FIXTURE::loadTestCase().

◆ AppendSymbol()

void SCH_SHEET_PATH::AppendSymbol	(	SCH_REFERENCE_LIST &	aReferences,
		SCH_SYMBOL *	aSymbol,
		bool	aIncludePowerSymbols = `true`,
		bool	aForceIncludeOrphanSymbols = `false`
	)		const

Append a SCH_REFERENCE object to aReferences based on aSymbol.

Parameters

aReferences	List of references to populate.
aSymbol	A symbol to add to aReferences
aIncludePowerSymbols	set to false to only get normal symbols.
aForceIncludeOrphanSymbols	set to true to include symbols having no symbol found in lib. The normal option is false, and set to true only to build the full list of symbols.

Definition at line 382 of file sch_sheet_path.cpp.

{
 // Skip pseudo-symbols, which have a reference starting with #. This mainly
 // affects power symbols.
 if( aIncludePowerSymbols || aSymbol->GetRef( this )[0] != wxT( '#' ) )
 {
 LIB_SYMBOL* symbol = aSymbol->GetLibSymbolRef().get();
 
 if( symbol || aForceIncludeOrphanSymbols )
 {
 SCH_REFERENCE schReference( aSymbol, symbol, *this );
 
 schReference.SetSheetNumber( m_virtualPageNumber );
 aReferences.AddItem( schReference );
 }
 }
}

References SCH_REFERENCE_LIST::AddItem(), SCH_SYMBOL::GetLibSymbolRef(), SCH_SYMBOL::GetRef(), m_virtualPageNumber, and SCH_REFERENCE::SetSheetNumber().

Referenced by SCH_EDIT_FRAME::AnnotateSymbols(), SCH_EDIT_FRAME::CheckAnnotate(), SCH_SEXPR_PLUGIN::Format(), GetSymbols(), and TEST_SCH_REFERENCE_LIST_FIXTURE::loadTestCase().

◆ at()

SCH_SHEET * SCH_SHEET_PATH::at ( size_t aIndex ) const

inline

Forwarded method from std::vector.

Definition at line 154 of file sch_sheet_path.h.

154{ return m_sheets.at( aIndex ); }

SCH_SHEET_PATH::m_sheets

std::vector< SCH_SHEET * > m_sheets

Definition: sch_sheet_path.h:413

References m_sheets.

Referenced by SCH_SHEET_LIST::AddNewSheetInstances(), Cmp(), GetSheet(), SCHEMATIC::GetUniqueFilenameForCurrentSheet(), IsContainedWithin(), SCH_SEXPR_PLUGIN::loadHierarchy(), operator+(), PathAsString(), PathHumanReadable(), and TestForRecursion().

◆ clear()

void SCH_SHEET_PATH::clear ( )

inline

Forwarded method from std::vector.

Definition at line 157 of file sch_sheet_path.h.

 {
 m_sheets.clear();
 Rehash();
 }

References m_sheets, and Rehash().

Referenced by SCH_EDIT_FRAME::doCloseWindow(), SCHEMATIC::Reset(), SCHEMATIC::SetRoot(), and HIERARCHY_PANE::UpdateHierarchyTree().

◆ Cmp()

int SCH_SHEET_PATH::Cmp ( const SCH_SHEET_PATH & aSheetPathToTest ) const

Compare if this is the same sheet path as aSheetPathToTest.

Parameters

aSheetPathToTest is the sheet path to compare.

Returns: 1 if this sheet path has more sheets than aSheetPathToTest, -1 if this sheet path has fewer sheets than aSheetPathToTest, or 0 if same

Definition at line 167 of file sch_sheet_path.cpp.

{
 if( size() > aSheetPathToTest.size() )
 return 1;
 
 if( size() < aSheetPathToTest.size() )
 return -1;
 
 //otherwise, same number of sheets.
 for( unsigned i = 0; i < size(); i++ )
 {
 if( at( i )->m_Uuid < aSheetPathToTest.at( i )->m_Uuid )
 return -1;
 
 if( at( i )->m_Uuid != aSheetPathToTest.at( i )->m_Uuid )
 return 1;
 }
 
 return 0;
}

References at(), EDA_ITEM::m_Uuid, and size().

Referenced by SCH_REFERENCE_LIST::sortByTimeStamp().

◆ ComparePageNum()

int SCH_SHEET_PATH::ComparePageNum ( const SCH_SHEET_PATH & aSheetPathToTest ) const

Compare sheets by their page number.

If the actual page number is equal, use virtual page numbers to compare.

Returns: -1 if aSheetPathToTest is greater than this (should appear later in the sort order) 0 if aSheetPathToTest is equal to this 1 if aSheetPathToTest is less than this (should appear earlier in the sort order)

Definition at line 189 of file sch_sheet_path.cpp.

{
 wxString pageA = this->GetPageNumber();
 wxString pageB = aSheetPathToTest.GetPageNumber();
 
 int pageNumComp = SCH_SHEET::ComparePageNum( pageA, pageB );
 
 if( pageNumComp == 0 )
 {
  int virtualPageA = GetVirtualPageNumber();
 int virtualPageB = aSheetPathToTest.GetVirtualPageNumber();
 
 if( virtualPageA > virtualPageB )
 pageNumComp = 1;
 else if( virtualPageA < virtualPageB )
 pageNumComp = -1;
 }
 
 return pageNumComp;
}

References SCH_SHEET::ComparePageNum(), GetPageNumber(), and GetVirtualPageNumber().

Referenced by HIERARCHY_TREE::OnCompareItems(), and SCH_SHEET_LIST::SortByPageNumbers().

◆ empty()

bool SCH_SHEET_PATH::empty ( ) const

inline

Forwarded method from std::vector.

Definition at line 164 of file sch_sheet_path.h.

164{ return m_sheets.empty(); }

References m_sheets.

Referenced by SCH_SHEET::findSelf(), Last(), SCH_SEXPR_PLUGIN::loadHierarchy(), DIALOG_ERC::OnERCItemSelected(), and PathHumanReadable().

◆ erase()

std::vector< SCH_SHEET * >::iterator SCH_SHEET_PATH::erase ( std::vector< SCH_SHEET * >::const_iterator aPosition )

inline

Definition at line 183 of file sch_sheet_path.h.

 {
 return m_sheets.erase( aPosition );
 }

References m_sheets.

◆ GetCurrentHash()

size_t SCH_SHEET_PATH::GetCurrentHash ( ) const

inline

Definition at line 190 of file sch_sheet_path.h.

190{ return m_current_hash; }

References m_current_hash.

Referenced by SCH_FIND_REPLACE_TOOL::FindNext(), SHEET_PATH_CMP::operator()(), operator==(), ERC_SCH_PIN_CONTEXT::rehash(), and SCH_SHEET_LIST::SortByPageNumbers().

◆ GetItem()

SCH_ITEM * SCH_SHEET_PATH::GetItem ( const KIID & aID ) const

Fetch a SCH_ITEM by ID.

Definition at line 812 of file sch_sheet_path.cpp.

{
 for( SCH_ITEM* aItem : LastScreen()->Items() )
 {
 if( aItem->m_Uuid == aID )
 return aItem;
 
 SCH_ITEM* childMatch = nullptr;
 
 aItem->RunOnChildren(
  [&]( SCH_ITEM* aChild )
 {
 if( aChild->m_Uuid == aID )
 childMatch = aChild;
 } );
 
 if( childMatch )
 return childMatch;
 }
 
 return nullptr;
}

References LastScreen(), EDA_ITEM::m_Uuid, and SCH_ITEM::RunOnChildren().

Referenced by SIM_PLOT_FRAME::applyTuners(), SCH_SHEET_LIST::GetItem(), and SIM_PLOT_FRAME::UpdateTunerValue().

◆ GetMultiUnitSymbols()

void SCH_SHEET_PATH::GetMultiUnitSymbols	(	SCH_MULTI_UNIT_REFERENCE_MAP &	aRefList,
		bool	aIncludePowerSymbols = `true`
	)		const

Add a SCH_REFERENCE_LIST object to aRefList for each same-reference set of multi-unit parts in the sheet.

The map key for each element will be the reference designator.

Parameters

aRefList	Map of reference designators to reference lists
aIncludePowerSymbols	Set to false to only get normal symbols.

Definition at line 403 of file sch_sheet_path.cpp.

{
 for( SCH_ITEM* item : LastScreen()->Items().OfType( SCH_SYMBOL_T ) )
 {
 SCH_SYMBOL* symbol = static_cast<SCH_SYMBOL*>( item );
 AppendMultiUnitSymbol( aRefList, symbol, aIncludePowerSymbols );
 }
}

References AppendMultiUnitSymbol(), LastScreen(), and SCH_SYMBOL_T.

Referenced by SCH_EDIT_FRAME::AnnotateSymbols().

◆ GetPageNumber()

wxString SCH_SHEET_PATH::GetPageNumber ( ) const

Definition at line 527 of file sch_sheet_path.cpp.

{
 SCH_SHEET* sheet = Last();
 
 wxCHECK( sheet, wxEmptyString );
 
 SCH_SHEET_PATH tmpPath = *this;
 
 tmpPath.pop_back();
 
 return sheet->getPageNumber( tmpPath );
}

References SCH_SHEET::getPageNumber(), Last(), and pop_back().

Referenced by SCH_SHEET_LIST::AllSheetPageNumbersEmpty(), HIERARCHY_PANE::buildHierarchyTree(), ComparePageNum(), SCH_EDIT_TOOL::EditPageNumber(), HIERARCHY_PANE::getRootString(), HIERARCHY_PANE::onRightClick(), SCH_SHEET_LIST::PageNumberExists(), SCH_PLOTTER::plotOneSheetDXF(), SCH_PLOTTER::plotOneSheetHpgl(), SCH_PLOTTER::plotOneSheetPS(), SCH_PLOTTER::plotOneSheetSVG(), SCHEMATIC::ResolveTextVar(), and DIALOG_SHEET_PROPERTIES::TransferDataToWindow().

◆ GetSheet()

const SCH_SHEET * SCH_SHEET_PATH::GetSheet ( unsigned aIndex ) const

inline

Definition at line 214 of file sch_sheet_path.h.

 {
 SCH_SHEET* retv = nullptr;
 
 if( aIndex < size() )
 retv = at( aIndex );
 
 return retv;
 }

References at(), and size().

Referenced by IsFullPath(), and SCH_SHEET_LIST::TestForRecursion().

◆ GetSymbols()

void SCH_SHEET_PATH::GetSymbols	(	SCH_REFERENCE_LIST &	aReferences,
		bool	aIncludePowerSymbols = `true`,
		bool	aForceIncludeOrphanSymbols = `false`
	)		const

Adds SCH_REFERENCE object to aReferences for each symbol in the sheet.

Parameters

aReferences	List of references to populate.
aIncludePowerSymbols	set to false to only get normal symbols.
aForceIncludeOrphanSymbols	set to true to include symbols having no symbol found in lib. The normal option is false, and set to true only to build the full list of symbols.

Definition at line 371 of file sch_sheet_path.cpp.

{
 for( SCH_ITEM* item : LastScreen()->Items().OfType( SCH_SYMBOL_T ) )
 {
 SCH_SYMBOL* symbol = static_cast<SCH_SYMBOL*>( item );
 AppendSymbol( aReferences, symbol, aIncludePowerSymbols, aForceIncludeOrphanSymbols );
 }
}

References AppendSymbol(), LastScreen(), and SCH_SYMBOL_T.

Referenced by SCH_EDIT_FRAME::AnnotateSymbols(), SCH_EDIT_FRAME::CheckAnnotate(), CollectOtherUnits(), findSymbolsAndPins(), SCH_SHEET_LIST::GetSymbols(), SCH_SHEET_LIST::GetSymbolsWithinPath(), SCH_EDITOR_CONTROL::Paste(), sheetContainsOnlyWantedItems(), and SCH_EDITOR_CONTROL::updatePastedSheet().

◆ GetVirtualPageNumber()

int SCH_SHEET_PATH::GetVirtualPageNumber ( ) const

inline

Definition at line 203 of file sch_sheet_path.h.

203{ return m_virtualPageNumber; }

References m_virtualPageNumber.

Referenced by SCH_NAVIGATE_TOOL::CanGoNext(), SCH_NAVIGATE_TOOL::CanGoPrevious(), ComparePageNum(), SCH_LABEL_BASE::GetIntersheetRefs(), SCH_SHEET_LIST::GetLastVirtualPageNumber(), SCH_NAVIGATE_TOOL::Next(), SCH_NAVIGATE_TOOL::Previous(), and SCH_GLOBALLABEL::ResolveTextVar().

◆ initFromOther()

void SCH_SHEET_PATH::initFromOther ( const SCH_SHEET_PATH & aOther )

private

Definition at line 140 of file sch_sheet_path.cpp.

{
 m_sheets = aOther.m_sheets;
 m_virtualPageNumber = aOther.m_virtualPageNumber;
 m_current_hash = aOther.m_current_hash;
 
 // Note: don't copy m_recursion_test_cache as it is slow and we want SCH_SHEET_PATHS to be
 // very fast to construct for use in the connectivity algorithm.
}

References m_current_hash, m_sheets, and m_virtualPageNumber.

Referenced by operator=(), and SCH_SHEET_PATH().

◆ IsContainedWithin()

bool SCH_SHEET_PATH::IsContainedWithin ( const SCH_SHEET_PATH & aSheetPathToTest ) const

Check if this path is contained inside aSheetPathToTest.

Parameters

aSheetPathToTest is the sheet path to compare against.

Returns: true if this path is contained inside or equal to aSheetPathToTest.

Definition at line 211 of file sch_sheet_path.cpp.

{
 if( aSheetPathToTest.size() > size() )
 return false;
 
 for( size_t i = 0; i < aSheetPathToTest.size(); ++i )
 {
 if( at( i )->m_Uuid != aSheetPathToTest.at( i )->m_Uuid )
 {
 wxLogTrace( traceSchSheetPaths, "Sheet path '%s' is not within path '%s'.",
 aSheetPathToTest.Path().AsString(), Path().AsString() );
 
 return false;
 }
 }
 
 wxLogTrace( traceSchSheetPaths, "Sheet path '%s' is within path '%s'.",
 aSheetPathToTest.Path().AsString(), Path().AsString() );
 
 return true;
}

References KIID_PATH::AsString(), SEXPR::AsString(), at(), EDA_ITEM::m_Uuid, Path(), size(), and traceSchSheetPaths.

Referenced by findSymbolsAndPins(), SCH_SHEET_LIST::GetSheetsWithinPath(), SCH_SHEET_LIST::GetSymbolsWithinPath(), and sheetContainsOnlyWantedItems().

◆ IsFullPath()

bool SCH_SHEET_PATH::IsFullPath ( ) const

Definition at line 151 of file sch_sheet_path.cpp.

{
 // The root sheet path is empty. All other sheet paths must start with the root sheet path.
 return ( m_sheets.size() == 0 ) || ( GetSheet( 0 )->IsRootSheet() );
}

References GetSheet(), SCH_SHEET::IsRootSheet(), and m_sheets.

Referenced by SCH_SHEET::addInstance(), SCH_SHEET::getPageNumber(), and SCH_SHEET::setPageNumber().

◆ Last()

SCH_SHEET * SCH_SHEET_PATH::Last ( ) const

Return a pointer to the last SCH_SHEET of the list.

One can see the others sheet as the "path" to reach this last sheet.

Definition at line 234 of file sch_sheet_path.cpp.

{
 if( !empty() )
 return m_sheets.back();
 
 return nullptr;
}

References empty(), and m_sheets.

Referenced by SCH_SHEET::addInstance(), SCH_NAVIGATE_TOOL::CanGoUp(), KIGFX::SCH_VIEW::DisplaySheet(), SCH_DRAWING_TOOLS::DrawSheet(), SCH_EDIT_TOOL::EditPageNumber(), SCH_SHEET::findSelf(), SCH_SHEET::GetContextualTextVars(), SCH_EAGLE_PLUGIN::getCurrentScreen(), SCH_ALTIUM_PLUGIN::getCurrentSheet(), SCH_EAGLE_PLUGIN::getCurrentSheet(), GetPageNumber(), SCH_SHEET::getPageNumber(), NETLIST_EXPORTER_SPICE::GetSheets(), SCH_TEXT::GetShownText(), SCH_TEXTBOX::GetShownText(), EE_SELECTION_TOOL::Init(), SCH_DRAWING_TOOLS::Init(), SCH_LINE_WIRE_BUS_TOOL::Init(), LastScreen(), CADSTAR_SCH_ARCHIVE_LOADER::loadSheetAndChildSheets(), MakeFilePathRelativeToParentSheet(), NETLIST_EXPORTER_XML::makeSymbols(), SCH_SHEET_LIST::NameExists(), HIERARCHY_PANE::onRightClick(), DIALOG_SCH_FIELD_PROPERTIES::onScintillaCharAdded(), DIALOG_TEXT_PROPERTIES::onScintillaCharAdded(), SCH_ALTIUM_PLUGIN::ParseComponent(), SCH_EDITOR_CONTROL::Paste(), SCH_PLOTTER::plotOneSheetDXF(), SCH_PLOTTER::plotOneSheetHpgl(), SCH_PLOTTER::plotOneSheetPDF(), SCH_PLOTTER::plotOneSheetPS(), SCH_PLOTTER::plotOneSheetSVG(), SCH_LABEL_BASE::ResolveTextVar(), SCHEMATIC::ResolveTextVar(), SCH_SHEET::ResolveTextVar(), SCH_SYMBOL::ResolveTextVar(), SCH_EDITOR_CONTROL::Revert(), SCH_EDITOR_CONTROL::SaveCurrSheetCopyAs(), SCH_SHEET::setPageNumber(), SetPageNumber(), and HIERARCHY_PANE::UpdateHierarchySelection().

◆ LastScreen() [1/2]

SCH_SCREEN * SCH_SHEET_PATH::LastScreen ( )

Returns: the SCH_SCREEN relative to the last sheet in list.; the SCH_SCREEN relative to the last sheet in list.

Definition at line 243 of file sch_sheet_path.cpp.

{
 SCH_SHEET* lastSheet = Last();
 
 if( lastSheet )
 return lastSheet->GetScreen();
 
 return nullptr;
}

References SCH_SHEET::GetScreen(), and Last().

Referenced by AddNewSymbolInstances(), SCH_SHEET_LIST::AnnotatePowerSymbols(), SCH_EDIT_FRAME::AnnotateSymbols(), BACK_ANNOTATE::applyChangelist(), SCH_EDITOR_CONTROL::AssignNetclass(), HIERARCHY_PANE::buildHierarchyTree(), SCH_SHEET_LIST::BuildSheetList(), SCH_EDIT_FRAME::CheckAnnotate(), SCH_EDIT_FRAME::CheckSheetForRecursion(), SCH_SHEET_LIST::ClearModifyStatus(), SCH_EDIT_FRAME::CommonSettingsChanged(), SCH_PLOTTER::createDXFFiles(), SCH_PLOTTER::createHPGLFiles(), SCH_PLOTTER::createPDFFile(), SCH_PLOTTER::createPSFiles(), SCH_PLOTTER::createSVGFiles(), SCH_EDIT_FRAME::DeleteAnnotation(), SCH_EDIT_FRAME::DisplayCurrentSheet(), SCH_EDIT_TOOL::EditPageNumber(), CONNECTION_GRAPH::ercCheckBusToBusConflicts(), CONNECTION_GRAPH::ercCheckBusToBusEntryConflicts(), CONNECTION_GRAPH::ercCheckBusToNetConflicts(), CONNECTION_GRAPH::ercCheckFloatingWires(), CONNECTION_GRAPH::ercCheckLabels(), CONNECTION_GRAPH::ercCheckMultipleDrivers(), CONNECTION_GRAPH::ercCheckNoConnects(), SCH_SHEET_LIST::FillItemMap(), SCH_SHEET_LIST::FindAllSheetsForScreen(), findItemsFromSyncSelection(), NETLIST_EXPORTER_BASE::findNextSymbol(), SCH_SHEET_LIST::FindSheetForScreen(), SCHEMATIC::GetContextualTextVars(), SCH_ALTIUM_PLUGIN::getCurrentScreen(), GetItem(), GetMultiUnitSymbols(), SCH_EDIT_FRAME::GetScreen(), GetSymbols(), SCH_EDIT_FRAME::HardRedraw(), DIALOG_EDIT_SYMBOLS_LIBID::initDlg(), SCH_SHEET_LIST::IsModified(), SCH_SEXPR_PLUGIN::loadHierarchy(), MakeFilePathRelativeToParentSheet(), NETLIST_EXPORTER_XML::makeSymbols(), SCH_PRINTOUT::OnPrintPage(), HIERARCHY_PANE::onRightClick(), DIALOG_ERC::OnRunERCClick(), DIALOG_SHEET_PROPERTIES::onSheetFilenameChanged(), SCH_EDITOR_CONTROL::Paste(), SCH_DRAWING_TOOLS::PlaceSymbol(), DIALOG_GLOBAL_EDIT_TEXT_AND_GRAPHICS::processItem(), BACK_ANNOTATE::processNetNameChange(), SCHEMATIC::RecomputeIntersheetRefs(), RemoveSymbolInstances(), SCH_EDITOR_CONTROL::RepairSchematic(), SCH_FIND_REPLACE_TOOL::ReplaceAndFindNext(), RESCUER::RESCUER(), SCH_EDIT_FRAME::ResolveERCExclusions(), SCH_EDIT_FRAME::SetCurrentSheet(), SCHEMATIC::SetSheetNumberAndCount(), TestForRecursion(), ERC_TESTER::TestMissingUnits(), ERC_TESTER::TestMultiunitFootprints(), ERC_TESTER::TestMultUnitPinConflicts(), ERC_TESTER::TestPinToPin(), ERC_TESTER::TestSimilarLabels(), DIALOG_SHEET_PROPERTIES::TransferDataFromWindow(), SCH_LINE_WIRE_BUS_TOOL::TrimOverLappingWires(), UpdateAllScreenReferences(), CONNECTION_GRAPH::updateItemConnectivity(), SCH_EDITOR_CONTROL::UpdateNetHighlighting(), SCH_SHEET_LIST::UpdateSymbolInstanceData(), and NETLIST_EXPORTER_ORCADPCB2::WriteNetlist().

◆ LastScreen() [2/2]

SCH_SCREEN * SCH_SHEET_PATH::LastScreen ( ) const

Definition at line 254 of file sch_sheet_path.cpp.

{
 SCH_SHEET* lastSheet = Last();
 
 if( lastSheet )
 return lastSheet->GetScreen();
 
 return nullptr;
}

References SCH_SHEET::GetScreen(), and Last().

◆ MakeFilePathRelativeToParentSheet()

void SCH_SHEET_PATH::MakeFilePathRelativeToParentSheet ( )

Make the sheet file name relative to its parent sheet.

This should only be called when changing the parent sheet path such performing a save as or a new schematic without a project in stand alone mode. The sheet file name is only made relative if the current file name is relative. Absolute sheet file name paths are a user choice so do not change them.

Sheet file name paths are set according to the following criteria:

If the sheet file name path is in the same as the parent sheet file name path, set the sheet file name to just the file name and extension with no path.
If the sheet file name path can be made relative to the parent sheet file name path, set the sheet file name using the relative path.
If the sheet file name path cannot be converted to a relative path, then fall back to the absolute file name path.

Definition at line 616 of file sch_sheet_path.cpp.

{
 wxCHECK( m_sheets.size() > 1, /* void */ );
 
 wxFileName sheetFileName = Last()->GetFileName();
 
 // If the sheet file name is absolute, then the user requested is so don't make it relative.
 if( sheetFileName.IsAbsolute() )
 return;
 
 SCH_SCREEN* screen = LastScreen();
 SCH_SCREEN* parentScreen = m_sheets[ m_sheets.size() - 2 ]->GetScreen();
 
 wxCHECK( screen && parentScreen, /* void */ );
 
 wxFileName fileName = screen->GetFileName();
 wxFileName parentFileName = parentScreen->GetFileName();
 
 // SCH_SCREEN file names must be absolute. If they are not, someone set them incorrectly
 // on load or on creation.
 wxCHECK( fileName.IsAbsolute() && parentFileName.IsAbsolute(), /* void */ );
 
 if( fileName.GetPath() == parentFileName.GetPath() )
 {
 Last()->SetFileName( fileName.GetFullName() );
 }
 else if( fileName.MakeRelativeTo( parentFileName.GetPath() ) )
 {
 Last()->SetFileName( fileName.GetFullPath() );
 }
 else
 {
 Last()->SetFileName( screen->GetFileName() );
 }
 
 wxLogTrace( tracePathsAndFiles,
 wxT( "\n File name: '%s'"
 "\n parent file name '%s',"
 "\n sheet '%s' file name '%s'." ),
 screen->GetFileName(), parentScreen->GetFileName(), PathHumanReadable(),
 Last()->GetFileName() );
}

References SCH_SCREEN::GetFileName(), SCH_SHEET::GetFileName(), Last(), LastScreen(), m_sheets, PathHumanReadable(), SCH_SHEET::SetFileName(), and tracePathsAndFiles.

◆ operator!=()

bool SCH_SHEET_PATH::operator!= ( const SCH_SHEET_PATH & d1 ) const

inline

Definition at line 405 of file sch_sheet_path.h.

405{ return !( *this == d1 ) ; }

◆ operator+()

SCH_SHEET_PATH SCH_SHEET_PATH::operator+ ( const SCH_SHEET_PATH & aOther )

Definition at line 127 of file sch_sheet_path.cpp.

{
 SCH_SHEET_PATH retv = *this;
 
 size_t size = aOther.size();
 
 for( size_t i = 0; i < size; i++ )
 retv.push_back( aOther.at( i ) );
 
 return retv;
}

References at(), push_back(), and size().

◆ operator<()

bool SCH_SHEET_PATH::operator< ( const SCH_SHEET_PATH & d1 ) const

inline

Definition at line 407 of file sch_sheet_path.h.

407{ return m_sheets < d1.m_sheets; }

References m_sheets.

◆ operator=()

SCH_SHEET_PATH & SCH_SHEET_PATH::operator= ( const SCH_SHEET_PATH & aOther )

Definition at line 120 of file sch_sheet_path.cpp.

{
 initFromOther( aOther );
 return *this;
}

References initFromOther().

◆ operator==()

bool SCH_SHEET_PATH::operator== ( const SCH_SHEET_PATH & d1 ) const

Definition at line 440 of file sch_sheet_path.cpp.

{
 return m_current_hash == d1.GetCurrentHash();
}

References GetCurrentHash(), and m_current_hash.

◆ Path()

KIID_PATH SCH_SHEET_PATH::Path ( ) const

Get the sheet path as an KIID_PATH.

Note: This KIID_PATH includes the root sheet UUID prefixed to the path.

Definition at line 280 of file sch_sheet_path.cpp.

{
 KIID_PATH path;
 
 for( const SCH_SHEET* sheet : m_sheets )
 path.push_back( sheet->m_Uuid );
 
 return path;
}

References m_sheets, and path.

Referenced by SCH_SHEET::addInstance(), SCH_SHEET_LIST::AddNewSheetInstances(), AddNewSymbolInstances(), SCH_EDIT_FRAME::AnnotateSymbols(), SCH_SYMBOL::ClearAnnotation(), findItemsFromSyncSelection(), SCH_SHEET_LIST::FindSheetForPath(), SCH_SEXPR_PLUGIN::Format(), SCH_SHEET::getPageNumber(), SCH_SHEET_LIST::GetPaths(), SCH_SYMBOL::GetRef(), SCH_SHEET_LIST::GetSheetInstances(), SCH_SHEET_LIST::GetSheetPathByKIIDPath(), SCH_SYMBOL::GetUnitSelection(), SCH_SYMBOL::IsAnnotated(), IsContainedWithin(), SCH_REFERENCE::IsSameInstance(), SCH_ALTIUM_PLUGIN::Load(), SCH_EAGLE_PLUGIN::loadInstance(), SCH_EAGLE_PLUGIN::loadSchematic(), SCH_EDIT_FRAME::mapExistingAnnotation(), SCH_ALTIUM_PLUGIN::ParseSheetSymbol(), SCH_SYMBOL::RemoveInstance(), SCH_SHEET::setPageNumber(), SCH_SYMBOL::SetRef(), SCHEMATIC::SetSheetNumberAndCount(), SCH_SYMBOL::SetUnitSelection(), and SCH_SHEET_LIST::UpdateSymbolInstanceData().

◆ PathAsString()

wxString SCH_SHEET_PATH::PathAsString ( ) const

Return the path of time stamps which do not changes even when editing sheet parameters.

A path is something like / (root) or /34005677 or /34005677/00AE4523.

Definition at line 265 of file sch_sheet_path.cpp.

{
 wxString s;
 
 s = wxT( "/" ); // This is the root path
 
 // Start at 1 to avoid the root sheet, which does not need to be added to the path.
 // Its timestamp changes anyway.
 for( unsigned i = 1; i < size(); i++ )
 s += at( i )->m_Uuid.AsString() + "/";
 
 return s;
}

References KIID::AsString(), at(), EDA_ITEM::m_Uuid, and size().

Referenced by SCH_REFERENCE::GetFullPath(), SCH_REFERENCE::GetPath(), NETLIST_EXPORTER_XML::makeSymbols(), SCH_EDIT_FRAME::SendSelectItemsToPcb(), and NETLIST_EXPORTER_ORCADPCB2::WriteNetlist().

◆ PathHumanReadable()

wxString SCH_SHEET_PATH::PathHumanReadable	(	bool	aUseShortRootName = `true`,
		bool	aStripTrailingSeparator = `false`
	)		const

Return the sheet path in a human readable form made from the sheet names.

The "normal" path instead uses the KIID objects in the path that do not change even when editing sheet parameters.

Definition at line 291 of file sch_sheet_path.cpp.

{
 wxString s;
 
 if( aUseShortRootName )
 {
 s = wxS( "/" ); // Use only the short name in netlists
 }
 else
 {
 wxString fileName;
 
 if( !empty() && at( 0 )->GetScreen() )
 fileName = at( 0 )->GetScreen()->GetFileName();
 
 wxFileName fn = fileName;
 
 s = fn.GetName() + wxS( "/" );
 }
 
 // Start at 1 since we've already processed the root sheet.
 for( unsigned i = 1; i < size(); i++ )
 s << at( i )->GetFields()[SHEETNAME].GetShownText() << wxS( "/" );
 
 if( aStripTrailingSeparator && s.EndsWith( "/" ) )
 s = s.Left( s.length() - 1 );
 
 return s;
}

References at(), empty(), SCH_SHEET::GetFields(), SCH_SCREEN::GetFileName(), SCH_SHEET::GetScreen(), SHEETNAME, and size().

Referenced by KIGFX::SCH_VIEW::DisplaySheet(), SCH_EDIT_TOOL::EditPageNumber(), CONNECTION_GRAPH::ercCheckBusToBusEntryConflicts(), SCH_EDIT_FRAME::GetScreenDesc(), MakeFilePathRelativeToParentSheet(), NETLIST_EXPORTER_XML::makeSymbols(), HIERARCHY_PANE::onRightClick(), DIALOG_SHEET_PROPERTIES::OnUpdateUI(), SCH_PLOTTER::plotOneSheetDXF(), SCH_PLOTTER::plotOneSheetHpgl(), SCH_PLOTTER::plotOneSheetPDF(), SCH_PLOTTER::plotOneSheetPS(), SCH_PLOTTER::plotOneSheetSVG(), SCH_CONNECTION::recacheName(), SCHEMATIC::ResolveTextVar(), SCH_SHEET::ResolveTextVar(), and SCH_EDIT_FRAME::updateTitle().

◆ pop_back()

void SCH_SHEET_PATH::pop_back ( )

inline

Forwarded method from std::vector.

Definition at line 167 of file sch_sheet_path.h.

 {
 m_sheets.pop_back();
 Rehash();
 }

References m_sheets, and Rehash().

Referenced by SCH_SHEET_LIST::AddNewSheetInstances(), HIERARCHY_PANE::buildHierarchyTree(), SCH_SHEET_LIST::BuildSheetList(), SCH_EDIT_TOOL::EditPageNumber(), SCH_SHEET::findSelf(), SCH_SHEET::GetContextualTextVars(), GetPageNumber(), SCH_SHEET_LIST::GetSheetInstances(), SCH_NAVIGATE_TOOL::LeaveSheet(), SCH_SEXPR_PLUGIN::loadHierarchy(), SCH_EAGLE_PLUGIN::loadSchematic(), SCH_SHEET::LocatePathOfScreen(), SCH_ALTIUM_PLUGIN::ParseAltiumSch(), SCH_SHEET::ResolveTextVar(), and SetPageNumber().

◆ push_back()

void SCH_SHEET_PATH::push_back ( SCH_SHEET * aSheet )

inline

Forwarded method from std::vector.

Definition at line 174 of file sch_sheet_path.h.

 {
 m_sheets.push_back( aSheet );
 Rehash();
 }

References m_sheets, and Rehash().

Referenced by SCH_EDIT_FRAME::AnnotateSymbols(), HIERARCHY_PANE::buildHierarchyTree(), SCH_SHEET_LIST::BuildSheetList(), SCH_EDIT_FRAME::CheckAnnotate(), SCH_EDIT_FRAME::CreateScreens(), SCH_EDIT_FRAME::DeleteAnnotation(), SCH_EDIT_TOOL::EditPageNumber(), SCH_NAVIGATE_TOOL::EnterSheet(), CONNECTION_GRAPH::ercCheckHierSheets(), SCH_SHEET::findSelf(), SCH_SEXPR_PLUGIN::Format(), HIERARCHY_PANE::getRootString(), SCH_ALTIUM_PLUGIN::Load(), SCH_SEXPR_PLUGIN::loadHierarchy(), KI_TEST::SCHEMATIC_TEST_FIXTURE::LoadSchematic(), SCH_EAGLE_PLUGIN::loadSchematic(), CADSTAR_SCH_ARCHIVE_LOADER::loadSheetAndChildSheets(), CADSTAR_SCH_ARCHIVE_LOADER::loadSheets(), SCH_SHEET::LocatePathOfScreen(), operator+(), SCH_ALTIUM_PLUGIN::ParseAltiumSch(), SCH_ALTIUM_PLUGIN::ParseHarnessConnector(), SCH_SEXPR_PARSER::parseSchSheetInstances(), SCH_ALTIUM_PLUGIN::ParseSheetSymbol(), CONNECTION_GRAPH::propagateToNeighbors(), SCH_EDITOR_CONTROL::Revert(), SCHEMATIC::SetRoot(), TEST_SCH_SHEET_PATH_FIXTURE::TEST_SCH_SHEET_PATH_FIXTURE(), DIALOG_SHEET_PROPERTIES::TransferDataFromWindow(), DIALOG_SHEET_PROPERTIES::TransferDataToWindow(), HIERARCHY_PANE::UpdateHierarchyTree(), and SCH_EDITOR_CONTROL::updatePastedSheet().

◆ Rehash()

void SCH_SHEET_PATH::Rehash ( )

Definition at line 158 of file sch_sheet_path.cpp.

{
 m_current_hash = 0;
 
 for( SCH_SHEET* sheet : m_sheets )
 boost::hash_combine( m_current_hash, sheet->m_Uuid.Hash() );
}

References hash_combine(), m_current_hash, and m_sheets.

Referenced by clear(), pop_back(), and push_back().

◆ RemoveSymbolInstances()

void SCH_SHEET_PATH::RemoveSymbolInstances ( const SCH_SHEET_PATH & aPrefixSheetPath )

Definition at line 598 of file sch_sheet_path.cpp.

{
 for( SCH_ITEM* item : LastScreen()->Items().OfType( SCH_SYMBOL_T ) )
 {
 SCH_SYMBOL* symbol = static_cast<SCH_SYMBOL*>( item );
 
 wxCHECK2( symbol, continue );
 
 SCH_SHEET_PATH fullSheetPath( aPrefixSheetPath );
 SCH_SHEET_PATH currentSheetPath( *this );
 
 // Prefix the hierarchical path of the symbol instance to be removed.
 fullSheetPath = fullSheetPath + currentSheetPath;
 symbol->RemoveInstance( fullSheetPath );
 }
}

References LastScreen(), SCH_SYMBOL::RemoveInstance(), and SCH_SYMBOL_T.

Referenced by SCH_SHEET_LIST::RemoveSymbolInstances().

◆ SetPageNumber()

void SCH_SHEET_PATH::SetPageNumber ( const wxString & aPageNumber )

Set the sheet instance user definable page number.

Note: User definable page numbers can be any string devoid of white space characters.

Definition at line 541 of file sch_sheet_path.cpp.

{
 SCH_SHEET* sheet = Last();
 
 wxCHECK( sheet, /* void */ );
 
 SCH_SHEET_PATH tmpPath = *this;
 
 tmpPath.pop_back();
 
 sheet->addInstance( tmpPath );
 sheet->setPageNumber( tmpPath, aPageNumber );
}

References SCH_SHEET::addInstance(), Last(), pop_back(), and SCH_SHEET::setPageNumber().

Referenced by SCH_SHEET_LIST::AddNewSheetInstances(), SCH_EDIT_FRAME::CreateScreens(), SCH_EDIT_TOOL::EditPageNumber(), SCH_ALTIUM_PLUGIN::Load(), SCH_EAGLE_PLUGIN::loadSchematic(), CADSTAR_SCH_ARCHIVE_LOADER::loadSheetAndChildSheets(), CADSTAR_SCH_ARCHIVE_LOADER::loadSheets(), HIERARCHY_PANE::onRightClick(), SCH_ALTIUM_PLUGIN::ParseHarnessConnector(), SCH_ALTIUM_PLUGIN::ParseParameter(), SCH_SEXPR_PARSER::parseSchSheetInstances(), SCH_ALTIUM_PLUGIN::ParseSheetSymbol(), SCH_SHEET_LIST::SetInitialPageNumbers(), DIALOG_SHEET_PROPERTIES::TransferDataFromWindow(), and DIALOG_SHEET_PROPERTIES::TransferDataToWindow().

◆ SetVirtualPageNumber()

void SCH_SHEET_PATH::SetVirtualPageNumber ( int aPageNumber )

inline

Set the sheet instance virtual page number.

Virtual page numbers are incremental integers set automatically when the sheet path hierarchy is created (

See also: SCH_SHEET_LIST::BuildSheetList). The virtual page numbering is ordered by the X and Y position of the sheet in a schematic which mimics the page numbering code prior to the addition of actual user definable page numbers. Virtual page numbers should only be use when annotating schematics.

Definition at line 201 of file sch_sheet_path.h.

201{ m_virtualPageNumber = aPageNumber; }

References m_virtualPageNumber.

Referenced by SCH_SHEET_LIST::AddNewSheetInstances(), SCH_SHEET_LIST::BuildSheetList(), SCHEMATIC::SetSheetNumberAndCount(), and SCH_SHEET_LIST::SortByPageNumbers().

◆ size()

size_t SCH_SHEET_PATH::size ( ) const

inline

Forwarded method from std::vector.

Definition at line 181 of file sch_sheet_path.h.

181{ return m_sheets.size(); }

References m_sheets.

Referenced by SCH_SHEET_LIST::AddNewSheetInstances(), Cmp(), SCH_EDIT_TOOL::EditPageNumber(), SCH_SHEET::GetContextualTextVars(), GetSheet(), SCHEMATIC::GetUniqueFilenameForCurrentSheet(), IsContainedWithin(), operator+(), PathAsString(), PathHumanReadable(), CONNECTION_GRAPH::propagateToNeighbors(), SCH_SHEET::ResolveTextVar(), SCH_SHEET_LIST::TestForRecursion(), and TestForRecursion().

◆ TestForRecursion()

bool SCH_SHEET_PATH::TestForRecursion	(	const wxString &	aSrcFileName,
		const wxString &	aDestFileName
	)

Test the SCH_SHEET_PATH file names to check adding the sheet stored in the file aSrcFileName to the sheet stored in file aDestFileName will cause a sheet path recursion.

Parameters

aSrcFileName	is the source file name of the sheet add to aDestFileName.
aDestFileName	is the file name of the destination sheet for aSrcFileName.

Returns: true if aFileName will cause recursion in the sheet path. Otherwise false.

Todo:: Store sheet file names with full path, either relative to project path or absolute path. The current design always assumes subsheet files are located in the project folder which may or may not be desirable.

Definition at line 446 of file sch_sheet_path.cpp.

{
 auto pair = std::make_pair( aSrcFileName, aDestFileName );
 
 if( m_recursion_test_cache.count( pair ) )
 return m_recursion_test_cache.at( pair );
 
 SCHEMATIC* sch = LastScreen()->Schematic();
 
 wxCHECK_MSG( sch, false, "No SCHEMATIC found in SCH_SHEET_PATH::TestForRecursion!" );
 
 wxFileName rootFn = sch->GetFileName();
 wxFileName srcFn = aSrcFileName;
 wxFileName destFn = aDestFileName;
 
 if( srcFn.IsRelative() )
 srcFn.MakeAbsolute( rootFn.GetPath() );
 
 if( destFn.IsRelative() )
 destFn.MakeAbsolute( rootFn.GetPath() );
 
 
 // The source and destination sheet file names cannot be the same.
 if( srcFn == destFn )
 {
 m_recursion_test_cache[pair] = true;
 return true;
 }
 
 unsigned i = 0;
 
 while( i < size() )
 {
 wxFileName cmpFn = at( i )->GetFileName();
 
 if( cmpFn.IsRelative() )
 cmpFn.MakeAbsolute( rootFn.GetPath() );
 
 // Test if the file name of the destination sheet is in anywhere in this sheet path.
 if( cmpFn == destFn )
 break;
 
 i++;
 }
 
 // The destination sheet file name was not found in the sheet path or the destination
 // sheet file name is the root sheet so no recursion is possible.
 if( i >= size() || i == 0 )
 {
 m_recursion_test_cache[pair] = false;
 return false;
 }
 
 // Walk back up to the root sheet to see if the source file name is already a parent in
 // the sheet path. If so, recursion will occur.
 do
 {
 i -= 1;
 
 wxFileName cmpFn = at( i )->GetFileName();
 
 if( cmpFn.IsRelative() )
 cmpFn.MakeAbsolute( rootFn.GetPath() );
 
 if( cmpFn == srcFn )
 {
 m_recursion_test_cache[pair] = true;
 return true;
 }
 
 } while( i != 0 );
 
 // The source sheet file name is not a parent of the destination sheet file name.
 m_recursion_test_cache[pair] = false;
 return false;
}

References at(), SCH_SHEET::GetFileName(), SCHEMATIC::GetFileName(), LastScreen(), m_recursion_test_cache, SCH_SCREEN::Schematic(), and size().

Referenced by SCH_SHEET_LIST::BuildSheetList().

◆ UpdateAllScreenReferences()

void SCH_SHEET_PATH::UpdateAllScreenReferences ( ) const

Update all the symbol references for this sheet path.

Mandatory in complex hierarchies because sheets may use the same screen (basic schematic) more than once but with different references and units according to the displayed sheet.

Definition at line 323 of file sch_sheet_path.cpp.

{
 std::vector<SCH_ITEM*> items;
 
 std::copy_if( LastScreen()->Items().begin(), LastScreen()->Items().end(),
 std::back_inserter( items ),
 []( SCH_ITEM* aItem )
 {
 return ( aItem->Type() == SCH_SYMBOL_T || aItem->Type() == SCH_GLOBAL_LABEL_T );
 } );
 
 for( SCH_ITEM* item : items )
 {
 if( item->Type() == SCH_SYMBOL_T )
 {
 SCH_SYMBOL* symbol = static_cast<SCH_SYMBOL*>( item );
 
 symbol->GetField( REFERENCE_FIELD )->SetText( symbol->GetRef( this ) );
 symbol->UpdateUnit( symbol->GetUnitSelection( this ) );
 LastScreen()->Update( item, false );
 }
 else if( item->Type() == SCH_GLOBAL_LABEL_T )
 {
 SCH_GLOBALLABEL* label = static_cast<SCH_GLOBALLABEL*>( item );
 
 if( label->GetFields().size() > 0 ) // Possible when reading a legacy .sch schematic
 {
 SCH_FIELD& intersheetRefs = label->GetFields()[0];
 
 // Fixup for legacy files which didn't store a position for the intersheet refs
 // unless they were shown.
 if( label->GetFields().size() == 1
 && intersheetRefs.GetInternalName() == wxT( "Intersheet References" )
 && intersheetRefs.GetPosition() == VECTOR2I( 0, 0 )
 && !intersheetRefs.IsVisible() )
 {
 label->AutoplaceFields( LastScreen(), false );
 }
 
 intersheetRefs.SetVisible( label->Schematic()->Settings().m_IntersheetRefsShow );
 LastScreen()->Update( &intersheetRefs );
 }
 }
 }
}

References SCH_LABEL_BASE::AutoplaceFields(), SCH_SYMBOL::GetField(), SCH_LABEL_BASE::GetFields(), SCH_FIELD::GetInternalName(), SCH_FIELD::GetPosition(), SCH_SYMBOL::GetRef(), SCH_SYMBOL::GetUnitSelection(), EDA_TEXT::IsVisible(), LastScreen(), SCHEMATIC_SETTINGS::m_IntersheetRefsShow, REFERENCE_FIELD, SCH_GLOBAL_LABEL_T, SCH_SYMBOL_T, SCH_ITEM::Schematic(), EDA_TEXT::SetText(), SCHEMATIC::Settings(), EDA_TEXT::SetVisible(), EDA_ITEM::Type(), SCH_SCREEN::Update(), and SCH_SYMBOL::UpdateUnit().

Referenced by SCH_EDIT_FRAME::AnnotateSymbols(), SCH_PLOTTER::createDXFFiles(), SCH_PLOTTER::createHPGLFiles(), SCH_PLOTTER::createPDFFile(), SCH_PLOTTER::createPSFiles(), SCH_PLOTTER::createSVGFiles(), SCH_EDIT_FRAME::DeleteAnnotation(), SCH_EDIT_FRAME::DisplayCurrentSheet(), ERC_TREE_MODEL::GetValue(), DIALOG_MIGRATE_BUSES::onItemSelected(), SCH_PRINTOUT::OnPrintPage(), DIALOG_UPDATE_FROM_PCB::OnUpdateClick(), SCH_EDIT_FRAME::OpenProjectFiles(), SCH_EDITOR_CONTROL::Paste(), SCH_DRAWING_TOOLS::PlaceSymbol(), DIALOG_CHANGE_SYMBOLS::processMatchingSymbols(), SCH_FIND_REPLACE_TOOL::ReplaceAll(), SCH_FIND_REPLACE_TOOL::ReplaceAndFindNext(), and SCH_PLOTTER::restoreEnvironment().

Member Data Documentation

◆ m_current_hash

size_t SCH_SHEET_PATH::m_current_hash

protected

Definition at line 415 of file sch_sheet_path.h.

Referenced by GetCurrentHash(), initFromOther(), operator==(), Rehash(), and SCH_SHEET_PATH().

◆ m_recursion_test_cache

std::map<std::pair<wxString, wxString>, bool> SCH_SHEET_PATH::m_recursion_test_cache

protected

Page numbers are maintained by the sheet load order.

Definition at line 419 of file sch_sheet_path.h.

Referenced by TestForRecursion().

◆ m_sheets

std::vector< SCH_SHEET* > SCH_SHEET_PATH::m_sheets

protected

Definition at line 413 of file sch_sheet_path.h.

Referenced by at(), clear(), empty(), erase(), initFromOther(), IsFullPath(), Last(), MakeFilePathRelativeToParentSheet(), operator<(), Path(), pop_back(), push_back(), Rehash(), and size().

◆ m_virtualPageNumber

int SCH_SHEET_PATH::m_virtualPageNumber

protected

Definition at line 417 of file sch_sheet_path.h.

Referenced by AppendMultiUnitSymbol(), AppendSymbol(), GetVirtualPageNumber(), initFromOther(), SCH_SHEET_PATH(), and SetVirtualPageNumber().

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

Public Member Functions

Protected Attributes

Private Member Functions

Detailed Description

Constructor & Destructor Documentation

◆ SCH_SHEET_PATH() [1/2]

◆ SCH_SHEET_PATH() [2/2]

◆ ~SCH_SHEET_PATH()

Member Function Documentation

◆ AddNewSymbolInstances()

◆ AppendMultiUnitSymbol()

◆ AppendSymbol()

◆ at()

◆ clear()

◆ Cmp()

◆ ComparePageNum()

◆ empty()

◆ erase()

◆ GetCurrentHash()

◆ GetItem()

◆ GetMultiUnitSymbols()

◆ GetPageNumber()

◆ GetSheet()

◆ GetSymbols()

◆ GetVirtualPageNumber()

◆ initFromOther()

◆ IsContainedWithin()

◆ IsFullPath()

◆ Last()

◆ LastScreen() [1/2]

◆ LastScreen() [2/2]

◆ MakeFilePathRelativeToParentSheet()

◆ operator!=()

◆ operator+()

◆ operator<()

◆ operator=()

◆ operator==()

◆ Path()

◆ PathAsString()

◆ PathHumanReadable()

◆ pop_back()

◆ push_back()

◆ Rehash()

◆ RemoveSymbolInstances()

◆ SetPageNumber()

◆ SetVirtualPageNumber()

◆ size()

◆ TestForRecursion()

◆ UpdateAllScreenReferences()

Member Data Documentation

◆ m_current_hash

◆ m_recursion_test_cache

◆ m_sheets

◆ m_virtualPageNumber