KiCad PCB EDA Suite
footprint_editor_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 Jon Evans <jon@craftyjon.com>
5  * Copyright (C) 2020 KiCad Developers, see AUTHORS.txt for contributors.
6  *
7  * This program is free software: you can redistribute it and/or modify it
8  * under the terms of the GNU General Public License as published by the
9  * Free Software Foundation, either version 3 of the License, or (at your
10  * option) any later version.
11  *
12  * This program is distributed in the hope that it will be useful, but
13  * WITHOUT ANY WARRANTY; without even the implied warranty of
14  * MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the GNU
15  * General Public License for more details.
16  *
17  * You should have received a copy of the GNU General Public License along
18  * with this program. If not, see <http://www.gnu.org/licenses/>.
19  */
20 
21 #include <common.h>
24 #include <pgm_base.h>
26 #include <settings/parameters.h>
28 #include <wx/config.h>
29 #include <base_units.h>
30 #include <widgets/ui_common.h>
31 
32 
34 const int fpEditSchemaVersion = 1;
35 
36 
39  m_DesignSettings( nullptr, "fpedit.settings" ),
40  m_MagneticItems(),
41  m_Display(),
42  m_UserGrid(),
43  m_PolarCoords( false ),
44  m_Use45DegreeGraphicSegments( true ),
45  m_LibWidth( 250 ),
46  m_LastImportExportPath(),
47  m_FootprintTextShownColumns()
48 {
52 
53  m_params.emplace_back( new PARAM<int>( "window.lib_width",
54  &m_LibWidth, 250 ) );
55 
56  m_params.emplace_back( new PARAM<wxString>( "system.last_import_export_path",
57  &m_LastImportExportPath, "" ) );
58 
59  m_params.emplace_back( new PARAM<wxString>( "window.footprint_text_shown_columns",
60  &m_FootprintTextShownColumns, "0 1 2 3 4 5 6" ) );
61 
62  m_params.emplace_back( new PARAM<int>( "editing.magnetic_pads",
63  reinterpret_cast<int*>( &m_MagneticItems.pads ),
64  static_cast<int>( MAGNETIC_OPTIONS::CAPTURE_ALWAYS ) ) );
65 
66  m_params.emplace_back( new PARAM<bool>( "editing.magnetic_graphics",
67  &m_MagneticItems.graphics, true ) );
68 
69  m_params.emplace_back( new PARAM<bool>( "editing.polar_coords", &m_PolarCoords, false ) );
70 
71  m_params.emplace_back( new PARAM<bool>( "editing.use_45_degree_graphic_segments",
72  &m_Use45DegreeGraphicSegments, false ) );
73 
74  m_params.emplace_back( new PARAM<bool>( "pcb_display.text_fill",
75  &m_Display.m_DisplayTextFill, true ) );
76 
77  m_params.emplace_back( new PARAM<bool>( "pcb_display.graphic_items_fill",
79 
80  m_params.emplace_back( new PARAM<bool>( "pcb_display.pad_fill",
81  &m_Display.m_DisplayPadFill, true ) );
82 
83  m_params.emplace_back( new PARAM_LAYER_PRESET( "pcb_display.layer_presets", &m_LayerPresets ) );
84 
85  m_params.emplace_back( new PARAM<wxString>( "pcb_display.active_layer_preset",
86  &m_ActiveLayerPreset, "" ) );
87 
88  m_params.emplace_back( new PARAM_LAMBDA<nlohmann::json>(
89  "design_settings.default_footprint_text_items",
90  [&] () -> nlohmann::json
91  {
92  nlohmann::json js = nlohmann::json::array();
93 
95  {
96  js.push_back( nlohmann::json( { item.m_Text.ToUTF8(),
97  item.m_Visible,
98  item.m_Layer } ) );
99  }
100 
101  return js;
102  },
103  [&] ( const nlohmann::json& aObj )
104  {
106 
107  if( !aObj.is_array() )
108  return;
109 
110  for( const nlohmann::json& entry : aObj )
111  {
112  if( entry.empty() || !entry.is_array() )
113  continue;
114 
115  TEXT_ITEM_INFO textInfo( wxT( "" ), true, F_SilkS );
116 
117  textInfo.m_Text = entry.at(0).get<wxString>();
118  textInfo.m_Visible = entry.at(1).get<bool>();
119  textInfo.m_Layer = entry.at(2).get<int>();
120 
121  m_DesignSettings.m_DefaultFPTextItems.push_back( std::move( textInfo ) );
122  }
123  },
124  nlohmann::json::array( {
125  { "REF**", true, F_SilkS },
126  { "", true, F_Fab },
127  { "${REFERENCE}", true, F_Fab }
128  } ) ) );
129 
130  m_params.emplace_back( new PARAM_SCALED<int>( "design_settings.silk_line_width",
133  MM_PER_IU ) );
134 
135  m_params.emplace_back( new PARAM_SCALED<int>( "design_settings.silk_text_size_h",
138 
139  m_params.emplace_back( new PARAM_SCALED<int>( "design_settings.silk_text_size_v",
142 
143  m_params.emplace_back( new PARAM_SCALED<int>( "design_settings.silk_text_thickness",
146 
147  m_params.emplace_back( new PARAM<bool>( "design_settings.silk_text_italic",
149 
150  m_params.emplace_back( new PARAM_SCALED<int>( "design_settings.copper_line_width",
153  MM_PER_IU ) );
154 
155  m_params.emplace_back( new PARAM_SCALED<int>( "design_settings.copper_text_size_h",
158  MM_PER_IU ) );
159 
160  m_params.emplace_back( new PARAM_SCALED<int>( "design_settings.copper_text_size_v",
163  MM_PER_IU ) );
164 
165  m_params.emplace_back( new PARAM_SCALED<int>( "design_settings.copper_text_thickness",
168  MM_PER_IU ) );
169 
170  m_params.emplace_back( new PARAM<bool>( "design_settings.copper_text_italic",
172 
173  m_params.emplace_back( new PARAM_SCALED<int>( "design_settings.edge_line_width",
176  MM_PER_IU ) );
177 
178  m_params.emplace_back( new PARAM_SCALED<int>( "design_settings.courtyard_line_width",
181  MM_PER_IU ) );
182 
183  m_params.emplace_back( new PARAM_SCALED<int>( "design_settings.fab_line_width",
186  MM_PER_IU ) );
187 
188  m_params.emplace_back( new PARAM_SCALED<int>( "design_settings.fab_text_size_h",
191 
192  m_params.emplace_back( new PARAM_SCALED<int>( "design_settings.fab_text_size_v",
195 
196  m_params.emplace_back( new PARAM_SCALED<int>( "design_settings.fab_text_thickness",
198  Millimeter2iu( DEFAULT_TEXT_WIDTH ), 1, TEXTS_MAX_WIDTH, MM_PER_IU ) );
199 
200  m_params.emplace_back( new PARAM<bool>( "design_settings.fab_text_italic",
202 
203  m_params.emplace_back( new PARAM_SCALED<int>( "design_settings.others_line_width",
206  MM_PER_IU ) );
207 
208  m_params.emplace_back( new PARAM_SCALED<int>( "design_settings.others_text_size_h",
211 
212  m_params.emplace_back( new PARAM_SCALED<int>( "design_settings.others_text_size_v",
215 
216  m_params.emplace_back( new PARAM_SCALED<int>( "design_settings.others_text_thickness",
218  Millimeter2iu( DEFAULT_TEXT_WIDTH ), 1, TEXTS_MAX_WIDTH, MM_PER_IU ) );
219 
220  m_params.emplace_back( new PARAM<bool>( "design_settings.others_text_italic",
222 
223  m_params.emplace_back( new PARAM_LAMBDA<nlohmann::json>( "editing.selection_filter",
224  [&]() -> nlohmann::json
225  {
226  nlohmann::json ret;
227 
228  ret["lockedItems"] = m_SelectionFilter.lockedItems;
229  ret["footprints"] = m_SelectionFilter.footprints;
230  ret["text"] = m_SelectionFilter.text;
231  ret["tracks"] = m_SelectionFilter.tracks;
232  ret["vias"] = m_SelectionFilter.vias;
233  ret["pads"] = m_SelectionFilter.pads;
234  ret["graphics"] = m_SelectionFilter.graphics;
235  ret["zones"] = m_SelectionFilter.zones;
236  ret["keepouts"] = m_SelectionFilter.keepouts;
237  ret["dimensions"] = m_SelectionFilter.dimensions;
238  ret["otherItems"] = m_SelectionFilter.otherItems;
239 
240  return ret;
241  },
242  [&]( const nlohmann::json& aVal )
243  {
244  if( aVal.empty() || !aVal.is_object() )
245  return;
246 
247  SetIfPresent( aVal, "lockedItems", m_SelectionFilter.lockedItems );
248  SetIfPresent( aVal, "footprints", m_SelectionFilter.footprints );
249  SetIfPresent( aVal, "text", m_SelectionFilter.text );
250  SetIfPresent( aVal, "tracks", m_SelectionFilter.tracks );
251  SetIfPresent( aVal, "vias", m_SelectionFilter.vias );
252  SetIfPresent( aVal, "pads", m_SelectionFilter.pads );
253  SetIfPresent( aVal, "graphics", m_SelectionFilter.graphics );
254  SetIfPresent( aVal, "zones", m_SelectionFilter.zones );
255  SetIfPresent( aVal, "keepouts", m_SelectionFilter.keepouts );
256  SetIfPresent( aVal, "dimensions", m_SelectionFilter.dimensions );
257  SetIfPresent( aVal, "otherItems", m_SelectionFilter.otherItems );
258  },
259  {
260  { "lockedItems", true },
261  { "footprints", true },
262  { "text", true },
263  { "tracks", true },
264  { "vias", true },
265  { "pads", true },
266  { "graphics", true },
267  { "zones", true },
268  { "keepouts", true },
269  { "dimensions", true },
270  { "otherItems", true }
271  } ) );
272 
274 }
275 
276 
278 {
279  bool ret = APP_SETTINGS_BASE::MigrateFromLegacy( aCfg );
280 
281  //
282  // NOTE: there's no value in line-wrapping these; it just makes the table unreadable.
283  //
284  ret &= fromLegacy<int>( aCfg, "ModeditLibWidth", "window.lib_width" );
285  ret &= fromLegacyString( aCfg, "import_last_path", "system.last_import_export_path" );
286  ret &= fromLegacyString( aCfg, "LibFootprintTextShownColumns", "window.footprint_text_shown_columns" );
287 
288  ret &= fromLegacy<int>( aCfg, "FpEditorMagneticPads", "editing.magnetic_pads" );
289  ret &= fromLegacy<bool>( aCfg, "FpEditorDisplayPolarCoords", "editing.polar_coords" );
290  ret &= fromLegacy<int>( aCfg, "FpEditorUse45DegreeGraphicSegments", "editing.use_45_degree_graphic_segments" );
291 
292  ret &= fromLegacy<bool>( aCfg, "FpEditorGraphicLinesDisplayMode", "pcb_display.graphic_items_fill" );
293  ret &= fromLegacy<bool>( aCfg, "FpEditorPadDisplayMode", "pcb_display.pad_fill" );
294  ret &= fromLegacy<bool>( aCfg, "FpEditorTextsDisplayMode", "pcb_display.footprint_text" );
295 
296  ret &= fromLegacy<double>( aCfg, "FpEditorSilkLineWidth", "design_settings.silk_line_width" );
297  ret &= fromLegacy<double>( aCfg, "FpEditorSilkTextSizeH", "design_settings.silk_text_size_h" );
298  ret &= fromLegacy<double>( aCfg, "FpEditorSilkTextSizeV", "design_settings.silk_text_size_v" );
299  ret &= fromLegacy<double>( aCfg, "FpEditorSilkTextThickness", "design_settings.silk_text_thickness" );
300  ret &= fromLegacy<bool>( aCfg, "FpEditorSilkTextItalic", "design_settings.silk_text_italic" );
301  ret &= fromLegacy<double>( aCfg, "FpEditorCopperLineWidth", "design_settings.copper_line_width" );
302  ret &= fromLegacy<double>( aCfg, "FpEditorCopperTextSizeH", "design_settings.copper_text_size_h" );
303  ret &= fromLegacy<double>( aCfg, "FpEditorCopperTextSizeV", "design_settings.copper_text_size_v" );
304  ret &= fromLegacy<double>( aCfg, "FpEditorCopperTextThickness", "design_settings.copper_text_thickness" );
305  ret &= fromLegacy<bool>( aCfg, "FpEditorCopperTextItalic", "design_settings.copper_text_italic" );
306  ret &= fromLegacy<double>( aCfg, "FpEditorEdgeCutLineWidth", "design_settings.edge_line_width" );
307  ret &= fromLegacy<double>( aCfg, "FpEditorCourtyardLineWidth", "design_settings.courtyard_line_width" );
308  ret &= fromLegacy<double>( aCfg, "FpEditorOthersLineWidth", "design_settings.others_line_width" );
309  ret &= fromLegacy<double>( aCfg, "FpEditorOthersTextSizeH", "design_settings.others_text_size_h" );
310  ret &= fromLegacy<double>( aCfg, "FpEditorOthersTextSizeV", "design_settings.others_text_size_v" );
311  ret &= fromLegacy<double>( aCfg, "FpEditorOthersTextThickness", "design_settings.others_text_thickness" );
312  ret &= fromLegacy<bool>( aCfg, "FpEditorOthersTextItalic", "design_settings.others_text_italic" );
313 
314  nlohmann::json textItems = nlohmann::json::array( {
315  { "REF**", true, F_SilkS },
316  { "", true, F_Fab }
317  } );
318 
319  ( *this )[PointerFromString( "design_settings.default_footprint_text_items" )] = textItems;
320 
321  ret &= fromLegacyString( aCfg, "FpEditorRefDefaultText", "design_settings.default_footprint_text_items.0.0" );
322  ret &= fromLegacy<bool>( aCfg, "FpEditorRefDefaultVisibility", "design_settings.default_footprint_text_items.0.1" );
323  ret &= fromLegacy<int>( aCfg, "FpEditorRefDefaultLayer", "design_settings.default_footprint_text_items.0.2" );
324  ret &= fromLegacyString( aCfg, "FpEditorValueDefaultText", "design_settings.default_footprint_text_items.1.0" );
325  ret &= fromLegacy<bool>( aCfg, "FpEditorValueDefaultVisibility", "design_settings.default_footprint_text_items.1.1" );
326  ret &= fromLegacy<int>( aCfg, "FpEditorValueDefaultLayer", "design_settings.default_footprint_text_items.1.2" );
327 
328 
329  std::string f = "ModEdit";
330 
331  // Migrate color settings that were stored in the pcbnew config file
332  // We create a copy of the user scheme for the footprint editor context
333 
334  SETTINGS_MANAGER& manager = Pgm().GetSettingsManager();
335  COLOR_SETTINGS* cs = manager.AddNewColorSettings( "user_footprints" );
336 
337  cs->SetName( wxT( "User (Footprints)" ) );
338  manager.Save( cs );
339 
340  auto migrateLegacyColor = [&] ( const std::string& aKey, int aLayerId )
341  {
342  wxString str;
343 
344  if( aCfg->Read( aKey, &str ) )
345  cs->SetColor( aLayerId, COLOR4D( str ) );
346  };
347 
348  for( int i = 0; i < PCB_LAYER_ID_COUNT; ++i )
349  {
350  wxString layer = LSET::Name( PCB_LAYER_ID( i ) );
351  migrateLegacyColor( f + "Color4DPCBLayer_" + layer.ToStdString(), PCB_LAYER_ID( i ) );
352  }
353 
354  migrateLegacyColor( f + "Color4DAnchorEx", LAYER_ANCHOR );
355  migrateLegacyColor( f + "Color4DAuxItems", LAYER_AUX_ITEMS );
356  migrateLegacyColor( f + "Color4DGrid", LAYER_GRID );
357  migrateLegacyColor( f + "Color4DNoNetPadMarker", LAYER_NO_CONNECTS );
358  migrateLegacyColor( f + "Color4DNonPlatedEx", LAYER_NON_PLATEDHOLES );
359  migrateLegacyColor( f + "Color4DPadBackEx", LAYER_PAD_BK );
360  migrateLegacyColor( f + "Color4DPadFrontEx", LAYER_PAD_FR );
361  migrateLegacyColor( f + "Color4DPadThruHoleEx", LAYER_PADS_TH );
362  migrateLegacyColor( f + "Color4DPCBBackground", LAYER_PCB_BACKGROUND );
363  migrateLegacyColor( f + "Color4DPCBCursor", LAYER_CURSOR );
364  migrateLegacyColor( f + "Color4DRatsEx", LAYER_RATSNEST );
365  migrateLegacyColor( f + "Color4DTxtInvisEx", LAYER_MOD_TEXT_INVISIBLE );
366  migrateLegacyColor( f + "Color4DViaBBlindEx", LAYER_VIA_BBLIND );
367  migrateLegacyColor( f + "Color4DViaMicroEx", LAYER_VIA_MICROVIA );
368  migrateLegacyColor( f + "Color4DViaThruEx", LAYER_VIA_THROUGH );
369  migrateLegacyColor( f + "Color4DWorksheet", LAYER_DRAWINGSHEET );
370 
371  manager.SaveColorSettings( cs, "board" );
372 
373  ( *this )[PointerFromString( "appearance.color_theme" )] = "user_footprints";
374 
375  double x, y;
376  f = "ModEditFrame";
377 
378  if( aCfg->Read( f + "PcbUserGrid_X", &x ) && aCfg->Read( f + "PcbUserGrid_Y", &y ) )
379  {
380  EDA_UNITS u = static_cast<EDA_UNITS>( aCfg->ReadLong( f + "PcbUserGrid_Unit",
381  static_cast<long>( EDA_UNITS::INCHES ) ) );
382 
383  // Convert to internal units
384  x = From_User_Unit( u, x );
385  y = From_User_Unit( u, y );
386 
387  ( *this )[PointerFromString( "window.grid.user_grid_x" )] = StringFromValue( u, x );
388  ( *this )[PointerFromString( "window.grid.user_grid_y" )] = StringFromValue( u, y );
389  }
390 
391  return ret;
392 }
393 
394 
396 {
404  if( !m_manager )
405  {
406  wxLogTrace( traceSettings,
407  "Error: FOOTPRINT_EDITOR_SETTINGS migration cannot run unmanaged!" );
408  return false;
409  }
410 
411  nlohmann::json::json_pointer theme_ptr( "/appearance/color_theme" );
412 
413  if( !count( theme_ptr ) )
414  return true;
415 
416  wxString selected = at( theme_ptr ).get<wxString>();
417  wxString search = selected + wxT( "_footprints" );
418 
419  for( COLOR_SETTINGS* settings : Pgm().GetSettingsManager().GetColorSettingsList() )
420  {
421  if( settings->GetFilename() == search )
422  {
423  wxLogTrace( traceSettings, "Updating footprint editor theme from %s to %s",
424  selected, search );
425  ( *this )[theme_ptr] = search;
426  return true;
427  }
428  }
429 
430  return true;
431 }
#define DEFAULT_SILK_TEXT_WIDTH
to draw blind/buried vias
show a marker on pads with no nets
bool otherItems
Anything not fitting one of the above categories.
std::vector< TEXT_ITEM_INFO > m_DefaultFPTextItems
std::vector< PARAM_BASE * > m_params
The list of parameters (owned by this object)
multilayer pads, usually with holes
#define TEXTS_MAX_WIDTH
Maximum text width in internal units (10 inches)
Definition: pcbnew.h:33
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)
#define DEFAULT_LINE_WIDTH
#define DEFAULT_COPPER_LINE_WIDTH
COLOR_SETTINGS * AddNewColorSettings(const wxString &aFilename)
Registers a new color settings object with the given filename.
KIWAY Kiway & Pgm(), KFCTL_STANDALONE
The global Program "get" accessor.
Definition: single_top.cpp:106
nlohmann::json json
Definition: gerbview.cpp:40
#define DEFAULT_TEXT_WIDTH
wxSize m_TextSize[LAYER_CLASS_COUNT]
const int fpEditSchemaVersion
! Update the schema version whenever a migration is required
PCB_LAYER_ID
A quick note on layer IDs:
#define DEFAULT_SILK_TEXT_SIZE
int m_TextThickness[LAYER_CLASS_COUNT]
#define DEFAULT_SILK_LINE_WIDTH
Auxiliary items (guides, rule, etc)
bool text
Text (free or attached to a footprint)
APP_SETTINGS_BASE is a settings class that should be derived for each standalone KiCad application.
Definition: app_settings.h:99
bool dimensions
Dimension items.
static const wxChar * Name(PCB_LAYER_ID aLayerId)
Return the fixed name association with aLayerId.
Definition: lset.cpp:82
bool graphics
Graphic lines, shapes, polygons.
static bool SetIfPresent(const nlohmann::json &aObj, const std::string &aPath, wxString &aTarget)
Sets the given string if the given key/path is present.
to draw usual through hole vias
bool m_TextItalic[LAYER_CLASS_COUNT]
Represents a parameter that has a scaling factor between the value in the file and the value used int...
Definition: parameters.h:388
Functions to provide common constants and other functions to assist in making a consistent UI.
SELECTION_FILTER_OPTIONS m_SelectionFilter
void SetName(const wxString &aName)
#define TEXTS_MAX_SIZE
Maximum text size in internal units (10 inches)
Definition: pcbnew.h:32
SETTINGS_MANAGER * GetSettingsManager()
bool footprints
Allow selecting entire footprints.
int m_LineThickness[LAYER_CLASS_COUNT]
#define TEXTS_MIN_SIZE
Minimum text size in internal units (1 mil)
Definition: pcbnew.h:31
EDA_UNITS
Definition: eda_units.h:38
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 lockedItems
Allow selecting locked items.
smd pads, front layer
see class PGM_BASE
Board layer functions and definitions.
void registerMigration(int aOldSchemaVersion, int aNewSchemaVersion, std::function< bool(void)> aMigrator)
Registers a migration from one schema version to another.
std::vector< LAYER_PRESET > m_LayerPresets
MAGNETIC_OPTIONS pads
void SaveColorSettings(COLOR_SETTINGS *aSettings, const std::string &aNamespace="")
Safely saves a COLOR_SETTINGS to disk, preserving any changes outside the given namespace.
The common library.
#define DEFAULT_COPPER_TEXT_WIDTH
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)
Convert a value to a string using double notation.
Definition: base_units.cpp:225
Color settings are a bit different than most of the settings objects in that there can be more than o...
#define DEFAULT_TEXT_SIZE
Ratio of the font height to the baseline of the text above the wire.
const wxChar *const traceSettings
Flag to enable debug output of settings operations and management.
drawingsheet frame and titleblock
#define DEFAULT_COPPER_TEXT_SIZE
BOARD_DESIGN_SETTINGS m_DesignSettings
Only some of these settings are actually used for footprint editing.
SETTINGS_MANAGER * m_manager
A pointer to the settings manager managing this file (may be null)
static constexpr int Millimeter2iu(double mm)
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:313
MAGNETIC_OPTIONS tracks
void SetColor(int aLayer, COLOR4D aColor)
A color representation with 4 components: red, green, blue, alpha.
Definition: color4d.h:98