75 m_fileFormatVersionAtLoad( 0 ),
76 m_paper( wxT(
"A4" ) ),
77 m_isReadOnly( false ),
102 wxT(
"SCH_SCREEN must have a SCHEMATIC parent!" ) );
110 for(
const std::pair<const wxString, LIB_SYMBOL*>& libSymbol :
m_libSymbols )
111 delete libSymbol.second;
119 wxASSERT( aFileName.IsEmpty() || wxIsAbsolutePath( aFileName ) );
133 wxCHECK_RET(
m_refCount != 0, wxT(
"Screen reference count already zero. Bad programmer!" ) );
142 return sheets.
begin() != sheets.
end();
187 std::vector<wxString> matches;
190 foundSymbol =
nullptr;
192 for(
const wxString& libSymbolName : matches )
199 foundSymbol = it->second;
201 wxCHECK2( foundSymbol,
continue );
211 newName = libSymbolName;
217 foundSymbol =
nullptr;
224 newName.Printf( wxT(
"%s_%d" ),
231 newName.Printf( wxT(
"%s_%d" ),
245 LIB_ID newLibId( wxEmptyString, newName );
249 newLibSymbol->
SetName( newName );
266 wxCHECK_RET( aScreen,
"Invalid screen object." );
273 aScreen->
Clear(
false );
300 std::vector<SCH_ITEM*> delete_list;
305 return ( aItem->Type() != SCH_SHEET_PIN_T && aItem->Type() != SCH_FIELD_T );
317 if(
Remove( aItem, aUpdateLibSymbol ) )
318 Append( aItem, aUpdateLibSymbol );
331 bool removeUnusedLibSymbol =
true;
339 removeUnusedLibSymbol =
false;
344 if( removeUnusedLibSymbol )
362 wxCHECK_RET( aItem, wxT(
"Cannot delete invalid item from screen." ) );
376 wxCHECK_RET( sheet, wxT(
"Sheet pin parent not properly set, bad programmer!" ) );
399 if( item->HitTest( aPosition, aAccuracy ) )
409#define PROCESSED CANDIDATE
411 std::set<SCH_ITEM*> retval;
412 std::stack<SCH_LINE*> to_search;
414 wxCHECK_MSG( aSegment && aSegment->
Type() ==
SCH_LINE_T, retval, wxT(
"Invalid pointer." ) );
416 to_search.push( aSegment );
418 while( !to_search.empty() )
449 retval.insert( junction );
451 retval.insert( line );
452 to_search.push( line );
454 else if( !junction && !
pin )
456 retval.insert( line );
457 to_search.push( line );
464 retval.insert( line );
465 to_search.push( line );
472 item->ClearTempFlags();
482 return info.isJunction;
491 return info.isJunction && ( !
info.hasBusEntry ||
info.hasBusEntryToMultipleWires );
500 return info.isJunction && ( !
info.hasBusEntry ||
info.hasBusEntryToMultipleWires )
501 && !
info.hasExplicitJunctionDot;
510 return info.isJunction && (!
info.hasBusEntry ||
info.hasBusEntryToMultipleWires );
518 auto ret = aDefaultOrientation;
524 switch( item->Type() )
529 if( busEntry->m_connected_bus_item )
533 auto bus =
static_cast<const SCH_LINE*
>( busEntry->m_connected_bus_item );
534 if( bus->Angle().AsDegrees() == 90.0 )
538 if( aPosition.
x < bus->GetPosition().x )
540 else if( aPosition.
x > bus->GetPosition().x )
543 else if( bus->Angle().AsDegrees() == 0.0 )
547 if( aPosition.
y < bus->GetPosition().y )
549 else if( aPosition.
y > bus->GetPosition().y )
558 auto line =
static_cast<const SCH_LINE*
>( item );
562 if( -45 < angle && angle <= 45 )
564 if( line->GetStartPoint().x <= line->GetEndPoint().x )
571 if( line->GetStartPoint().y <= line->GetEndPoint().y )
585 if(
pin->GetPosition() == aPosition )
587 if(
pin->GetOrientation() == PIN_ORIENTATION::PIN_RIGHT )
589 else if(
pin->GetOrientation() == PIN_ORIENTATION::PIN_LEFT )
591 else if(
pin->GetOrientation() == PIN_ORIENTATION::PIN_UP )
593 else if(
pin->GetOrientation() == PIN_ORIENTATION::PIN_DOWN )
715 wxT(
"Invalid layer type passed to SCH_SCREEN::IsTerminalPoint()." ) );
728 if( sheetPin && sheetPin->
IsConnected( aPosition ) )
751 if(
GetPin( aPosition,
nullptr,
true ) )
764 if( sheetPin && sheetPin->
IsConnected( aPosition ) )
779 wxCHECK_RET(
Schematic(),
"Cannot call SCH_SCREEN::UpdateSymbolLinks with no SCHEMATIC" );
782 std::unique_ptr< LIB_SYMBOL > libSymbol;
783 std::vector<SCH_SYMBOL*> symbols;
790 symbols.push_back(
static_cast<SCH_SYMBOL*
>( item ) );
805 auto it =
m_libSymbols.find( symbol->GetSchSymbolLibraryName() );
811 msg.Printf(
_(
"Setting schematic symbol '%s %s' library identifier to '%s'." ),
819 symbol->SetLibSymbol(
new LIB_SYMBOL( *it->second ) );
823 if( !symbol->GetLibId().IsValid() )
827 msg.Printf(
_(
"Schematic symbol reference '%s' library identifier is not valid. "
828 "Unable to link library symbol." ),
839 if( !libs->
HasLibrary( symbol->GetLibId().GetLibNickname() ) && !legacyLibs )
843 msg.Printf(
_(
"Symbol library '%s' not found and no fallback cache library "
844 "available. Unable to link library symbol." ),
845 symbol->GetLibId().GetLibNickname().wx_str() );
852 if( libs->
HasLibrary( symbol->GetLibId().GetLibNickname() ) )
862 msg.Printf(
_(
"I/O error %s resolving library symbol %s" ), ioe.
What(),
871 SYMBOL_LIB& legacyCacheLib = legacyLibs->back();
874 wxCHECK2( legacyCacheLib.
IsCache(),
continue );
876 wxString
id = symbol->GetLibId().Format();
878 id.Replace(
':',
'_' );
882 msg.Printf(
_(
"Falling back to cache to set symbol '%s:%s' link '%s'." ),
896 libSymbol->SetParent();
898 m_libSymbols.insert( { symbol->GetSchSymbolLibraryName(),
903 msg.Printf(
_(
"Setting schematic symbol '%s %s' library identifier to '%s'." ),
914 msg.Printf(
_(
"No library symbol found for schematic symbol '%s %s'." ),
921 if( libSymbol.get() )
922 symbol->SetLibSymbol( libSymbol.release() );
934 std::vector<SCH_SYMBOL*> symbols;
937 symbols.push_back(
static_cast<SCH_SYMBOL*
>( item ) );
944 auto it =
m_libSymbols.find( symbol->GetSchSymbolLibraryName() );
951 symbol->SetLibSymbol( libSymbol );
961 item->SetConnectivityDirty(
true );
968 std::vector<SCH_ITEM*> junctions;
969 std::vector<SCH_ITEM*> bitmaps;
970 std::vector<SCH_ITEM*> other;
974 if( item->IsMoving() )
978 junctions.push_back( item );
980 bitmaps.push_back( item );
982 other.push_back( item );
986 std::stable_sort( other.begin(), other.end(),
989 if( a->Type() == b->Type() )
990 return a->GetLayer() > b->GetLayer();
992 return a->Type() < b->Type();
996 item->Print( aSettings, 0, 0,
VECTOR2I( 0, 0 ),
false,
false );
999 item->PrintBackground( aSettings, 0, 0,
VECTOR2I( 0, 0 ),
false );
1002 item->Print( aSettings, 0, 0,
VECTOR2I( 0, 0 ),
false,
false );
1005 item->Print( aSettings, 0, 0,
VECTOR2I( 0, 0 ),
false,
false );
1012 std::vector<SCH_ITEM*> junctions;
1013 std::vector<SCH_ITEM*> bitmaps;
1014 std::vector<SCH_SYMBOL*> symbols;
1015 std::vector<SCH_ITEM*> other;
1019 if( item->IsMoving() )
1023 junctions.push_back( item );
1025 bitmaps.push_back( item );
1027 other.push_back( item );
1038 symbols.push_back(
static_cast<SCH_SYMBOL*
>( item ) );
1046 std::sort( other.begin(), other.end(),
1049 if( a->Type() == b->Type() )
1050 return a->GetLayer() > b->GetLayer();
1052 return a->Type() > b->Type();
1056 constexpr bool background =
true;
1064 item->Plot( aPlotter, background, aPlotOpts, 0, 0, { 0, 0 }, false );
1071 item->Plot( aPlotter, background, aPlotOpts, 0, 0, { 0, 0 }, false );
1078 item->Plot( aPlotter, !background, aPlotOpts, 0, 0, { 0, 0 }, false );
1083 TRANSFORM savedTransform = renderSettings->m_Transform;
1087 renderSettings->m_Transform = sym->GetTransform();
1090 for(
SCH_FIELD field : sym->GetFields() )
1092 field.ClearRenderCache();
1093 field.Plot( aPlotter,
false, aPlotOpts, sym->GetUnit(), sym->GetBodyStyle(), { 0, 0 },
1097 sym->PlotPins( aPlotter );
1100 sym->PlotDNP( aPlotter );
1103 renderSettings->m_Transform = savedTransform;
1108 item->Plot( aPlotter, !background, aPlotOpts, 0, 0, { 0, 0 }, false );
1116 item->ClearTempFlags();
1121 bool aEndPointOnly )
const
1128 candidate =
static_cast<SCH_SYMBOL*
>( item );
1158 if(
pin && aSymbol )
1159 *aSymbol = candidate;
1173 sheetPin = sheet->
GetPin( aPosition );
1189 if( ( item->Type() !=
SCH_JUNCTION_T || aTestJunctions ) && item->IsConnected( aPos ) )
1227 static const std::vector<KICAD_T> hierarchicalTypes = {
SCH_SYMBOL_T,
1233 if( item->IsType( hierarchicalTypes ) )
1234 aItems->push_back( item );
1242 aItems->push_back( item );
1244 std::sort( aItems->begin(), aItems->end(),
1247 if( a->GetPosition().x == b->GetPosition().x )
1250 if( a->GetPosition().y == b->GetPosition().y )
1251 return a->m_Uuid < b->m_Uuid;
1253 return a->GetPosition().y < b->GetPosition().y;
1257 return a->GetPosition().x < b->GetPosition().x;
1264 std::function<
void(
SCH_ITEM* )>* aChangedHandler )
const
1268 std::vector<DANGLING_END_ITEM> endPointsByPos;
1269 std::vector<DANGLING_END_ITEM> endPointsByType;
1274 if( item->IsConnectable() )
1275 item->GetEndPoints( endPointsByType );
1281 if( item->UpdateDanglingState( endPointsByType, endPointsByPos, aPath ) )
1283 if( aChangedHandler )
1284 ( *aChangedHandler )( item );
1291 item->RunOnChildren( get_ends );
1294 PROF_TIMER sortTimer(
"SCH_SCREEN::TestDanglingEnds pre-sort" );
1295 endPointsByPos = endPointsByType;
1304 update_state( item );
1305 item->RunOnChildren( update_state );
1317 aAccuracy = std::max( aAccuracy, 1 );
1319 for(
SCH_ITEM* item :
Items().Overlapping( aPosition, aAccuracy ) )
1324 if( item->GetLayer() != aLayer )
1327 if( !item->HitTest( aPosition, aAccuracy ) )
1330 switch( aSearchType )
1336 if( !( (
SCH_LINE*) item )->IsEndPoint( aPosition ) )
1341 if( ( (
SCH_LINE*) item )->IsEndPoint( aPosition ) )
1351 bool aIgnoreEndpoints )
const
1353 std::vector<SCH_LINE*> retVal;
1357 if( item->IsType( { SCH_ITEM_LOCATE_WIRE_T, SCH_ITEM_LOCATE_BUS_T } ) )
1361 if( aIgnoreEndpoints && wire->
IsEndPoint( aPosition ) )
1365 retVal.push_back( wire );
1375 std::vector<VECTOR2I> retval;
1382 std::vector<VECTOR2I> pts = item->GetConnectionPoints();
1383 retval.insert( retval.end(), pts.begin(), pts.end() );
1388 std::sort( retval.begin(), retval.end(),
1391 return a.x < b.x || ( a.x == b.x && a.y < b.y );
1393 retval.erase( std::unique( retval.begin(), retval.end() ), retval.end() );
1401 std::vector<VECTOR2I> pts;
1404 for(
const EDA_ITEM* edaItem : aItems )
1412 pts.insert( pts.end(), new_pts.begin(), new_pts.end() );
1420 for(
const VECTOR2I& pt : connections )
1423 pts.push_back( pt );
1429 std::sort( pts.begin(), pts.end(),
1432 return a.x < b.x || ( a.x == b.x && a.y < b.y );
1435 pts.erase( unique( pts.begin(), pts.end() ), pts.end() );
1438 pts.erase( std::remove_if( pts.begin(), pts.end(),
1439 [
this](
const VECTOR2I& a ) ->
bool
1441 return !IsExplicitJunctionNeeded( a );
1451 for(
SCH_ITEM* item :
Items().Overlapping( aPosition, aAccuracy ) )
1453 switch( item->Type() )
1459 if( item->HitTest( aPosition, aAccuracy ) )
1475 wxCHECK( aLibSymbol, );
1497 for(
auto& [filename, embeddedFile] : libSym->EmbeddedFileMap() )
1505 embeddedFile->data_sha = file->
data_sha;
1506 embeddedFile->is_valid = file->
is_valid;
1556 std::vector<wxString>& aMatches )
1561 aMatches.emplace_back( searchName );
1570 if( pair.first.StartsWith( searchName, &suffix ) && suffix.ToLong( &tmp ) )
1571 aMatches.emplace_back( pair.first );
1574 return aMatches.size();
1586 if( aProjectName.IsEmpty() )
1593 wxCHECK2( symbol,
continue );
1595 std::set<KIID_PATH> pathsToPrune;
1596 const std::vector<SCH_SYMBOL_INSTANCE> instances = symbol->
GetInstances();
1601 if( aProjectName != instance.m_ProjectName )
1604 std::optional<SCH_SHEET_PATH> pathFound =
1610 pathsToPrune.emplace( instance.m_Path );
1611 else if( pathFound.value().LastScreen() !=
this )
1612 pathsToPrune.emplace( pathFound.value().Path() );
1615 for(
const KIID_PATH& sheetPath : pathsToPrune )
1618 aProjectName, sheetPath.AsString() );
1633 if( aProjectName.IsEmpty() )
1640 wxCHECK2( sheet,
continue );
1642 std::set<KIID_PATH> pathsToPrune;
1643 const std::vector<SCH_SHEET_INSTANCE> instances = sheet->
GetInstances();
1648 if( aProjectName != instance.m_ProjectName )
1651 std::optional<SCH_SHEET_PATH> pathFound =
1657 pathsToPrune.emplace( instance.m_Path );
1658 else if( pathFound.value().LastScreen() !=
this )
1659 pathsToPrune.emplace( pathFound.value().Path() );
1662 for(
const KIID_PATH& sheetPath : pathsToPrune )
1665 aProjectName, sheetPath.AsString() );
1673void SCH_SCREEN::Show(
int nestLevel, std::ostream& os )
const
1676 NestedSpace( nestLevel, os ) <<
'<' <<
GetClass().Lower().mb_str() <<
">\n";
1679 item->Show( nestLevel + 1, os );
1681 NestedSpace( nestLevel, os ) <<
"</" <<
GetClass().Lower().mb_str() <<
">\n";
1738 if( aScreen ==
nullptr )
1743 if( screen == aScreen )
1758 wxCHECK_RET( screen,
"No screen for aSheet" );
1777 wxCHECK_RET( sch,
"Null schematic in SCH_SCREENS::ClearAnnotationOfNewSheetPaths" );
1787 bool path_exists =
false;
1789 for(
const SCH_SHEET_PATH& existing_sheetpath: aInitialSheetPathList )
1791 if( existing_sheetpath.Path() == sheetpath.Path() )
1801 SCH_SCREEN* curr_screen = sheetpath.LastScreen();
1816 std::vector<SCH_ITEM*> items;
1821 return a->
m_Uuid < b->m_Uuid;
1824 std::set<
EDA_ITEM*,
decltype( timestamp_cmp )> unique_stamps( timestamp_cmp );
1827 screen->GetHierarchicalItems( &items );
1829 if( items.size() < 2 )
1834 if( !unique_stamps.insert( item ).second )
1839 const_cast<KIID&
>( item->m_Uuid ) =
KIID();
1856 for(
SCH_ITEM* item : screen->Items() )
1857 item->ClearEditFlags();
1868 if( item == aMarker )
1870 screen->DeleteItem( item );
1879 bool aIncludeExclusions )
1883 std::vector<SCH_ITEM*> markers;
1888 std::shared_ptr<RC_ITEM>rcItem = marker->
GetRCItem();
1891 && ( aErrorCode ==
ERCE_UNSPECIFIED || rcItem->GetErrorCode() == aErrorCode )
1892 && ( !marker->
IsExcluded() || aIncludeExclusions ) )
1894 markers.push_back( item );
1899 screen->DeleteItem( marker );
1905 bool aIncludeExclusions )
1914 screen->UpdateSymbolLinks( aReporter );
1923 wxCHECK_RET( sch,
"Null schematic in SCH_SCREENS::UpdateSymbolLinks" );
1936 bool has_symbols =
false;
1951 return has_symbols ? true :
false;
1964 if( !nickname.
empty() && ( aLibNicknames.Index( nickname ) == wxNOT_FOUND ) )
1965 aLibNicknames.Add( nickname );
1969 return aLibNicknames.GetCount();
2002 if( screen->GetFileName() == aSchematicFileName )
2019 wxCHECK_RET( sch,
"Null schematic in SCH_SCREENS::BuildClientSheetPathList" );
2022 curr_screen->GetClientSheetPaths().clear();
2026 SCH_SCREEN* used_screen = sheetpath.LastScreen();
2031 if( used_screen == curr_screen )
2044 screen->SetLegacySymbolInstanceData();
2051 screen->FixLegacyPowerSymbolMismatches();
2065 SIM_MODEL::MigrateSimModel<SCH_SYMBOL>( *symbol, &
Schematic()->
Prj() );
2073 if( aProjectName.IsEmpty() )
2077 screen->PruneOrphanedSymbolInstances( aProjectName, aValidSheetPaths );
2084 if( aProjectName.IsEmpty() )
2088 screen->PruneOrphanedSheetInstances( aProjectName, aValidSheetPaths );
constexpr EDA_IU_SCALE schIUScale
Handles how to draw a screen (a board, a schematic ...)
int m_virtualPageNumber
An integer based page number used for printing a range of pages.
bool m_Center
Center on screen.
int m_pageCount
The number of BASE_SCREEN objects in this design.
void SetContentModified(bool aModified=true)
void InitDataPoints(const VECTOR2I &aPageSizeInternalUnits)
void SetOrigin(const Vec &pos)
BOX2< Vec > & Inflate(coord_type dx, coord_type dy)
Inflates the rectangle horizontally by dx and vertically by dy.
void Recalculate(const SCH_SHEET_LIST &aSheetList, bool aUnconditional=false, std::function< void(SCH_ITEM *)> *aChangedItemHandler=nullptr)
Update the connection graph for the given list of sheets.
static void sort_dangling_end_items(std::vector< DANGLING_END_ITEM > &aItemListByType, std::vector< DANGLING_END_ITEM > &aItemListByPos)
Both contain the same information.
A base class for most all the KiCad significant classes used in schematics and boards.
virtual const BOX2I GetBoundingBox() const
Return the orthogonal bounding box of this object for display purposes.
void SetFlags(EDA_ITEM_FLAGS aMask)
KICAD_T Type() const
Returns the type of object.
virtual void SetParent(EDA_ITEM *aParent)
EDA_ITEM * GetParent() const
bool HasFlag(EDA_ITEM_FLAGS aFlag) const
EE_TYPE Overlapping(const BOX2I &aRect) const
bool remove(SCH_ITEM *aItem)
Remove an item from the tree.
void insert(SCH_ITEM *aItem)
Insert an item into the tree.
bool contains(const SCH_ITEM *aItem, bool aRobust=false) const
Determine if a given item exists in the tree.
iterator end()
Returns a read/write iterator that points to one past the last element in the EE_RTREE.
iterator begin()
Returns a read/write iterator that points to the first element in the EE_RTREE N.B.
EE_TYPE OfType(KICAD_T aType) const
void clear()
Remove all items from the RTree.
EMBEDDED_FILE * GetEmbeddedFile(const wxString &aName) const
Returns the embedded file with the given name or nullptr if it does not exist.
Hold an error message and may be used when throwing exceptions containing meaningful error messages.
virtual const wxString What() const
A composite of Problem() and Where()
A logical library item identifier and consists of various portions much like a URI.
int SetLibNickname(const UTF8 &aLibNickname)
Override the logical library name portion of the LIB_ID to aLibNickname.
wxString GetUniStringLibId() const
const wxString GetUniStringLibItemName() const
Get strings for display messages in dialogs.
const UTF8 & GetLibNickname() const
Return the logical library name portion of a LIB_ID.
Define a library symbol object.
const LIB_ID & GetLibId() const override
LIB_ITEMS_CONTAINER & GetDrawItems()
Return a reference to the draw item list.
wxString GetName() const override
std::unique_ptr< LIB_SYMBOL > Flatten() const
Return a flattened symbol inheritance to the caller.
void SetLibId(const LIB_ID &aLibId)
virtual void SetName(const wxString &aName)
bool HasLibrary(const wxString &aNickname, bool aCheckEnabled=false) const
Test for the existence of aNickname in the library table.
Instantiate the current locale within a scope in which you are expecting exceptions to be thrown.
std::shared_ptr< RC_ITEM > GetRCItem() const
enum MARKER_T GetMarkerType() const
const VECTOR2D GetSizeIU(double aIUScale) const
Gets the page size in internal units.
Base plotter engine class.
RENDER_SETTINGS * RenderSettings()
virtual void SetCurrentLineWidth(int width, void *aData=nullptr)=0
Set the line width for the next drawing.
A small class to help profiling.
void Show(std::ostream &aStream=std::cerr)
Print the elapsed time (in a suitable unit) to a stream.
void Stop()
Save the time when this function was called, and set the counter stane to stop.
static SYMBOL_LIB_TABLE * SchSymbolLibTable(PROJECT *aProject)
Accessor for project symbol library table.
static SYMBOL_LIBS * SchLibs(PROJECT *aProject)
A pure virtual class used to derive REPORTER objects from.
virtual REPORTER & ReportTail(const wxString &aText, SEVERITY aSeverity=RPT_SEVERITY_UNDEFINED)
Places the report at the end of the list, for objects that support report ordering.
Holds all the data relating to one schematic.
CONNECTION_GRAPH * ConnectionGraph() const override
SCH_SHEET_LIST BuildSheetListSortedByPageNumbers() const override
Class for a wire to bus entry.
Instances are attached to a symbol or sheet and provide a place for the symbol's value,...
Base class for any item which can be embedded within the SCHEMATIC container class,...
virtual bool IsConnectable() const
SCH_LAYER_ID GetLayer() const
Return the layer this item is on.
bool IsConnected(const VECTOR2I &aPoint) const
Test the item to see if it is connected to aPoint.
virtual std::vector< VECTOR2I > GetConnectionPoints() const
Add all the connection points for this item to aPoints.
Segment description base class to describe items which have 2 end points (track, wire,...
EDA_ANGLE Angle() const
Gets the angle between the start and end lines.
VECTOR2I GetEndPoint() const
VECTOR2I GetStartPoint() const
bool IsEndPoint(const VECTOR2I &aPoint) const
Container class that holds multiple SCH_SCREEN objects in a hierarchy.
std::vector< SCH_SHEET * > m_sheets
SCH_SCREEN * GetScreen(unsigned int aIndex) const
void UpdateSymbolLinks(REPORTER *aReporter=nullptr)
Initialize the LIB_SYMBOL reference for each SCH_SYMBOL found in the full schematic.
void DeleteMarker(SCH_MARKER *aMarker)
Delete a specific marker.
void DeleteMarkers(enum MARKER_BASE::MARKER_T aMarkerTyp, int aErrorCode, bool aIncludeExclusions=true)
Delete all markers of a particular type and error code.
void buildScreenList(SCH_SHEET *aSheet)
void FixLegacyPowerSymbolMismatches()
Fix legacy power symbols that have mismatched value text fields and invisible power pin names.
void DeleteAllMarkers(enum MARKER_BASE::MARKER_T aMarkerType, bool aIncludeExclusions)
Delete all electronic rules check markers of aMarkerType from all the screens in the list.
void PruneOrphanedSheetInstances(const wxString &aProjectName, const SCH_SHEET_LIST &aValidSheetPaths)
int ChangeSymbolLibNickname(const wxString &aFrom, const wxString &aTo)
Change all of the symbol library nicknames.
SCH_SCREENS(SCH_SHEET *aSheet)
void BuildClientSheetPathList()
built the list of sheet paths sharing a screen for each screen in use
void ClearAnnotationOfNewSheetPaths(SCH_SHEET_LIST &aInitialSheetPathList)
Clear the annotation for the symbols inside new sheetpaths when a complex hierarchy is modified and n...
void PruneOrphanedSymbolInstances(const wxString &aProjectName, const SCH_SHEET_LIST &aValidSheetPaths)
bool HasNoFullyDefinedLibIds()
Test all of the schematic symbols to see if all LIB_ID objects library nickname is not set.
SCH_SHEET * GetSheet(unsigned int aIndex) const
int ReplaceDuplicateTimeStamps()
Test all sheet and symbol objects in the schematic for duplicate time stamps and replaces them as nec...
std::vector< SCH_SCREEN * > m_screens
bool HasSchematic(const wxString &aSchematicFileName)
Check if one of the schematics in the list of screens is aSchematicFileName.
size_t GetLibNicknames(wxArrayString &aLibNicknames)
Fetch all of the symbol library nicknames into aLibNicknames.
void SetLegacySymbolInstanceData()
Update the symbol value and footprint instance data for legacy designs.
void addScreenToList(SCH_SCREEN *aScreen, SCH_SHEET *aSheet)
std::map< wxString, LIB_SYMBOL * > m_libSymbols
Library symbols required for this schematic.
SCH_PIN * GetPin(const VECTOR2I &aPosition, SCH_SYMBOL **aSymbol=nullptr, bool aEndPointOnly=false) const
Test the screen for a symbol pin item at aPosition.
void ClearDrawingState()
Clear the state flags of all the items in the screen.
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.
void Append(SCH_ITEM *aItem, bool aUpdateLibSymbol=true)
void AddLibSymbol(LIB_SYMBOL *aLibSymbol)
Add aLibSymbol to the library symbol map.
void AddBusAlias(std::shared_ptr< BUS_ALIAS > aAlias)
Add a bus alias definition (and transfers ownership of the pointer).
void FixLegacyPowerSymbolMismatches()
Fix legacy power symbols that have mismatched value text fields and invisible power pin names.
bool HasItems(KICAD_T aItemType) const
void Clear(bool aFree=true)
Delete all draw items and clears the project settings.
void PruneOrphanedSymbolInstances(const wxString &aProjectName, const SCH_SHEET_LIST &aValidSheetPaths)
Remove all invalid symbol instance data in this screen object for the project defined by aProjectName...
std::vector< SCH_SHEET_PATH > & GetClientSheetPaths()
Return the number of times this screen is used.
void UpdateSymbolLinks(REPORTER *aReporter=nullptr)
Initialize the LIB_SYMBOL reference for each SCH_SYMBOL found in this schematic from the project SYMB...
SCH_LINE * GetWire(const VECTOR2I &aPosition, int aAccuracy=0, SCH_LINE_TEST_T aSearchType=ENTIRE_LENGTH_T) 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.
void EnsureAlternateReferencesExist()
For screens shared by many sheetpaths (complex hierarchies): to be able to clear or modify any refere...
void PruneOrphanedSheetInstances(const wxString &aProjectName, const SCH_SHEET_LIST &aValidSheetPaths)
Remove all invalid sheet instance data in this screen object for the project defined by aProjectName ...
std::vector< SCH_LINE * > GetBusesAndWires(const VECTOR2I &aPosition, bool aIgnoreEndpoints=false) const
Return buses and wires passing through aPosition.
double m_LastZoomLevel
last value for the zoom level, useful in Eeschema when changing the current displayed sheet to reuse ...
bool IsExplicitJunction(const VECTOR2I &aPosition) const
Indicates that a junction dot is necessary at the given location.
EE_RTREE & Items()
Gets the full RTree, usually for iterating.
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.
void Print(const SCH_RENDER_SETTINGS *aSettings)
Print all the items in the screen to aDC.
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.
bool IsExplicitJunctionAllowed(const VECTOR2I &aPosition) const
Indicates that a juction dot may be placed at the given location.
bool IsTerminalPoint(const VECTOR2I &aPosition, int aLayer) const
Test if aPosition is a connection point on aLayer.
void UpdateLocalLibSymbolLinks()
Initialize the LIB_SYMBOL reference for each SCH_SYMBOL found in this schematic with the local projec...
void SetFileName(const wxString &aFileName)
Set the file name for this screen to aFileName.
static bool ClassOf(const EDA_ITEM *aItem)
void SetLegacySymbolInstanceData()
Update the symbol value and footprint instance data for legacy designs.
SCH_LINE * GetBus(const VECTOR2I &aPosition, int aAccuracy=0, SCH_LINE_TEST_T aSearchType=ENTIRE_LENGTH_T) const
bool Remove(SCH_ITEM *aItem, bool aUpdateLibSymbol=true)
Remove aItem from the schematic associated with this screen.
SCH_SCREEN(EDA_ITEM *aParent=nullptr)
SCHEMATIC * Schematic() const
void FixupEmbeddedData()
After loading a file from disk, the library symbols do not yet contain the full data for their embedd...
void GetHierarchicalItems(std::vector< SCH_ITEM * > *aItems) const
Add all schematic sheet and symbol objects in the screen to aItems.
bool IsExplicitJunctionNeeded(const VECTOR2I &aPosition) const
Indicates that a junction dot is necessary at the given location, and does not yet exist.
SCH_SHEET_PIN * GetSheetPin(const VECTOR2I &aPosition) const
Test the screen if aPosition is a sheet label object.
void FreeDrawList()
Free all the items from the schematic associated with the screen.
void Plot(PLOTTER *aPlotter, const SCH_PLOT_OPTS &aPlotOpts) const
Plot all the schematic objects to aPlotter.
virtual wxString GetClass() const override
Return the class name.
void Update(SCH_ITEM *aItem, bool aUpdateLibSymbol=true)
Update aItem's bounding box in the tree.
void SetConnectivityDirty()
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.
bool IsJunction(const VECTOR2I &aPosition) const
Test if a junction is required for the items at aPosition on the screen.
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,...
bool CheckIfOnDrawList(const SCH_ITEM *aItem) const
std::vector< VECTOR2I > GetConnections() const
Collect a unique list of all possible connection points in the schematic.
SPIN_STYLE GetLabelOrientationForPoint(const VECTOR2I &aPosition, SPIN_STYLE aDefaultOrientation, const SCH_SHEET_PATH *aSheet) const
void ClearAnnotation(SCH_SHEET_PATH *aSheetPath, bool aResetPrefix)
Clear the annotation for the symbols in aSheetPath on the screen.
size_t CountConnectedItems(const VECTOR2I &aPos, bool aTestJunctions) const
void MigrateSimModels()
Migrate any symbols having V6 simulation models to their V7 equivalents.
void DeleteItem(SCH_ITEM *aItem)
Removes aItem from the linked list and deletes the object.
std::set< std::shared_ptr< BUS_ALIAS >, BusAliasCmp > m_aliases
List of bus aliases stored in this screen.
size_t getLibSymbolNameMatches(const SCH_SYMBOL &aSymbol, std::vector< wxString > &aMatches)
Return a list of potential library symbol matches for aSymbol.
SCH_LABEL_BASE * GetLabel(const VECTOR2I &aPosition, int aAccuracy=0) const
Return a label item located at aPosition.
A container for handling SCH_SHEET_PATH objects in a flattened hierarchy.
std::optional< SCH_SHEET_PATH > GetSheetPathByKIIDPath(const KIID_PATH &aPath, bool aIncludeLastSheet=true) const
Finds a SCH_SHEET_PATH that matches the provided KIID_PATH.
Handle access to a stack of flattened SCH_SHEET objects by way of a path for creating a flattened sch...
Define a sheet pin (label) used in sheets to create hierarchical schematics.
SCH_SHEET * GetParent() const
Get the parent sheet object of this sheet pin.
Sheet symbol placed in a schematic, and is the entry point for a sub schematic.
void RemoveInstance(const KIID_PATH &aInstancePath)
SCH_SHEET_PIN * GetPin(const VECTOR2I &aPosition)
Return the sheet pin item found at aPosition in the sheet.
void RemovePin(const SCH_SHEET_PIN *aSheetPin)
Remove aSheetPin from the sheet.
SCH_SCREEN * GetScreen() const
const std::vector< SCH_SHEET_INSTANCE > & GetInstances() const
void SetLibId(const LIB_ID &aName)
SCH_ITEM * GetDrawItem(const VECTOR2I &aPosition, KICAD_T aType=TYPE_NOT_INIT)
Return the symbol library item at aPosition that is part of this symbol.
const std::vector< SCH_SYMBOL_INSTANCE > & GetInstances() const
void RemoveInstance(const SCH_SHEET_PATH &aInstancePath)
void SetValueFieldText(const wxString &aValue)
wxString GetSchSymbolLibraryName() const
bool AddSheetPathReferenceEntryIfMissing(const KIID_PATH &aSheetPath)
Add an instance to the alternate references list (m_instanceReferences), if this entry does not alrea...
void ClearAnnotation(const SCH_SHEET_PATH *aSheetPath, bool aResetPrefix)
Clear exiting symbol annotation.
std::vector< SCH_PIN * > GetPins(const SCH_SHEET_PATH *aSheet=nullptr) const
Retrieve a list of the SCH_PINs for the given sheet path.
std::vector< SCH_PIN * > GetAllLibPins() const
void AddHierarchicalReference(const KIID_PATH &aPath, const wxString &aRef, int aUnit)
Add a full hierarchical reference to this symbol.
const LIB_ID & GetLibId() const override
void SetSchSymbolLibraryName(const wxString &aName)
The name of the symbol in the schematic library symbol list.
std::vector< SCH_PIN * > GetLibPins() const
Populate a vector with all the pins from the library object that match the current unit and bodyStyle...
int GetOrientation() const
Get the display symbol orientation.
std::unique_ptr< LIB_SYMBOL > & GetLibSymbolRef()
void SetLibSymbol(LIB_SYMBOL *aLibSymbol)
Set this schematic symbol library symbol reference to aLibSymbol.
VECTOR2I GetPinPhysicalPosition(const SCH_PIN *Pin) const
A collection of SYMBOL_LIB objects.
LIB_SYMBOL * LoadSymbol(const wxString &aNickname, const wxString &aName)
Load a LIB_SYMBOL having aName from the library given by aNickname.
Object used to load, save, search, and otherwise manipulate symbol library files.
LIB_SYMBOL * FindSymbol(const wxString &aName) const
Find LIB_SYMBOL by aName.
An 8 bit string that is assuredly encoded in UTF8, and supplies special conversion support to and fro...
#define STRUCT_DELETED
flag indication structures to be erased
#define IS_MOVING
Item being moved.
static const wxChar DanglingProfileMask[]
Flag to enable connectivity profiling.
const wxChar *const traceSchSheetPaths
Flag to enable debug output of schematic symbol sheet path manipulation code.
POINT_INFO AnalyzePoint(const EE_RTREE &aItem, const VECTOR2I &aPosition, bool aBreakCrossings)
Check a tree of items for a confluence at a given point and work out what kind of junction it is,...
static const wxChar DanglingProfileMask[]
SYMBOL_ORIENTATION_T
enum used in RotationMiroir()
@ SYM_ROTATE_COUNTERCLOCKWISE
wxString UnescapeString(const wxString &aSource)
The EE_TYPE struct provides a type-specific auto-range iterator to the RTree.
std::vector< char > decompressedData
std::string compressedEncodedData
A selection of information about a point in the schematic that might be eligible for turning into a j...
A simple container for sheet instance information.
A simple container for schematic symbol instance information.
Definition for symbol library class.
@ VALUE_FIELD
Field Value of part, i.e. "3.3K".
@ REFERENCE_FIELD
Field Reference of part, i.e. "IC21".
wxLogTrace helper definitions.
bool IsPointOnSegment(const VECTOR2I &aSegStart, const VECTOR2I &aSegEnd, const VECTOR2I &aTestPoint)
Test if aTestPoint is on line defined by aSegStart and aSegEnd.
KICAD_T
The set of class identification values stored in EDA_ITEM::m_structType.
VECTOR2< int32_t > VECTOR2I