.. toctree::
   :maxdepth: 1
   :caption: Contents:

Applications
============

.. describe:: offler-size

    ``offler-size <input-OFF>`` - print the dimensions of the axis-aligned bounding box of a mesh.

.. describe:: offler-add-fixed-colour

    ``offler-add-fixed-colour <input-OFF> <output-OFF> <r> <g> <b> <a>`` - set the colour of each vertex to ``(r, g, b, a)``.

.. describe:: offler-estimate-normals

    ``offler-add-normals <input-OFF> <output-OFF>`` - estimate normals by using face normals weighted by the vertex's distance from each face's barycentre.

.. describe:: offler-export-pointcloud

    ``offler-export-pointcloud <input-OFF> <output-XYZ>`` - export mesh vertices as a point cloud.

.. describe:: offler-import-normals

    ``offler-import-normals <input-OFF> <output-OFF> <normal-file>`` - import previously-exported normals from a file.

.. describe:: offler-import-colours

    ``offler-import-colours <input-OFF> <output-OFF> <colour-file>`` - import previously-exported colours from a file.

.. describe:: offler-rotate-mesh

    ``offler-rotate-mesh <input-OFF> <output-OFF> <x/y/z> <angle-in-radians>`` - rotate mesh around the specified axis by the specified angle.

.. describe:: offler-scale-mesh

    ``offler-scale-mesh <input-OFF> <output-OFF> <scale-factor>`` - apply a scale factor to ``input-OFF``, ``>1`` grows the mesh, ``<1`` shrinks it.

.. describe:: offler-strip-colour

    ``offler-strip-colour <input-OFF> <output-OFF> <where-to-store-colours>`` - strip colours from a mesh, optionally storing them for later.

.. describe:: offler-strip-normals

    ``offler-strip-normals <input-OFF> <output-OFF> <where-to-store-normals>`` - strip normals from a mesh, optionally storing them for later use.

.. describe:: offler-swap-axes

    ``offler-swap-axes <input-OFF> <output-OFF> <"xy" swap>`` - swap the axes of a mesh, e.g. swap the ``x`` and ``y`` axes.

.. describe:: offler-translate-mesh

    ``offler-translate-mesh <input-OFF> <output-OFF> <xshift> <yshift> <zshift>`` - adjust the position of a mesh.