KiCad PCB EDA Suite
Loading...
Searching...
No Matches
gerbview_settings.cpp
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#include <gerbview_settings.h>
22#include <layer_ids.h>
23#include <pgm_base.h>
26#include <settings/parameters.h>
28#include <wx/config.h>
29
30
33
34
39{
40 // Init settings:
41 m_params.emplace_back( new PARAM<bool>( "appearance.show_border_and_titleblock",
42 &m_Appearance.show_border_and_titleblock, false ) );
43
44 m_params.emplace_back( new PARAM<bool>( "appearance.show_dcodes",
45 &m_Appearance.show_dcodes, false ) );
46
47 m_params.emplace_back( new PARAM<bool>( "appearance.show_negative_objects",
48 &m_Appearance.show_negative_objects, false ) );
49
50 m_params.emplace_back( new PARAM<wxString>( "appearance.page_type",
51 &m_Appearance.page_type, "GERBER" ) );
52
53 m_params.emplace_back( new PARAM<bool>( "appearance.show_page_limit",
54 &m_Display.m_DisplayPageLimits, false ) );
55
56 m_params.emplace_back( new PARAM<double>( "appearance.mode_opacity_value",
57 &m_Display.m_OpacityModeAlphaValue, 0.6 ) );
58
59 // WARNING: any change to this key MUST be reflected in GetFileHistories()
60 m_params.emplace_back( new PARAM_LIST<wxString>( "system.drill_file_history",
61 &m_DrillFileHistory, {} ) );
62
63 // WARNING: any change to this key MUST be reflected in GetFileHistories()
64 m_params.emplace_back( new PARAM_LIST<wxString>( "system.zip_file_history",
65 &m_ZipFileHistory, {} ) );
66
67 // WARNING: any change to this key MUST be reflected in GetFileHistories()
68 m_params.emplace_back( new PARAM_LIST<wxString>( "system.job_file_history",
69 &m_JobFileHistory, {} ) );
70
71 m_params.emplace_back( new PARAM_LIST<int>( "gerber_to_pcb_layers",
73
74 m_params.emplace_back( new PARAM<int>( "gerber_to_pcb_copperlayers_count",
75 &m_BoardLayersCount, 2 ) );
76
77 m_params.emplace_back( new PARAM<bool>( "excellon_defaults.unit_mm",
78 &m_ExcellonDefaults.m_UnitsMM, false ) );
79
80 m_params.emplace_back( new PARAM<bool>( "excellon_defaults.lz_format",
81 &m_ExcellonDefaults.m_LeadingZero, true ) );
82
83 m_params.emplace_back( new PARAM<int>( "excellon_defaults.mm_integer_len",
84 &m_ExcellonDefaults.m_MmIntegerLen, FMT_INTEGER_MM, 2 , 6 ) );
85
86 m_params.emplace_back( new PARAM<int>( "excellon_defaults.mm_mantissa_len",
87 &m_ExcellonDefaults.m_MmMantissaLen, FMT_MANTISSA_MM, 2 , 6 ) );
88
89 m_params.emplace_back( new PARAM<int>( "excellon_defaults.inch_integer_len",
90 &m_ExcellonDefaults.m_InchIntegerLen, FMT_INTEGER_INCH, 2 , 6 ) );
91
92 m_params.emplace_back( new PARAM<int>( "excellon_defaults.inch_mantissa_len",
93 &m_ExcellonDefaults.m_InchMantissaLen, FMT_MANTISSA_INCH, 2 , 6 ) );
94}
95
96
97bool GERBVIEW_SETTINGS::MigrateFromLegacy( wxConfigBase* aCfg )
98{
99 bool ret = APP_SETTINGS_BASE::MigrateFromLegacy( aCfg );
100
101 ret &= fromLegacy<bool>( aCfg,
102 "ShowBorderAndTitleBlock", "appearance.show_border_and_titleblock" );
103
104 ret &= fromLegacy<bool>( aCfg, "ShowDCodesOpt", "appearance.show_dcodes" );
105 ret &= fromLegacy<bool>( aCfg, "ShowNegativeObjectsOpt", "appearance.show_negative_objects" );
106 ret &= fromLegacyString( aCfg, "PageSizeOpt", "appearance.page_type" );
107
108 auto migrate_files = [&] ( const std::string& aPath, const std::string& aDest )
109 {
110 int max_history_size = Pgm().GetCommonSettings()->m_System.file_history_size;
111 wxString file, key;
112 nlohmann::json js = nlohmann::json::array();
113
114 aCfg->SetPath( aPath );
115
116 for( int i = 0; i < max_history_size; i++ )
117 {
118 key.Printf( wxT( "file%d" ), i );
119 file = aCfg->Read( key, wxEmptyString );
120
121 if( !file.IsEmpty() )
122 js.emplace_back( file.ToStdString() );
123 }
124
125 aCfg->SetPath( wxT( ".." ) );
126
127 Set( aDest, js );
128 };
129
130 migrate_files( "drl_files", "system.drill_file_history" );
131 migrate_files( "zip_files", "system.zip_file_history" );
132 migrate_files( "job_files", "system.job_file_history" );
133
134 {
135 wxString key;
136 int value = 0;
137
138 Set( "gerber_to_pcb_layers", nlohmann::json::array() );
139
140 for( int i = 0; i < GERBER_DRAWLAYERS_COUNT; i++ )
141 {
142 key.Printf( wxT( "GbrLyr%dToPcb" ), i );
143 aCfg->Read( key, &value, UNSELECTED_LAYER );
144 At( "gerber_to_pcb_layers" ).emplace_back( value );
145 }
146 }
147
149
150 auto migrateLegacyColor = [&] ( const std::string& aKey, int aLayerId ) {
151 wxString str;
152
153 if( aCfg->Read( aKey, &str ) )
154 cs->SetColor( aLayerId, COLOR4D( str ) );
155 };
156
157 migrateLegacyColor( "BackgroundColorEx", LAYER_GERBVIEW_BACKGROUND );
158 migrateLegacyColor( "DCodeColorEx", LAYER_DCODES );
159 migrateLegacyColor( "GridColorEx", LAYER_GERBVIEW_GRID );
160 migrateLegacyColor( "NegativeObjectsColorEx", LAYER_NEGATIVE_OBJECTS );
161 migrateLegacyColor( "WorksheetColorEx", LAYER_GERBVIEW_DRAWINGSHEET );
162 migrateLegacyColor( "GridColorEx", LAYER_GERBVIEW_PAGE_LIMITS );
163
164 wxString key;
165
166 for( int i = 0, id = GERBVIEW_LAYER_ID_START;
168 {
169 key.Printf( wxT( "ColorLayer%dEx" ), i );
170 migrateLegacyColor( key.ToStdString(), id );
171 }
172
173 Pgm().GetSettingsManager().SaveColorSettings( cs, "gerbview" );
174
175 Set( "appearance.color_theme", cs->GetFilename() );
176
177 return ret;
178}
179
180
181std::map<std::string, nlohmann::json> GERBVIEW_SETTINGS::GetFileHistories()
182{
183 std::map<std::string, nlohmann::json> histories = JSON_SETTINGS::GetFileHistories();
184
185 for( const std::string& candidate : { std::string("system.drill_file_history"),
186 std::string("system.zip_file_history"),
187 std::string("system.job_file_history") } )
188 {
189 if( Contains( candidate ) )
190 histories[candidate] = GetJson( candidate ).value();
191 }
192
193 return histories;
194}
195
APP_SETTINGS_BASE(const std::string &aFilename, int aSchemaVersion)
virtual bool MigrateFromLegacy(wxConfigBase *aCfg) override
Migrates from wxConfig to JSON-based configuration.
Color settings are a bit different than most of the settings objects in that there can be more than o...
void SetColor(int aLayer, const COLOR4D &aColor)
std::vector< wxString > m_JobFileHistory
std::vector< wxString > m_DrillFileHistory
GBR_DISPLAY_OPTIONS m_Display
EXCELLON_DEFAULTS m_ExcellonDefaults
std::vector< int > m_GerberToPcbLayerMapping
A list of GERBER_DRAWLAYERS_COUNT length containing a mapping of gerber layers to PCB layers,...
std::vector< wxString > m_ZipFileHistory
bool MigrateFromLegacy(wxConfigBase *aLegacyConfig) override
Migrates from wxConfig to JSON-based configuration.
std::map< std::string, nlohmann::json > GetFileHistories() override
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.
virtual std::map< std::string, nlohmann::json > GetFileHistories()
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 Contains(const std::string &aPath) const
std::vector< PARAM_BASE * > m_params
The list of parameters (owned by this object)
nlohmann::json & At(const std::string &aPath)
Wrappers for the underlying JSON API so that most consumers don't need json.hpp All of these function...
wxString GetFilename() const
A color representation with 4 components: red, green, blue, alpha.
Definition color4d.h:101
virtual COMMON_SETTINGS * GetCommonSettings() const
Definition pgm_base.cpp:528
virtual SETTINGS_MANAGER & GetSettingsManager() const
Definition pgm_base.h:124
void SaveColorSettings(COLOR_SETTINGS *aSettings, const std::string &aNamespace="")
Safely save a COLOR_SETTINGS to disk, preserving any changes outside the given namespace.
COLOR_SETTINGS * GetMigratedColorSettings()
Return a color theme for storing colors migrated from legacy (5.x and earlier) settings,...
#define FMT_MANTISSA_INCH
#define FMT_INTEGER_MM
#define FMT_MANTISSA_MM
#define FMT_INTEGER_INCH
const int gerbviewSchemaVersion
! Update the schema version whenever a migration is required
@ LAYER_GERBVIEW_DRAWINGSHEET
Definition layer_ids.h:532
@ GERBVIEW_LAYER_ID_START
Definition layer_ids.h:522
@ LAYER_GERBVIEW_BACKGROUND
Definition layer_ids.h:531
@ LAYER_DCODES
Definition layer_ids.h:527
@ LAYER_NEGATIVE_OBJECTS
Definition layer_ids.h:528
@ LAYER_GERBVIEW_PAGE_LIMITS
Definition layer_ids.h:533
@ LAYER_GERBVIEW_GRID
Definition layer_ids.h:529
@ UNSELECTED_LAYER
Definition layer_ids.h:58
#define GERBER_DRAWLAYERS_COUNT
Number of draw layers in Gerbview.
Definition layer_ids.h:517
PGM_BASE & Pgm()
The global program "get" accessor.
see class PGM_BASE