35#include <wx/filename.h>
69 "schematic.drawing.field_names",
70 [&]() -> nlohmann::json
72 nlohmann::json ret = nlohmann::json::array();
77 ret.push_back( nlohmann::json( {
78 {
"name", field.m_Name },
79 {
"visible", field.m_Visible },
80 {
"url", field.m_URL }
86 [&](
const nlohmann::json& aJson )
88 if( aJson.is_string() )
92 TEMPLATES::SCOPE::PROJECT );
94 else if( aJson.is_array() )
98 for(
const nlohmann::json& entry : aJson )
100 if( entry.contains(
"name" ) && entry.contains(
"url" )
101 && entry.contains(
"visible" ) )
104 field.
m_URL = entry[
"url"].get<
bool>();
105 field.
m_Visible = entry[
"visible"].get<
bool>();
152 [&]() -> nlohmann::json
154 nlohmann::json ret = nlohmann::json::array();
157 ret.push_back( libName );
161 [&](
const nlohmann::json& aJson )
163 if( aJson.empty() || !aJson.is_array() )
168 for(
const nlohmann::json& entry : aJson )
173 [&]() -> nlohmann::json
177 return nlohmann::json();
179 nlohmann::json ret = nlohmann::json::object();
183 nlohmann::json members = nlohmann::json::array();
185 for(
const wxString& member : alias.second )
186 members.push_back( member );
188 ret[ alias.first.ToStdString() ] = members;
193 [&](
const nlohmann::json& aJson )
198 if( !aJson.is_object() )
201 for(
auto it = aJson.begin(); it != aJson.end(); ++it )
203 const nlohmann::json& membersJson = it.value();
205 if( !membersJson.is_array() )
208 std::vector<wxString> members;
210 for(
const nlohmann::json& entry : membersJson )
212 if( entry.is_string() )
214 wxString member = entry.get<wxString>().Strip( wxString::both );
216 if( !member.IsEmpty() )
217 members.push_back( member );
221 wxString
name = wxString::FromUTF8( it.key().c_str() ).Strip( wxString::both );
223 if( !
name.IsEmpty() )
229 m_params.back()->SetClearUnknownKeys();
231 m_NetSettings = std::make_shared<NET_SETTINGS>(
this,
"net_settings" );
234 std::make_shared<COMPONENT_CLASS_SETTINGS>(
this,
"component_class_settings" );
272 [
this]() {
return nlohmann::json(
m_IP2581Bom.sections.value_or( wxString() ) ); },
273 [
this](
const nlohmann::json& aVal )
275 wxString sections = aVal.is_string() ? aVal.get<wxString>() : wxString();
276 m_IP2581Bom.sections = sections.IsEmpty() ? std::nullopt : std::optional<wxString>( sections );
278 nlohmann::json(
"" ) ) );
282 [
this](
const nlohmann::json& aVal )
284 if( aVal.is_boolean() && aVal.get<
bool>() && !
m_IP2581Bom.sections )
287 nlohmann::json(
false ) ) );
331 auto p(
"/board/layer_presets"_json_pointer );
338 for( nlohmann::json& entry : presets )
349 auto p(
"/board/layer_presets"_json_pointer );
356 for( nlohmann::json& entry : presets )
367 const auto aliases =
GetJson(
"schematic.bus_aliases" );
369 if( aliases && aliases->is_object() && aliases->empty() )
372 Set(
"schematic.bus_aliases", nlohmann::json() );
386 std::set<wxString> group_blacklist;
393 auto loadPinnedLibs =
394 [&](
const std::string& aDest )
397 wxString libKey = wxT(
"PinnedItems" );
400 nlohmann::json libs = nlohmann::json::array();
402 while( aCfg->Read( libKey, &str ) )
404 libs.push_back( str );
406 aCfg->DeleteEntry( libKey,
true );
408 libKey = wxT(
"PinnedItems" );
409 libKey << ++libIndex;
415 aCfg->SetPath( wxT(
"/LibeditFrame" ) );
416 loadPinnedLibs(
"libraries.pinned_symbol_libs" );
418 aCfg->SetPath( wxT(
"/ModEditFrame" ) );
419 loadPinnedLibs(
"libraries.pinned_footprint_libs" );
421 aCfg->SetPath( wxT(
"/cvpcb/equfiles" ) );
425 wxString eqKey = wxT(
"EquName" );
428 nlohmann::json eqs = nlohmann::json::array();
430 while( aCfg->Read( eqKey, &str ) )
432 eqs.push_back( str );
434 eqKey = wxT(
"EquName" );
438 Set(
"cvpcb.equivalence_files", eqs );
442 group_blacklist.insert( wxT(
"/cvpcb" ) );
444 aCfg->SetPath( wxT(
"/eeschema" ) );
447 aCfg->SetPath( wxT(
"/eeschema/libraries" ) );
451 wxString libKey = wxT(
"LibName" );
454 nlohmann::json libs = nlohmann::json::array();
456 while( aCfg->Read( libKey, &str ) )
458 libs.push_back( str );
460 libKey = wxT(
"LibName" );
464 Set(
"schematic.legacy_lib_list", libs );
467 group_blacklist.insert( wxT(
"/eeschema" ) );
469 aCfg->SetPath( wxT(
"/text_variables" ) );
476 nlohmann::json vars = nlohmann::json();
478 while( aCfg->Read( txtKey, &str ) )
480 wxArrayString tokens = wxSplit( str,
':' );
482 if( tokens.size() == 2 )
483 vars[ tokens[0].ToStdString() ] = tokens[1];
489 Set(
"text_variables", vars );
492 group_blacklist.insert( wxT(
"/text_variables" ) );
494 aCfg->SetPath( wxT(
"/schematic_editor" ) );
496 fromLegacyString( aCfg,
"PageLayoutDescrFile",
"schematic.page_layout_descr_file" );
499 fromLegacy<bool>( aCfg,
"SpiceAjustPassiveValues",
"schematic.spice_adjust_passive_values" );
500 fromLegacy<int>( aCfg,
"SubpartIdSeparator",
"schematic.subpart_id_separator" );
501 fromLegacy<int>( aCfg,
"SubpartFirstId",
"schematic.subpart_first_id" );
503 fromLegacy<int>( aCfg,
"LineThickness",
"schematic.drawing.default_line_thickness" );
504 fromLegacy<int>( aCfg,
"WireThickness",
"schematic.drawing.default_wire_thickness" );
505 fromLegacy<int>( aCfg,
"BusThickness",
"schematic.drawing.default_bus_thickness" );
506 fromLegacy<int>( aCfg,
"LabSize",
"schematic.drawing.default_text_size" );
508 if( !
fromLegacy<int>( aCfg,
"PinSymbolSize",
"schematic.drawing.pin_symbol_size" ) )
511 Set(
"schematic.drawing.pin_symbol_size", 0 );
514 fromLegacy<int>( aCfg,
"JunctionSize",
"schematic.drawing.default_junction_size" );
516 fromLegacyString( aCfg,
"FieldNameTemplates",
"schematic.drawing.field_names" );
518 if( !
fromLegacy<double>( aCfg,
"TextOffsetRatio",
"schematic.drawing.text_offset_ratio" ) )
521 Set(
"schematic.drawing.text_offset_ratio", 0.08 );
522 Set(
"schematic.drawing.label_size_ratio", 0.25 );
526 group_blacklist.insert( wxT(
"/schematic_editor" ) );
528 aCfg->SetPath( wxT(
"/pcbnew" ) );
530 fromLegacyString( aCfg,
"PageLayoutDescrFile",
"pcbnew.page_layout_descr_file" );
535 fromLegacyString( aCfg,
"LastSpecctraDSNExportPath",
"pcbnew.last_paths.specctra_dsn" );
536 fromLegacyString( aCfg,
"LastGenCADExportPath",
"pcbnew.last_paths.gencad" );
538 std::string bp =
"board.design_settings.";
542 wxString key = wxT(
"DRCExclusion" );
545 nlohmann::json exclusions = nlohmann::json::array();
547 while( aCfg->Read( key, &str ) )
549 exclusions.push_back( str );
551 key = wxT(
"DRCExclusion" );
555 Set( bp +
"drc_exclusions", exclusions );
559 fromLegacy<bool>( aCfg,
"AllowBlindVias", bp +
"rules.allow_blind_buried_vias" );
565 if( !
fromLegacy<double>( aCfg,
"MinThroughDrill", bp +
"rules.min_through_hole_diameter" ) )
568 fromLegacy<double>( aCfg,
"MinMicroViaDiameter", bp +
"rules.min_microvia_diameter" );
571 fromLegacy<double>( aCfg,
"CopperEdgeClearance", bp +
"rules.min_copper_edge_clearance" );
572 fromLegacy<double>( aCfg,
"SolderMaskClearance", bp +
"rules.solder_mask_clearance" );
574 fromLegacy<double>( aCfg,
"SolderPasteClearance", bp +
"rules.solder_paste_clearance" );
575 fromLegacy<double>( aCfg,
"SolderPasteRatio", bp +
"rules.solder_paste_margin_ratio" );
578 fromLegacy<double>( aCfg,
"ModuleOutlineThickness", bp +
"defaults.silk_line_width" );
586 if( !
fromLegacy<double>( aCfg,
"SilkTextSizeThickness", bp +
"defaults.silk_text_thickness" ) )
587 fromLegacy<double>( aCfg,
"ModuleTextSizeThickness", bp +
"defaults.silk_text_thickness" );
589 fromLegacy<bool>( aCfg,
"SilkTextItalic", bp +
"defaults.silk_text_italic" );
590 fromLegacy<bool>( aCfg,
"SilkTextUpright", bp +
"defaults.silk_text_upright" );
592 if( !
fromLegacy<double>( aCfg,
"CopperLineWidth", bp +
"defaults.copper_line_width" ) )
595 if( !
fromLegacy<double>( aCfg,
"CopperTextSizeV", bp +
"defaults.copper_text_size_v" ) )
598 if( !
fromLegacy<double>( aCfg,
"CopperTextSizeH", bp +
"defaults.copper_text_size_h" ) )
601 if( !
fromLegacy<double>( aCfg,
"CopperTextThickness", bp +
"defaults.copper_text_thickness" ) )
602 fromLegacy<double>( aCfg,
"PcbTextThickness", bp +
"defaults.copper_text_thickness" );
604 fromLegacy<bool>( aCfg,
"CopperTextItalic", bp +
"defaults.copper_text_italic" );
605 fromLegacy<bool>( aCfg,
"CopperTextUpright", bp +
"defaults.copper_text_upright" );
607 if( !
fromLegacy<double>( aCfg,
"EdgeCutLineWidth", bp +
"defaults.board_outline_line_width" ) )
609 bp +
"defaults.board_outline_line_width" );
611 fromLegacy<double>( aCfg,
"CourtyardLineWidth", bp +
"defaults.courtyard_line_width" );
616 fromLegacy<double>( aCfg,
"FabTextSizeThickness", bp +
"defaults.fab_text_thickness" );
618 fromLegacy<bool>( aCfg,
"FabTextUpright", bp +
"defaults.fab_text_upright" );
620 if( !
fromLegacy<double>( aCfg,
"OthersLineWidth", bp +
"defaults.other_line_width" ) )
621 fromLegacy<double>( aCfg,
"ModuleOutlineThickness", bp +
"defaults.other_line_width" );
625 fromLegacy<double>( aCfg,
"OthersTextSizeThickness", bp +
"defaults.other_text_thickness" );
626 fromLegacy<bool>( aCfg,
"OthersTextItalic", bp +
"defaults.other_text_italic" );
627 fromLegacy<bool>( aCfg,
"OthersTextUpright", bp +
"defaults.other_text_upright" );
629 fromLegacy<int>( aCfg,
"DimensionUnits", bp +
"defaults.dimension_units" );
630 fromLegacy<int>( aCfg,
"DimensionPrecision", bp +
"defaults.dimension_precision" );
632 std::string sev = bp +
"rule_severities";
634 fromLegacy<bool>( aCfg,
"RequireCourtyardDefinitions", sev +
"legacy_no_courtyard_defined" );
636 fromLegacy<bool>( aCfg,
"ProhibitOverlappingCourtyards", sev +
"legacy_courtyards_overlap" );
640 wxString keyBase =
"TrackWidth";
641 wxString key = keyBase;
644 nlohmann::json widths = nlohmann::json::array();
648 while( aCfg->Read( key, &val ) )
650 widths.push_back( val );
655 Set( bp +
"track_widths", widths );
660 wxString keyBase =
"ViaDiameter";
661 wxString key = keyBase;
665 nlohmann::json vias = nlohmann::json::array();
669 while( aCfg->Read( key, &diameter ) )
673 aCfg->Read( key << idx, &drill );
675 nlohmann::json
via = { {
"diameter", diameter }, {
"drill", drill } };
676 vias.push_back(
via );
682 Set( bp +
"via_dimensions", vias );
687 wxString keyBase =
"dPairWidth";
688 wxString key = keyBase;
693 nlohmann::json pairs = nlohmann::json::array();
697 while( aCfg->Read( key, &width ) )
701 aCfg->Read( key << idx, &gap );
705 aCfg->Read( key << idx, &via_gap );
707 nlohmann::json pair = { {
"width", width }, {
"gap", gap }, {
"via_gap", via_gap } };
708 pairs.push_back( pair );
714 Set( bp +
"diff_pair_dimensions", pairs );
717 group_blacklist.insert( wxT(
"/pcbnew" ) );
720 group_blacklist.insert( wxT(
"/general" ) );
723 aCfg->SetPath( wxT(
"/" ) );
725 auto loadSheetNames =
730 nlohmann::json arr = nlohmann::json::array();
734 aCfg->SetPath( wxT(
"/sheetnames" ) );
736 while( aCfg->Read( wxString::Format(
"%d", sheet++ ), &entry ) )
738 wxArrayString tokens = wxSplit( entry,
':' );
740 if( tokens.size() == 2 )
742 wxLogTrace(
traceSettings, wxT(
"%d: %s = %s" ), sheet, tokens[0], tokens[1] );
743 arr.push_back( nlohmann::json::array( { tokens[0], tokens[1] } ) );
747 Set(
"sheets", arr );
749 aCfg->SetPath(
"/" );
754 std::vector<wxString> groups;
756 groups.emplace_back( wxEmptyString );
758 auto loadLegacyPairs =
759 [&](
const std::string& aGroup ) ->
bool
761 wxLogTrace(
traceSettings, wxT(
"Migrating group %s" ), aGroup );
768 while( aCfg->GetNextEntry( keyStr,
index ) )
770 if( !aCfg->Read( keyStr, &val ) )
773 std::string key( keyStr.ToUTF8() );
779 Set(
"legacy." + aGroup +
"." + key, val );
790 for(
size_t i = 0; i < groups.size(); i++ )
792 aCfg->SetPath( groups[i] );
794 if( groups[i] == wxT(
"/sheetnames" ) )
796 ret |= loadSheetNames();
800 aCfg->DeleteEntry( wxT(
"last_client" ),
true );
801 aCfg->DeleteEntry( wxT(
"update" ),
true );
802 aCfg->DeleteEntry( wxT(
"version" ),
true );
808 while( aCfg->GetNextGroup( str,
index ) )
810 wxString
group = groups[i] +
"/" + str;
812 if( !group_blacklist.count(
group ) )
813 groups.emplace_back(
group );
816 aCfg->SetPath(
"/" );
836 wxString projectName =
m_project->GetProjectName();
840 defaultSheet.
name = projectName;
841 defaultSheet.
filename = projectName +
".kicad_sch";
848 wxLogTrace(
traceSettings, wxT(
"PROJECT_FILE: Migrated old single-root format to top_level_sheets" ) );
857 wxString projectPath =
m_project->GetProjectPath();
858 wxString projectName =
m_project->GetProjectName();
862 wxFileName referencedFile( sheetInfo.filename );
863 referencedFile.MakeAbsolute( projectPath );
865 if( referencedFile.FileExists() )
871 wxFileName candidateFile( projectPath, expectedFile );
873 if( candidateFile.FileExists() )
876 wxT(
"PROJECT_FILE: Fixing stale top_level_sheets reference '%s' -> '%s'" ),
877 sheetInfo.filename, expectedFile );
879 sheetInfo.filename = expectedFile;
880 sheetInfo.name = projectName;
942 return std::string();
950 wxString oldProjectName = oldFilename.GetName();
951 wxString oldProjectPath = oldFilename.GetPath();
957 [&]( wxString& aPath )
959 if( aPath.StartsWith( oldProjectName + wxS(
"." ) ) )
960 aPath.Replace( oldProjectName, aFile,
false );
961 else if( aPath.StartsWith( oldProjectPath + wxS(
"/" ) ) )
962 aPath.Replace( oldProjectPath, aDirectory,
false );
970 auto updatePathByPtr =
971 [&](
const std::string& aPtr )
975 updatePath(
path.value() );
980 updatePathByPtr(
"schematic.page_layout_descr_file" );
981 updatePathByPtr(
"schematic.plot_directory" );
982 updatePathByPtr(
"schematic.ngspice.workbook_filename" );
983 updatePathByPtr(
"pcbnew.page_layout_descr_file" );
987 updatePath( sheetInfo.filename );
990 if( sheetInfo.name == oldProjectName )
991 sheetInfo.name = aFile;
1019 aJson = nlohmann::json::array( { aPair.first.AsString().ToUTF8(), aPair.second.ToUTF8() } );
1025 wxCHECK( aJson.is_array() && aJson.size() == 2, );
1026 aPair.first =
KIID( wxString( aJson[0].get<std::string>().c_str(), wxConvUTF8 ) );
1027 aPair.second = wxString( aJson[1].get<std::string>().c_str(), wxConvUTF8 );
1033 aJson = nlohmann::json::object();
1035 aJson[
"name"] = aInfo.
name.ToUTF8();
1036 aJson[
"filename"] = aInfo.
filename.ToUTF8();
1042 wxCHECK( aJson.is_object(), );
1044 if( aJson.contains(
"uuid" ) )
1045 aInfo.
uuid =
KIID( wxString( aJson[
"uuid"].get<std::string>().c_str(), wxConvUTF8 ) );
1047 if( aJson.contains(
"name" ) )
1048 aInfo.
name = wxString( aJson[
"name"].get<std::string>().c_str(), wxConvUTF8 );
1050 if( aJson.contains(
"filename" ) )
1051 aInfo.
filename = wxString( aJson[
"filename"].get<std::string>().c_str(), wxConvUTF8 );
bool fromLegacyString(wxConfigBase *aConfig, const std::string &aKey, const std::string &aDest)
Translates a legacy wxConfig string value to a given JSON pointer value.
bool fromLegacy(wxConfigBase *aConfig, const std::string &aKey, const std::string &aDest)
Translates a legacy wxConfig value to a given JSON pointer value.
bool flushToStore()
Flushes nested settings and parameters into the JSON store.
void Set(const std::string &aPath, ValueType aVal)
Stores a value into the JSON document Will throw an exception if ValueType isn't something that the l...
std::optional< nlohmann::json > GetJson(const std::string &aPath) const
Fetches a JSON object that is a subset of this JSON_SETTINGS object, using a path of the form "key1....
bool m_modified
True if the JSON data store has been written to since the last file write.
virtual bool LoadFromFile(const wxString &aDirectory="")
Loads the backing file from disk and then calls Load()
void SetReadOnly(bool aReadOnly)
wxString GetFullFilename() const
std::optional< ValueType > Get(const std::string &aPath) const
Fetches a value from within the JSON document.
std::vector< PARAM_BASE * > m_params
The list of parameters (owned by this object)
void registerMigration(int aOldSchemaVersion, int aNewSchemaVersion, std::function< bool(void)> aMigrator)
Registers a migration from one schema version to another.
JSON_SETTINGS(const wxString &aFilename, SETTINGS_LOC aLocation, int aSchemaVersion)
bool m_deleteLegacyAfterMigration
Whether or not to delete legacy file after migration.
std::unique_ptr< JSON_SETTINGS_INTERNALS > m_internals
void SetFilename(const wxString &aFilename)
virtual bool SaveToFile(const wxString &aDirectory="", bool aForce=false)
Calls Store() and then writes the contents of the JSON document to a file.
std::string formatFileContents()
Overlays the current store on the original file contents.
virtual bool Store()
Stores the current parameters into the JSON document represented by this object Note: this doesn't do...
wxString GetFilename() const
wxString AsString() const
Stores an enum as an integer.
Like a normal param, but with custom getter and setter functions.
static void MigrateToV9Layers(nlohmann::json &aJson)
static void MigrateToNamedRenderLayers(nlohmann::json &aJson)
Represents a list of strings holding directory paths.
Stores a path as a string with directory separators normalized to unix-style.
A helper for <wxString, wxString> maps.
std::map< wxString, wxString > m_TextVars
wxString getFileExt() const override
bool m_BusAliasesDefined
An explicit alias table was loaded or set, including a deliberately empty table.
std::vector< LAYER_PAIR_INFO > m_LayerPairInfos
List of stored 3D viewports (view matrixes)
ERC_SETTINGS * m_ErcSettings
Eeschema params.
SCHEMATIC_SETTINGS * m_SchematicSettings
bool migrateSchema1To2()
Schema version 2: Bump for KiCad 9 layer numbering changes.
wxString m_BoardDrawingSheetFile
PcbNew params.
std::shared_ptr< NET_SETTINGS > m_NetSettings
Net settings for this project (owned here)
struct IP2581_BOM m_IP2581Bom
Layer pair list for the board.
bool m_topLevelSheetsChanged
wxString m_PcbLastPath[LAST_PATH_SIZE]
MRU path storage.
TEMPLATES m_TemplateFieldNames
Project and global field name templates shared by project editors.
PROJECT * m_project
A link to the owning PROJECT.
std::vector< TOP_LEVEL_SHEET_INFO > m_topLevelSheets
A list of top-level schematic sheets in this project.
std::vector< VIEWPORT > m_Viewports
List of stored layer presets.
std::vector< wxString > m_PinnedDesignBlockLibs
The list of pinned design block libraries.
bool SaveAs(const wxString &aDirectory, const wxString &aFile)
std::map< wxString, std::vector< wxString > > m_BusAliases
Bus alias definitions for the schematic project.
std::vector< wxString > m_EquivalenceFiles
CvPcb params.
bool Store() override
Stores the current parameters into the JSON document represented by this object Note: this doesn't do...
bool migrateSchema2To3()
Schema version 3: move layer presets to use named render layers.
wxString getLegacyFileExt() const override
std::vector< wxString > m_PinnedFootprintLibs
The list of pinned footprint libraries.
bool LoadFromFile(const wxString &aDirectory="") override
Loads the backing file from disk and then calls Load()
bool migrateSchema3To4()
Schema version 4 distinguishes explicit empty alias tables from older default writes.
std::string SerializeToString()
Serialize to the bytes SaveToFile would write, without touching the file.
std::shared_ptr< BOARD_DESIGN_SETTINGS > m_BoardSettings
Board design settings for this project's board.
std::vector< FILE_INFO_PAIR > m_sheets
An list of schematic sheets in this project.
std::vector< wxString > m_FindByPropertiesQueries
Recent queries for Find by Properties dialog.
virtual bool MigrateFromLegacy(wxConfigBase *aCfg) override
Migrates from wxConfig to JSON-based configuration.
std::vector< LAYER_PRESET > m_LayerPresets
std::vector< FILE_INFO_PAIR > m_boards
A list of board files in this project.
std::shared_ptr< TUNING_PROFILES > m_tuningProfileParameters
Tuning profile parameters for this project.
wxArrayString m_LegacyLibNames
std::vector< wxString > m_PinnedSymbolLibs
Below are project-level settings that have not been moved to a dedicated file.
IDF_EXPORT_SETTINGS m_IdfExportSettings
IPC-2581 BOM settings.
std::vector< VIEWPORT3D > m_Viewports3D
List of stored viewports (pos + zoom)
bool SaveToFile(const wxString &aDirectory="", bool aForce=false) override
Calls Store() and then writes the contents of the JSON document to a file.
PROJECT_FILE(const wxString &aFullPath)
Construct the project file for a project.
std::shared_ptr< COMPONENT_CLASS_SETTINGS > m_ComponentClassSettings
Component class settings for the project (owned here)
Container for project specific data.
static std::string ToStdString(const wxString &aStr)
static const std::string ProjectFileExtension
static const std::string LegacyProjectFileExtension
static const std::string KiCadSchematicFileExtension
void to_json(nlohmann::json &aJson, const FILE_INFO_PAIR &aPair)
void from_json(const nlohmann::json &aJson, FILE_INFO_PAIR &aPair)
const int projectFileSchemaVersion
! Update the schema version whenever a migration is required
std::pair< KIID, wxString > FILE_INFO_PAIR
For files like sheets and boards, a pair of that object KIID and display name Display name is typical...
Hold a name of a symbol's field, field value, and default visibility.
Information about a top-level schematic sheet.
KIID uuid
Unique identifier for the sheet.
wxString name
Display name for the sheet.
wxString filename
Relative path to the sheet file.
Definition of file extensions used in Kicad.