KiCad PCB EDA Suite
Loading...
Searching...
No Matches
sch_tool_utils.h
Go to the documentation of this file.
1/*
2 * This program source code file is part of KiCad, a free EDA CAD application.
3 *
4 * Copyright The KiCad Developers, see AUTHORS.txt for contributors.
5 *
6 * This program is free software; you can redistribute it and/or
7 * modify it under the terms of the GNU General Public License
8 * as published by the Free Software Foundation; either version 2
9 * of the License, or (at your option) any later version.
10 *
11 * This program is distributed in the hope that it will be useful,
12 * but WITHOUT ANY WARRANTY; without even the implied warranty of
13 * MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the
14 * GNU General Public License for more details.
15 *
16 * You should have received a copy of the GNU General Public License
17 * along with this program. If not, see <https://www.gnu.org/licenses/>.
18 */
19
20#pragma once
21
22#include <optional>
23#include <set>
24
25#include <sch_item.h>
26#include <tool/selection.h>
27
28class SCHEMATIC;
29class SCH_REFERENCE;
31class SCH_SCREEN;
32class SCH_SYMBOL;
33class SCH_PIN;
34class SCHEMATIC;
35class LIB_ID;
36
37wxString GetSchItemAsText( const SCH_ITEM& aItem );
38
39wxString GetSelectedItemsAsText( const SELECTION& aSel );
40
44std::set<int> GetUnplacedUnitsForSymbol( const SCH_SYMBOL& aSym );
45
61bool IsUnannotatedUnitOccupied( const SCH_REFERENCE_LIST& aRefs, const wxString& aRef,
62 const LIB_ID& aLibId, int aUnit );
63
69std::optional<SCH_REFERENCE> FindSymbolByRefAndUnit( const SCHEMATIC& aSheet, const wxString& aRef,
70 int aUnit );
71
80std::vector<SCH_SYMBOL*> GetSameSymbolMultiUnitSelection( const SELECTION& aSel );
81
90bool SwapPinGeometry( SCH_PIN* aFirst, SCH_PIN* aSecond );
91
101bool SymbolHasSheetInstances( const SCH_SYMBOL& aSymbol, const wxString& aCurrentProject,
102 std::set<wxString>* aSheetPaths = nullptr, std::set<wxString>* aProjectNames = nullptr );
103
112std::set<wxString> GetSheetNamesFromPaths( const std::set<wxString>& aSheetPaths, const SCHEMATIC& aSchematic );
113
118wxString UniqueSheetName( SCH_SCREEN* aScreen, const wxString& aBaseName );
119
124wxString UniqueGroupName( SCH_SCREEN* aScreen, const wxString& aBaseName );
A logical library item identifier and consists of various portions much like a URI.
Definition lib_id.h:45
Holds all the data relating to one schematic.
Definition schematic.h:90
Base class for any item which can be embedded within the SCHEMATIC container class,...
Definition sch_item.h:162
Container to create a flattened list of symbols because in a complex hierarchy, a symbol can be used ...
A helper to define a symbol's reference designator in a schematic.
Schematic symbol object.
Definition sch_symbol.h:69
wxString UniqueGroupName(SCH_SCREEN *aScreen, const wxString &aBaseName)
Return aBaseName, or aBaseName + smallest free integer if a group with that name already exists on aS...
std::optional< SCH_REFERENCE > FindSymbolByRefAndUnit(const SCHEMATIC &aSheet, const wxString &aRef, int aUnit)
Find a symbol by reference and unit.
bool IsUnannotatedUnitOccupied(const SCH_REFERENCE_LIST &aRefs, const wxString &aRef, const LIB_ID &aLibId, int aUnit)
Decide whether aUnit of an unannotated multi-unit symbol is already placed.
std::set< wxString > GetSheetNamesFromPaths(const std::set< wxString > &aSheetPaths, const SCHEMATIC &aSchematic)
Get human-readable sheet names from a set of sheet paths, e.g.
bool SwapPinGeometry(SCH_PIN *aFirst, SCH_PIN *aSecond)
Swap the positions/lengths/etc.
std::set< int > GetUnplacedUnitsForSymbol(const SCH_SYMBOL &aSym)
Get a list of unplaced (i.e.
bool SymbolHasSheetInstances(const SCH_SYMBOL &aSymbol, const wxString &aCurrentProject, std::set< wxString > *aSheetPaths=nullptr, std::set< wxString > *aProjectNames=nullptr)
Returns true when the given symbol has instances, e.g.
wxString GetSelectedItemsAsText(const SELECTION &aSel)
std::vector< SCH_SYMBOL * > GetSameSymbolMultiUnitSelection(const SELECTION &aSel)
Validates and gathers a selection containing multiple symbol units that all belong to the same refere...
wxString UniqueSheetName(SCH_SCREEN *aScreen, const wxString &aBaseName)
Return aBaseName, or aBaseName + smallest free integer if a sheet with that name already exists on aS...
wxString GetSchItemAsText(const SCH_ITEM &aItem)