[Export_3D][Added] center option to origin

Closes #871

Author: set-soft

CHANGELOG.md

@@ -28,6 +28,7 @@ and this project adheres to [Semantic Versioning](https://semver.org/spec/v2.0.0
 - Navigate Results, PCB Print, PcbDraw: Support for big SVGs (#851)
 - PCB Print: Workaround for KiCad 9.0.5 change in how holes are plotted when
   a layer is not included (black instead of white).
+- Export_3D: `center` option to `origin` (#871)
 
 ### Fixed
 - User.N layer numbering. I.e. pcb_print issues with their numbering (#808)

docs/samples/generic_plot.kibot.yaml

@@ -1421,9 +1421,10 @@ outputs:
       no_optimize_step: false
       # [boolean=false] Used to exclude 3D models for components with 'virtual' attribute
       no_virtual: false
-      # [string='grid'] [grid,drill,*] Determines the coordinates origin. Using grid the coordinates are the same as you have in the
-      # design sheet.
-      # The drill option uses the auxiliary reference defined by the user.
+      # [string='grid'] [grid,drill,center,*] Determines the coordinates origin.
+      # Using `grid` the coordinates are the same as you have in the design sheet.
+      # The `drill` option uses the auxiliary reference defined by the user.
+      # Using `center` you'll get the center of the board as origin.
       # You can define any other origin using the format 'X,Y', i.e. '3.2,-10'. Don't put units here.
       # The units used here are the ones specified by the `units` option
       origin: 'grid'

docs/source/Changelog.rst

@@ -52,6 +52,7 @@ Added
 -  Navigate Results, PCB Print, PcbDraw: Support for big SVGs (#851)
 -  PCB Print: Workaround for KiCad 9.0.5 change in how holes are plotted
    when a layer is not included (black instead of white).
+-  Export_3D: ``center`` option to ``origin`` (#871)
 
 Fixed
 ~~~~~
@@ -511,7 +512,7 @@ Fixed:
 
    -  Problems with filters that change fields for components that are
       only in the PCB. (#628)
-   -  Use of ’_none’ filter in lists of filters and \_kf()
+   -  Use of ’\_none’ filter in lists of filters and \_kf()
 
 -  Variants:
 
@@ -710,7 +711,7 @@ Changed
 -  KiRi: continue even on corrupted schematics (#583)
 -  Variants: avoid W045 on nameless pads. Assuming they are on purpose
    and not real pads. (See #584)
--  BoardView: Skip footprints with no pads (not just REF**)
+-  BoardView: Skip footprints with no pads (not just REF*\*)
    (whitequark/kicad-boardview#14)
 
 .. _fixed-7:

docs/source/configuration/outputs/Export_3DOptions.rst

@@ -20,9 +20,10 @@ Export_3DOptions parameters
    - XAO: XAO (SALOME/Gmsh) format, used for FEM and simulations. |br|
    - BRep: Part of Open CASCADE Technology (OCCT).
 -  **no_virtual** :index:`: <pair: output - export_3d - options; no_virtual>` [:ref:`boolean <boolean>`] (default: ``false``) Used to exclude 3D models for components with 'virtual' attribute.
--  **origin** :index:`: <pair: output - export_3d - options; origin>` [:ref:`string <string>`] (default: ``'grid'``) (choices: "grid", "drill") (also accepts any string) Determines the coordinates origin. Using grid the coordinates are the same as you have in the
-   design sheet. |br|
-   The drill option uses the auxiliary reference defined by the user. |br|
+-  **origin** :index:`: <pair: output - export_3d - options; origin>` [:ref:`string <string>`] (default: ``'grid'``) (choices: "grid", "drill", "center") (also accepts any string) Determines the coordinates origin.
+   Using `grid` the coordinates are the same as you have in the design sheet. |br|
+   The `drill` option uses the auxiliary reference defined by the user. |br|
+   Using `center` you'll get the center of the board as origin. |br|
    You can define any other origin using the format 'X,Y', i.e. '3.2,-10'. Don't put units here. |br|
    The units used here are the ones specified by the `units` option.
 -  **output** :index:`: <pair: output - export_3d - options; output>` [:ref:`string <string>`] (default: ``'%f-%i%I%v.%x'``) Name for the generated 3D file (%i='3D' %x='step/glb/stl/xao/brep'). Affected by global options.

kibot/out_export_3d.py

@@ -33,9 +33,10 @@ def __init__(self):
                 - BRep: Part of Open CASCADE Technology (OCCT) """
             #    - PLY: Polygon File Format or the Stanford Triangle Format.
             self.origin = 'grid'
-            """ *[grid,drill,*] Determines the coordinates origin. Using grid the coordinates are the same as you have in the
-                design sheet.
-                The drill option uses the auxiliary reference defined by the user.
+            """ *[grid,drill,center,*] Determines the coordinates origin.
+                Using `grid` the coordinates are the same as you have in the design sheet.
+                The `drill` option uses the auxiliary reference defined by the user.
+                Using `center` you'll get the center of the board as origin.
                 You can define any other origin using the format 'X,Y', i.e. '3.2,-10'. Don't put units here.
                 The units used here are the ones specified by the `units` option """
             self.units = 'millimeters'
@@ -82,13 +83,21 @@ def config(self, parent):
         # Validate and parse the origin
         val = self.origin
         if (val not in ['grid', 'drill']):
-            user_origin = re.match(r'([-\d\.]+)\s*,\s*([-\d\.]+)\s*$', val)
-            if user_origin is None:
-                raise KiPlotConfigurationError('Origin must be `grid` or `drill` or `X,Y` (no units here)')
-            self._user_x = float(user_origin.group(1))
-            self._user_y = float(user_origin.group(2))
+            if val == 'center':
+                bb = GS.board.ComputeBoundingBox(True)
+                center = bb.GetCenter()
+                self._user_x = GS.to_mm(center.x)
+                self._user_y = GS.to_mm(center.y)
+                self._units = 'mm'
+            else:
+                user_origin = re.match(r'([-\d\.]+)\s*,\s*([-\d\.]+)\s*$', val)
+                if user_origin is None:
+                    raise KiPlotConfigurationError('Origin must be `grid` or `drill` or `X,Y` (no units here)')
+                self._user_x = float(user_origin.group(1))
+                self._user_y = float(user_origin.group(2))
         # Adjust the units
-        self._units = UNITS_2_KICAD[self.units]
+        if self.origin != 'center':
+            self._units = UNITS_2_KICAD[self.units]
         if self._units == 'mils':
             self._units = 'in'
             self._scale = 0.001