KiCad PCB EDA Suite
Loading...
Searching...
No Matches
board_design_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, 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 <pcb_dimension.h>
25#include <pcb_track.h>
26#include <layer_ids.h>
27#include <lset.h>
28#include <kiface_base.h>
29#include <pad.h>
32#include <drc/drc_item.h>
33#include <drc/drc_engine.h>
35#include <settings/parameters.h>
37#include <advanced_config.h>
38
39const int bdsSchemaVersion = 2;
40
41
42BOARD_DESIGN_SETTINGS::BOARD_DESIGN_SETTINGS( JSON_SETTINGS* aParent, const std::string& aPath ) :
43 NESTED_SETTINGS( "board_design_settings", bdsSchemaVersion, aParent, aPath )
44{
45 // We want to leave alone parameters that aren't found in the project JSON as they may be
46 // initialized by the board file parser before NESTED_SETTINGS::LoadFromFile is called.
48
49 // Create a default NET_SETTINGS so that things don't break horribly if there's no project
50 // loaded. This also is used during file load for legacy boards that have netclasses stored
51 // in the file. After load, this information will be moved to the project and the pointer
52 // updated.
53 m_NetSettings = std::make_shared<NET_SETTINGS>( nullptr, "" );
54
55 m_HasStackup = false; // no stackup defined by default
56
57 m_Pad_Master = std::make_unique<PAD>( nullptr );
59
60 LSET all_set = LSET().set();
61 m_enabledLayers = all_set; // All layers enabled at first.
62 // SetCopperLayerCount() will adjust this.
63
64 // Default design is a double layer board with 4 user defined layers
67
69
70 // if true, when creating a new track starting on an existing track, use this track width
73
74 // First is always the reference designator
75 m_DefaultFPTextItems.emplace_back( wxT( "REF**" ), true, F_SilkS );
76 // Second is always the value
77 m_DefaultFPTextItems.emplace_back( wxT( "" ), true, F_Fab );
78 // Any following ones are freebies
79 m_DefaultFPTextItems.emplace_back( wxT( "${REFERENCE}" ), true, F_Fab );
80
87
94
95 // Edges & Courtyards; text properties aren't used but better to have them holding
96 // reasonable values than not.
99 pcbIUScale.mmToIU( DEFAULT_TEXT_SIZE ) );
103
106 pcbIUScale.mmToIU( DEFAULT_TEXT_SIZE ) );
110
113 pcbIUScale.mmToIU( DEFAULT_TEXT_SIZE ) );
115 m_TextItalic[ LAYER_CLASS_FAB ] = false;
117
120 pcbIUScale.mmToIU( DEFAULT_TEXT_SIZE ) );
124
125 m_StyleFPFields = false;
126 m_StyleFPText = false;
127 m_StyleFPShapes = false;
128 m_StyleFPDimensions = false;
129 m_StyleFPBarcodes = false;
130
139
140 m_useCustomTrackVia = false;
142 m_customViaSize.m_Diameter = pcbIUScale.mmToIU( DEFAULT_VIASMINSIZE );
144
145 m_useCustomDiffPair = false;
149
166
167 for( int errorCode = DRCE_FIRST; errorCode <= DRCE_LAST; ++errorCode )
168 m_DRCSeverities[ errorCode ] = RPT_SEVERITY_ERROR;
169
172
176
179
182
184
192
198
200
203
205
208
211
213
217
218 // Global mask margins:
222
223 // Solder paste margin absolute value
225 // Solder paste margin as a ratio of pad size
226 // The final margin is the sum of these 2 values
227 // Usually < 0 because the mask is smaller than pad
229
231 m_TentViasFront = true;
232 m_TentViasBack = true;
233
234 m_CoverViasFront = false;
235 m_CoverViasBack = false;
236
237 m_PlugViasFront = false;
238 m_PlugViasBack = false;
239
240 m_CapVias = false;
241
242 m_FillVias = false;
243
244 // Layer thickness for 3D viewer
246
247 // Default spacing for meanders
251
252 m_viaSizeIndex = 0;
254 m_diffPairIndex = 0;
255
256 // Parameters stored in JSON in the project file
257
258 // NOTE: Previously, BOARD_DESIGN_SETTINGS stored the basic board layer information (layer
259 // names and enable/disable state) in the project file even though this information is also
260 // stored in the board file. This was implemented for importing these settings from another
261 // project. Going forward, the import feature will just import from other board files (since
262 // we could have multi-board projects in the future anyway) so this functionality is dropped.
263
264
265 m_params.emplace_back( new PARAM<bool>( "rules.use_height_for_length_calcs",
266 &m_UseHeightForLengthCalcs, true ) );
267
268 m_params.emplace_back( new PARAM_SCALED<int>( "rules.min_clearance",
270 pcbIUScale.mmToIU( 0.00 ), pcbIUScale.mmToIU( 25.0 ), pcbIUScale.MM_PER_IU ) );
271
272 m_params.emplace_back( new PARAM_SCALED<int>( "rules.min_connection",
274 pcbIUScale.mmToIU( 0.00 ), pcbIUScale.mmToIU( 100.0 ), pcbIUScale.MM_PER_IU ) );
275
276 m_params.emplace_back( new PARAM_SCALED<int>( "rules.min_track_width",
278 pcbIUScale.mmToIU( 0.00 ), pcbIUScale.mmToIU( 25.0 ), pcbIUScale.MM_PER_IU ) );
279
280 m_params.emplace_back( new PARAM_SCALED<int>( "rules.min_via_annular_width",
282 pcbIUScale.mmToIU( 0.00 ), pcbIUScale.mmToIU( 25.0 ), pcbIUScale.MM_PER_IU ) );
283
284 m_params.emplace_back( new PARAM_SCALED<int>( "rules.min_via_diameter",
286 pcbIUScale.mmToIU( 0.00 ), pcbIUScale.mmToIU( 25.0 ), pcbIUScale.MM_PER_IU ) );
287
288 m_params.emplace_back( new PARAM_SCALED<int>( "rules.min_through_hole_diameter",
290 pcbIUScale.mmToIU( 0.00 ), pcbIUScale.mmToIU( 25.0 ), pcbIUScale.MM_PER_IU ) );
291
292 m_params.emplace_back( new PARAM_SCALED<int>( "rules.min_microvia_diameter",
294 pcbIUScale.mmToIU( 0.00 ), pcbIUScale.mmToIU( 10.0 ), pcbIUScale.MM_PER_IU ) );
295
296 m_params.emplace_back( new PARAM_SCALED<int>( "rules.min_microvia_drill",
298 pcbIUScale.mmToIU( 0.00 ), pcbIUScale.mmToIU( 10.0 ), pcbIUScale.MM_PER_IU ) );
299
300 m_params.emplace_back( new PARAM_SCALED<int>( "rules.min_hole_to_hole",
302 pcbIUScale.mmToIU( 0.00 ), pcbIUScale.mmToIU( 10.0 ), pcbIUScale.MM_PER_IU ) );
303
304 m_params.emplace_back( new PARAM_SCALED<int>( "rules.min_hole_clearance",
306 pcbIUScale.mmToIU( 0.00 ), pcbIUScale.mmToIU( 100.0 ), pcbIUScale.MM_PER_IU ) );
307
308 m_params.emplace_back( new PARAM_SCALED<int>( "rules.min_silk_clearance",
310 pcbIUScale.mmToIU( -10.0 ), pcbIUScale.mmToIU( 100.0 ), pcbIUScale.MM_PER_IU ) );
311
312 m_params.emplace_back( new PARAM_SCALED<int>( "rules.min_groove_width",
314 pcbIUScale.mmToIU( 0.00 ), pcbIUScale.mmToIU( 25.0 ), pcbIUScale.MM_PER_IU ) );
315
316 // While the maximum *effective* value is 4, we've had users interpret this as the count on
317 // all layers, and enter something like 10. They'll figure it out soon enough *unless* we
318 // enforce a max of 4 (and therefore reset it back to the default of 2), at which point it
319 // just looks buggy.
320 m_params.emplace_back( new PARAM<int>( "rules.min_resolved_spokes",
322
323 m_params.emplace_back( new PARAM_SCALED<int>( "rules.min_text_height",
325 pcbIUScale.mmToIU( 0.00 ), pcbIUScale.mmToIU( 100.0 ), pcbIUScale.MM_PER_IU ) );
326
327 m_params.emplace_back( new PARAM_SCALED<int>( "rules.min_text_thickness",
329 pcbIUScale.mmToIU( 0.00 ), pcbIUScale.mmToIU( 25.0 ), pcbIUScale.MM_PER_IU ) );
330
331 // Note: a clearance of -0.01 is a flag indicating we should use the legacy (pre-6.0) method
332 // based on the edge cut thicknesses.
333 m_params.emplace_back( new PARAM_SCALED<int>( "rules.min_copper_edge_clearance",
335 pcbIUScale.mmToIU( -0.01 ), pcbIUScale.mmToIU( 25.0 ), pcbIUScale.MM_PER_IU ) );
336
337 m_params.emplace_back( new PARAM_LAMBDA<nlohmann::json>( "rule_severities",
338 [&]() -> nlohmann::json
339 {
340 nlohmann::json ret = {};
341
342 for( const RC_ITEM& item : DRC_ITEM::GetItemsWithSeverities() )
343 {
344 wxString name = item.GetSettingsKey();
345 int code = item.GetErrorCode();
346
347 if( name.IsEmpty() || m_DRCSeverities.count( code ) == 0 )
348 continue;
349
350 ret[std::string( name.ToUTF8() )] = SeverityToString( m_DRCSeverities[code] );
351 }
352
353 return ret;
354 },
355 [&]( const nlohmann::json& aJson )
356 {
357 if( !aJson.is_object() )
358 return;
359
360 // Load V8 'hole_near_hole' token first (if present). Any current 'hole_to_hole' token
361 // found will then overwrite it.
362 // We can't use the migration architecture because we forgot to bump the version number
363 // when the change was made. But this is a one-off as any future deprecations should
364 // bump the version number and use registerMigration().
365 if( aJson.contains( "hole_near_hole" ) )
367
368 for( const RC_ITEM& item : DRC_ITEM::GetItemsWithSeverities() )
369 {
370 wxString name = item.GetSettingsKey();
371 std::string key( name.ToUTF8() );
372
373 if( aJson.contains( key ) )
374 m_DRCSeverities[item.GetErrorCode()] = SeverityFromString( aJson[key] );
375 }
376 }, {} ) );
377
378 m_params.emplace_back( new PARAM_LAMBDA<nlohmann::json>( "drc_exclusions",
379 [&]() -> nlohmann::json
380 {
381 nlohmann::json js = nlohmann::json::array();
382
383 for( const wxString& entry : m_DrcExclusions )
384 js.push_back( { entry, m_DrcExclusionComments[ entry ] } );
385
386 return js;
387 },
388 [&]( const nlohmann::json& aObj )
389 {
390 m_DrcExclusions.clear();
391
392 if( !aObj.is_array() )
393 return;
394
395 for( const nlohmann::json& entry : aObj )
396 {
397 if( entry.is_array() )
398 {
399 wxString serialized = entry[0].get<wxString>();
400 m_DrcExclusions.insert( serialized );
401 m_DrcExclusionComments[ serialized ] = entry[1].get<wxString>();
402 }
403 else if( entry.is_string() )
404 {
405 m_DrcExclusions.insert( entry.get<wxString>() );
406 }
407 }
408 },
409 {} ) );
410
411 m_params.emplace_back( new PARAM_LAMBDA<nlohmann::json>( "track_widths",
412 [&]() -> nlohmann::json
413 {
414 nlohmann::json js = nlohmann::json::array();
415
416 for( const int& width : m_TrackWidthList )
417 js.push_back( pcbIUScale.IUTomm( width ) );
418
419 return js;
420 },
421 [&]( const nlohmann::json& aJson )
422 {
423 if( !aJson.is_array() )
424 return;
425
426 m_TrackWidthList.clear();
427
428 for( const nlohmann::json& entry : aJson )
429 {
430 if( entry.empty() )
431 continue;
432
433 m_TrackWidthList.emplace_back( pcbIUScale.mmToIU( entry.get<double>() ) );
434 }
435 },
436 {} ) );
437
438 m_params.emplace_back( new PARAM_LAMBDA<nlohmann::json>( "via_dimensions",
439 [&]() -> nlohmann::json
440 {
441 nlohmann::json js = nlohmann::json::array();
442
443 for( const auto& via : m_ViasDimensionsList )
444 {
445 nlohmann::json entry = {};
446
447 entry["diameter"] = pcbIUScale.IUTomm( via.m_Diameter );
448 entry["drill"] = pcbIUScale.IUTomm( via.m_Drill );
449
450 js.push_back( entry );
451 }
452
453 return js;
454 },
455 [&]( const nlohmann::json& aObj )
456 {
457 if( !aObj.is_array() )
458 return;
459
460 m_ViasDimensionsList.clear();
461
462 for( const nlohmann::json& entry : aObj )
463 {
464 if( entry.empty() || !entry.is_object() )
465 continue;
466
467 if( !entry.contains( "diameter" ) || !entry.contains( "drill" ) )
468 continue;
469
470 int diameter = pcbIUScale.mmToIU( entry["diameter"].get<double>() );
471 int drill = pcbIUScale.mmToIU( entry["drill"].get<double>() );
472
473 m_ViasDimensionsList.emplace_back( VIA_DIMENSION( diameter, drill ) );
474 }
475 },
476 {} ) );
477
478 m_params.emplace_back( new PARAM_LAMBDA<nlohmann::json>( "diff_pair_dimensions",
479 [&]() -> nlohmann::json
480 {
481 nlohmann::json js = nlohmann::json::array();
482
483 for( const auto& pair : m_DiffPairDimensionsList )
484 {
485 nlohmann::json entry = {};
486
487 entry["width"] = pcbIUScale.IUTomm( pair.m_Width );
488 entry["gap"] = pcbIUScale.IUTomm( pair.m_Gap );
489 entry["via_gap"] = pcbIUScale.IUTomm( pair.m_ViaGap );
490
491 js.push_back( entry );
492 }
493
494 return js;
495 },
496 [&]( const nlohmann::json& aObj )
497 {
498 if( !aObj.is_array() )
499 return;
500
502
503 for( const nlohmann::json& entry : aObj )
504 {
505 if( entry.empty() || !entry.is_object() )
506 continue;
507
508 if( !entry.contains( "width" )
509 || !entry.contains( "gap" )
510 || !entry.contains( "via_gap" ) )
511 {
512 continue;
513 }
514
515 int width = pcbIUScale.mmToIU( entry["width"].get<double>() );
516 int gap = pcbIUScale.mmToIU( entry["gap"].get<double>() );
517 int via_gap = pcbIUScale.mmToIU( entry["via_gap"].get<double>() );
518
519 m_DiffPairDimensionsList.emplace_back( DIFF_PAIR_DIMENSION( width, gap, via_gap ) );
520 }
521 },
522 {} ) );
523
524 // Handle options for teardrops (targets and some others):
525 m_params.emplace_back( new PARAM_LAMBDA<nlohmann::json>( "teardrop_options",
526 [&]() -> nlohmann::json
527 {
528 nlohmann::json js = nlohmann::json::array();
529 nlohmann::json entry = {};
530
531 entry["td_onvia"] = m_TeardropParamsList.m_TargetVias;
532 entry["td_onpthpad"] = m_TeardropParamsList.m_TargetPTHPads;
533 entry["td_onsmdpad"] = m_TeardropParamsList.m_TargetSMDPads;
534 entry["td_ontrackend"] = m_TeardropParamsList.m_TargetTrack2Track;
535 entry["td_onroundshapesonly"] = m_TeardropParamsList.m_UseRoundShapesOnly;
536
537 js.push_back( entry );
538
539 return js;
540 },
541 [&]( const nlohmann::json& aObj )
542 {
543 if( !aObj.is_array() )
544 return;
545
546 for( const nlohmann::json& entry : aObj )
547 {
548 if( entry.empty() || !entry.is_object() )
549 continue;
550
551 if( entry.contains( "td_onvia" ) )
552 m_TeardropParamsList.m_TargetVias = entry["td_onvia"].get<bool>();
553
554 if( entry.contains( "td_onpthpad" ) )
555 m_TeardropParamsList.m_TargetPTHPads = entry["td_onpthpad"].get<bool>();
556
557 if( entry.contains( "td_onsmdpad" ) )
558 m_TeardropParamsList.m_TargetSMDPads = entry["td_onsmdpad"].get<bool>();
559
560 if( entry.contains( "td_ontrackend" ) )
561 m_TeardropParamsList.m_TargetTrack2Track = entry["td_ontrackend"].get<bool>();
562
563 if( entry.contains( "td_onroundshapesonly" ) )
564 m_TeardropParamsList.m_UseRoundShapesOnly = entry["td_onroundshapesonly"].get<bool>();
565
566 // Legacy settings
567 for( int ii = 0; ii < 3; ++ii )
568 {
569 TEARDROP_PARAMETERS* td_prm = m_TeardropParamsList.GetParameters( (TARGET_TD)ii );
570
571 if( entry.contains( "td_allow_use_two_tracks" ) )
572 td_prm->m_AllowUseTwoTracks = entry["td_allow_use_two_tracks"].get<bool>();
573
574 if( entry.contains( "td_curve_segcount" ) )
575 {
576 if( entry["td_curve_segcount"].get<int>() > 0 )
577 td_prm->m_CurvedEdges = true;
578 }
579
580 if( entry.contains( "td_on_pad_in_zone" ) )
581 td_prm->m_TdOnPadsInZones = entry["td_on_pad_in_zone"].get<bool>();
582 }
583 }
584 },
585 {} ) );
586
587 // Handle parameters (sizes, shape) for each type of teardrop:
588 m_params.emplace_back( new PARAM_LAMBDA<nlohmann::json>( "teardrop_parameters",
589 [&]() -> nlohmann::json
590 {
591 nlohmann::json js = nlohmann::json::array();
592
593 for( size_t ii = 0; ii < m_TeardropParamsList.GetParametersCount(); ii++ )
594 {
595 nlohmann::json entry = {};
596 TEARDROP_PARAMETERS* td_prm = m_TeardropParamsList.GetParameters( (TARGET_TD)ii );
597
598 entry["td_target_name"] = GetTeardropTargetCanonicalName( (TARGET_TD)ii );
599 entry["td_maxlen"] = pcbIUScale.IUTomm( td_prm->m_TdMaxLen );
600 entry["td_maxheight"] = pcbIUScale.IUTomm( td_prm->m_TdMaxWidth );
601 entry["td_length_ratio"] = td_prm->m_BestLengthRatio;
602 entry["td_height_ratio"] = td_prm->m_BestWidthRatio;
603 entry["td_curve_segcount"] = td_prm->m_CurvedEdges ? 1 : 0;
604 entry["td_width_to_size_filter_ratio"] = td_prm->m_WidthtoSizeFilterRatio;
605 entry["td_allow_use_two_tracks"] = td_prm->m_AllowUseTwoTracks;
606 entry["td_on_pad_in_zone"] = td_prm->m_TdOnPadsInZones;
607
608 js.push_back( entry );
609 }
610
611 return js;
612 },
613 [&]( const nlohmann::json& aObj )
614 {
615 if( !aObj.is_array() )
616 return;
617
618 for( const nlohmann::json& entry : aObj )
619 {
620 if( entry.empty() || !entry.is_object() )
621 continue;
622
623 if( !entry.contains( "td_target_name" ) )
624 continue;
625
626 int idx = GetTeardropTargetTypeFromCanonicalName( entry["td_target_name"].get<std::string>() );
627
628 if( idx >= 0 && idx < 3 )
629 {
630 TEARDROP_PARAMETERS* td_prm = m_TeardropParamsList.GetParameters( (TARGET_TD)idx );
631
632 if( entry.contains( "td_maxlen" ) )
633 td_prm->m_TdMaxLen = pcbIUScale.mmToIU( entry["td_maxlen"].get<double>() );
634
635 if( entry.contains( "td_maxheight" ) )
636 td_prm->m_TdMaxWidth = pcbIUScale.mmToIU( entry["td_maxheight"].get<double>() );
637
638 if( entry.contains( "td_length_ratio" ) )
639 td_prm->m_BestLengthRatio = entry["td_length_ratio"].get<double>();
640
641 if( entry.contains( "td_height_ratio" ) )
642 td_prm->m_BestWidthRatio = entry["td_height_ratio"].get<double>();
643
644 if( entry.contains( "td_curve_segcount" ) )
645 {
646 if( entry["td_curve_segcount"].get<int>() > 0 )
647 td_prm->m_CurvedEdges = true;
648 }
649
650 if( entry.contains( "td_width_to_size_filter_ratio" ) )
651 td_prm->m_WidthtoSizeFilterRatio = entry["td_width_to_size_filter_ratio"].get<double>();
652
653 if( entry.contains( "td_allow_use_two_tracks" ) )
654 td_prm->m_AllowUseTwoTracks = entry["td_allow_use_two_tracks"].get<bool>();
655
656 if( entry.contains( "td_on_pad_in_zone" ) )
657 td_prm->m_TdOnPadsInZones = entry["td_on_pad_in_zone"].get<bool>();
658 }
659 }
660 },
661 {} ) );
662
663 m_params.emplace_back( new PARAM_LAMBDA<nlohmann::json>( "tuning_pattern_settings",
664 [&]() -> nlohmann::json
665 {
666 nlohmann::json js = {};
667
668 auto make_settings =
669 []( const PNS::MEANDER_SETTINGS& aSettings )
670 {
671 nlohmann::json entry = {};
672
673 entry["min_amplitude"] = pcbIUScale.IUTomm( aSettings.m_minAmplitude );
674 entry["max_amplitude"] = pcbIUScale.IUTomm( aSettings.m_maxAmplitude );
675 entry["spacing"] = pcbIUScale.IUTomm( aSettings.m_spacing );
676 entry["corner_style"] = aSettings.m_cornerStyle == PNS::MEANDER_STYLE_CHAMFER ? 0 : 1;
677 entry["corner_radius_percentage"] = aSettings.m_cornerRadiusPercentage;
678 entry["single_sided"] = aSettings.m_singleSided;
679
680 return entry;
681 };
682
683 js["single_track_defaults"] = make_settings( m_SingleTrackMeanderSettings );
684 js["diff_pair_defaults"] = make_settings( m_DiffPairMeanderSettings );
685 js["diff_pair_skew_defaults"] = make_settings( m_SkewMeanderSettings );
686
687 return js;
688 },
689 [&]( const nlohmann::json& aObj )
690 {
691 auto read_settings =
692 []( const nlohmann::json& entry ) -> PNS::MEANDER_SETTINGS
693 {
694 PNS::MEANDER_SETTINGS settings;
695
696 if( entry.contains( "min_amplitude" ) )
697 settings.m_minAmplitude = pcbIUScale.mmToIU( entry["min_amplitude"].get<double>() );
698
699 if( entry.contains( "max_amplitude" ) )
700 settings.m_maxAmplitude = pcbIUScale.mmToIU( entry["max_amplitude"].get<double>() );
701
702 if( entry.contains( "spacing" ) )
703 settings.m_spacing = pcbIUScale.mmToIU( entry["spacing"].get<double>() );
704
705 if( entry.contains( "corner_style" ) )
706 {
707 settings.m_cornerStyle = entry["corner_style"] == 0 ? PNS::MEANDER_STYLE_CHAMFER
709 }
710
711 if( entry.contains( "corner_radius_percentage" ) )
712 settings.m_cornerRadiusPercentage = entry["corner_radius_percentage"].get<int>();
713
714 if( entry.contains( "single_sided" ) )
715 settings.m_singleSided = entry["single_sided"].get<bool>();
716
717 return settings;
718 };
719
720 if( aObj.contains( "single_track_defaults" ) )
721 m_SingleTrackMeanderSettings = read_settings( aObj["single_track_defaults"] );
722
723 if( aObj.contains( "diff_pair_defaults" ) )
724 m_DiffPairMeanderSettings = read_settings( aObj["diff_pair_defaults"] );
725
726 if( aObj.contains( "diff_pair_skew_defaults" ) )
727 m_SkewMeanderSettings = read_settings( aObj["diff_pair_skew_defaults"] );
728 },
729 {} ) );
730
731 int minTextSize = pcbIUScale.mmToIU( TEXT_MIN_SIZE_MM );
732 int maxTextSize = pcbIUScale.mmToIU( TEXT_MAX_SIZE_MM );
733 int minStroke = 1;
734 int maxStroke = pcbIUScale.mmToIU( 100 );
735
736 m_params.emplace_back( new PARAM_SCALED<int>( "defaults.silk_line_width",
738 minStroke, maxStroke, pcbIUScale.MM_PER_IU ) );
739
740 m_params.emplace_back( new PARAM_SCALED<int>( "defaults.silk_text_size_v",
742 minTextSize, maxTextSize, pcbIUScale.MM_PER_IU ) );
743
744 m_params.emplace_back( new PARAM_SCALED<int>( "defaults.silk_text_size_h",
746 minTextSize, maxTextSize, pcbIUScale.MM_PER_IU ) );
747
748 m_params.emplace_back( new PARAM_SCALED<int>( "defaults.silk_text_thickness",
750 minStroke, maxStroke, pcbIUScale.MM_PER_IU ) );
751
752 m_params.emplace_back( new PARAM<bool>( "defaults.silk_text_italic",
753 &m_TextItalic[LAYER_CLASS_SILK], false ) );
754
755 m_params.emplace_back( new PARAM<bool>( "defaults.silk_text_upright",
756 &m_TextUpright[ LAYER_CLASS_SILK ], true ) );
757
758 m_params.emplace_back( new PARAM_SCALED<int>( "defaults.copper_line_width",
760 minStroke, maxStroke, pcbIUScale.MM_PER_IU ) );
761
762 m_params.emplace_back( new PARAM_SCALED<int>( "defaults.copper_text_size_v",
764 minTextSize, maxTextSize, pcbIUScale.MM_PER_IU ) );
765
766 m_params.emplace_back( new PARAM_SCALED<int>( "defaults.copper_text_size_h",
768 minTextSize, maxTextSize, pcbIUScale.MM_PER_IU ) );
769
770 m_params.emplace_back( new PARAM_SCALED<int>( "defaults.copper_text_thickness",
772 minStroke, maxStroke, pcbIUScale.MM_PER_IU ) );
773
774 m_params.emplace_back( new PARAM<bool>( "defaults.copper_text_italic",
775 &m_TextItalic[LAYER_CLASS_COPPER], false ) );
776
777 m_params.emplace_back( new PARAM<bool>( "defaults.copper_text_upright",
779
780 m_params.emplace_back( new PARAM_SCALED<int>( "defaults.board_outline_line_width",
782 minStroke, maxStroke, pcbIUScale.MM_PER_IU ) );
783
784 m_params.emplace_back( new PARAM_SCALED<int>( "defaults.courtyard_line_width",
786 minStroke, maxStroke, pcbIUScale.MM_PER_IU ) );
787
788 m_params.emplace_back( new PARAM_SCALED<int>( "defaults.fab_line_width",
790 minStroke, maxStroke, pcbIUScale.MM_PER_IU ) );
791
792 m_params.emplace_back( new PARAM_SCALED<int>( "defaults.fab_text_size_v",
794 minTextSize, maxTextSize, pcbIUScale.MM_PER_IU ) );
795
796 m_params.emplace_back( new PARAM_SCALED<int>( "defaults.fab_text_size_h",
798 minTextSize, maxTextSize, pcbIUScale.MM_PER_IU ) );
799
800 m_params.emplace_back( new PARAM_SCALED<int>( "defaults.fab_text_thickness",
802 minStroke, maxStroke, pcbIUScale.MM_PER_IU ) );
803
804 m_params.emplace_back( new PARAM<bool>( "defaults.fab_text_italic",
805 &m_TextItalic[LAYER_CLASS_FAB], false ) );
806
807 m_params.emplace_back( new PARAM<bool>( "defaults.fab_text_upright",
808 &m_TextUpright[LAYER_CLASS_FAB], true ) );
809
810 m_params.emplace_back( new PARAM_SCALED<int>( "defaults.other_line_width",
812 minStroke, maxStroke, pcbIUScale.MM_PER_IU ) );
813
814 m_params.emplace_back( new PARAM_SCALED<int>( "defaults.other_text_size_v",
816 minTextSize, maxTextSize, pcbIUScale.MM_PER_IU ) );
817
818 m_params.emplace_back( new PARAM_SCALED<int>( "defaults.other_text_size_h",
820 minTextSize, maxTextSize, pcbIUScale.MM_PER_IU ) );
821
822 m_params.emplace_back( new PARAM_SCALED<int>( "defaults.other_text_thickness",
824 minStroke, maxStroke, pcbIUScale.MM_PER_IU ) );
825
826 m_params.emplace_back( new PARAM<bool>( "defaults.other_text_italic",
827 &m_TextItalic[LAYER_CLASS_OTHERS], false ) );
828
829 m_params.emplace_back( new PARAM<bool>( "defaults.other_text_upright",
831
832 m_params.emplace_back( new PARAM_ENUM<DIM_UNITS_MODE>( "defaults.dimension_units",
835
836 m_params.emplace_back( new PARAM_ENUM<DIM_PRECISION>( "defaults.dimension_precision",
838
839 m_params.emplace_back( new PARAM_ENUM<DIM_UNITS_FORMAT>( "defaults.dimensions.units_format",
842
843 m_params.emplace_back( new PARAM<bool>( "defaults.dimensions.suppress_zeroes",
844 &m_DimensionSuppressZeroes, true ) );
845
846 // NOTE: excluding DIM_TEXT_POSITION::MANUAL from the valid range here
847 m_params.emplace_back( new PARAM_ENUM<DIM_TEXT_POSITION>( "defaults.dimensions.text_position",
850
851 m_params.emplace_back( new PARAM<bool>( "defaults.dimensions.keep_text_aligned",
853
854 m_params.emplace_back( new PARAM<int>( "defaults.dimensions.arrow_length",
857
858 m_params.emplace_back( new PARAM<int>( "defaults.dimensions.extension_offset",
861
862 m_params.emplace_back( new PARAM<bool>( "defaults.apply_defaults_to_fp_fields",
863 &m_StyleFPFields, false ) );
864 m_params.emplace_back( new PARAM<bool>( "defaults.apply_defaults_to_fp_text",
865 &m_StyleFPText, false ) );
866 m_params.emplace_back( new PARAM<bool>( "defaults.apply_defaults_to_fp_shapes",
867 &m_StyleFPShapes, false ) );
868 m_params.emplace_back( new PARAM<bool>( "defaults.apply_defaults_to_fp_dimensions",
869 &m_StyleFPDimensions, false ) );
870 m_params.emplace_back( new PARAM<bool>( "defaults.apply_defaults_to_fp_barcodes",
871 &m_StyleFPBarcodes, false ) );
872
873 m_params.emplace_back( new PARAM_SCALED<int>( "defaults.zones.min_clearance",
874 &m_defaultZoneSettings.m_ZoneClearance, pcbIUScale.mmToIU( ZONE_CLEARANCE_MM ),
875 pcbIUScale.mmToIU( 0.0 ), pcbIUScale.mmToIU( 25.0 ), pcbIUScale.MM_PER_IU ) );
876
877 m_params.emplace_back( new PARAM_LAMBDA<nlohmann::json>( "defaults.pads",
878 [&]() -> nlohmann::json
879 {
880 nlohmann::json ret =
881 {
882 { "width", pcbIUScale.IUTomm( m_Pad_Master->GetSize( PADSTACK::ALL_LAYERS ).x ) },
883 { "height", pcbIUScale.IUTomm( m_Pad_Master->GetSize( PADSTACK::ALL_LAYERS ).y ) },
884 { "drill", pcbIUScale.IUTomm( m_Pad_Master->GetDrillSize().x ) }
885 };
886
887 return ret;
888 },
889 [&]( const nlohmann::json& aJson )
890 {
891 if( aJson.contains( "width" ) && aJson.contains( "height" )
892 && aJson.contains( "drill" ) )
893 {
894 VECTOR2I sz;
895 sz.x = pcbIUScale.mmToIU( aJson["width"].get<double>() );
896 sz.y = pcbIUScale.mmToIU( aJson["height"].get<double>() );
897
898 m_Pad_Master->SetSize( PADSTACK::ALL_LAYERS, sz );
899
900 int drill = pcbIUScale.mmToIU( aJson["drill"].get<double>() );
901
902 m_Pad_Master->SetDrillSize( VECTOR2I( drill, drill ) );
903 }
904 }, {} ) );
905
906 m_params.emplace_back( new PARAM_SCALED<int>( "rules.max_error",
908 pcbIUScale.mmToIU( 0.0001 ), pcbIUScale.mmToIU( 1.0 ), pcbIUScale.MM_PER_IU ) );
909
910 m_params.emplace_back( new PARAM_SCALED<int>( "rules.solder_mask_to_copper_clearance",
912 pcbIUScale.mmToIU( 0.0 ), pcbIUScale.mmToIU( 25.0 ), pcbIUScale.MM_PER_IU ) );
913
914 m_params.emplace_back( new PARAM<bool>( "zones_allow_external_fillets",
915 &m_ZoneKeepExternalFillets, false ) );
916
918
919 registerMigration( 1, 2,
920 [&]() -> bool
921 {
922 // Schema 1 to 2: move mask and paste margin settings back to board.
923 // The parameters are removed, so we just have to manually load them here and
924 // they will get saved with the board
925 if( std::optional<double> optval = Get<double>( "rules.solder_mask_clearance" ) )
926 m_SolderMaskExpansion = static_cast<int>( *optval * pcbIUScale.IU_PER_MM );
927
928 if( std::optional<double> optval = Get<double>( "rules.solder_mask_min_width" ) )
929 m_SolderMaskMinWidth = static_cast<int>( *optval * pcbIUScale.IU_PER_MM );
930
931 if( std::optional<double> optval = Get<double>( "rules.solder_paste_clearance" ) )
932 m_SolderPasteMargin = static_cast<int>( *optval * pcbIUScale.IU_PER_MM );
933
934 if( std::optional<double> optval = Get<double>( "rules.solder_paste_margin_ratio" ) )
935 m_SolderPasteMarginRatio = *optval;
936
937 try
938 {
939 At( "rules" ).erase( "solder_mask_clearance" );
940 At( "rules" ).erase( "solder_mask_min_width" );
941 At( "rules" ).erase( "solder_paste_clearance" );
942 At( "rules" ).erase( "solder_paste_margin_ratio" );
943 }
944 catch( ... )
945 {}
946
947 return true;
948 } );
949}
950
951
953{
954 if( m_parent )
955 {
956 m_parent->ReleaseNestedSettings( this );
957 m_parent = nullptr;
958 }
959}
960
961
963 NESTED_SETTINGS( "board_design_settings", bdsSchemaVersion, aOther.m_parent,
964 aOther.m_path ),
965 m_Pad_Master( nullptr )
966{
967 initFromOther( aOther );
968}
969
970
972{
973 initFromOther( aOther );
974 return *this;
975}
976
977
979{
980 // Copy of NESTED_SETTINGS around is not allowed, so let's just update the params.
989 m_MinConn = aOther.m_MinConn;
1007 m_MaxError = aOther.m_MaxError;
1020 m_CapVias = aOther.m_CapVias;
1021 m_FillVias = aOther.m_FillVias;
1024
1025 std::copy( std::begin( aOther.m_LineThickness ), std::end( aOther.m_LineThickness ),
1026 std::begin( m_LineThickness ) );
1027
1028 std::copy( std::begin( aOther.m_TextSize ), std::end( aOther.m_TextSize ),
1029 std::begin( m_TextSize ) );
1030
1031 std::copy( std::begin( aOther.m_TextThickness ), std::end( aOther.m_TextThickness ),
1032 std::begin( m_TextThickness ) );
1033
1034 std::copy( std::begin( aOther.m_TextItalic ), std::end( aOther.m_TextItalic ),
1035 std::begin( m_TextItalic ) );
1036
1037 std::copy( std::begin( aOther.m_TextUpright ), std::end( aOther.m_TextUpright ),
1038 std::begin( m_TextUpright ) );
1039
1048
1049 m_auxOrigin = aOther.m_auxOrigin;
1050 m_gridOrigin = aOther.m_gridOrigin;
1051 m_HasStackup = aOther.m_HasStackup;
1053
1067 m_stackup = aOther.m_stackup;
1069 m_Pad_Master = std::make_unique<PAD>( *aOther.m_Pad_Master );
1071
1077}
1078
1079
1081{
1082 if( m_TrackWidthList != aOther.m_TrackWidthList ) return false;
1083 if( m_ViasDimensionsList != aOther.m_ViasDimensionsList ) return false;
1084 if( m_DiffPairDimensionsList != aOther.m_DiffPairDimensionsList ) return false;
1085 if( m_CurrentViaType != aOther.m_CurrentViaType ) return false;
1086 if( m_UseConnectedTrackWidth != aOther.m_UseConnectedTrackWidth ) return false;
1087 if( m_TempOverrideTrackWidth != aOther.m_TempOverrideTrackWidth ) return false;
1088 if( m_MinClearance != aOther.m_MinClearance ) return false;
1089 if( m_MinGrooveWidth != aOther.m_MinGrooveWidth ) return false;
1090 if( m_MinConn != aOther.m_MinConn ) return false;
1091 if( m_TrackMinWidth != aOther.m_TrackMinWidth ) return false;
1092 if( m_ViasMinAnnularWidth != aOther.m_ViasMinAnnularWidth ) return false;
1093 if( m_ViasMinSize != aOther.m_ViasMinSize ) return false;
1094 if( m_MinThroughDrill != aOther.m_MinThroughDrill ) return false;
1095 if( m_MicroViasMinSize != aOther.m_MicroViasMinSize ) return false;
1096 if( m_MicroViasMinDrill != aOther.m_MicroViasMinDrill ) return false;
1097 if( m_CopperEdgeClearance != aOther.m_CopperEdgeClearance ) return false;
1098 if( m_HoleClearance != aOther.m_HoleClearance ) return false;
1099 if( m_HoleToHoleMin != aOther.m_HoleToHoleMin ) return false;
1100 if( m_SilkClearance != aOther.m_SilkClearance ) return false;
1101 if( m_MinResolvedSpokes != aOther.m_MinResolvedSpokes ) return false;
1102 if( m_MinSilkTextHeight != aOther.m_MinSilkTextHeight ) return false;
1103 if( m_MinSilkTextThickness != aOther.m_MinSilkTextThickness ) return false;
1104 if( m_DRCSeverities != aOther.m_DRCSeverities ) return false;
1105 if( m_DrcExclusions != aOther.m_DrcExclusions ) return false;
1106 if( m_DrcExclusionComments != aOther.m_DrcExclusionComments ) return false;
1107 if( m_ZoneKeepExternalFillets != aOther.m_ZoneKeepExternalFillets ) return false;
1108 if( m_MaxError != aOther.m_MaxError ) return false;
1109 if( m_SolderMaskExpansion != aOther.m_SolderMaskExpansion ) return false;
1110 if( m_SolderMaskMinWidth != aOther.m_SolderMaskMinWidth ) return false;
1112 if( m_SolderPasteMargin != aOther.m_SolderPasteMargin ) return false;
1113 if( m_SolderPasteMarginRatio != aOther.m_SolderPasteMarginRatio ) return false;
1115 if( m_TentViasFront != aOther.m_TentViasFront ) return false;
1116 if( m_TentViasBack != aOther.m_TentViasBack ) return false;
1117 if( m_CoverViasFront != aOther.m_CoverViasFront ) return false;
1118 if( m_CoverViasBack != aOther.m_CoverViasBack ) return false;
1119 if( m_PlugViasFront != aOther.m_PlugViasFront ) return false;
1120 if( m_PlugViasBack != aOther.m_PlugViasBack ) return false;
1121 if( m_CapVias != aOther.m_CapVias ) return false;
1122 if( m_FillVias != aOther.m_FillVias ) return false;
1123 if( m_DefaultFPTextItems != aOther.m_DefaultFPTextItems ) return false;
1124 if( m_UserLayerNames != aOther.m_UserLayerNames ) return false;
1125
1126 if( !std::equal( std::begin( m_LineThickness ), std::end( m_LineThickness ),
1127 std::begin( aOther.m_LineThickness ) ) )
1128 return false;
1129
1130 if( !std::equal( std::begin( m_TextSize ), std::end( m_TextSize ),
1131 std::begin( aOther.m_TextSize ) ) )
1132 return false;
1133
1134 if( !std::equal( std::begin( m_TextThickness ), std::end( m_TextThickness ),
1135 std::begin( aOther.m_TextThickness ) ) )
1136 return false;
1137
1138 if( !std::equal( std::begin( m_TextItalic ), std::end( m_TextItalic ),
1139 std::begin( aOther.m_TextItalic ) ) )
1140 return false;
1141
1142 if( !std::equal( std::begin( m_TextUpright ), std::end( m_TextUpright ),
1143 std::begin( aOther.m_TextUpright ) ) )
1144 return false;
1145
1146 if( m_DimensionUnitsMode != aOther.m_DimensionUnitsMode ) return false;
1147 if( m_DimensionPrecision != aOther.m_DimensionPrecision ) return false;
1148 if( m_DimensionUnitsFormat != aOther.m_DimensionUnitsFormat ) return false;
1149 if( m_DimensionSuppressZeroes != aOther.m_DimensionSuppressZeroes ) return false;
1150 if( m_DimensionTextPosition != aOther.m_DimensionTextPosition ) return false;
1151 if( m_DimensionKeepTextAligned != aOther.m_DimensionKeepTextAligned ) return false;
1152 if( m_DimensionArrowLength != aOther.m_DimensionArrowLength ) return false;
1153 if( m_DimensionExtensionOffset != aOther.m_DimensionExtensionOffset ) return false;
1154 if( m_auxOrigin != aOther.m_auxOrigin ) return false;
1155 if( m_gridOrigin != aOther.m_gridOrigin ) return false;
1156 if( m_HasStackup != aOther.m_HasStackup ) return false;
1157 if( m_UseHeightForLengthCalcs != aOther.m_UseHeightForLengthCalcs ) return false;
1158 if( m_trackWidthIndex != aOther.m_trackWidthIndex ) return false;
1159 if( m_viaSizeIndex != aOther.m_viaSizeIndex ) return false;
1160 if( m_diffPairIndex != aOther.m_diffPairIndex ) return false;
1161 if( m_useCustomTrackVia != aOther.m_useCustomTrackVia ) return false;
1162 if( m_customTrackWidth != aOther.m_customTrackWidth ) return false;
1163 if( m_customViaSize != aOther.m_customViaSize ) return false;
1164 if( m_useCustomDiffPair != aOther.m_useCustomDiffPair ) return false;
1165 if( m_customDiffPair != aOther.m_customDiffPair ) return false;
1166 if( m_copperLayerCount != aOther.m_copperLayerCount ) return false;
1167 if( m_userDefinedLayerCount != aOther.m_userDefinedLayerCount ) return false;
1168 if( m_enabledLayers != aOther.m_enabledLayers ) return false;
1169 if( m_boardThickness != aOther.m_boardThickness ) return false;
1170 if( m_currentNetClassName != aOther.m_currentNetClassName ) return false;
1171 if( m_stackup != aOther.m_stackup ) return false;
1172 if( *m_NetSettings != *aOther.m_NetSettings ) return false;
1173 if( *m_Pad_Master != *aOther.m_Pad_Master ) return false;
1174 if( m_defaultZoneSettings != aOther.m_defaultZoneSettings ) return false;
1175
1176 if( m_StyleFPFields != aOther.m_StyleFPFields ) return false;
1177 if( m_StyleFPText != aOther.m_StyleFPText ) return false;
1178 if( m_StyleFPShapes != aOther.m_StyleFPShapes ) return false;
1179 if( m_StyleFPDimensions != aOther.m_StyleFPDimensions ) return false;
1180 if( m_StyleFPBarcodes != aOther.m_StyleFPBarcodes ) return false;
1181
1182 return true;
1183}
1184
1185
1187{
1205 std::string units_ptr( "defaults.dimension_units" );
1206 std::string precision_ptr( "defaults.dimension_precision" );
1207
1208 if( !( Contains( units_ptr )
1209 && Contains( precision_ptr )
1210 && At( units_ptr ).is_number_integer()
1211 && At( precision_ptr ).is_number_integer() ) )
1212 {
1213 // if either is missing or invalid, migration doesn't make sense
1214 return true;
1215 }
1216
1217 int units = *Get<int>( units_ptr );
1218 int precision = *Get<int>( precision_ptr );
1219
1220 // The enum maps directly to precision if the units is mils
1221 int extraDigits = 0;
1222
1223 switch( units )
1224 {
1225 case 0: extraDigits = 3; break;
1226 case 2: extraDigits = 2; break;
1227 default: break;
1228 }
1229
1230 precision += extraDigits;
1231
1232 Set( precision_ptr, precision );
1233
1234 return true;
1235}
1236
1237
1238bool BOARD_DESIGN_SETTINGS::LoadFromFile( const wxString& aDirectory )
1239{
1240 bool ret = NESTED_SETTINGS::LoadFromFile( aDirectory );
1241
1242 // A number of things won't have been translated by the PROJECT_FILE migration because of
1243 // descoped objects required to decode this data. So, it will be in the legacy.pcbnew
1244 // section and needs to be pulled out here
1245
1246 PROJECT_FILE* project = dynamic_cast<PROJECT_FILE*>( GetParent() );
1247
1248 if( !project )
1249 return ret;
1250
1251 bool migrated = false;
1252
1253 auto drcName =
1254 []( int aCode ) -> std::string
1255 {
1256 return std::string( DRC_ITEM::Create( aCode )->GetSettingsKey().ToUTF8() );
1257 };
1258
1259 const std::string rs = "rule_severities.";
1260 const std::string no_courtyard_key = "legacy_no_courtyard_defined";
1261 const std::string courtyard_overlap_key = "legacy_courtyards_overlap";
1262
1263 try
1264 {
1265 nlohmann::json& severities =
1266 project->Internals()->at( "/board/design_settings/rule_severities"_json_pointer );
1267
1268 if( severities.contains( no_courtyard_key ) )
1269 {
1270 if( severities[no_courtyard_key].get<bool>() )
1271 Set( rs + drcName( DRCE_MISSING_COURTYARD ), "error" );
1272 else
1273 Set( rs + drcName( DRCE_MISSING_COURTYARD ), "ignore" );
1274
1275 severities.erase( no_courtyard_key );
1276 migrated = true;
1277 }
1278
1279 if( severities.contains( courtyard_overlap_key ) )
1280 {
1281 if( severities[courtyard_overlap_key].get<bool>() )
1282 Set( rs + drcName( DRCE_OVERLAPPING_FOOTPRINTS ), "error" );
1283 else
1284 Set( rs + drcName( DRCE_OVERLAPPING_FOOTPRINTS ), "ignore" );
1285
1286 severities.erase( courtyard_overlap_key );
1287 migrated = true;
1288 }
1289 }
1290 catch( ... )
1291 {
1292 }
1293
1294 if( Contains( "legacy" ) )
1295 {
1296 // This defaults to false for new boards, but version 5.1.x and prior kept the fillets
1297 // so we do the same for legacy boards.
1299
1300 project->At( "legacy" ).erase( "pcbnew" );
1301 }
1302
1303 // Now that we have everything, we need to load again
1304 if( migrated )
1305 Load();
1306
1307 return ret;
1308}
1309
1310
1312{
1313 return m_DRCSeverities[ aDRCErrorCode ];
1314}
1315
1316
1317bool BOARD_DESIGN_SETTINGS::Ignore( int aDRCErrorCode )
1318{
1319 return m_DRCSeverities[ aDRCErrorCode ] == RPT_SEVERITY_IGNORE;
1320}
1321
1322
1324{
1325 int biggest = std::max( m_MinClearance, m_HoleClearance );
1326 DRC_CONSTRAINT constraint;
1327
1328 biggest = std::max( biggest, m_HoleToHoleMin );
1329 biggest = std::max( biggest, m_CopperEdgeClearance );
1330
1331 if( m_DRCEngine )
1332 {
1333 m_DRCEngine->QueryWorstConstraint( CLEARANCE_CONSTRAINT, constraint );
1334 biggest = std::max( biggest, constraint.Value().Min() );
1335
1336 m_DRCEngine->QueryWorstConstraint( PHYSICAL_CLEARANCE_CONSTRAINT, constraint );
1337 biggest = std::max( biggest, constraint.Value().Min() );
1338
1339 m_DRCEngine->QueryWorstConstraint( HOLE_CLEARANCE_CONSTRAINT, constraint );
1340 biggest = std::max( biggest, constraint.Value().Min() );
1341
1342 m_DRCEngine->QueryWorstConstraint( EDGE_CLEARANCE_CONSTRAINT, constraint );
1343 biggest = std::max( biggest, constraint.Value().Min() );
1344
1345 m_DRCEngine->QueryWorstConstraint( HOLE_TO_HOLE_CONSTRAINT, constraint );
1346 biggest = std::max( biggest, constraint.Value().Min() );
1347 }
1348
1349 // Clip to avoid integer overflows in subsequent calculations
1350 return std::min( biggest, MAXIMUM_CLEARANCE );
1351}
1352
1353
1355{
1356 int clearance = m_NetSettings->GetDefaultNetclass()->GetClearance();
1357
1358 for( const auto& [name, netclass] : m_NetSettings->GetNetclasses() )
1359 clearance = std::min( clearance, netclass->GetClearance() );
1360
1361 return clearance;
1362}
1363
1364
1366{
1367 m_viaSizeIndex = std::min( aIndex, (int) m_ViasDimensionsList.size() - 1 );
1368 m_useCustomTrackVia = false;
1369}
1370
1371
1373{
1375 return m_customViaSize.m_Diameter;
1377 return m_NetSettings->GetDefaultNetclass()->GetViaDiameter();
1378 else
1379 return m_ViasDimensionsList[ m_viaSizeIndex ].m_Diameter;
1380}
1381
1382
1384{
1385 int drill;
1386
1388 drill = m_customViaSize.m_Drill;
1390 drill = m_NetSettings->GetDefaultNetclass()->GetViaDrill();
1391 else
1392 drill = m_ViasDimensionsList[ m_viaSizeIndex ].m_Drill;
1393
1394 return drill > 0 ? drill : -1;
1395}
1396
1397
1399{
1400 m_trackWidthIndex = std::min( aIndex, (int) m_TrackWidthList.size() - 1 );
1401 m_useCustomTrackVia = false;
1402}
1403
1404
1406{
1408 return m_customTrackWidth;
1410 return m_NetSettings->GetDefaultNetclass()->GetTrackWidth();
1411 else
1413}
1414
1415
1417{
1418 if( !m_DiffPairDimensionsList.empty() )
1419 m_diffPairIndex = std::min( aIndex, (int) m_DiffPairDimensionsList.size() - 1 );
1420
1421 m_useCustomDiffPair = false;
1422}
1423
1424
1426{
1428 {
1429 return m_customDiffPair.m_Width;
1430 }
1432 {
1433 if( m_NetSettings->GetDefaultNetclass()->HasDiffPairWidth() )
1434 return m_NetSettings->GetDefaultNetclass()->GetDiffPairWidth();
1435 else
1436 return m_NetSettings->GetDefaultNetclass()->GetTrackWidth();
1437 }
1438 else
1439 {
1441 }
1442}
1443
1444
1446{
1448 {
1449 return m_customDiffPair.m_Gap;
1450 }
1452 {
1453 if( m_NetSettings->GetDefaultNetclass()->HasDiffPairGap() )
1454 return m_NetSettings->GetDefaultNetclass()->GetDiffPairGap();
1455 else
1456 return m_NetSettings->GetDefaultNetclass()->GetClearance();
1457 }
1458 else
1459 {
1461 }
1462}
1463
1464
1466{
1468 {
1469 return m_customDiffPair.m_ViaGap;
1470 }
1472 {
1473 if( m_NetSettings->GetDefaultNetclass()->HasDiffPairViaGap() )
1474 return m_NetSettings->GetDefaultNetclass()->GetDiffPairViaGap();
1475 else
1476 return GetCurrentDiffPairGap();
1477 }
1478 else
1479 {
1481 }
1482}
1483
1484
1486{
1487 m_copperLayerCount = aNewLayerCount;
1488
1489 // Update only enabled copper layers mask
1490 m_enabledLayers.ClearCopperLayers();
1491
1492 if( aNewLayerCount > 0 )
1493 m_enabledLayers |= LSET::AllCuMask( aNewLayerCount );
1494}
1495
1496
1498{
1499 m_userDefinedLayerCount = aNewLayerCount;
1500
1501 m_enabledLayers.ClearUserDefinedLayers();
1502
1503 if( aNewLayerCount > 0 )
1504 m_enabledLayers |= LSET::UserDefinedLayersMask( aNewLayerCount );
1505}
1506
1507
1509{
1510 m_enabledLayers = aMask;
1511
1512 // Ensures mandatory back and front layers are always enabled regardless of board file
1513 // configuration.
1514 m_enabledLayers.set( B_Cu ).set( F_Cu )
1515 .set( B_CrtYd ).set( F_CrtYd )
1516 .set( Edge_Cuts )
1517 .set( Margin );
1518
1519 // update layer counts to ensure their consistency with m_EnabledLayers
1520 LSET copperLayers = aMask;
1521 copperLayers.ClearNonCopperLayers();
1522
1523 LSET userLayers = aMask & LSET::UserDefinedLayersMask();
1524
1525 m_copperLayerCount = (int) copperLayers.count();
1526 m_userDefinedLayerCount = (int) userLayers.count();
1527}
1528
1529
1530// Return the layer class index { silk, copper, edges & courtyards, fab, others } of the
1531// given layer.
1533{
1534 if( aLayer == F_SilkS || aLayer == B_SilkS )
1535 return LAYER_CLASS_SILK;
1536 else if( IsCopperLayer( aLayer ) )
1537 return LAYER_CLASS_COPPER;
1538 else if( aLayer == Edge_Cuts )
1539 return LAYER_CLASS_EDGES;
1540 else if( aLayer == F_CrtYd || aLayer == B_CrtYd )
1541 return LAYER_CLASS_COURTYARD;
1542 else if( aLayer == F_Fab || aLayer == B_Fab )
1543 return LAYER_CLASS_FAB;
1544 else
1545 return LAYER_CLASS_OTHERS;
1546}
1547
1548
1550{
1551 return pcbIUScale.mmToIU( ADVANCED_CFG::GetCfg().m_DRCEpsilon );
1552}
1553
1554
1556{
1557 return pcbIUScale.mmToIU( ADVANCED_CFG::GetCfg().m_HoleWallThickness );
1558}
1559
1560
1562{
1563 return m_LineThickness[ GetLayerClass( aLayer ) ];
1564}
1565
1566
1568{
1569 return m_TextSize[ GetLayerClass( aLayer ) ];
1570}
1571
1572
1574{
1575 return m_TextThickness[ GetLayerClass( aLayer ) ];
1576}
1577
1578
1580{
1581 return m_TextItalic[ GetLayerClass( aLayer ) ];
1582}
1583
1584
1586{
1587 return m_TextUpright[ GetLayerClass( aLayer ) ];
1588}
1589
1591{
1592 m_Pad_Master->SetSizeX( pcbIUScale.mmToIU( DEFAULT_PAD_WIDTH_MM ) );
1593 m_Pad_Master->SetSizeY( pcbIUScale.mmToIU( DEFAULT_PAD_HEIGTH_MM ) );
1594 m_Pad_Master->SetDrillShape( PAD_DRILL_SHAPE::CIRCLE );
1595 m_Pad_Master->SetDrillSize( VECTOR2I( pcbIUScale.mmToIU( DEFAULT_PAD_DRILL_DIAMETER_MM ), 0 ) );
1597
1598 constexpr double RR_RADIUS = DEFAULT_PAD_HEIGTH_MM * DEFAULT_PAD_RR_RADIUS_RATIO;
1599 m_Pad_Master->SetRoundRectCornerRadius( PADSTACK::ALL_LAYERS, pcbIUScale.mmToIU( RR_RADIUS ) );
1600
1601 if( m_Pad_Master->GetFrontShape() == PAD_SHAPE::CIRCLE )
1602 m_Pad_Master->SetThermalSpokeAngle( ANGLE_45 );
1603 else
1604 m_Pad_Master->SetThermalSpokeAngle( ANGLE_90 );
1605}
const char * name
constexpr int ARC_HIGH_DEF
Definition base_units.h:129
constexpr EDA_IU_SCALE pcbIUScale
Definition base_units.h:112
const int bdsSchemaVersion
#define DEFAULT_MICROVIASMINDRILL
#define DEFAULT_SOLDERPASTE_CLEARANCE
#define DEFAULT_SOLDERPASTE_RATIO
#define DEFAULT_CUSTOMDPAIRWIDTH
#define DEFAULT_DP_MEANDER_SPACING
@ LAYER_CLASS_OTHERS
@ LAYER_CLASS_FAB
@ LAYER_CLASS_COURTYARD
@ LAYER_CLASS_SILK
@ LAYER_CLASS_COPPER
@ LAYER_CLASS_EDGES
#define DEFAULT_PAD_WIDTH_MM
#define DEFAULT_VIASMINSIZE
#define DEFAULT_PAD_DRILL_DIAMETER_MM
#define DEFAULT_TEXT_WIDTH
#define DEFAULT_COPPER_TEXT_WIDTH
#define DEFAULT_CUSTOMDPAIRGAP
#define DEFAULT_MINCLEARANCE
#define DEFAULT_HOLECLEARANCE
#define DEFAULT_SOLDERMASK_EXPANSION
#define DEFAULT_SOLDERMASK_MIN_WIDTH
#define DEFAULT_DIMENSION_EXTENSION_OFFSET
#define DEFAULT_COPPEREDGECLEARANCE
#define DEFAULT_PAD_HEIGTH_MM
#define DEFAULT_DIMENSION_ARROW_LENGTH
#define DEFAULT_TRACKMINWIDTH
#define DEFAULT_MINTHROUGHDRILL
#define DEFAULT_PAD_RR_RADIUS_RATIO
#define DEFAULT_SILK_TEXT_SIZE
#define MAXIMUM_CLEARANCE
#define DEFAULT_HOLETOHOLEMIN
#define DEFAULT_MINCONNECTION
#define DEFAULT_COPPER_LINE_WIDTH
#define DEFAULT_SILK_LINE_WIDTH
#define DEFAULT_SILKCLEARANCE
#define DEFAULT_MICROVIASMINSIZE
#define DEFAULT_SILK_TEXT_WIDTH
#define DEFAULT_MINGROOVEWIDTH
#define DEFAULT_TEXT_SIZE
#define DEFAULT_EDGE_WIDTH
#define DEFAULT_CUSTOMTRACKWIDTH
#define DEFAULT_CUSTOMDPAIRVIAGAP
#define DEFAULT_COPPER_TEXT_SIZE
#define DEFAULT_SOLDERMASK_TO_COPPER_CLEARANCE
#define DEFAULT_LINE_WIDTH
#define DEFAULT_MEANDER_SPACING
#define DEFAULT_COURTYARD_WIDTH
#define DEFAULT_BOARD_THICKNESS_MM
#define DEFAULT_MINRESOLVEDSPOKES
static const ADVANCED_CFG & GetCfg()
Get the singleton instance's config, which is shared by all consumers.
BASE_SET & set(size_t pos)
Definition base_set.h:116
DIM_PRECISION m_DimensionPrecision
Number of digits after the decimal.
std::vector< TEXT_ITEM_INFO > m_DefaultFPTextItems
int GetHolePlatingThickness() const
Pad & via drills are finish size.
VIATYPE m_CurrentViaType
(VIA_BLIND_BURIED, VIA_THROUGH, VIA_MICROVIA)
void SetEnabledLayers(const LSET &aMask)
Change the bit-mask of enabled layers to aMask.
std::shared_ptr< NET_SETTINGS > m_NetSettings
bool operator==(const BOARD_DESIGN_SETTINGS &aOther) const
std::map< wxString, wxString > m_DrcExclusionComments
DIM_UNITS_FORMAT m_DimensionUnitsFormat
void initFromOther(const BOARD_DESIGN_SETTINGS &aOther)
bool GetTextUpright(PCB_LAYER_ID aLayer) const
std::map< int, SEVERITY > m_DRCSeverities
VECTOR2I m_gridOrigin
origin for grid offsets
int GetTextThickness(PCB_LAYER_ID aLayer) const
Return the default text thickness from the layer class for the given layer.
VECTOR2I m_auxOrigin
origin for plot exports
bool m_TextUpright[LAYER_CLASS_COUNT]
BOARD_DESIGN_SETTINGS(JSON_SETTINGS *aParent, const std::string &aPath)
bool GetTextItalic(PCB_LAYER_ID aLayer) const
wxString m_currentNetClassName
Current net class name used to display netclass info.
void SetViaSizeIndex(int aIndex)
Set the current via size list index to aIndex.
std::shared_ptr< DRC_ENGINE > m_DRCEngine
std::vector< DIFF_PAIR_DIMENSION > m_DiffPairDimensionsList
std::set< wxString > m_DrcExclusions
bool Ignore(int aDRCErrorCode)
Return true if the DRC error code's severity is SEVERITY_IGNORE.
std::map< std::string, wxString > m_UserLayerNames
std::unique_ptr< PAD > m_Pad_Master
TEARDROP_PARAMETERS_LIST m_TeardropParamsList
The parameters of teardrops for the different teardrop targets (via/pad, track end).
void SetUserDefinedLayerCount(int aNewLayerCount)
Set the number of user defined layers to aNewLayerCount.
int GetDRCEpsilon() const
Return an epsilon which accounts for rounding errors, etc.
int GetLayerClass(PCB_LAYER_ID aLayer) const
PNS::MEANDER_SETTINGS m_DiffPairMeanderSettings
int m_boardThickness
Board thickness for 3D viewer.
int m_copperLayerCount
Number of copper layers for this design.
int m_userDefinedLayerCount
Number of user defined layers for this design.
bool LoadFromFile(const wxString &aDirectory="") override
Loads the backing file from disk and then calls Load()
PNS::MEANDER_SETTINGS m_SingleTrackMeanderSettings
void SetTrackWidthIndex(int aIndex)
Set the current track width list index to aIndex.
int m_TextThickness[LAYER_CLASS_COUNT]
ZONE_SETTINGS m_defaultZoneSettings
The default settings that will be used for new zones.
SEVERITY GetSeverity(int aDRCErrorCode)
std::vector< int > m_TrackWidthList
DIFF_PAIR_DIMENSION m_customDiffPair
int m_LineThickness[LAYER_CLASS_COUNT]
VECTOR2I GetTextSize(PCB_LAYER_ID aLayer) const
Return the default text size from the layer class for the given layer.
int GetLineThickness(PCB_LAYER_ID aLayer) const
Return the default graphic segment thickness from the layer class for the given layer.
bool m_UseHeightForLengthCalcs
Enable inclusion of stackup height in track length measurements and length tuning.
VECTOR2I m_TextSize[LAYER_CLASS_COUNT]
PNS::MEANDER_SETTINGS m_SkewMeanderSettings
LSET m_enabledLayers
Bit-mask for layer enabling.
bool m_TextItalic[LAYER_CLASS_COUNT]
void SetCopperLayerCount(int aNewLayerCount)
Set the copper layer count to aNewLayerCount.
DIM_TEXT_POSITION m_DimensionTextPosition
BOARD_STACKUP m_stackup
The description of layers stackup, for board fabrication only physical layers are in layers stackup.
std::vector< VIA_DIMENSION > m_ViasDimensionsList
BOARD_DESIGN_SETTINGS & operator=(const BOARD_DESIGN_SETTINGS &aOther)
MINOPTMAX< int > & Value()
Definition drc_rule.h:188
static std::vector< std::reference_wrapper< RC_ITEM > > GetItemsWithSeverities()
Definition drc_item.h:143
static std::shared_ptr< DRC_ITEM > Create(int aErrorCode)
Constructs a DRC_ITEM for the given error code.
Definition drc_item.cpp:405
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...
bool Contains(const std::string &aPath) const
virtual void Load()
Updates the parameters of this object based on the current JSON document contents.
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.
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...
JSON_SETTINGS(const wxString &aFilename, SETTINGS_LOC aLocation, int aSchemaVersion)
bool m_resetParamsIfMissing
Whether or not to set parameters to their default value if missing from JSON on Load()
LSET is a set of PCB_LAYER_IDs.
Definition lset.h:37
static const LSET & AllCuMask()
return AllCuMask( MAX_CU_LAYERS );
Definition lset.cpp:608
LSET & ClearNonCopperLayers()
Clear the non-copper layers in this set.
Definition lset.cpp:951
static LSET UserDefinedLayersMask(int aUserDefinedLayerCount=MAX_USER_DEFINED_LAYERS)
Return a mask with the requested number of user defined layers.
Definition lset.cpp:704
T Min() const
Definition minoptmax.h:33
std::string m_path
The path (in pointer format) of where to store this document in the parent.
JSON_SETTINGS * GetParent()
JSON_SETTINGS * m_parent
A pointer to the parent object to load and store from.
NESTED_SETTINGS(const std::string &aName, int aSchemaVersion, JSON_SETTINGS *aParent, const std::string &aPath, bool aLoadFromFile=true)
bool LoadFromFile(const wxString &aDirectory="") override
Loads the JSON document from the parent and then calls Load()
static constexpr PCB_LAYER_ID ALL_LAYERS
! Temporary layer identifier to identify code that is not padstack-aware
Definition padstack.h:177
Stores an enum as an integer.
Definition parameters.h:230
Like a normal param, but with custom getter and setter functions.
Definition parameters.h:297
Represents a parameter that has a scaling factor between the value in the file and the value used int...
Definition parameters.h:394
Dimensions for the meandering algorithm.
Definition pns_meander.h:70
int m_minAmplitude
Maximum meandering amplitude.
Definition pns_meander.h:95
int m_cornerRadiusPercentage
Place meanders on one side.
bool m_singleSided
Initial side when placing meanders at segment.
MEANDER_STYLE m_cornerStyle
Rounding percentage (0 - 100).
int m_maxAmplitude
Meandering period/spacing (see dialog picture for explanation).
Definition pns_meander.h:98
int m_spacing
Amplitude/spacing adjustment step.
The backing store for a PROJECT, in JSON format.
A holder for a rule check item, DRC in Pcbnew or ERC in Eeschema.
Definition rc_item.h:81
TEARDROP_PARAMETARS is a helper class to handle parameters needed to build teardrops for a board thes...
double m_BestWidthRatio
The height of a teardrop as ratio between height and size of pad/via.
int m_TdMaxLen
max allowed length for teardrops in IU. <= 0 to disable
bool m_AllowUseTwoTracks
True to create teardrops using 2 track segments if the first in too small.
int m_TdMaxWidth
max allowed height for teardrops in IU. <= 0 to disable
double m_BestLengthRatio
The length of a teardrop as ratio between length and size of pad/via.
double m_WidthtoSizeFilterRatio
The ratio (H/D) between the via/pad size and the track width max value to create a teardrop 1....
bool m_TdOnPadsInZones
A filter to exclude pads inside zone fills.
bool m_CurvedEdges
True if the teardrop should be curved.
@ DRCE_TUNING_PROFILE_IMPLICIT_RULES
Definition drc_item.h:114
@ DRCE_SILK_EDGE_CLEARANCE
Definition drc_item.h:99
@ DRCE_FOOTPRINT_FILTERS
Definition drc_item.h:80
@ DRCE_SILK_MASK_CLEARANCE
Definition drc_item.h:97
@ DRCE_PADSTACK
Definition drc_item.h:63
@ DRCE_MIRRORED_TEXT_ON_FRONT_LAYER
Definition drc_item.h:110
@ DRCE_LIB_FOOTPRINT_ISSUES
Definition drc_item.h:83
@ DRCE_OVERLAPPING_FOOTPRINTS
Definition drc_item.h:66
@ DRCE_SCHEMATIC_FIELDS_PARITY
Definition drc_item.h:120
@ DRCE_MISSING_COURTYARD
Definition drc_item.h:67
@ DRCE_TRACK_NOT_CENTERED_ON_VIA
Definition drc_item.h:118
@ DRCE_ISOLATED_COPPER
Definition drc_item.h:49
@ DRCE_MISSING_TUNING_PROFILE
Definition drc_item.h:113
@ DRCE_DRILLED_HOLES_TOO_CLOSE
Definition drc_item.h:53
@ DRCE_COPPER_SLIVER
Definition drc_item.h:93
@ DRCE_PTH_IN_COURTYARD
Definition drc_item.h:70
@ DRCE_FIRST
Definition drc_item.h:39
@ DRCE_DANGLING_VIA
Definition drc_item.h:51
@ DRCE_FOOTPRINT_TYPE_MISMATCH
Definition drc_item.h:82
@ DRCE_NONMIRRORED_TEXT_ON_BACK_LAYER
Definition drc_item.h:111
@ DRCE_DUPLICATE_FOOTPRINT
Definition drc_item.h:76
@ DRCE_DANGLING_TRACK
Definition drc_item.h:52
@ DRCE_TEXT_HEIGHT
Definition drc_item.h:101
@ DRCE_DRILLED_HOLES_COLOCATED
Definition drc_item.h:54
@ DRCE_EXTRA_FOOTPRINT
Definition drc_item.h:77
@ DRCE_SILK_CLEARANCE
Definition drc_item.h:100
@ DRCE_LAST
Definition drc_item.h:122
@ DRCE_LIB_FOOTPRINT_MISMATCH
Definition drc_item.h:84
@ DRCE_NET_CONFLICT
Definition drc_item.h:78
@ DRCE_MISSING_FOOTPRINT
Definition drc_item.h:75
@ DRCE_TEXT_THICKNESS
Definition drc_item.h:102
@ DRCE_NPTH_IN_COURTYARD
Definition drc_item.h:71
@ DRCE_CONNECTION_WIDTH
Definition drc_item.h:60
@ DRCE_SCHEMATIC_PARITY
Definition drc_item.h:79
@ EDGE_CLEARANCE_CONSTRAINT
Definition drc_rule.h:53
@ CLEARANCE_CONSTRAINT
Definition drc_rule.h:49
@ HOLE_CLEARANCE_CONSTRAINT
Definition drc_rule.h:51
@ PHYSICAL_CLEARANCE_CONSTRAINT
Definition drc_rule.h:77
@ HOLE_TO_HOLE_CONSTRAINT
Definition drc_rule.h:52
static constexpr EDA_ANGLE ANGLE_90
Definition eda_angle.h:413
static constexpr EDA_ANGLE ANGLE_45
Definition eda_angle.h:412
#define TEXT_MIN_SIZE_MM
Minimum text size (1 micron).
Definition eda_text.h:47
#define TEXT_MAX_SIZE_MM
Maximum text size in mm (~10 inches)
Definition eda_text.h:48
bool IsCopperLayer(int aLayerId)
Test whether a layer is a copper layer.
Definition layer_ids.h:677
PCB_LAYER_ID
A quick note on layer IDs:
Definition layer_ids.h:60
@ F_CrtYd
Definition layer_ids.h:116
@ Edge_Cuts
Definition layer_ids.h:112
@ B_Cu
Definition layer_ids.h:65
@ F_Fab
Definition layer_ids.h:119
@ Margin
Definition layer_ids.h:113
@ F_SilkS
Definition layer_ids.h:100
@ B_CrtYd
Definition layer_ids.h:115
@ B_SilkS
Definition layer_ids.h:101
@ F_Cu
Definition layer_ids.h:64
@ B_Fab
Definition layer_ids.h:118
@ MEANDER_STYLE_ROUND
Definition pns_meander.h:54
@ MEANDER_STYLE_CHAMFER
Definition pns_meander.h:55
@ ROUNDRECT
Definition padstack.h:57
@ OUTSIDE
Text appears outside the dimension line (default)
@ INLINE
Text appears in line with the dimension line.
SEVERITY
@ RPT_SEVERITY_WARNING
@ RPT_SEVERITY_ERROR
@ RPT_SEVERITY_IGNORE
Container to handle a stock of specific differential pairs each with unique track width,...
Container to handle a stock of specific vias each with unique diameter and drill sizes in the BOARD c...
std::string GetTeardropTargetCanonicalName(TARGET_TD aTdType)
TARGET_TD GetTeardropTargetTypeFromCanonicalName(const std::string &aTargetName)
int clearance
SEVERITY SeverityFromString(const wxString &aSeverity)
Definition ui_common.cpp:56
wxString SeverityToString(const SEVERITY &aSeverity)
Definition ui_common.cpp:67
VECTOR2< int32_t > VECTOR2I
Definition vector2d.h:695
#define ZONE_CLEARANCE_MM
Definition zones.h:36