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_SYMBOL;
32class SCH_PIN;
33class SCHEMATIC;
34class LIB_ID;
35
36wxString GetSchItemAsText( const SCH_ITEM& aItem );
37
38wxString GetSelectedItemsAsText( const SELECTION& aSel );
39
43std::set<int> GetUnplacedUnitsForSymbol( const SCH_SYMBOL& aSym );
44
60bool IsUnannotatedUnitOccupied( const SCH_REFERENCE_LIST& aRefs, const wxString& aRef,
61 const LIB_ID& aLibId, int aUnit );
62
68std::optional<SCH_REFERENCE> FindSymbolByRefAndUnit( const SCHEMATIC& aSheet, const wxString& aRef,
69 int aUnit );
70
79std::vector<SCH_SYMBOL*> GetSameSymbolMultiUnitSelection( const SELECTION& aSel );
80
89bool SwapPinGeometry( SCH_PIN* aFirst, SCH_PIN* aSecond );
90
100bool SymbolHasSheetInstances( const SCH_SYMBOL& aSymbol, const wxString& aCurrentProject,
101 std::set<wxString>* aSheetPaths = nullptr, std::set<wxString>* aProjectNames = nullptr );
102
111std::set<wxString> GetSheetNamesFromPaths( const std::set<wxString>& aSheetPaths, const SCHEMATIC& aSchematic );
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
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 GetSchItemAsText(const SCH_ITEM &aItem)