2011-10-15 13:25:57 +00:00
|
|
|
/*
|
|
|
|
* This program source code file is part of KiCad, a free EDA CAD application.
|
|
|
|
*
|
2017-07-26 10:03:24 +00:00
|
|
|
* Copyright (C) 2017 Jean-Pierre Charras, jp.charras at wanadoo.fr
|
2017-10-06 18:07:43 +00:00
|
|
|
* Copyright (C) 2011 Wayne Stambaugh <stambaughw@gmail.com>
|
2020-02-20 22:52:01 +00:00
|
|
|
* Copyright (C) 1992-2020 KiCad Developers, see AUTHORS.txt for contributors.
|
2011-10-15 13:25:57 +00:00
|
|
|
*
|
|
|
|
* This program is free software; you can redistribute it and/or
|
|
|
|
* modify it under the terms of the GNU General Public License
|
|
|
|
* as published by the Free Software Foundation; either version 2
|
|
|
|
* of the License, or (at your option) any later version.
|
|
|
|
*
|
|
|
|
* This program is distributed in the hope that it will be useful,
|
|
|
|
* but WITHOUT ANY WARRANTY; without even the implied warranty of
|
|
|
|
* MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the
|
|
|
|
* GNU General Public License for more details.
|
|
|
|
*
|
|
|
|
* You should have received a copy of the GNU General Public License
|
|
|
|
* along with this program; if not, you may find one here:
|
|
|
|
* http://www.gnu.org/licenses/old-licenses/gpl-2.0.html
|
|
|
|
* or you may search the http://www.gnu.org website for the version 2 license,
|
|
|
|
* or you may write to the Free Software Foundation, Inc.,
|
|
|
|
* 51 Franklin Street, Fifth Floor, Boston, MA 02110-1301, USA
|
|
|
|
*/
|
|
|
|
|
2011-09-30 18:15:37 +00:00
|
|
|
/**
|
|
|
|
* @file sch_sheet_path.h
|
|
|
|
* @brief Definition of the SCH_SHEET_PATH and SCH_SHEET_LIST classes for Eeschema.
|
|
|
|
*/
|
2009-01-04 18:52:57 +00:00
|
|
|
|
|
|
|
#ifndef CLASS_DRAWSHEET_PATH_H
|
|
|
|
#define CLASS_DRAWSHEET_PATH_H
|
|
|
|
|
2020-10-14 01:06:53 +00:00
|
|
|
#include <eda_item.h>
|
2020-04-24 13:36:10 +00:00
|
|
|
#include <erc_item.h>
|
2009-01-04 18:52:57 +00:00
|
|
|
|
2016-05-28 16:46:29 +00:00
|
|
|
#include <map>
|
|
|
|
|
2011-12-01 16:49:28 +00:00
|
|
|
|
2020-04-26 20:53:29 +00:00
|
|
|
/**
|
|
|
|
* A simple container for schematic symbol instance infromation.
|
|
|
|
*/
|
2020-11-15 17:03:27 +00:00
|
|
|
struct SYMBOL_INSTANCE_REFERENCE
|
2020-04-26 20:53:29 +00:00
|
|
|
{
|
|
|
|
KIID_PATH m_Path;
|
2020-08-29 13:41:47 +00:00
|
|
|
|
|
|
|
// Things that can be annotated:
|
2020-04-26 20:53:29 +00:00
|
|
|
wxString m_Reference;
|
|
|
|
int m_Unit;
|
2020-08-29 13:41:47 +00:00
|
|
|
|
|
|
|
// Things that can be back-annotated:
|
|
|
|
wxString m_Value;
|
|
|
|
wxString m_Footprint;
|
2020-04-26 20:53:29 +00:00
|
|
|
};
|
|
|
|
|
|
|
|
|
2020-10-18 20:30:37 +00:00
|
|
|
/**
|
|
|
|
* A simple container for sheet instance infromation.
|
|
|
|
*/
|
|
|
|
struct SCH_SHEET_INSTANCE
|
|
|
|
{
|
|
|
|
KIID_PATH m_Path;
|
|
|
|
|
|
|
|
wxString m_PageNumber;
|
|
|
|
};
|
|
|
|
|
|
|
|
|
|
|
|
/**
|
|
|
|
* Complex hierarchies
|
|
|
|
*
|
2020-11-15 17:03:27 +00:00
|
|
|
* A hierarchical schematic uses sheets (hierarchical sheets) included in a given sheet.
|
|
|
|
* Each sheet corresponds to a schematic drawing handled by a SCH_SCREEN structure. A
|
|
|
|
* SCH_SCREEN structure contains drawings, and have a filename to write it's data. Also a
|
|
|
|
* SCH_SCREEN displays a sheet number and the name of the sheet.
|
2009-11-03 13:26:31 +00:00
|
|
|
*
|
2020-11-15 17:03:27 +00:00
|
|
|
* In simple (and flat) hierarchies a sheet is linked to a SCH_SCREEN, and a SCH_SCREEN is
|
|
|
|
* used by the single hierarchical sheet.
|
2009-01-06 20:09:32 +00:00
|
|
|
*
|
2020-11-15 17:03:27 +00:00
|
|
|
* In complex hierarchies the same SCH_SCREEN (and its data) is shared by more than one sheet.
|
|
|
|
* Therefore subsheets (like subsheets in a SCH_SCREEN shared by many sheets) can also be
|
|
|
|
* shared. So the same SCH_SCREEN must handle different symbol references and unit selections
|
|
|
|
* depending on which sheet is currently selected, and how a given subsheet is selected. Two
|
|
|
|
* sheets share the same SCH_SCREEN (the same drawings) if they have the same filename.
|
2009-01-06 20:09:32 +00:00
|
|
|
*
|
2020-11-15 17:03:27 +00:00
|
|
|
* In KiCad each symbol and sheet receives (when created) a uuid. So each sheet has 2 id: its
|
|
|
|
* uuid (which cannot change) and its name (that can be edited and therefore is not reliable
|
|
|
|
* for strong identification).
|
|
|
|
* A given sheet in a hierarchy is fully labeled by its path (or sheet path) that is the list
|
|
|
|
* of uuids found to access it through the hierarchy. The root sheet is /. All other sheets
|
|
|
|
* have a path like /1234ABCD or /4567FEDC/AA2233DD/. This path can be displayed as human
|
|
|
|
* readable sheet name like: / or /sheet1/include_sheet/ or /sheet2/include_sheet/
|
2009-01-06 20:09:32 +00:00
|
|
|
*
|
|
|
|
* So to know for a given SCH_SCREEN (a given schematic drawings) we must:
|
2009-11-03 13:26:31 +00:00
|
|
|
* 1) Handle all references possibilities.
|
|
|
|
* 2) When acceded by a given selected sheet, display (update) the
|
|
|
|
* corresponding references and sheet path
|
2009-01-06 20:09:32 +00:00
|
|
|
*
|
2020-11-15 17:03:27 +00:00
|
|
|
* The class SCH_SHEET_PATH handles paths used to access a sheet. The class SCH_SHEET_LIST
|
|
|
|
* allows one to handle the full (or partial) list of sheets and their paths in a complex
|
|
|
|
* hierarchy. The class EDA_ScreenList allows one to handle the list of SCH_SCREEN. It is
|
|
|
|
* useful to clear or save data, but is not suitable to handle the full complex hierarchy
|
|
|
|
* possibilities (usable in flat and simple hierarchies).
|
2009-01-06 20:09:32 +00:00
|
|
|
*/
|
|
|
|
|
|
|
|
|
2010-11-10 15:30:12 +00:00
|
|
|
class wxFindReplaceData;
|
2019-03-11 21:32:05 +00:00
|
|
|
class SCH_SHEET;
|
2010-11-10 15:30:12 +00:00
|
|
|
class SCH_SCREEN;
|
2016-02-15 20:14:48 +00:00
|
|
|
class SCH_MARKER;
|
2010-11-10 15:30:12 +00:00
|
|
|
class SCH_ITEM;
|
2016-02-15 20:16:54 +00:00
|
|
|
class SCH_REFERENCE_LIST;
|
2017-10-06 18:07:43 +00:00
|
|
|
|
2010-03-16 18:22:59 +00:00
|
|
|
|
2016-02-15 20:16:54 +00:00
|
|
|
/**
|
2020-10-18 20:30:37 +00:00
|
|
|
* Container to map reference designators for multi-unit parts.
|
2016-02-15 20:16:54 +00:00
|
|
|
*/
|
|
|
|
typedef std::map<wxString, SCH_REFERENCE_LIST> SCH_MULTI_UNIT_REFERENCE_MAP;
|
|
|
|
|
2010-07-30 21:41:55 +00:00
|
|
|
/**
|
2020-10-18 20:30:37 +00:00
|
|
|
* Handle access to a stack of flattened #SCH_SHEET objects by way of a path for
|
2016-02-27 19:35:45 +00:00
|
|
|
* creating a flattened schematic hierarchy.
|
|
|
|
*
|
2010-07-30 21:41:55 +00:00
|
|
|
* <p>
|
2016-02-27 19:35:45 +00:00
|
|
|
* 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.
|
2011-03-29 19:33:07 +00:00
|
|
|
* </p>
|
2009-01-07 17:33:18 +00:00
|
|
|
*/
|
2019-04-09 03:27:04 +00:00
|
|
|
class SCH_SHEET_PATH
|
2009-01-04 18:52:57 +00:00
|
|
|
{
|
2019-04-09 03:27:04 +00:00
|
|
|
protected:
|
|
|
|
std::vector< SCH_SHEET* > m_sheets;
|
|
|
|
|
|
|
|
size_t m_current_hash;
|
|
|
|
|
2020-10-26 17:01:20 +00:00
|
|
|
int m_virtualPageNumber; /// Page numbers are maintained by the sheet load order.
|
2009-01-04 18:52:57 +00:00
|
|
|
|
2020-02-29 04:03:04 +00:00
|
|
|
std::map<std::pair<wxString, wxString>, bool> m_recursion_test_cache;
|
|
|
|
|
2011-01-23 21:22:42 +00:00
|
|
|
public:
|
2010-03-16 18:22:59 +00:00
|
|
|
SCH_SHEET_PATH();
|
|
|
|
|
2020-07-08 21:42:05 +00:00
|
|
|
SCH_SHEET_PATH( const SCH_SHEET_PATH& aOther );
|
|
|
|
|
|
|
|
SCH_SHEET_PATH& operator=( const SCH_SHEET_PATH& aOther );
|
|
|
|
|
2019-04-09 03:27:04 +00:00
|
|
|
/// Forwarded method from std::vector
|
|
|
|
SCH_SHEET* at( size_t aIndex ) const { return m_sheets.at( aIndex ); }
|
|
|
|
|
|
|
|
/// Forwarded method from std::vector
|
|
|
|
void clear()
|
|
|
|
{
|
|
|
|
m_sheets.clear();
|
|
|
|
Rehash();
|
|
|
|
}
|
|
|
|
|
|
|
|
/// Forwarded method from std::vector
|
|
|
|
bool empty() const { return m_sheets.empty(); }
|
|
|
|
|
|
|
|
/// Forwarded method from std::vector
|
|
|
|
void pop_back()
|
|
|
|
{
|
|
|
|
m_sheets.pop_back();
|
|
|
|
Rehash();
|
|
|
|
}
|
|
|
|
|
|
|
|
/// Forwarded method from std::vector
|
|
|
|
void push_back( SCH_SHEET* aSheet )
|
|
|
|
{
|
|
|
|
m_sheets.push_back( aSheet );
|
|
|
|
Rehash();
|
|
|
|
}
|
|
|
|
|
|
|
|
/// Forwarded method from std::vector
|
|
|
|
size_t size() const { return m_sheets.size(); }
|
|
|
|
|
|
|
|
void Rehash();
|
|
|
|
|
|
|
|
size_t GetCurrentHash() const { return m_current_hash; }
|
|
|
|
|
2020-10-26 17:01:20 +00:00
|
|
|
/**
|
|
|
|
* Set the sheet instance virtual page number.
|
|
|
|
*
|
|
|
|
* Virtual page numbers are incremental integers set automatically when the sheet path
|
|
|
|
* hierarchy is created (@see #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.
|
|
|
|
*/
|
|
|
|
void SetVirtualPageNumber( int aPageNumber ) { m_virtualPageNumber = aPageNumber; }
|
|
|
|
|
|
|
|
int GetVirtualPageNumber() const { return m_virtualPageNumber; }
|
|
|
|
|
|
|
|
/**
|
|
|
|
* Set the sheet instance user definable page number.
|
|
|
|
*
|
|
|
|
* @note User definable page numbers can be any string devoid of white space characters.
|
|
|
|
*/
|
2020-10-18 20:30:37 +00:00
|
|
|
void SetPageNumber( const wxString& aPageNumber );
|
2009-01-07 20:09:03 +00:00
|
|
|
|
2020-10-18 20:30:37 +00:00
|
|
|
wxString GetPageNumber() const;
|
2011-01-23 21:22:42 +00:00
|
|
|
|
2016-03-06 21:22:01 +00:00
|
|
|
const SCH_SHEET* GetSheet( unsigned aIndex ) const
|
2015-06-07 20:31:55 +00:00
|
|
|
{
|
2016-03-06 21:22:01 +00:00
|
|
|
SCH_SHEET* retv = NULL;
|
|
|
|
|
2016-02-27 19:35:45 +00:00
|
|
|
if( aIndex < size() )
|
2016-03-06 21:22:01 +00:00
|
|
|
retv = at( aIndex );
|
|
|
|
|
2020-12-20 18:59:07 +00:00
|
|
|
return retv;
|
2016-03-06 21:22:01 +00:00
|
|
|
}
|
2015-06-07 20:31:55 +00:00
|
|
|
|
2010-11-12 15:17:10 +00:00
|
|
|
/**
|
2011-01-23 21:22:42 +00:00
|
|
|
* Compare if this is the same sheet path as aSheetPathToTest
|
2020-10-18 20:30:37 +00:00
|
|
|
*
|
2011-01-23 21:22:42 +00:00
|
|
|
* @param aSheetPathToTest = sheet path to compare
|
2015-12-14 21:20:54 +00:00
|
|
|
* @return 1 if this sheet path has more sheets than aSheetPathToTest,
|
|
|
|
* -1 if this sheet path has fewer sheets than aSheetPathToTest,
|
2015-08-31 11:13:26 +00:00
|
|
|
* or 0 if same
|
2009-01-06 20:09:32 +00:00
|
|
|
*/
|
2011-03-28 18:23:01 +00:00
|
|
|
int Cmp( const SCH_SHEET_PATH& aSheetPathToTest ) const;
|
2009-01-07 17:33:18 +00:00
|
|
|
|
2010-11-12 15:17:10 +00:00
|
|
|
/**
|
2020-10-18 20:30:37 +00:00
|
|
|
* 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.
|
2009-01-07 17:33:18 +00:00
|
|
|
*/
|
2014-04-30 19:16:22 +00:00
|
|
|
SCH_SHEET* Last() const;
|
2009-01-07 17:33:18 +00:00
|
|
|
|
2010-11-12 15:17:10 +00:00
|
|
|
/**
|
2020-10-18 20:30:37 +00:00
|
|
|
* @return the #SCH_SCREEN relative to the last sheet in list.
|
2009-01-07 17:33:18 +00:00
|
|
|
*/
|
2019-06-25 23:39:58 +00:00
|
|
|
SCH_SCREEN* LastScreen();
|
2009-01-07 17:33:18 +00:00
|
|
|
|
2009-01-06 20:09:32 +00:00
|
|
|
|
2019-06-25 23:39:58 +00:00
|
|
|
///> @copydoc SCH_SHEET_PATH::LastScreen()
|
|
|
|
SCH_SCREEN* LastScreen() const;
|
2010-03-16 18:22:59 +00:00
|
|
|
|
2010-11-12 15:17:10 +00:00
|
|
|
/**
|
2020-10-18 20:30:37 +00:00
|
|
|
* 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.
|
2009-01-04 18:52:57 +00:00
|
|
|
*/
|
2020-02-22 21:39:59 +00:00
|
|
|
wxString PathAsString() const;
|
|
|
|
|
|
|
|
/**
|
2020-10-18 20:30:37 +00:00
|
|
|
* Get the sheet path as an #KIID_PATH.
|
|
|
|
*
|
|
|
|
* @note This #KIID_PATH includes the root sheet UUID prefixed to the path.
|
2020-02-22 21:39:59 +00:00
|
|
|
* @return
|
|
|
|
*/
|
|
|
|
KIID_PATH Path() const;
|
2009-01-04 18:52:57 +00:00
|
|
|
|
2010-07-31 23:57:36 +00:00
|
|
|
/**
|
2020-10-18 20:30:37 +00:00
|
|
|
* Get the sheet path as an #KIID_PATH without the root sheet UUID prefix.
|
|
|
|
*
|
|
|
|
* @note This #KIID_PATH does not include the root sheet UUID prefixed to the path.
|
|
|
|
* @return
|
|
|
|
*/
|
|
|
|
KIID_PATH PathWithoutRootUuid() const;
|
|
|
|
|
|
|
|
/**
|
|
|
|
* Return the sheet path in a human readable form made from thesheet names.
|
|
|
|
*
|
|
|
|
* The the "normal" path instead uses the #KIID objects in the path that do not change
|
|
|
|
* even when editing sheet parameters.
|
2009-01-04 18:52:57 +00:00
|
|
|
*/
|
2020-10-27 19:57:56 +00:00
|
|
|
wxString PathHumanReadable( bool aUseShortRootName = true ) const;
|
2019-06-23 17:37:21 +00:00
|
|
|
|
2016-02-15 20:17:51 +00:00
|
|
|
/**
|
2020-10-18 20:30:37 +00:00
|
|
|
* 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.
|
2016-02-15 20:17:51 +00:00
|
|
|
*/
|
|
|
|
void UpdateAllScreenReferences();
|
|
|
|
|
2016-02-15 20:16:54 +00:00
|
|
|
/**
|
2020-10-18 20:30:37 +00:00
|
|
|
* Adds #SCH_REFERENCE object to \a aReferences for each component in the sheet.
|
2017-10-06 18:07:43 +00:00
|
|
|
*
|
2016-02-15 20:16:54 +00:00
|
|
|
* @param aReferences List of references to populate.
|
|
|
|
* @param aIncludePowerSymbols : false to only get normal components.
|
2020-10-18 20:30:37 +00:00
|
|
|
* @param aForceIncludeOrphanComponents : true to include components having no symbol found
|
|
|
|
* in lib.
|
2017-11-21 17:06:37 +00:00
|
|
|
* ( orphan components)
|
|
|
|
* The normal option is false, and set to true only to build the full list of components.
|
2016-02-15 20:16:54 +00:00
|
|
|
*/
|
2020-11-15 16:08:31 +00:00
|
|
|
void GetSymbols( SCH_REFERENCE_LIST& aReferences, bool aIncludePowerSymbols = true,
|
|
|
|
bool aForceIncludeOrphanComponents = false ) const;
|
2016-02-15 20:16:54 +00:00
|
|
|
|
2016-02-15 20:14:48 +00:00
|
|
|
/**
|
2020-10-18 20:30:37 +00:00
|
|
|
* Add a #SCH_REFERENCE_LIST object to \a aRefList for each same-reference set of
|
|
|
|
* multi-unit parts in the sheet.
|
|
|
|
*
|
|
|
|
* The map key for each element will be the reference designator.
|
2017-10-06 18:07:43 +00:00
|
|
|
*
|
2016-02-15 20:14:48 +00:00
|
|
|
* @param aRefList Map of reference designators to reference lists
|
|
|
|
* @param aIncludePowerSymbols : false to only get normal components.
|
|
|
|
*/
|
2017-10-06 18:07:43 +00:00
|
|
|
void GetMultiUnitComponents( SCH_MULTI_UNIT_REFERENCE_MAP &aRefList,
|
2020-05-13 02:00:37 +00:00
|
|
|
bool aIncludePowerSymbols = true ) const;
|
2016-02-15 20:14:48 +00:00
|
|
|
|
2016-02-15 20:12:42 +00:00
|
|
|
/**
|
2020-10-18 20:30:37 +00:00
|
|
|
* Test the SCH_SHEET_PATH file names to check adding the sheet stored in the file
|
2016-02-15 20:12:42 +00:00
|
|
|
* \a aSrcFileName to the sheet stored in file \a aDestFileName will cause a sheet
|
|
|
|
* path recursion.
|
|
|
|
*
|
|
|
|
* @param aSrcFileName is the source file name of the sheet add to \a aDestFileName.
|
|
|
|
* @param aDestFileName is the file name of the destination sheet for \a aSrcFileName.
|
|
|
|
* @return true if \a aFileName will cause recursion in the sheet path. Otherwise false.
|
|
|
|
*/
|
2020-02-29 04:03:04 +00:00
|
|
|
bool TestForRecursion( const wxString& aSrcFileName, const wxString& aDestFileName );
|
2016-02-15 20:12:42 +00:00
|
|
|
|
2010-08-03 02:13:33 +00:00
|
|
|
bool operator==( const SCH_SHEET_PATH& d1 ) const;
|
2009-01-04 18:52:57 +00:00
|
|
|
|
2011-01-30 22:22:38 +00:00
|
|
|
bool operator!=( const SCH_SHEET_PATH& d1 ) const { return !( *this == d1 ) ; }
|
2019-04-09 03:27:04 +00:00
|
|
|
|
|
|
|
bool operator<( const SCH_SHEET_PATH& d1 ) const { return m_sheets < d1.m_sheets; }
|
|
|
|
|
2020-07-08 21:42:05 +00:00
|
|
|
private:
|
|
|
|
|
|
|
|
void initFromOther( const SCH_SHEET_PATH& aOther );
|
2009-01-04 18:52:57 +00:00
|
|
|
};
|
|
|
|
|
|
|
|
|
2019-03-11 21:32:05 +00:00
|
|
|
namespace std
|
|
|
|
{
|
|
|
|
template<> struct hash<SCH_SHEET_PATH>
|
|
|
|
{
|
|
|
|
size_t operator()( const SCH_SHEET_PATH& path ) const;
|
|
|
|
};
|
|
|
|
}
|
|
|
|
|
|
|
|
|
2016-03-06 21:22:01 +00:00
|
|
|
typedef std::vector< SCH_SHEET_PATH > SCH_SHEET_PATHS;
|
|
|
|
typedef SCH_SHEET_PATHS::iterator SCH_SHEET_PATHS_ITER;
|
|
|
|
|
|
|
|
|
2010-07-30 21:41:55 +00:00
|
|
|
/**
|
2020-10-18 20:30:37 +00:00
|
|
|
* A container for handling #SCH_SHEET_PATH objects in a flattened hierarchy.
|
2016-03-06 21:22:01 +00:00
|
|
|
*
|
|
|
|
* #SCH_SHEET objects are not unique, there can be many sheets with the same filename and
|
|
|
|
* that share the same #SCH_SCREEN reference. Each The schematic file (#SCH_SCREEN) may
|
|
|
|
* be shared between these sheets and component references are specific to a sheet path.
|
|
|
|
* When a sheet is entered, component references and sheet page number are updated.
|
2009-01-06 20:09:32 +00:00
|
|
|
*/
|
2016-03-06 21:22:01 +00:00
|
|
|
class SCH_SHEET_LIST : public SCH_SHEET_PATHS
|
2009-01-04 18:52:57 +00:00
|
|
|
{
|
|
|
|
private:
|
2016-03-06 21:22:01 +00:00
|
|
|
SCH_SHEET_PATH m_currentSheetPath;
|
2009-01-04 18:52:57 +00:00
|
|
|
|
|
|
|
public:
|
2010-07-30 21:41:55 +00:00
|
|
|
|
|
|
|
/**
|
2020-10-18 20:30:37 +00:00
|
|
|
* Construct a flattened list of SCH_SHEET_PATH objects from \a aSheet.
|
2010-03-16 18:22:59 +00:00
|
|
|
*
|
2016-03-06 21:22:01 +00:00
|
|
|
* If aSheet == NULL, then this is an empty hierarchy which the user can populate.
|
2010-03-16 18:22:59 +00:00
|
|
|
*/
|
2020-10-05 12:24:21 +00:00
|
|
|
SCH_SHEET_LIST( SCH_SHEET* aSheet = nullptr, bool aCheckIntegrity = false );
|
2010-03-16 18:22:59 +00:00
|
|
|
|
2016-03-06 21:22:01 +00:00
|
|
|
~SCH_SHEET_LIST() {}
|
2009-01-04 18:52:57 +00:00
|
|
|
|
2016-02-15 20:21:18 +00:00
|
|
|
/**
|
2020-10-18 20:30:37 +00:00
|
|
|
* Check the entire hierarchy for any modifications.
|
|
|
|
*
|
2017-07-20 18:23:21 +00:00
|
|
|
* @return True if the hierarchy is modified otherwise false.
|
2016-02-15 20:21:18 +00:00
|
|
|
*/
|
|
|
|
bool IsModified();
|
|
|
|
|
|
|
|
void ClearModifyStatus();
|
|
|
|
|
2020-03-16 11:05:01 +00:00
|
|
|
/**
|
|
|
|
* Fetch a SCH_ITEM by ID. Also returns the sheet the item was found on in \a aPathOut.
|
|
|
|
*/
|
2020-05-13 02:00:37 +00:00
|
|
|
SCH_ITEM* GetItem( const KIID& aID, SCH_SHEET_PATH* aPathOut = nullptr );
|
2020-03-16 11:05:01 +00:00
|
|
|
|
2020-04-24 13:36:10 +00:00
|
|
|
/**
|
|
|
|
* Fill an item cache for temporary use when many items need to be fetched.
|
|
|
|
*/
|
2020-04-24 22:22:11 +00:00
|
|
|
void FillItemMap( std::map<KIID, EDA_ITEM*>& aMap );
|
2020-04-24 13:36:10 +00:00
|
|
|
|
2016-02-15 20:18:32 +00:00
|
|
|
/**
|
2020-10-18 20:30:37 +00:00
|
|
|
* Silently annotate the not yet annotated power symbols of the entire hierarchy of the
|
|
|
|
* sheet path list.
|
|
|
|
*
|
2017-07-20 18:23:21 +00:00
|
|
|
* It is called before creating a netlist, to annotate power symbols, without prompting
|
|
|
|
* the user about not annotated or duplicate for these symbols, if only these symbols
|
|
|
|
* need annotation ( a very frequent case ).
|
2016-02-15 20:18:32 +00:00
|
|
|
*/
|
2017-10-06 18:07:43 +00:00
|
|
|
void AnnotatePowerSymbols();
|
2016-02-15 20:18:32 +00:00
|
|
|
|
2016-02-15 20:16:54 +00:00
|
|
|
/**
|
2020-10-18 20:30:37 +00:00
|
|
|
* Add a #SCH_REFERENCE object to \a aReferences for each component in the list
|
2016-02-15 20:16:54 +00:00
|
|
|
* of sheets.
|
2017-10-06 18:07:43 +00:00
|
|
|
*
|
2016-02-15 20:16:54 +00:00
|
|
|
* @param aReferences List of references to populate.
|
|
|
|
* @param aIncludePowerSymbols Set to false to only get normal components.
|
2020-10-18 20:30:37 +00:00
|
|
|
* @param aForceIncludeOrphanComponents : true to include components having no symbol found
|
|
|
|
* in lib.
|
2017-11-21 17:06:37 +00:00
|
|
|
* ( orphan components)
|
|
|
|
* The normal option is false, and set to true only to build the full list of components.
|
2016-02-15 20:16:54 +00:00
|
|
|
*/
|
2020-11-15 16:08:31 +00:00
|
|
|
void GetSymbols( SCH_REFERENCE_LIST& aReferences, bool aIncludePowerSymbols = true,
|
|
|
|
bool aForceIncludeOrphanComponents = false ) const;
|
2016-02-15 20:16:54 +00:00
|
|
|
|
2016-02-15 20:14:48 +00:00
|
|
|
/**
|
2020-10-18 20:30:37 +00:00
|
|
|
* Add a #SCH_REFERENCE_LIST object to \a aRefList for each same-reference set of
|
2016-02-15 20:14:48 +00:00
|
|
|
* multi-unit parts in the list of sheets. The map key for each element will be the
|
|
|
|
* reference designator.
|
2017-10-06 18:07:43 +00:00
|
|
|
*
|
2016-02-15 20:14:48 +00:00
|
|
|
* @param aRefList Map of reference designators to reference lists
|
|
|
|
* @param aIncludePowerSymbols Set to false to only get normal components.
|
|
|
|
*/
|
2020-11-15 16:08:31 +00:00
|
|
|
void GetMultiUnitSymbols( SCH_MULTI_UNIT_REFERENCE_MAP &aRefList,
|
|
|
|
bool aIncludePowerSymbols = true ) const;
|
2016-02-15 20:14:48 +00:00
|
|
|
|
2016-02-15 20:12:42 +00:00
|
|
|
/**
|
2020-10-18 20:30:37 +00:00
|
|
|
* Test every #SCH_SHEET_PATH in this #SCH_SHEET_LIST to verify if adding the sheets stored
|
2016-02-15 20:12:42 +00:00
|
|
|
* in \a aSrcSheetHierarchy to the sheet stored in \a aDestFileName will cause recursion.
|
|
|
|
*
|
|
|
|
* @param aSrcSheetHierarchy is the SCH_SHEET_LIST of the source sheet add to \a aDestFileName.
|
|
|
|
* @param aDestFileName is the file name of the destination sheet for \a aSrcFileName.
|
|
|
|
* @return true if \a aFileName will cause recursion in the sheet path. Otherwise false.
|
|
|
|
*/
|
|
|
|
bool TestForRecursion( const SCH_SHEET_LIST& aSrcSheetHierarchy,
|
2020-02-29 04:03:04 +00:00
|
|
|
const wxString& aDestFileName );
|
2016-02-15 20:12:42 +00:00
|
|
|
|
2019-05-19 21:04:04 +00:00
|
|
|
/**
|
2020-10-18 20:30:37 +00:00
|
|
|
* Return a pointer to the first #SCH_SHEET_PATH object (not necessarily the only one) using
|
|
|
|
* a particular screen.
|
2019-05-19 21:04:04 +00:00
|
|
|
*/
|
|
|
|
SCH_SHEET_PATH* FindSheetForScreen( SCH_SCREEN* aScreen );
|
|
|
|
|
2010-07-30 21:41:55 +00:00
|
|
|
/**
|
2020-10-18 20:30:37 +00:00
|
|
|
* Build the list of sheets and their sheet path from \a aSheet.
|
|
|
|
*
|
2011-11-10 15:55:05 +00:00
|
|
|
* If \a aSheet is the root sheet, the full sheet path and sheet list are built.
|
2020-11-29 18:30:58 +00:00
|
|
|
*
|
|
|
|
* The list will be ordered as per #SCH_SCREEN::GetSheets which results in sheets being ordered
|
|
|
|
* in the legacy way of using the X and Y positions of the sheets.
|
|
|
|
*
|
|
|
|
* @see #SortByPageNumbers to sort by page numbers
|
2010-07-30 21:41:55 +00:00
|
|
|
*
|
2011-11-10 15:55:05 +00:00
|
|
|
* @param aSheet is the starting sheet from which the list is built, or NULL
|
|
|
|
* indicating that g_RootSheet should be used.
|
|
|
|
* @throw std::bad_alloc if the memory for the sheet path list could not be allocated.
|
2009-01-06 20:09:32 +00:00
|
|
|
*/
|
2020-10-05 12:24:21 +00:00
|
|
|
void BuildSheetList( SCH_SHEET* aSheet, bool aCheckIntegrity );
|
2020-11-29 18:30:58 +00:00
|
|
|
|
|
|
|
/**
|
|
|
|
* Sorts the list of sheets by page number. This should be called after #BuildSheetList
|
|
|
|
*
|
|
|
|
* @param aUpdateVirtualPageNums If true, updates the virtual page numbers to match the new
|
|
|
|
* ordering
|
|
|
|
*/
|
|
|
|
void SortByPageNumbers( bool aUpdateVirtualPageNums = true );
|
2020-03-13 09:53:44 +00:00
|
|
|
|
|
|
|
bool NameExists( const wxString& aSheetName );
|
2020-04-26 20:53:29 +00:00
|
|
|
|
|
|
|
/**
|
|
|
|
* Update all of the symbol instance information using \a aSymbolInstances.
|
2020-05-13 02:00:37 +00:00
|
|
|
* WARNING: Do not call this on anything other than the full hierarchy.
|
2020-04-26 20:53:29 +00:00
|
|
|
* @param aSymbolInstances is the symbol path information loaded from the root schematic.
|
|
|
|
*/
|
2020-11-15 17:03:27 +00:00
|
|
|
void UpdateSymbolInstances( const std::vector<SYMBOL_INSTANCE_REFERENCE>& aSymbolInstances );
|
2020-04-26 20:53:29 +00:00
|
|
|
|
2020-10-18 20:30:37 +00:00
|
|
|
/**
|
|
|
|
* Update all of the sheet instance information using \a aSheetInstances.
|
|
|
|
*
|
|
|
|
* @warning Do not call this on anything other than the full hierarchy.
|
|
|
|
*
|
|
|
|
* @param aSymbolInstances is the symbol path information loaded from the root schematic.
|
|
|
|
*/
|
|
|
|
void UpdateSheetInstances( const std::vector<SCH_SHEET_INSTANCE>& aSheetInstances );
|
|
|
|
|
2020-04-26 20:53:29 +00:00
|
|
|
std::vector<KIID_PATH> GetPaths() const;
|
|
|
|
|
|
|
|
/**
|
|
|
|
* Update all of the symbol sheet paths to the sheet paths defined in \a aOldSheetPaths.
|
|
|
|
*
|
|
|
|
* @note The list of old sheet paths must be the exact same size and order as the existing
|
|
|
|
* sheet paths. This should not be an issue if no new sheets where added between the
|
|
|
|
* creation of this sheet list and \a aOldSheetPaths. This should only be called
|
|
|
|
* when updating legacy schematics to the new schematic file format. Once this
|
|
|
|
* happens, the schematic cannot be save to the legacy file format because the
|
|
|
|
* time stamp part of UUIDs are no longer guaranteed to be unique.
|
|
|
|
*
|
|
|
|
* @param aOldSheetPaths is the #SHEET_PATH_LIST to update from.
|
|
|
|
*/
|
|
|
|
void ReplaceLegacySheetPaths( const std::vector<KIID_PATH>& aOldSheetPaths );
|
2020-10-18 20:30:37 +00:00
|
|
|
|
|
|
|
/**
|
|
|
|
* Check all of the sheet instance for empty page numbers.
|
|
|
|
*
|
|
|
|
* @note This should only return true when loading a legacy schematic or an s-expression
|
|
|
|
* schematic before version 20201005.
|
|
|
|
*
|
|
|
|
* @return true if all sheet instance page numbers are not defined. Otherwise false.
|
|
|
|
*/
|
|
|
|
bool AllSheetPageNumbersEmpty() const;
|
|
|
|
|
|
|
|
/**
|
|
|
|
* Set initial sheet page numbers.
|
|
|
|
*
|
|
|
|
* The number scheme is base on the old psuedo sheet numbering algorithm prior to
|
|
|
|
* the implementation of user defineable sheet page numbers.
|
|
|
|
*/
|
|
|
|
void SetInitialPageNumbers();
|
2009-01-04 18:52:57 +00:00
|
|
|
};
|
|
|
|
|
2010-07-30 21:41:55 +00:00
|
|
|
#endif // CLASS_DRAWSHEET_PATH_H
|