.. _geom_export:

Geometry Export
=========================================================================================

This section demonstrates the use of the S3Dlib function *save_surfgeom_to_obj* which
saves a surface object to an obj format file.  The method is limited to exports of only the object's
geometry information.
As a result, the example scripts do not include any color information of the surface. 
This also excludes shading and highlighting which, in general, would not be included in the
object coloration since these depend on the Matplotlib Axes3D rendering.

Included with each script example is a screen copy of the exported object rendered in 
the `Blender <https://www.blender.org/>`_  graphic software tool.  Any uniform coloration of
the surface shown in these images has been applied using the *Blender* software. Since
rendering is to be done by *Blender*, these scripts do not import *Matplotlib* modules or methods.

.. toctree::
   :hidden:

   export/export_mp_triple.rst

.. raw:: html

    <a href="export/export_mp_triple.html">
    <div class="docbutton">
    <span class="tooltiptext">Planar surface based on a function, z=f(x,y)</span>

.. only:: html

.. image:: export/images/export_logo.png
   :class: docfig

Functional Planar Surface

.. raw:: html

    </div></a>




.. toctree::
   :hidden:

   export/export_knot.rst

.. raw:: html

    <a href="export/export_knot.html">
    <div class="docbutton">
    <span class="tooltiptext">Toroidal surface using on a geometry function</span>

.. only:: html

.. image:: export/images/export_logo.png
   :class: docfig

Functional Closed Surface

.. raw:: html

    </div></a>




.. toctree::
   :hidden:

   export/export_jacksboro.rst

.. raw:: html

    <a href="export/export_jacksboro.html">
    <div class="docbutton">
    <span class="tooltiptext">Surface generated using a datagrid</span>

.. only:: html

.. image:: export/images/export_logo.png
   :class: docfig

Datagrid Surface

.. raw:: html

    </div></a>









.. toctree::
   :hidden:

   export/export_earth_shaded.rst

.. raw:: html

    <a href="export/export_earth_shaded.html">
    <div class="docbutton">
    <span class="tooltiptext">Surface based on an image geometry file</span>

.. only:: html

.. image:: export/images/export_logo.png
   :class: docfig

Geometric Mapping

.. raw:: html

    </div></a>





.. toctree::
   :hidden:

   export/export_earth_land_clipped.rst

.. raw:: html

    <a href="export/export_earth_land_clipped.html">
    <div class="docbutton">
    <span class="tooltiptext">A surface with alpha clipping based on an image file</span>

.. only:: html

.. image:: export/images/export_logo.png
   :class: docfig

Clipped Geometry

.. raw:: html

    </div></a>






.. toctree::
   :hidden:

   export/export_mobius.rst

.. raw:: html

    <a href="export/export_mobius.html">
    <div class="docbutton">
    <span class="tooltiptext">A non-orientable surface</span>

.. only:: html

.. image:: export/images/export_logo.png
   :class: docfig

Mobius Strip

.. raw:: html

    </div></a>






.. toctree::
   :hidden:

   export/export_klein_bottle.rst

.. raw:: html

    <a href="export/export_klein_bottle.html">
    <div class="docbutton">
    <span class="tooltiptext">A non-orientable surface</span>

.. only:: html

.. image:: export/images/export_logo.png
   :class: docfig

Klein Bottle

.. raw:: html

    </div></a>












.. toctree::
   :hidden:

   export/export_spirals.rst

.. raw:: html

    <a href="export/export_spirals.html">
    <div class="docbutton">
    <span class="tooltiptext">A single composite surface</span>

.. only:: html

.. image:: export/images/export_logo.png
   :class: docfig

Composite Surface

.. raw:: html

    </div></a>






.. toctree::
   :hidden:

   export/export_hyperboloid.rst

.. raw:: html

    <a href="export/export_hyperboloid.html">
    <div class="docbutton">
    <span class="tooltiptext">A line to line filled surface</span>

.. only:: html

.. image:: export/images/export_logo.png
   :class: docfig

Parametric Line Generated Surface

.. raw:: html

    </div></a>







.. toctree::
   :hidden:

   export/export_bin_surf.rst

.. raw:: html

    <a href="export/export_bin_surf.html">
    <div class="docbutton">
    <span class="tooltiptext">Surface visualization in Blender of an inner and outer surface</span>

.. only:: html

.. image:: export/images/export_logo.png
   :class: docfig

Geometry: inner/outer surface

.. raw:: html

    </div></a>








.. toctree::
   :hidden:

   export/export_pycube.rst

.. raw:: html

    <a href="export/export_pycube.html">
    <div class="docbutton">
    <span class="tooltiptext">Image mapped and clipped composite surface</span>

.. only:: html

.. image:: export/images/export_logo.png
   :class: docfig

Composite of Clipped Copies

.. raw:: html

    </div></a>








.. toctree::
   :hidden:

   export/export_nacl.rst

.. raw:: html

    <a href="export/export_nacl.html">
    <div class="docbutton">
    <span class="tooltiptext">Instead of a single composite, separate objects are rendered in Blender.</span>

.. only:: html

.. image:: export/images/export_logo.png
   :class: docfig

Two Surface Object Export

.. raw:: html

    </div></a>






.. toctree::
   :hidden:

   export/export_arch_solid.rst

.. raw:: html

    <a href="export/export_arch_solid.html">
    <div class="docbutton">
    <span class="tooltiptext">A surface is subdivided into face sets, exported and individually colored in Blender.</span>

.. only:: html

.. image:: export/images/export_logo.png
   :class: docfig

Rhombicub octahedron

.. raw:: html

    </div></a>







.. toctree::
   :hidden:

   export/export_bunny_toy.rst

.. raw:: html

    <a href="export/export_bunny_toy.html">
    <div class="docbutton">
    <span class="tooltiptext">Surface object constructed from an input object.</span>

.. only:: html

.. image:: export/images/export_logo.png
   :class: docfig

.. raw:: html

   Bunny <sup>3</sup>

.. raw:: html

    </div></a>