project_file.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 CERN
 * Copyright (C) 2021 KiCad Developers, see AUTHORS.txt for contributors.
 * @author Jon Evans <[email protected]>
 *
 * 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_PROJECT_FILE_H
#define KICAD_PROJECT_FILE_H

#include <common.h> // needed for wxstring hash template
#include <kiid.h>
#include <project/board_project_settings.h>
#include <settings/json_settings.h>
#include <settings/nested_settings.h>

class BOARD_DESIGN_SETTINGS;
class ERC_SETTINGS;
class NET_SETTINGS;
class SCHEMATIC_SETTINGS;
class TEMPLATES;

typedef std::pair<KIID, wxString> FILE_INFO_PAIR;

enum LAST_PATH_TYPE : unsigned int
{
 LAST_PATH_NETLIST = 0,
 LAST_PATH_STEP,
 LAST_PATH_IDF,
 LAST_PATH_VRML,
 LAST_PATH_SPECCTRADSN,
 LAST_PATH_GENCAD,

 LAST_PATH_SIZE
};

class PROJECT_FILE : public JSON_SETTINGS
{
public:
 PROJECT_FILE( const wxString& aFullPath );

 virtual ~PROJECT_FILE() = default;

 virtual bool MigrateFromLegacy( wxConfigBase* aCfg ) override;

 bool SaveToFile( const wxString& aDirectory = "", bool aForce = false ) override;

 bool SaveAs( const wxString& aDirectory, const wxString& aFile );

 void SetProject( PROJECT* aProject )
 {
 m_project = aProject;
 }

 std::vector<FILE_INFO_PAIR>& GetSheets()
 {
 return m_sheets;
 }

 std::vector<FILE_INFO_PAIR>& GetBoards()
 {
 return m_boards;
 }

 NET_SETTINGS& NetSettings()
 {
 return *m_NetSettings;
 }

protected:
 wxString getFileExt() const override;

 wxString getLegacyFileExt() const override;

public:
 std::vector<wxString> m_PinnedSymbolLibs;

 std::vector<wxString> m_PinnedFootprintLibs;

 std::map<wxString, wxString> m_TextVars;

 // Schematic ERC settings: lifecycle managed by SCHEMATIC
 ERC_SETTINGS* m_ErcSettings;

 // Schematic editing and misc settings: lifecycle managed by SCHEMATIC
 SCHEMATIC_SETTINGS* m_SchematicSettings;

 // Legacy parameters LibDir and LibName, for importing old projects
 wxString m_LegacyLibDir;

 wxArrayString m_LegacyLibNames;

 std::vector<wxString> m_EquivalenceFiles;

 wxString m_BoardDrawingSheetFile;

 wxString m_PcbLastPath[LAST_PATH_SIZE];

 BOARD_DESIGN_SETTINGS* m_BoardSettings;

 std::shared_ptr<NET_SETTINGS> m_NetSettings;

 std::vector<LAYER_PRESET> m_LayerPresets;

private:
 std::vector<FILE_INFO_PAIR> m_sheets;

 std::vector<FILE_INFO_PAIR> m_boards;

 PROJECT* m_project;
};

// Specializations to allow directly reading/writing FILE_INFO_PAIRs from JSON

void to_json( nlohmann::json& aJson, const FILE_INFO_PAIR& aPair );

void from_json( const nlohmann::json& aJson, FILE_INFO_PAIR& aPair );

#endif