schematic.h

Go to the documentation of this file.

/*
 * This program source code file is part of KiCad, a free EDA CAD application.
 *
 * Copyright (C) 2020-2021 KiCad Developers, see AUTHORS.txt for contributors.
 *
 * 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 3 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, see <http://www.gnu.org/licenses/>.
 */

#ifndef KICAD_SCHEMATIC_H
#define KICAD_SCHEMATIC_H

#include <eda_item.h>
#include <sch_sheet_path.h>
#include <schematic_settings.h>


class BUS_ALIAS;
class CONNECTION_GRAPH;
class EDA_BASE_FRAME;
class ERC_SETTINGS;
class PROJECT;
class SCH_SCREEN;
class SCH_SHEET;
class SCH_SHEET_LIST;


class SCHEMATIC_IFACE
{
public:
 SCHEMATIC_IFACE() {};
 virtual ~SCHEMATIC_IFACE() {};

 virtual CONNECTION_GRAPH* ConnectionGraph() const = 0;
 virtual SCH_SHEET_LIST GetSheets() const = 0;
 virtual void SetCurrentSheet( const SCH_SHEET_PATH& aPath ) = 0;
 virtual SCH_SHEET_PATH& CurrentSheet() const = 0;
 virtual wxString GetFileName() const = 0;
 virtual PROJECT& Prj() const = 0;
};

class SCHEMATIC : public SCHEMATIC_IFACE, public EDA_ITEM
{
public:
 SCHEMATIC( PROJECT* aPrj );

 virtual ~SCHEMATIC();

 virtual wxString GetClass() const override
 {
 return wxT( "SCHEMATIC" );
 }

 void Reset();

 PROJECT& Prj() const override
 {
 return *m_project;
 }

 void SetProject( PROJECT* aPrj );

 SCH_SHEET_LIST GetSheets() const override
 {
 return SCH_SHEET_LIST( m_rootSheet );
 }

 SCH_SHEET& Root() const
 {
 return *m_rootSheet;
 }

 void SetRoot( SCH_SHEET* aRootSheet );

 bool IsValid() const
 {
 return m_rootSheet != nullptr;
 }

 SCH_SCREEN* RootScreen() const;

 bool ResolveTextVar( wxString* token, int aDepth ) const;

 wxString GetFileName() const override;

 SCH_SHEET_PATH& CurrentSheet() const override
 {
 return *m_currentSheet;
 }

 void SetCurrentSheet( const SCH_SHEET_PATH& aPath ) override
 {
 *m_currentSheet = aPath;
 }

 CONNECTION_GRAPH* ConnectionGraph() const override
 {
 return m_connectionGraph;
 }

 SCHEMATIC_SETTINGS& Settings() const;

 ERC_SETTINGS& ErcSettings() const;

 std::vector<SCH_MARKER*> ResolveERCExclusions();

 std::shared_ptr<BUS_ALIAS> GetBusAlias( const wxString& aLabel ) const;

 std::vector<wxString> GetNetClassAssignmentCandidates();

 bool ResolveCrossReference( wxString* token, int aDepth ) const;

 std::map<wxString, std::set<wxString>>& GetPageRefsMap() { return m_labelToPageRefsMap; }

 wxString ConvertRefsToKIIDs( const wxString& aSource ) const;
 wxString ConvertKIIDsToRefs( const wxString& aSource ) const;

 SCH_SHEET_LIST& GetFullHierarchy() const;


#if defined(DEBUG)
 void Show( int nestLevel, std::ostream& os ) const override {}
#endif

private:
 friend class SCH_EDIT_FRAME;

 PROJECT* m_project;

 SCH_SHEET* m_rootSheet;

 SCH_SHEET_PATH* m_currentSheet;

 CONNECTION_GRAPH* m_connectionGraph;

 std::map<wxString, std::set<wxString>> m_labelToPageRefsMap;
};

#endif