KiCad PCB EDA Suite
pcbnew_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 (C) 2020 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, you may find one here:
18 * http://www.gnu.org/licenses/old-licenses/gpl-2.0.html
19 * or you may search the http://www.gnu.org website for the version 2 license,
20 * or you may write to the Free Software Foundation, Inc.,
21 * 51 Franklin Street, Fifth Floor, Boston, MA 02110-1301, USA
22 */
23 
24 #include <common.h>
27 #include <pcbnew_settings.h>
28 #include <pgm_base.h>
32 #include <settings/parameters.h>
34 #include <wx/config.h>
35 #include <wx/tokenzr.h>
36 #include <zones.h>
37 #include <widgets/ui_common.h>
38 #include <base_units.h>
39 
40 #include "../3d-viewer/3d_viewer/3d_viewer_settings.h"
41 
42 
44 const int pcbnewSchemaVersion = 0;
45 
46 
49  m_AuiPanels(),
50  m_Cleanup(),
51  m_DrcDialog(),
52  m_ExportIdf(),
53  m_ExportStep(),
54  m_ExportSvg(),
55  m_ExportVrml(),
56  m_FootprintWizardList(),
57  m_GenDrill(),
58  m_ImportGraphics(),
59  m_NetlistDialog(),
60  m_PlaceFile(),
61  m_Plot(),
62  m_FootprintChooser(),
63  m_Zones(),
64  m_FootprintViewer(),
65  m_FootprintWizard(),
66  m_Display(),
67  m_TrackDragAction( TRACK_DRAG_ACTION::DRAG ),
68  m_Use45DegreeGraphicSegments( false ),
69  m_FlipLeftRight( false ),
70  m_PolarCoords( false ),
71  m_RotationAngle( 900 ),
72  m_PlotLineWidth( 0.1 ),
73  m_ShowPageLimits( true ),
74  m_PnsSettings( nullptr ),
75  m_FootprintViewerAutoZoom( false ),
76  m_FootprintViewerZoom( 1.0 )
77 {
80  m_MagneticItems.graphics = false;
81 
82  m_params.emplace_back( new PARAM<bool>( "aui.show_layer_manager",
84 
85  m_params.emplace_back(
86  new PARAM<int>( "aui.right_panel_width", &m_AuiPanels.right_panel_width, -1 ) );
87 
88  m_params.emplace_back( new PARAM<int>(
89  "aui.appearance_panel_tab", &m_AuiPanels.appearance_panel_tab, 0, 0, 2 ) );
90 
91  m_params.emplace_back( new PARAM<int>( "footprint_chooser.width",
92  &m_FootprintChooser.width, -1 ) );
93 
94  m_params.emplace_back( new PARAM<int>( "footprint_chooser.height",
95  &m_FootprintChooser.height, -1 ) );
96 
97  m_params.emplace_back( new PARAM<int>( "footprint_chooser.sash_h",
98  &m_FootprintChooser.sash_h, -1 ) );
99 
100  m_params.emplace_back( new PARAM<int>( "footprint_chooser.sash_v",
101  &m_FootprintChooser.sash_v, -1 ) );
102 
103  m_params.emplace_back( new PARAM<bool>( "editing.flip_left_right", &m_FlipLeftRight, true ) );
104 
105  m_params.emplace_back(
106  new PARAM<bool>( "editing.magnetic_graphics", &m_MagneticItems.graphics, true ) );
107 
108  m_params.emplace_back( new PARAM<int>( "editing.magnetic_pads",
109  reinterpret_cast<int*>( &m_MagneticItems.pads ),
110  static_cast<int>( MAGNETIC_OPTIONS::CAPTURE_CURSOR_IN_TRACK_TOOL ) ) );
111 
112  m_params.emplace_back( new PARAM<int>( "editing.magnetic_tracks",
113  reinterpret_cast<int*>( &m_MagneticItems.tracks ),
114  static_cast<int>( MAGNETIC_OPTIONS::CAPTURE_CURSOR_IN_TRACK_TOOL ) ) );
115 
116  m_params.emplace_back( new PARAM<bool>( "editing.polar_coords", &m_PolarCoords, false ) );
117 
118  m_params.emplace_back( new PARAM<int>( "editing.track_drag_action",
119  reinterpret_cast<int*>( &m_TrackDragAction ),
120  static_cast<int>( TRACK_DRAG_ACTION::DRAG ) ) );
121 
122  m_params.emplace_back( new PARAM<bool>( "editing.use_45_degree_graphic_segments",
123  &m_Use45DegreeGraphicSegments, false ) );
124 
125  m_params.emplace_back( new PARAM<bool>(
126  "pcb_display.graphic_items_fill", &m_Display.m_DisplayGraphicsFill, true ) );
127 
128  m_params.emplace_back( new PARAM<int>(
129  "pcb_display.max_links_shown", &m_Display.m_MaxLinksShowed, 3, 0, 15 ) );
130 
131  m_params.emplace_back( new PARAM<bool>(
132  "pcb_display.graphics_fill", &m_Display.m_DisplayGraphicsFill, true ) );
133 
134  m_params.emplace_back( new PARAM<bool>(
135  "pcb_display.text_fill", &m_Display.m_DisplayTextFill, true ) );
136 
137  m_params.emplace_back( new PARAM<int>(
138  "pcb_display.net_names_mode", &m_Display.m_DisplayNetNamesMode, 3, 0, 3 ) );
139 
140  m_params.emplace_back(
141  new PARAM<bool>( "pcb_display.pad_clearance", &m_Display.m_DisplayPadIsol, true ) );
142 
143  m_params.emplace_back(
144  new PARAM<bool>( "pcb_display.pad_fill", &m_Display.m_DisplayPadFill, true ) );
145 
146  m_params.emplace_back(
147  new PARAM<bool>( "pcb_display.pad_numbers", &m_Display.m_DisplayPadNum, true ) );
148 
149  m_params.emplace_back( new PARAM<bool>(
150  "pcb_display.ratsnest_global", &m_Display.m_ShowGlobalRatsnest, true ) );
151 
152  m_params.emplace_back( new PARAM<bool>(
153  "pcb_display.ratsnest_footprint", &m_Display.m_ShowModuleRatsnest, true ) );
154 
155  m_params.emplace_back( new PARAM<bool>(
156  "pcb_display.ratsnest_curved", &m_Display.m_DisplayRatsnestLinesCurved, false ) );
157 
158  m_params.emplace_back( new PARAM<int>(
159  "pcb_display.rotation_angle", &m_RotationAngle, 900, 1, 900 ) );
160 
161  m_params.emplace_back( new PARAM<int>( "pcb_display.track_clearance_mode",
162  reinterpret_cast<int*>( &m_Display.m_ShowTrackClearanceMode ),
164 
165  m_params.emplace_back(
166  new PARAM<bool>( "pcb_display.track_fill", &m_Display.m_DisplayPcbTrackFill, true ) );
167 
168  m_params.emplace_back(
169  new PARAM<bool>( "pcb_display.via_fill", &m_Display.m_DisplayViaFill, true ) );
170 
171  m_params.emplace_back( new PARAM_ENUM<ZONE_DISPLAY_MODE>( "pcb_display.zone_mode",
174 
175  m_params.emplace_back( new PARAM<int>( "pcb_display.origin_mode",
176  reinterpret_cast<int*>( &m_Display.m_DisplayOrigin ),
178 
179  m_params.emplace_back(
180  new PARAM<bool>( "pcb_display.origin_invert_x_axis", &m_Display.m_DisplayInvertXAxis, false ) );
181 
182  m_params.emplace_back(
183  new PARAM<bool>( "pcb_display.origin_invert_y_axis", &m_Display.m_DisplayInvertYAxis, false ) );
184 
185  m_params.emplace_back(
186  new PARAM<double>( "plot.line_width", &m_PlotLineWidth, 0.1, 0.01, 5.0 ) );
187 
188  m_params.emplace_back( new PARAM<bool>( "cleanup.cleanup_vias",
189  &m_Cleanup.cleanup_vias, true ) );
190 
191  m_params.emplace_back( new PARAM<bool>( "cleanup.delete_dangling_vias",
192  &m_Cleanup.delete_dangling_vias, true ) );
193 
194  m_params.emplace_back( new PARAM<bool>( "cleanup.merge_segments",
195  &m_Cleanup.merge_segments, true ) );
196 
197  m_params.emplace_back( new PARAM<bool>( "cleanup.cleanup_unconnected",
198  &m_Cleanup.cleanup_unconnected, true ) );
199 
200  m_params.emplace_back( new PARAM<bool>( "cleanup.cleanup_short_circuits",
202 
203  m_params.emplace_back( new PARAM<bool>( "cleanup.cleanup_tracks_in_pad",
204  &m_Cleanup.cleanup_tracks_in_pad, true ) );
205 
206  m_params.emplace_back( new PARAM<bool>( "drc_dialog.refill_zones",
207  &m_DrcDialog.refill_zones, true ) );
208 
209  m_params.emplace_back( new PARAM<bool>( "drc_dialog.test_all_track_errors",
211 
212  m_params.emplace_back( new PARAM<bool>( "drc_dialog.test_footprints",
213  &m_DrcDialog.test_footprints, false ) );
214 
215  m_params.emplace_back( new PARAM<int>( "drc_dialog.severities",
217 
218  m_params.emplace_back( new PARAM<bool>( "gen_drill.merge_pth_npth",
219  &m_GenDrill.merge_pth_npth, false ) );
220 
221  m_params.emplace_back( new PARAM<bool>( "gen_drill.minimal_header",
222  &m_GenDrill.minimal_header, false ) );
223 
224  m_params.emplace_back( new PARAM<bool>( "gen_drill.mirror", &m_GenDrill.mirror, false ) );
225 
226  m_params.emplace_back( new PARAM<bool>( "gen_drill.unit_drill_is_inch",
227  &m_GenDrill.unit_drill_is_inch, true ) );
228 
229  m_params.emplace_back( new PARAM<bool>( "gen_drill.use_route_for_oval_holes",
231 
232  m_params.emplace_back( new PARAM<int>(
233  "gen_drill.drill_file_type", &m_GenDrill.drill_file_type, 0 ) );
234 
235  m_params.emplace_back( new PARAM<int>(
236  "gen_drill.map_file_type", &m_GenDrill.map_file_type, 1 ) );
237 
238  m_params.emplace_back( new PARAM<int>(
239  "gen_drill.zeros_format", &m_GenDrill.zeros_format, 0, 0, 3 ) );
240 
241  m_params.emplace_back(
242  new PARAM<bool>( "export_idf.auto_adjust", &m_ExportIdf.auto_adjust, false ) );
243 
244  m_params.emplace_back( new PARAM<int>( "export_idf.ref_units", &m_ExportIdf.ref_units, 0 ) );
245 
246  m_params.emplace_back( new PARAM<double>( "export_idf.ref_x", &m_ExportIdf.ref_x, 0 ) );
247 
248  m_params.emplace_back( new PARAM<double>( "export_idf.ref_y", &m_ExportIdf.ref_y, 0 ) );
249 
250  m_params.emplace_back(
251  new PARAM<bool>( "export_idf.units_mils", &m_ExportIdf.units_mils, false ) );
252 
253  m_params.emplace_back(
254  new PARAM<int>( "export_step.origin_mode", &m_ExportStep.origin_mode, 0 ) );
255 
256  m_params.emplace_back(
257  new PARAM<int>( "export_step.origin_units", &m_ExportStep.origin_units, 0 ) );
258 
259  m_params.emplace_back( new PARAM<double>( "export_step.origin_x", &m_ExportStep.origin_x, 0 ) );
260 
261  m_params.emplace_back( new PARAM<double>( "export_step.origin_y", &m_ExportStep.origin_y, 0 ) );
262 
263  m_params.emplace_back(
264  new PARAM<bool>( "export_step.no_virtual", &m_ExportStep.no_virtual, false ) );
265 
266  m_params.emplace_back(
267  new PARAM<bool>( "export_svg.black_and_white", &m_ExportSvg.black_and_white, false ) );
268 
269  m_params.emplace_back(
270  new PARAM<bool>( "export_svg.mirror", &m_ExportSvg.mirror, false ) );
271 
272  m_params.emplace_back( new PARAM<bool>( "export_svg.one_file", &m_ExportSvg.one_file, false ) );
273 
274  m_params.emplace_back(new PARAM<bool>(
275  "export_svg.plot_board_edges", &m_ExportSvg.plot_board_edges, true ) );
276 
277  m_params.emplace_back( new PARAM<int>( "export_svg.page_size", &m_ExportSvg.page_size, 0 ) );
278 
279  m_params.emplace_back(
280  new PARAM<wxString>( "export_svg.output_dir", &m_ExportSvg.output_dir, "" ) );
281 
282  m_params.emplace_back( new PARAM_LIST<int>( "export_svg.layers", &m_ExportSvg.layers, {} ) );
283 
284  m_params.emplace_back( new PARAM<int>( "export_vrml.units", &m_ExportVrml.units, 1 ) );
285 
286  m_params.emplace_back( new PARAM<bool>(
287  "export_vrml.copy_3d_models", &m_ExportVrml.copy_3d_models, false ) );
288 
289  m_params.emplace_back( new PARAM<bool>(
290  "export_vrml.use_relative_paths", &m_ExportVrml.use_relative_paths, false ) );
291 
292  m_params.emplace_back( new PARAM<bool>(
293  "export_vrml.use_plain_pcb", &m_ExportVrml.use_plain_pcb, false ) );
294 
295  m_params.emplace_back( new PARAM<int>( "export_vrml.ref_units", &m_ExportVrml.ref_units, 0 ) );
296 
297  m_params.emplace_back( new PARAM<double>( "export_vrml.ref_x", &m_ExportVrml.ref_x, 0 ) );
298 
299  m_params.emplace_back( new PARAM<double>( "export_vrml.ref_y", &m_ExportVrml.ref_y, 0 ) );
300 
301  m_params.emplace_back( new PARAM<int>( "zones.hatching_style", &m_Zones.hatching_style, 0 ) );
302 
303  m_params.emplace_back( new PARAM<wxString>( "zones.net_filter", &m_Zones.net_filter, "" ) );
304 
305  m_params.emplace_back( new PARAM<int>( "zones.net_sort_mode", &m_Zones.net_sort_mode, 1 ) );
306 
307  m_params.emplace_back(
308  new PARAM<double>( "zones.clearance", &m_Zones.clearance, ZONE_CLEARANCE_MIL ) );
309 
310  m_params.emplace_back( new PARAM<double>( "zones.min_thickness",
312 
313  m_params.emplace_back( new PARAM<double>( "zones.thermal_relief_gap",
315 
316  m_params.emplace_back( new PARAM<double>( "zones.thermal_relief_copper_width",
318 
319  m_params.emplace_back(
320  new PARAM<int>( "import_graphics.layer", &m_ImportGraphics.layer, Dwgs_User ) );
321 
322  m_params.emplace_back( new PARAM<bool>( "import_graphics.interactive_placement",
324 
325  m_params.emplace_back( new PARAM<int>(
326  "import_graphics.line_width_units", &m_ImportGraphics.line_width_units, 0 ) );
327 
328  m_params.emplace_back(
329  new PARAM<double>( "import_graphics.line_width", &m_ImportGraphics.line_width, 0.2 ) );
330 
331  m_params.emplace_back(
332  new PARAM<int>( "import_graphics.origin_units", &m_ImportGraphics.origin_units, 0 ) );
333 
334  m_params.emplace_back(
335  new PARAM<double>( "import_graphics.origin_x", &m_ImportGraphics.origin_x, 0 ) );
336 
337  m_params.emplace_back(
338  new PARAM<double>( "import_graphics.origin_y", &m_ImportGraphics.origin_y, 0 ) );
339 
340  m_params.emplace_back(
341  new PARAM<int>( "import_graphics.dxf_units", &m_ImportGraphics.dxf_units, 0 ) );
342 
343  m_params.emplace_back(
344  new PARAM<int>( "netlist.report_filter", &m_NetlistDialog.report_filter, -1 ) );
345 
346  m_params.emplace_back( new PARAM<bool>(
347  "netlist.update_footprints", &m_NetlistDialog.update_footprints, true ) );
348 
349  m_params.emplace_back( new PARAM<bool>(
350  "netlist.delete_shorting_tracks", &m_NetlistDialog.delete_shorting_tracks, false ) );
351 
352  m_params.emplace_back( new PARAM<bool>(
353  "netlist.delete_extra_footprints", &m_NetlistDialog.delete_extra_footprints, false ) );
354 
355  m_params.emplace_back( new PARAM<bool>(
356  "netlist.delete_single_pad_nets", &m_NetlistDialog.delete_single_pad_nets, false ) );
357 
358  m_params.emplace_back( new PARAM<bool>(
359  "netlist.associate_by_ref_sch", &m_NetlistDialog.associate_by_ref_sch, false ) );
360 
361  m_params.emplace_back(new PARAM<int>( "place_file.units", &m_PlaceFile.units, 1 ) );
362 
363  m_params.emplace_back(
364  new PARAM<int>( "place_file.file_options", &m_PlaceFile.file_options, 0 ) );
365 
366  m_params.emplace_back(
367  new PARAM<int>( "place_file.file_format", &m_PlaceFile.file_format, 0 ) );
368 
369  m_params.emplace_back( new PARAM<bool>(
370  "place_file.include_board_edge", &m_PlaceFile.include_board_edge, false ) );
371 
372  m_params.emplace_back( new PARAM<int>( "plot.all_layers_on_one_page",
374 
375  m_params.emplace_back(
376  new PARAM<int>( "plot.pads_drill_mode", &m_Plot.pads_drill_mode, 2 ) );
377 
378  m_params.emplace_back( new PARAM<double>( "plot.fine_scale_x", &m_Plot.fine_scale_x, 0 ) );
379 
380  m_params.emplace_back( new PARAM<double>( "plot.fine_scale_y", &m_Plot.fine_scale_y, 0 ) );
381 
382  m_params.emplace_back(
383  new PARAM<double>( "plot.ps_fine_width_adjust", &m_Plot.ps_fine_width_adjust, 0 ) );
384 
385  m_params.emplace_back( new PARAM<bool>( "plot.check_zones_before_plotting",
387 
388  m_params.emplace_back( new PARAM<bool>( "plot.mirror",
389  &m_Plot.mirror, false ) );
390 
391  m_params.emplace_back( new PARAM<wxString>( "window.footprint_text_shown_columns",
392  &m_FootprintTextShownColumns, "0 1 2 3 4 5 6" ) );
393 
394  m_params.emplace_back( new PARAM<int>( "footprint_wizard_list.width",
395  &m_FootprintWizardList.width, -1 ) );
396 
397  m_params.emplace_back( new PARAM<int>( "footprint_wizard_list.height",
398  &m_FootprintWizardList.height, -1 ) );
399 
400  m_params.emplace_back( new PARAM<bool>(
401  "reannotate_dialog.annotate_sort_on_modules", &m_Reannotate.sort_on_fp_location, true ) );
402  m_params.emplace_back( new PARAM<bool>(
403  "reannotate_dialog.annotate_remove_front_prefix", &m_Reannotate.remove_front_prefix, false ) );
404  m_params.emplace_back( new PARAM<bool>(
405  "reannotate_dialog.annotate_remove_back_prefix", &m_Reannotate.remove_back_prefix, false ) );
406  m_params.emplace_back( new PARAM<bool>(
407  "reannotate_dialog.annotate_update_schematic", &m_Reannotate.update_schematic, true ) );
408  m_params.emplace_back( new PARAM<bool>(
409  "reannotate_dialog.annotate_exclude_locked", &m_Reannotate.exclude_locked, false ) );
410 
411  m_params.emplace_back(
412  new PARAM<int>( "reannotate_dialog.annotate_grid_index", &m_Reannotate.grid_index, 0 ) );
413  m_params.emplace_back(
414  new PARAM<int>( "reannotate_dialog.annotate_sort_code", &m_Reannotate.sort_code, 0 ) );
415  m_params.emplace_back(
416  new PARAM<int>( "reannotate_dialog.annotate_choice", &m_Reannotate.annotation_choice, 0 ) );
417  m_params.emplace_back( new PARAM<int>(
418  "reannotate_dialog.annotate_report_severity", &m_Reannotate.report_severity, 0 ) );
419 
420  m_params.emplace_back( new PARAM<wxString>(
421  "reannotate_dialog.annotate_front_refdes_start", &m_Reannotate.front_refdes_start, "1" ) );
422  m_params.emplace_back( new PARAM<wxString>(
423  "reannotate_dialog.annotate_back_refdes_start", &m_Reannotate.back_refdes_start, "" ) );
424  m_params.emplace_back( new PARAM<wxString>(
425  "reannotate_dialog.annotate_front_prefix", &m_Reannotate.front_prefix, "" ) );
426  m_params.emplace_back(
427  new PARAM<wxString>( "reannotate_dialog.annotate_back_prefix", &m_Reannotate.back_prefix, "" ) );
428  m_params.emplace_back( new PARAM<wxString>(
429  "reannotate_dialog.annotate_exclude_list", &m_Reannotate.exclude_list, "" ) );
430  m_params.emplace_back( new PARAM<wxString>(
431  "reannotate_dialog.annotate_report_file_name", &m_Reannotate.report_file_name, "" ) );
432 
433 #if defined(KICAD_SCRIPTING) && defined(KICAD_SCRIPTING_ACTION_MENU)
434  m_params.emplace_back( new PARAM_LAMBDA<nlohmann::json>( "action_plugins",
435  [&]() -> nlohmann::json
436  {
437  nlohmann::json js = nlohmann::json::array();
438 
439  for( const auto& pair : m_VisibleActionPlugins )
440  js.push_back( nlohmann::json( { { pair.first.ToUTF8(), pair.second } } ) );
441 
442  return js;
443  },
444  [&]( const nlohmann::json& aObj )
445  {
446  m_VisibleActionPlugins.clear();
447 
448  if( !aObj.is_array() )
449  {
450  return;
451  }
452 
453  for( const auto& entry : aObj )
454  {
455  if( entry.empty() || !entry.is_object() )
456  continue;
457 
458  for( const auto& pair : entry.items() )
459  {
460  m_VisibleActionPlugins.emplace_back( std::make_pair(
461  wxString( pair.key().c_str(), wxConvUTF8 ), pair.value() ) );
462  }
463  }
464  },
465  nlohmann::json::array() ) );
466 #endif
467 
468  addParamsForWindow( &m_FootprintViewer, "footprint_viewer" );
469 
470  m_params.emplace_back( new PARAM<bool>( "footprint_viewer.auto_zoom",
471  &m_FootprintViewerAutoZoom, false ) );
472 
473  m_params.emplace_back( new PARAM<double>( "footprint_viewer.zoom",
474  &m_FootprintViewerZoom, 1.0 ) );
475 
476  addParamsForWindow( &m_FootprintWizard, "footprint_wizard" );
477 
478  m_params.emplace_back( new PARAM<wxString>( "system.last_footprint_lib_dir",
479  &m_lastFootprintLibDir, "" ) );
480 
481  m_params.emplace_back( new PARAM<wxString>( "system.last_footprint3d_dir",
482  &m_lastFootprint3dDir, "" ) );
483 }
484 
485 
487 
488 
489 bool PCBNEW_SETTINGS::MigrateFromLegacy( wxConfigBase* aCfg )
490 {
491  bool ret = APP_SETTINGS_BASE::MigrateFromLegacy( aCfg );
492 
493  const std::string f = getLegacyFrameName();
494 
495  //
496  // NOTE: there's no value in line-wrapping these; it just makes the table unreadable.
497  //
498  ret &= fromLegacy<bool>( aCfg, "ShowLayerManagerTools", "aui.show_layer_manager" );
499 
500  ret &= fromLegacy<int>( aCfg, "FootprintChooserHSashPosition", "footprint_chooser.sash_h" );
501  ret &= fromLegacy<int>( aCfg, "FootprintChooserVSashPosition", "footprint_chooser.sash_v" );
502  ret &= fromLegacy<int>( aCfg, "FootprintChooserWidth", "footprint_chooser.width" );
503  ret &= fromLegacy<int>( aCfg, "FootprintChooserHeight", "footprint_chooser.height" );
504 
505  ret &= fromLegacy<bool>( aCfg, "FlipLeftRight", "editing.flip_left_right" );
506  ret &= fromLegacy<bool>( aCfg, "MagneticGraphics", "editing.magnetic_graphics" );
507  ret &= fromLegacy<int>( aCfg, "MagneticPads", "editing.magnetic_pads" );
508  ret &= fromLegacy<int>( aCfg, "MagneticTracks", "editing.magnetic_tracks" );
509  ret &= fromLegacy<bool>( aCfg, "DisplayPolarCoords", "editing.polar_coords" );
510  ret &= fromLegacy<bool>( aCfg, "Use45DegreeGraphicSegments",
511  "editing.use_45_degree_graphic_segments" );
512 
513  ret &= fromLegacy<bool>( aCfg, "PcbAffT", "pcb_display.graphic_items_fill" );
514  ret &= fromLegacy<int>( aCfg, "MaxLnkS", "pcb_display.max_links_shown" );
515  ret &= fromLegacy<bool>( aCfg, "ModAffC", "pcb_display.footprint_edge_fill" );
516  ret &= fromLegacy<bool>( aCfg, "ModAffT", "pcb_display.footprint_text_fill" );
517  ret &= fromLegacy<int>( aCfg, "ShowNetNamesMode", "pcb_display.net_names_mode" );
518  ret &= fromLegacy<int>( aCfg, "PcbDisplayOrigin", "pcb_display.origin_mode" );
519  ret &= fromLegacy<bool>( aCfg, "PcbInvertXAxis", "pcb_display.origin_invert_x_axis" );
520  ret &= fromLegacy<bool>( aCfg, "PcbInvertYAxis", "pcb_display.origin_invert_y_axis" );
521  ret &= fromLegacy<bool>( aCfg, "PadAffG", "pcb_display.pad_clearance" );
522  ret &= fromLegacy<bool>( aCfg, "PadFill", "pcb_display.pad_fill" );
523  ret &= fromLegacy<bool>( aCfg, "PadSNum", "pcb_display.pad_numbers" );
524  ret &= fromLegacy<bool>( aCfg, "ShowRatsnestLines", "pcb_display.ratsnest_global" );
525  ret &= fromLegacy<bool>( aCfg, "ShowRatsnestModuleLines", "pcb_display.ratsnest_footprint" );
526  ret &= fromLegacy<bool>( aCfg, "CurvedRatsnestLines", "pcb_display.ratsnest_curved" );
527  ret &= fromLegacy<int>( aCfg, "RotationAngle", "pcb_display.rotation_angle" );
528  ret &= fromLegacy<int>( aCfg, "TrackDisplayClearance", "pcb_display.track_clearance_mode" );
529  ret &= fromLegacy<bool>( aCfg, "DisplayTrackFilled", "pcb_display.track_fill" );
530  ret &= fromLegacy<bool>( aCfg, "ViaFill", "pcb_display.via_fill" );
531  ret &= fromLegacy<int>( aCfg, "PcbShowZonesMode", "pcb_display.zone_mode" );
532 
533  ret &= fromLegacy<double>( aCfg, "PlotLineWidth_mm", "plot.line_width" );
534 
535  aCfg->SetPath( "/dialogs/cleanup_tracks" );
536  ret &= fromLegacy<bool>( aCfg, "DialogCleanupVias", "cleanup.cleanup_vias" );
537  ret &= fromLegacy<bool>( aCfg, "DialogCleanupMergeSegments", "cleanup.merge_segments" );
538  ret &= fromLegacy<bool>( aCfg, "DialogCleanupUnconnected", "cleanup.cleanup_unconnected" );
539  ret &= fromLegacy<bool>( aCfg, "DialogCleanupShortCircuit", "cleanup.cleanup_short_circuits" );
540  ret &= fromLegacy<bool>( aCfg, "DialogCleanupTracksInPads", "cleanup.cleanup_tracks_in_pad" );
541  aCfg->SetPath( "../.." );
542 
543  ret &= fromLegacy<bool>( aCfg, "RefillZonesBeforeDrc", "drc_dialog.refill_zones" );
544  ret &= fromLegacy<bool>( aCfg, "DrcTestFootprints", "drc_dialog.test_footprints" );
545 
546  ret &= fromLegacy<bool>( aCfg, "DrillMergePTHNPTH", "gen_drill.merge_pth_npth" );
547  ret &= fromLegacy<bool>( aCfg, "DrillMinHeader", "gen_drill.minimal_header" );
548  ret &= fromLegacy<bool>( aCfg, "DrillMirrorYOpt", "gen_drill.mirror" );
549  ret &= fromLegacy<bool>( aCfg, "DrillUnit", "gen_drill.unit_drill_is_inch" );
550  ret &= fromLegacy<bool>( aCfg, "OvalHolesRouteMode", "gen_drill.use_route_for_oval_holes" );
551  ret &= fromLegacy<int>( aCfg, "DrillFileType", "gen_drill.drill_file_type" );
552  ret &= fromLegacy<int>( aCfg, "DrillMapFileType", "gen_drill.map_file_type" );
553  ret &= fromLegacy<int>( aCfg, "DrillZerosFormat", "gen_drill.zeros_format" );
554 
555  ret &= fromLegacy<bool>( aCfg, "IDFRefAutoAdj", "export_idf.auto_adjust" );
556  ret &= fromLegacy<int>( aCfg, "IDFRefUnits", "export_idf.ref_units" );
557  ret &= fromLegacy<double>( aCfg, "IDFRefX", "export_idf.ref_x" );
558  ret &= fromLegacy<double>( aCfg, "IDFRefY", "export_idf.ref_y" );
559  ret &= fromLegacy<bool>( aCfg, "IDFExportThou", "export_idf.units_mils" );
560 
561  ret &= fromLegacy<int>( aCfg, "STEP_Origin_Opt", "export_step.origin_mode" );
562  ret &= fromLegacy<int>( aCfg, "STEP_UserOriginUnits", "export_step.origin_units" );
563  ret &= fromLegacy<double>( aCfg, "STEP_UserOriginX", "export_step.origin_x" );
564  ret &= fromLegacy<double>( aCfg, "STEP_UserOriginY", "export_step.origin_y" );
565  ret &= fromLegacy<bool>( aCfg, "STEP_NoVirtual", "export_step.no_virtual" );
566 
567  ret &= fromLegacy<bool>( aCfg, "PlotSVGModeColor", "export_svg.black_and_white" );
568  ret &= fromLegacy<bool>( aCfg, "PlotSVGModeMirror", "export_svg.mirror" );
569  ret &= fromLegacy<bool>( aCfg, "PlotSVGModeOneFile", "export_svg.one_file" );
570  ret &= fromLegacy<bool>( aCfg, "PlotSVGBrdEdge", "export_svg.plot_board_edges" );
571  ret &= fromLegacy<int>( aCfg, "PlotSVGPageOpt", "export_svg.page_size" );
572  ret &= fromLegacyString( aCfg, "PlotSVGDirectory", "export_svg.output_dir" );
573 
574  {
575  nlohmann::json js = nlohmann::json::array();
576  wxString key;
577  bool val = false;
578 
579  for( unsigned i = 0; i < PCB_LAYER_ID_COUNT; ++i )
580  {
581  key.Printf( wxT( "PlotSVGLayer_%d" ), i );
582 
583  if( aCfg->Read( key, &val ) && val )
584  js.push_back( i );
585  }
586 
587  ( *this )[PointerFromString( "export_svg.layers" ) ] = js;
588  }
589 
590  {
591  nlohmann::json js = nlohmann::json::array();
592 
593  wxString packed;
594 
595  if( aCfg->Read( "ActionPluginButtons", &packed ) )
596  {
597  wxStringTokenizer pluginSettingsTokenizer = wxStringTokenizer( packed, ";" );
598 
599  while( pluginSettingsTokenizer.HasMoreTokens() )
600  {
601  nlohmann::json row;
602  wxString plugin = pluginSettingsTokenizer.GetNextToken();
603  wxStringTokenizer pluginTokenizer = wxStringTokenizer( plugin, "=" );
604 
605  if( pluginTokenizer.CountTokens() != 2 )
606  {
607  // Bad config
608  continue;
609  }
610 
611  std::string key( pluginTokenizer.GetNextToken().ToUTF8() );
612 
613  js.push_back( nlohmann::json( {
614  { key, pluginTokenizer.GetNextToken().Cmp( wxT( "Visible" ) ) == 0 } } ) );
615  }
616  }
617 
618  ( *this )[PointerFromString( "action_plugins" ) ] = js;
619  }
620 
621  //
622  // NOTE: there's no value in line-wrapping these; it just makes the table unreadable.
623  //
624  ret &= fromLegacy<int>( aCfg, "VrmlExportUnit", "export_vrml.units" );
625  ret &= fromLegacy<bool>( aCfg, "VrmlExportCopyFiles", "export_vrml.copy_3d_models" );
626  ret &= fromLegacy<bool>( aCfg, "VrmlUseRelativePaths", "export_vrml.use_relative_paths" );
627  ret &= fromLegacy<bool>( aCfg, "VrmlUsePlainPCB", "export_vrml.use_plain_pcb" );
628  ret &= fromLegacy<int>( aCfg, "VrmlRefUnits", "export_vrml.ref_units" );
629  ret &= fromLegacy<double>( aCfg, "VrmlRefX", "export_vrml.ref_x" );
630  ret &= fromLegacy<double>( aCfg, "VrmlRefY", "export_vrml.ref_y" );
631 
632  ret &= fromLegacy<int>( aCfg, "Zone_Ouline_Hatch_Opt", "zones.hatching_style" );
633  ret &= fromLegacyString( aCfg, "Zone_Filter_Opt", "zones.net_filter" );
634  ret &= fromLegacy<int>( aCfg, "Zone_NetSort_Opt", "zones.net_sort_mode" );
635  ret &= fromLegacy<double>( aCfg, "Zone_Clearance", "zones.clearance" );
636  ret &= fromLegacy<double>( aCfg, "Zone_Thickness", "zones.min_thickness" );
637  ret &= fromLegacy<double>( aCfg, "Zone_TH_Gap", "zones.thermal_relief_gap" );
638  ret &= fromLegacy<double>( aCfg, "Zone_TH_Copper_Width", "zones.thermal_relief_copper_width" );
639 
640  aCfg->SetPath( "ImportGraphics" );
641  ret &= fromLegacy<int>( aCfg, "BoardLayer", "import_graphics.layer" );
642  ret &= fromLegacy<bool>( aCfg, "InteractivePlacement", "import_graphics.interactive_placement" );
643  ret &= fromLegacyString( aCfg, "LastFile", "import_graphics.last_file" );
644  ret &= fromLegacy<double>( aCfg, "LineWidth", "import_graphics.line_width" );
645  ret &= fromLegacy<int>( aCfg, "LineWidthUnits", "import_graphics.line_width_units" );
646  ret &= fromLegacy<int>( aCfg, "PositionUnits", "import_graphics.origin_units" );
647  ret &= fromLegacy<double>( aCfg, "PositionX", "import_graphics.origin_x" );
648  ret &= fromLegacy<double>( aCfg, "PositionY", "import_graphics.origin_y" );
649  aCfg->SetPath( ".." );
650 
651  ret &= fromLegacy<int>( aCfg, "NetlistReportFilterMsg", "netlist.report_filter" );
652  ret &= fromLegacy<bool>( aCfg, "NetlistUpdateFootprints", "netlist.update_footprints" );
653  ret &= fromLegacy<bool>( aCfg, "NetlistDeleteShortingTracks", "netlist.delete_shorting_tracks" );
654  ret &= fromLegacy<bool>( aCfg, "NetlistDeleteExtraFootprints", "netlist.delete_extra_footprints" );
655  ret &= fromLegacy<bool>( aCfg, "NetlistDeleteSinglePadNets", "netlist.delete_single_pad_nets" );
656 
657  ret &= fromLegacy<int>( aCfg, "PlaceFileUnits", "place_file.units" );
658  ret &= fromLegacy<int>( aCfg, "PlaceFileOpts", "place_file.file_options" );
659  ret &= fromLegacy<int>( aCfg, "PlaceFileFormat", "place_file.file_format" );
660  ret &= fromLegacy<bool>( aCfg, "PlaceFileIncludeBrdEdge", "place_file.include_board_edge" );
661 
662  ret &= fromLegacy<int>( aCfg, "PrintSinglePage", "plot.all_layers_on_one_page" );
663  ret &= fromLegacy<int>( aCfg, "PrintPadsDrillOpt", "plot.pads_drill_mode" );
664  ret &= fromLegacy<double>( aCfg, "PlotXFineScaleAdj", "plot.fine_scale_x" );
665  ret &= fromLegacy<double>( aCfg, "PlotYFineScaleAdj", "plot.fine_scale_y" );
666  ret &= fromLegacy<double>( aCfg, "PSPlotFineWidthAdj", "plot.ps_fine_width_adjust" );
667  ret &= fromLegacy<bool>( aCfg, "CheckZonesBeforePlotting", "plot.check_zones_before_plotting" );
668 
669  ret &= fromLegacyString( aCfg, "FootprintTextShownColumns", "window.footprint_text_shown_columns" );
670 
671  ret &= fromLegacy<int>( aCfg, "FpWizardListWidth", "footprint_wizard_list.width" );
672  ret &= fromLegacy<int>( aCfg, "FpWizardListHeight", "footprint_wizard_list.height" );
673 
674  migrateWindowConfig( aCfg, "ModViewFrame", "footprint_viewer" );
675 
676  ret &= fromLegacy<bool>( aCfg, "ModViewFrameAutoZoom", "footprint_viewer.auto_zoom" );
677  ret &= fromLegacy<double>( aCfg, "ModViewFrameZoom", "footprint_viewer.zoom" );
678 
679  migrateWindowConfig( aCfg, "FootprintWizard", "footprint_wizard" );
680  ret &= fromLegacyString( aCfg, "Fpwizard_auiPerspective", "footprint_wizard.perspective" );
681 
682 
683  const std::string p = "pcbnew.InteractiveRouter.";
684 
685  ( *this )[PointerFromString( "tools.pns.meta" )] = nlohmann::json( {
686  { "filename", "pns" },
687  { "version", 0 }
688  } );
689 
690  ret &= fromLegacy<int>( aCfg, p + "Mode", "tools.pns.mode" );
691  ret &= fromLegacy<int>( aCfg, p + "OptimizerEffort", "tools.pns.effort" );
692  ret &= fromLegacy<bool>( aCfg, p + "RemoveLoops", "tools.pns.remove_loops" );
693  ret &= fromLegacy<bool>( aCfg, p + "SmartPads", "tools.pns.smart_pads" );
694  ret &= fromLegacy<bool>( aCfg, p + "ShoveVias", "tools.pns.shove_vias" );
695  ret &= fromLegacy<bool>( aCfg, p + "StartDiagonal", "tools.pns.start_diagonal" );
696  ret &= fromLegacy<int>( aCfg, p + "ShoveTimeLimit", "tools.pns.shove_time_limit" );
697  ret &= fromLegacy<int>( aCfg, p + "ShoveIterationLimit", "tools.pns.shove_iteration_limit" );
698  ret &= fromLegacy<int>( aCfg, p + "WalkaroundIterationLimit", "tools.pns.walkaround_iteration_limit" );
699  ret &= fromLegacy<bool>( aCfg, p + "JumpOverObstacles", "tools.pns.jump_over_obstacles" );
700  ret &= fromLegacy<bool>( aCfg, p + "SmoothDraggedSegments", "tools.pns.smooth_dragged_segments" );
701  ret &= fromLegacy<bool>( aCfg, p + "CanViolateDRC", "tools.pns.can_violate_drc" );
702  ret &= fromLegacy<bool>( aCfg, p + "SuggestFinish", "tools.pns.suggest_finish" );
703  ret &= fromLegacy<bool>( aCfg, p + "FreeAngleMode", "tools.pns.free_angle_mode" );
704  ret &= fromLegacy<bool>( aCfg, p + "InlineDragEnabled", "tools.pns.inline_drag" );
705 
706  // Migrate color settings that were stored in the pcbnew config file
707 
708  COLOR_SETTINGS* cs = Pgm().GetSettingsManager().GetMigratedColorSettings();
709 
710  auto migrateLegacyColor = [&] ( const std::string& aKey, int aLayerId ) {
711  wxString str;
712 
713  if( aCfg->Read( aKey, &str ) )
714  cs->SetColor( aLayerId, COLOR4D( str ) );
715  };
716 
717  for( int i = 0; i < PCB_LAYER_ID_COUNT; ++i )
718  {
719  wxString layer = LSET::Name( PCB_LAYER_ID( i ) );
720  migrateLegacyColor( "Color4DPCBLayer_" + layer.ToStdString(), PCB_LAYER_ID( i ) );
721  }
722 
723  migrateLegacyColor( "Color4DAnchorEx", LAYER_ANCHOR );
724  migrateLegacyColor( "Color4DAuxItems", LAYER_AUX_ITEMS );
725  migrateLegacyColor( "Color4DGrid", LAYER_GRID );
726  migrateLegacyColor( "Color4DNoNetPadMarker", LAYER_NO_CONNECTS );
727  migrateLegacyColor( "Color4DNonPlatedEx", LAYER_NON_PLATEDHOLES );
728  migrateLegacyColor( "Color4DPadBackEx", LAYER_PAD_BK );
729  migrateLegacyColor( "Color4DPadFrontEx", LAYER_PAD_FR );
730  migrateLegacyColor( "Color4DPadThruHoleEx", LAYER_PADS_TH );
731  migrateLegacyColor( "Color4DPCBBackground", LAYER_PCB_BACKGROUND );
732  migrateLegacyColor( "Color4DPCBCursor", LAYER_CURSOR );
733  migrateLegacyColor( "Color4DRatsEx", LAYER_RATSNEST );
734  migrateLegacyColor( "Color4DTxtInvisEx", LAYER_MOD_TEXT_INVISIBLE );
735  migrateLegacyColor( "Color4DViaBBlindEx", LAYER_VIA_BBLIND );
736  migrateLegacyColor( "Color4DViaMicroEx", LAYER_VIA_MICROVIA );
737  migrateLegacyColor( "Color4DViaThruEx", LAYER_VIA_THROUGH );
738  migrateLegacyColor( "Color4DWorksheet", LAYER_WORKSHEET );
739 
740  Pgm().GetSettingsManager().SaveColorSettings( cs, "board" );
741 
742  ( *this )[PointerFromString( "appearance.color_theme" )] = cs->GetFilename();
743 
744  double x, y;
745 
746  if( aCfg->Read( f + "PcbUserGrid_X", &x ) && aCfg->Read( f + "PcbUserGrid_Y", &y ) )
747  {
748  EDA_UNITS u = static_cast<EDA_UNITS>( aCfg->ReadLong( f + "PcbUserGrid_Unit",
749  static_cast<long>( EDA_UNITS::INCHES ) ) );
750 
751  // Convert to internal units
752  x = From_User_Unit( u, x );
753  y = From_User_Unit( u, y );
754 
755  ( *this )[PointerFromString( "window.grid.user_grid_x" )] = StringFromValue( u, x );
756  ( *this )[PointerFromString( "window.grid.user_grid_y" )] = StringFromValue( u, y );
757  }
758 
759  // Footprint editor settings were stored in pcbnew config file. Migrate them here.
760  auto fpedit = Pgm().GetSettingsManager().GetAppSettings<FOOTPRINT_EDITOR_SETTINGS>( false );
761  fpedit->MigrateFromLegacy( aCfg );
762  fpedit->Load();
763 
764  // Same with 3D viewer
765  auto viewer3d = Pgm().GetSettingsManager().GetAppSettings<EDA_3D_VIEWER_SETTINGS>( false );
766  viewer3d->MigrateFromLegacy( aCfg );
767  viewer3d->Load();
768 
769  return ret;
770 }
DIALOG_GENERATE_DRILL m_GenDrill
Filled polygons are shown.
void addParamsForWindow(WINDOW_SETTINGS *aWindow, const std::string &aJsonPath)
Adds parameters for the given window object.
to draw blind/buried vias
show a marker on pads with no nets
DIALOG_EXPORT_STEP m_ExportStep
std::vector< PARAM_BASE * > m_params
The list of parameters (owned by this object)
DIALOG_CLEANUP m_Cleanup
multilayer pads, usually with holes
Implementation of conversion functions that require both schematic and board internal units.
virtual bool MigrateFromLegacy(wxConfigBase *aCfg) override
Migrates from wxConfig to JSON-based configuration.
handle color for not plated holes (holes, not pads)
anchor of items having an anchor point (texts, footprints)
DIALOG_EXPORT_IDF m_ExportIdf
wxString GetFilename() const
Definition: json_settings.h:64
Stores an enum as an integer.
Definition: parameters.h:226
const int pcbnewSchemaVersion
! Update the schema version whenever a migration is required
#define ZONE_THERMAL_RELIEF_COPPER_WIDTH_MIL
Definition: zones.h:30
double m_FootprintViewerZoom
The last zoom level in the footprint viewer.
wxString m_FootprintTextShownColumns
DIALOG_EXPORT_VRML m_ExportVrml
KIWAY Kiway & Pgm(), KFCTL_STANDALONE
The global Program "get" accessor.
Definition: single_top.cpp:102
nlohmann::json json
Definition: gerbview.cpp:39
FOOTPRINT_CHOOSER m_FootprintChooser
TRACK_DRAG_ACTION
TRACE_CLEARANCE_DISPLAY_MODE_T m_ShowTrackClearanceMode
How trace clearances are displayed.
DIALOG_FOOTPRINT_WIZARD_LIST m_FootprintWizardList
bool m_Use45DegreeGraphicSegments
wxString m_lastFootprint3dDir
WINDOW_SETTINGS m_FootprintWizard
PCB_LAYER_ID
A quick note on layer IDs:
DIALOG_EXPORT_SVG m_ExportSvg
Auxiliary items (guides, rule, etc)
APP_SETTINGS_BASE is a settings class that should be derived for each standalone KiCad application.
Definition: app_settings.h:99
PCB_DISPLAY_ORIGIN_OPTIONS_T m_DisplayOrigin
Which origin is used for display transforms.
TRACK_DRAG_ACTION m_TrackDragAction
virtual bool MigrateFromLegacy(wxConfigBase *aLegacyConfig) override
Migrates from wxConfig to JSON-based configuration.
static const wxChar * Name(PCB_LAYER_ID aLayerId)
Return the fixed name association with aLayerId.
Definition: lset.cpp:82
DIALOG_NETLIST m_NetlistDialog
to draw usual through hole vias
virtual bool MigrateFromLegacy(wxConfigBase *aLegacyConfig) override
Migrates from wxConfig to JSON-based configuration.
Functions to provide common constants and other functions to assist in making a consistent UI.
#define ZONE_CLEARANCE_MIL
Definition: zones.h:33
WINDOW_SETTINGS m_FootprintViewer
#define ZONE_THICKNESS_MIL
Definition: zones.h:31
virtual std::string getLegacyFrameName() const override
EDA_UNITS
Definition: eda_units.h:38
DIALOG_PLACE_FILE m_PlaceFile
bool fromLegacyString(wxConfigBase *aConfig, const std::string &aKey, const std::string &aDest)
Translates a legacy wxConfig string value to a given JSON pointer value.
smd pads, front layer
see class PGM_BASE
virtual ~PCBNEW_SETTINGS()
Board layer functions and definitions.
MAGNETIC_OPTIONS pads
ZONE_DISPLAY_MODE m_ZoneDisplayMode
AUI_PANELS m_AuiPanels
The common library.
DIALOG_PLOT m_Plot
DIALOG_REANNOTATE m_Reannotate
virtual bool MigrateFromLegacy(wxConfigBase *aLegacyConfig) override
Migrates from wxConfig to JSON-based configuration.
wxString StringFromValue(EDA_UNITS aUnits, double aValue, bool aAddUnitSymbol, EDA_DATA_TYPE aType)
Function StringFromValue returns the string from aValue according to units (inch, mm ....
Definition: base_units.cpp:220
DIALOG_IMPORT_GRAPHICS m_ImportGraphics
Color settings are a bit different than most of the settings objects in that there can be more than o...
#define ZONE_THERMAL_RELIEF_GAP_MIL
Definition: zones.h:29
DIALOG_DRC m_DrcDialog
MAGNETIC_SETTINGS m_MagneticItems
wxString m_lastFootprintLibDir
bool m_FootprintViewerAutoZoom
Should the footprint viewer auto zoom on select.
PCB_DISPLAY_OPTIONS m_Display
static nlohmann::json::json_pointer PointerFromString(std::string aPath)
Builds a JSON pointer based on a given string.
double From_User_Unit(EDA_UNITS aUnits, double aValue)
Return in internal units the value "val" given in a real unit such as "in", "mm" or "deg".
Definition: base_units.cpp:308
bool migrateWindowConfig(wxConfigBase *aCfg, const std::string &aFrameName, const std::string &aJsonPath)
Migrates legacy window settings into the JSON document.
Outlines of filled polygons are shown.
MAGNETIC_OPTIONS tracks
void SetColor(int aLayer, COLOR4D aColor)
COLOR4D is the color representation with 4 components: red, green, blue, alpha.
Definition: color4d.h:100