KiCad PCB EDA Suite
Loading...
Searching...
No Matches
advanced_config.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) 2019-2023 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 <advanced_config.h>
25
26#include <config_params.h>
27#include <paths.h>
28
29#include <wx/app.h>
30#include <wx/config.h>
31#include <wx/filename.h>
32#include <wx/log.h>
33#include <wx/tokenzr.h>
34
35/*
36 * Flag to enable advanced config debugging
37 *
38 * Use "KICAD_ADVANCED_CONFIG" to enable.
39 *
40 * @ingroup trace_env_vars
41 */
42static const wxChar AdvancedConfigMask[] = wxT( "KICAD_ADVANCED_CONFIG" );
43
49namespace AC_STACK
50{
51 static constexpr int min_stack = 32 * 4096;
52 static constexpr int default_stack = 256 * 4096;
53 static constexpr int max_stack = 4096 * 4096;
54}
55
62namespace AC_KEYS
63{
64
68static const wxChar IncrementalConnectivity[] = wxT( "IncrementalConnectivity" );
69
73static const wxChar Use3DConnexionDriver[] = wxT( "3DConnexionDriver" );
74
79static const wxChar ExtraFillMargin[] = wxT( "ExtraFillMargin" );
80
86static const wxChar DRCEpsilon[] = wxT( "DRCEpsilon" );
87
91static const wxChar DRCSliverWidthTolerance[] = wxT( "DRCSliverWidthTolerance" );
92static const wxChar DRCSliverMinimumLength[] = wxT( "DRCSliverMinimumLength" );
93static const wxChar DRCSliverAngleTolerance[] = wxT( "DRCSliverAngleTolerance" );
94
100static const wxChar HoleWallThickness[] = wxT( "HoleWallPlatingThickness" );
101
106static const wxChar CoroutineStackSize[] = wxT( "CoroutineStackSize" );
107
111static const wxChar ShowRouterDebugGraphics[] = wxT( "ShowRouterDebugGraphics" );
112
116static const wxChar EnableRouterDump[] = wxT( "EnableRouterDump" );
117
121static const wxChar HyperZoom[] = wxT( "HyperZoom" );
122
127static const wxChar CompactFileSave[] = wxT( "CompactSave" );
128
136static const wxChar DrawArcAccuracy[] = wxT( "DrawArcAccuracy" );
137
144static const wxChar DrawArcCenterStartEndMaxAngle[] = wxT( "DrawArcCenterStartEndMaxAngle" );
145
151static const wxChar MaxTangentTrackAngleDeviation[] = wxT( "MaxTangentTrackAngleDeviation" );
152
157static const wxChar MaxTrackLengthToKeep[] = wxT( "MaxTrackLengthToKeep" );
158
162static const wxChar StrokeTriangulation[] = wxT( "StrokeTriangulation" );
163
168static const wxChar ExtraZoneDisplayModes[] = wxT( "ExtraZoneDisplayModes" );
169
174static const wxChar MinPlotPenWidth[] = wxT( "MinPlotPenWidth" );
175
176static const wxChar DebugZoneFiller[] = wxT( "DebugZoneFiller" );
177
178static const wxChar DebugPDFWriter[] = wxT( "DebugPDFWriter" );
179
184static const wxChar SmallDrillMarkSize[] = wxT( "SmallDrillMarkSize" );
185
186static const wxChar HotkeysDumper[] = wxT( "HotkeysDumper" );
187
188static const wxChar DrawBoundingBoxes[] = wxT( "DrawBoundingBoxes" );
189
190static const wxChar ShowPcbnewExportNetlist[] = wxT( "ShowPcbnewExportNetlist" );
191
192static const wxChar Skip3DModelFileCache[] = wxT( "Skip3DModelFileCache" );
193
194static const wxChar Skip3DModelMemoryCache[] = wxT( "Skip3DModelMemoryCache" );
195
196static const wxChar HideVersionFromTitle[] = wxT( "HideVersionFromTitle" );
197
198static const wxChar TraceMasks[] = wxT( "TraceMasks" );
199
200static const wxChar ShowRepairSchematic[] = wxT( "ShowRepairSchematic" );
201
202static const wxChar ShowEventCounters[] = wxT( "ShowEventCounters" );
203
204static const wxChar AllowManualCanvasScale[] = wxT( "AllowManualCanvasScale" );
205
206static const wxChar UpdateUIEventInterval[] = wxT( "UpdateUIEventInterval" );
207
208static const wxChar V3DRT_BevelHeight_um[] = wxT( "V3DRT_BevelHeight_um" );
209
210static const wxChar V3DRT_BevelExtentFactor[] = wxT( "V3DRT_BevelExtentFactor" );
211
212static const wxChar UseClipper2[] = wxT( "UseClipper2" );
213
214static const wxChar EnableGenerators[] = wxT( "EnableGenerators" );
215
216static const wxChar EnableGit[] = wxT( "EnableGit" );
217
218static const wxChar EnableEeschemaPrintCairo[] = wxT( "EnableEeschemaPrintCairo" );
219
223static const wxChar DisambiguationTime[] = wxT( "DisambiguationTime" );
224} // namespace KEYS
225
226
231namespace AC_GROUPS
232{
233static const wxChar V3D_RayTracing[] = wxT( "G_3DV_RayTracing" );
234}
235
236/*
237 * Get a simple string for common parameters.
238 *
239 * This isn't exhaustive, but it covers most common types that might be
240 * used in the advance config
241 */
242wxString dumpParamCfg( const PARAM_CFG& aParam )
243{
244 wxString s = aParam.m_Ident + wxS( ": " );
245
246 /*
247 * This implementation is rather simplistic, but it is
248 * effective enough for simple uses. A better implementation would be
249 * some kind of visitor, but that's somewhat more work.
250 */
251 switch( aParam.m_Type )
252 {
255 s << *static_cast<const PARAM_CFG_INT&>( aParam ).m_Pt_param;
256 break;
258 s << *static_cast<const PARAM_CFG_DOUBLE&>( aParam ).m_Pt_param;
259 break;
261 s << *static_cast<const PARAM_CFG_WXSTRING&>( aParam ).m_Pt_param;
262 break;
264 s << *static_cast<const PARAM_CFG_FILENAME&>( aParam ).m_Pt_param;
265 break;
267 s << ( *static_cast<const PARAM_CFG_BOOL&>( aParam ).m_Pt_param ? wxS( "true" ) : wxS( "false" ) );
268 break;
269 default: s << wxS( "Unsupported PARAM_CFG variant: " ) << aParam.m_Type;
270 }
271
272 return s;
273}
274
275
279static void dumpCfg( const std::vector<PARAM_CFG*>& aArray )
280{
281 // only dump if we need to
282 if( !wxLog::IsAllowedTraceMask( AdvancedConfigMask ) )
283 return;
284
285 for( const PARAM_CFG* param : aArray )
286 {
287 wxLogTrace( AdvancedConfigMask, dumpParamCfg( *param ) );
288 }
289}
290
291
297static wxFileName getAdvancedCfgFilename()
298{
299 const static wxString cfg_filename{ wxS( "kicad_advanced" ) };
300 return wxFileName( PATHS::GetUserSettingsPath(), cfg_filename );
301}
302
303
305{
306 wxLogTrace( AdvancedConfigMask, wxS( "Init advanced config" ) );
307
308 // Init defaults - this is done in case the config doesn't exist,
309 // then the values will remain as set here.
312 m_EnableRouterDump = false;
313 m_HyperZoom = false;
314 m_DrawArcAccuracy = 10.0;
317 m_MaxTrackLengthToKeep = 0.0005;
320
321 m_ExtraClearance = 0.0005;
322 m_DRCEpsilon = 0.0005; // 0.5um is small enough not to materially violate
323 // any constraints.
325 m_SliverMinimumLength = 0.0008;
327
328 m_HoleWallThickness = 0.020; // IPC-6012 says 15-18um; Cadence says at least
329 // 0.020 for a Class 2 board and at least 0.025
330 // for Class 3.
331
332 m_MinPlotPenWidth = 0.0212; // 1 pixel at 1200dpi.
333
334 m_DebugZoneFiller = false;
335 m_DebugPDFWriter = false;
337 m_HotkeysDumper = false;
338 m_DrawBoundingBoxes = false;
343 m_ShowEventCounters = false;
345 m_CompactSave = false;
347 m_ShowRepairSchematic = false;
348 m_EnableGenerators = false;
349 m_EnableGit = false;
351
353 m_3DRT_BevelExtentFactor = 1.0 / 16.0;
354
355 m_UseClipper2 = true;
356
358
360
362
364}
365
366
368{
369 static ADVANCED_CFG instance;
370 return instance;
371}
372
373
375{
376 const wxFileName k_advanced = getAdvancedCfgFilename();
377
378 // If we are running headless, use the class defaults because we cannot instantiate wxConfig
379 if( !wxTheApp )
380 return;
381
382 if( !k_advanced.FileExists() )
383 {
384 wxLogTrace( AdvancedConfigMask, wxS( "File does not exist %s" ), k_advanced.GetFullPath() );
385
386 // load the defaults
387 wxConfig emptyConfig;
388 loadSettings( emptyConfig );
389
390 return;
391 }
392
393 wxLogTrace( AdvancedConfigMask, wxS( "Loading advanced config from: %s" ), k_advanced.GetFullPath() );
394
395 wxFileConfig file_cfg( wxS( "" ), wxS( "" ), k_advanced.GetFullPath() );
396 loadSettings( file_cfg );
397}
398
399
400void ADVANCED_CFG::loadSettings( wxConfigBase& aCfg )
401{
402 std::vector<PARAM_CFG*> configParams;
403
404 configParams.push_back( new PARAM_CFG_DOUBLE( true, AC_KEYS::ExtraFillMargin,
405 &m_ExtraClearance, m_ExtraClearance, 0.0, 1.0 ) );
406
407 configParams.push_back( new PARAM_CFG_DOUBLE( true, AC_KEYS::DRCEpsilon,
408 &m_DRCEpsilon, m_DRCEpsilon, 0.0, 1.0 ) );
409
410 configParams.push_back( new PARAM_CFG_DOUBLE( true, AC_KEYS::DRCSliverWidthTolerance,
412
413 configParams.push_back( new PARAM_CFG_DOUBLE( true, AC_KEYS::DRCSliverMinimumLength,
415
416 configParams.push_back( new PARAM_CFG_DOUBLE( true, AC_KEYS::DRCSliverAngleTolerance,
418
419 configParams.push_back( new PARAM_CFG_DOUBLE( true, AC_KEYS::HoleWallThickness,
421
422 configParams.push_back( new PARAM_CFG_INT( true, AC_KEYS::CoroutineStackSize,
425
426 configParams.push_back( new PARAM_CFG_INT( true, AC_KEYS::UpdateUIEventInterval,
428
429 configParams.push_back( new PARAM_CFG_BOOL( true, AC_KEYS::ShowRouterDebugGraphics,
431
432 configParams.push_back( new PARAM_CFG_BOOL( true, AC_KEYS::EnableRouterDump,
434
435 configParams.push_back( new PARAM_CFG_BOOL( true, AC_KEYS::HyperZoom,
437
438 configParams.push_back( new PARAM_CFG_BOOL( true, AC_KEYS::CompactFileSave,
440
441 configParams.push_back( new PARAM_CFG_DOUBLE( true, AC_KEYS::DrawArcAccuracy,
442 &m_DrawArcAccuracy, m_DrawArcAccuracy, 0.0, 100000.0 ) );
443
444 configParams.push_back( new PARAM_CFG_DOUBLE( true, AC_KEYS::DrawArcCenterStartEndMaxAngle,
446
447 configParams.push_back( new PARAM_CFG_DOUBLE( true, AC_KEYS::MaxTangentTrackAngleDeviation,
449
450 configParams.push_back( new PARAM_CFG_DOUBLE( true, AC_KEYS::MaxTrackLengthToKeep,
452
453 configParams.push_back( new PARAM_CFG_BOOL( true, AC_KEYS::ExtraZoneDisplayModes,
455
456 configParams.push_back( new PARAM_CFG_BOOL( true, AC_KEYS::StrokeTriangulation,
458
459 configParams.push_back( new PARAM_CFG_DOUBLE( true, AC_KEYS::MinPlotPenWidth,
460 &m_MinPlotPenWidth, m_MinPlotPenWidth, 0.0, 1.0 ) );
461
462 configParams.push_back( new PARAM_CFG_BOOL( true, AC_KEYS::DebugZoneFiller,
464
465 configParams.push_back( new PARAM_CFG_BOOL( true, AC_KEYS::DebugPDFWriter,
467
468 configParams.push_back( new PARAM_CFG_DOUBLE( true, AC_KEYS::SmallDrillMarkSize,
470
471 configParams.push_back( new PARAM_CFG_BOOL( true, AC_KEYS::HotkeysDumper,
473
474 configParams.push_back( new PARAM_CFG_BOOL( true, AC_KEYS::DrawBoundingBoxes,
476
477 configParams.push_back( new PARAM_CFG_BOOL( true, AC_KEYS::ShowPcbnewExportNetlist,
479
480 configParams.push_back( new PARAM_CFG_BOOL( true, AC_KEYS::Skip3DModelFileCache,
482
483 configParams.push_back( new PARAM_CFG_BOOL( true, AC_KEYS::Skip3DModelMemoryCache,
485
486 configParams.push_back( new PARAM_CFG_BOOL( true, AC_KEYS::HideVersionFromTitle,
488
489 configParams.push_back( new PARAM_CFG_BOOL( true, AC_KEYS::ShowRepairSchematic,
491
492 configParams.push_back( new PARAM_CFG_BOOL( true, AC_KEYS::ShowEventCounters,
494
495 configParams.push_back( new PARAM_CFG_BOOL( true, AC_KEYS::AllowManualCanvasScale,
497
498 configParams.push_back( new PARAM_CFG_INT( true, AC_KEYS::V3DRT_BevelHeight_um,
500 0, std::numeric_limits<int>::max(),
502
503 configParams.push_back( new PARAM_CFG_DOUBLE( true, AC_KEYS::V3DRT_BevelExtentFactor,
505 0.0, 100.0,
507
508 configParams.push_back( new PARAM_CFG_BOOL( true, AC_KEYS::UseClipper2,
510
511 configParams.push_back( new PARAM_CFG_BOOL( true, AC_KEYS::Use3DConnexionDriver,
513
514 configParams.push_back( new PARAM_CFG_BOOL( true, AC_KEYS::IncrementalConnectivity,
516
517 configParams.push_back( new PARAM_CFG_INT( true, AC_KEYS::DisambiguationTime,
519 50, 10000 ) );
520
521 configParams.push_back( new PARAM_CFG_BOOL( true, AC_KEYS::EnableGenerators,
523
524 configParams.push_back( new PARAM_CFG_BOOL( true, AC_KEYS::EnableGit,
526
527 configParams.push_back( new PARAM_CFG_BOOL( true, AC_KEYS::EnableEeschemaPrintCairo,
529
530
531 // Special case for trace mask setting...we just grab them and set them immediately
532 // Because we even use wxLogTrace inside of advanced config
533 wxString traceMasks;
534 configParams.push_back( new PARAM_CFG_WXSTRING( true, AC_KEYS::TraceMasks, &traceMasks, wxS( "" ) ) );
535
536 // Load the config from file
537 wxConfigLoadSetups( &aCfg, configParams );
538
539 // Now actually set the trace masks
540 wxStringTokenizer traceMaskTokenizer( traceMasks, wxS( "," ) );
541
542 while( traceMaskTokenizer.HasMoreTokens() )
543 {
544 wxString mask = traceMaskTokenizer.GetNextToken();
545 wxLog::AddTraceMask( mask );
546 }
547
548 dumpCfg( configParams );
549
550 for( PARAM_CFG* param : configParams )
551 delete param;
552}
553
554
static void dumpCfg(const std::vector< PARAM_CFG * > &aArray)
Dump the configs in the given array to trace.
wxString dumpParamCfg(const PARAM_CFG &aParam)
static const wxChar AdvancedConfigMask[]
static wxFileName getAdvancedCfgFilename()
Get the filename for the advanced config file.
void loadFromConfigFile()
Load the config from the normal config file.
void loadSettings(wxConfigBase &aCfg)
static const ADVANCED_CFG & GetCfg()
Get the singleton instance's config, which is shared by all consumers.
Configuration object for booleans.
Configuration object for double precision floating point numbers.
Configuration object for integers.
Configuration object for wxString objects.
A base class which establishes the interface functions ReadParam and SaveParam, which are implemented...
Definition: config_params.h:80
paramcfg_id m_Type
Type of parameter.
wxString m_Ident
Keyword in config data.
static wxString GetUserSettingsPath()
Return the user configuration path used to store KiCad's configuration files.
Definition: paths.cpp:486
void wxConfigLoadSetups(wxConfigBase *aCfg, const std::vector< PARAM_CFG * > &aList)
Use aList of PARAM_CFG object to load configuration values from aCfg.
@ PARAM_WXSTRING
Definition: config_params.h:58
@ PARAM_INT_WITH_SCALE
Definition: config_params.h:54
@ PARAM_INT
Definition: config_params.h:53
@ PARAM_FILENAME
Definition: config_params.h:60
@ PARAM_DOUBLE
Definition: config_params.h:55
@ PARAM_BOOL
Definition: config_params.h:56
bool m_Skip3DModelFileCache
Skip reading/writing 3d model file caches This does not prevent the models from being cached in memor...
bool m_ShowRepairSchematic
double m_DrawArcCenterMaxAngle
When drawing an arc, the angle ( center - start ) - ( start - end ) can be limited to avoid extremely...
int m_DisambiguationMenuDelay
The number of milliseconds to wait in a click before showing a disambiguation menu.
double m_MaxTangentAngleDeviation
Maximum angle between the tangent line of an arc track and a connected straight track in order to com...
bool m_Use3DConnexionDriver
Use the 3DConnexion Driver.
bool m_ShowRouterDebugGraphics
Show PNS router debug graphics.
bool m_Skip3DModelMemoryCache
Skip reading/writing 3d model memory caches This ensures 3d models are always reloaded from disk even...
double m_HoleWallThickness
Hole wall plating thickness.
int m_CoroutineStackSize
Set the stack size for coroutines.
bool m_UseClipper2
Use Clipper2 instead of Clipper1.
double m_SmallDrillMarkSize
The diameter of the drill marks on print and plot outputs (in mm), when the "Drill marks" option is s...
bool m_EnableGenerators
When true, enable support for generators.
bool m_IncrementalConnectivity
Use the new incremental netlister for realtime jobs.
double m_ExtraClearance
Extra fill clearance for zone fills.
bool m_DrawBoundingBoxes
Draw GAL bounding boxes in painters.
bool m_EnableRouterDump
Enable PNS router to dump state information for debug purpose (press 0 while routing)
double m_DRCEpsilon
Epsilon for DRC tests.
double m_SliverAngleTolerance
bool m_AllowManualCanvasScale
double m_SliverWidthTolerance
Sliver tolerances for DRC.
bool m_EnableGit
When true, enable git integration.
bool m_ExtraZoneDisplayModes
When true, adds zone-display-modes for stroking the zone fracture boundaries and the zone triangulati...
double m_MinPlotPenWidth
Sets an absolute minimum pen width for plotting.
double m_SliverMinimumLength
double m_MaxTrackLengthToKeep
Maximum track length to keep after doing an arc track resizing operation.
double m_DrawArcAccuracy
Distance from an arc end point and the estimated end point, when rotating from the start point to the...
bool m_HotkeysDumper
Enable the hotkeys dumper feature, used for generating documentation.
int m_UpdateUIEventInterval
The update interval the wxWidgets sends wxUpdateUIEvents to windows.
double m_3DRT_BevelExtentFactor
3D-Viewer raytracing factor applied to Extent.z of the item layer.
bool m_ShowPcbnewExportNetlist
Enable exporting board editor netlist to a file for troubleshooting purposes.
bool m_DebugPDFWriter
A mode that writes PDFs without compression.
bool m_ShowEventCounters
Shows debugging event counters in various places.
bool m_HyperZoom
Slide the zoom steps over for debugging things "up close".
bool m_DrawTriangulationOutlines
When true, strokes the triangulations with visible color.
int m_3DRT_BevelHeight_um
3D-Viewer, Raytracing Bevel height of layer items.
bool m_CompactSave
Save files in compact display mode When is is not specified, points are written one per line.
bool m_HideVersionFromTitle
Hides the build version from the KiCad manager frame title.
bool m_EnableEeschemaPrintCairo
When true, enable Eeschema printing using Cairo.
bool m_DebugZoneFiller
A mode that dumps the various stages of a F_Cu fill into In1_Cu through In9_Cu.
List of known groups for advanced configuration options.
static const wxChar V3D_RayTracing[]
List of known keys for advanced configuration options.
static const wxChar DebugPDFWriter[]
static const wxChar HotkeysDumper[]
static const wxChar ShowRepairSchematic[]
static const wxChar HideVersionFromTitle[]
static const wxChar AllowManualCanvasScale[]
static const wxChar MaxTangentTrackAngleDeviation[]
For arc track interactive drag-resizing Maximum angle between the tangent line of an arc track and a ...
static const wxChar MaxTrackLengthToKeep[]
For arc track interactive drag-resizing Maximum track length to keep after doing an arc track resizin...
static const wxChar ShowPcbnewExportNetlist[]
static const wxChar EnableGit[]
static const wxChar UseClipper2[]
static const wxChar DrawBoundingBoxes[]
static const wxChar EnableGenerators[]
static const wxChar MinPlotPenWidth[]
Absolute minimum pen width to send to the plotter.
static const wxChar CoroutineStackSize[]
Configure the coroutine stack size in bytes.
static const wxChar HoleWallThickness[]
Used to calculate the actual hole size from the finish hole size.
static const wxChar DRCSliverWidthTolerance[]
Angle and width tolerances for copper and solder mask sliver detection.
static const wxChar DisambiguationTime[]
The time in milliseconds to wait before displaying a disambiguation menu.
static const wxChar HyperZoom[]
Slide the zoom steps over for debugging things "up close".
static const wxChar IncrementalConnectivity[]
Should the schematic use the new incremental connectivity algorithm.
static const wxChar DebugZoneFiller[]
static const wxChar StrokeTriangulation[]
When true, GAL will stroke the triangulations (only used in OpenGL) with a visible color.
static const wxChar CompactFileSave[]
When set to true, this will wrap polygon point sets at 4 points per line rather than a single point p...
static const wxChar DRCSliverAngleTolerance[]
static const wxChar UpdateUIEventInterval[]
static const wxChar V3DRT_BevelHeight_um[]
static const wxChar ShowRouterDebugGraphics[]
Show PNS router debug graphics while routing.
static const wxChar DRCEpsilon[]
A fudge factor for DRC.
static const wxChar EnableEeschemaPrintCairo[]
static const wxChar V3DRT_BevelExtentFactor[]
static const wxChar EnableRouterDump[]
Enable PNS router to dump state information for debug purpose (press 0 while routing)
static const wxChar DrawArcAccuracy[]
For drawsegments - arcs.
static const wxChar Skip3DModelMemoryCache[]
static const wxChar ExtraZoneDisplayModes[]
When true, a third zone-display-mode is included which strokes the filled areas and fracture boundari...
static const wxChar Skip3DModelFileCache[]
static const wxChar SmallDrillMarkSize[]
The diameter of the drill marks on print and plot outputs (in mm), when the "Drill marks" option is s...
static const wxChar DrawArcCenterStartEndMaxAngle[]
For drawsegments - arcs.
static const wxChar ExtraFillMargin[]
When filling zones, we add an extra amount of clearance to each zone to ensure that rounding errors d...
static const wxChar DRCSliverMinimumLength[]
static const wxChar ShowEventCounters[]
static const wxChar TraceMasks[]
static const wxChar Use3DConnexionDriver[]
Decide whether to attempt usage of the 3DConnexion mouse.
Limits and default settings for the coroutine stack size allowed.
static constexpr int min_stack
static constexpr int max_stack
static constexpr int default_stack