.. |video13| raw:: html

   <video style="width: 740px" controls loop>
     <source src="../_static/07-13-geo_to_cable.mp4" type="video/mp4">
     Your browser does not support the video tag.
   </video>

.. |video_rigid_instances| raw:: html

   <video controls loop>
     <source src="../_static/07-rigin-instances.mp4" type="video/mp4">
     Your browser does not support the video tag.
   </video>


Geo-Nodes Helper Functions
================================

Various Geometry Nodes functions that help with cabling. I don't use Geometry Nodes too much, so if you come up with some cool setups you'd like to see in Cablerator, let me know!

* :ref:`Convert Between a Mesh and a Curve<convertbetween>`.
* :ref:`Convert a Curve to a Geometry Nodes Object<curvetogn>`.
* :ref:`Convert to Geometry Nodes Multicable<curvetomultign>`.
* :ref:`Rigid Instances Along a Curve<gnrigidinstance>`.

--------------------------------

.. _curvetogn:

Convert a Curve to a Geometry Nodes Object
-------------------------------------------

This function converts the selected curve objects to Geometry Nodes curve objects. This is useful for curves with bevel width or a bevel profile, because adding a Geometry Nodes modifier to a curve with these settings enabled converts the curve to a mesh, which is not always the desired outcome. This helper removes the bevel width or bevel profile and recreates them as a Geometry Nodes setup.

--------------------------------

.. _curvetomultign:

Convert To Geo Nodes Multicable
-------------------------------------------

This function converts the selected curve to a Geometry Nodes curve object and additionally adds several duplicates of the curve with an offset.

--------------------------------

.. _gntocurve:

Convert Geo Nodes to Cable
-------------------------------------------

This function will convert the Geometry Nodes curve objects (for example, Multicable) to Blender curves, allowing for individual modification of each curve as needed.

|video13|

--------------------------------

.. _gnrigidinstance:

Rigid Instances Along a Curve
--------------------------------

This function adds a Geometry Nodes setup that allows instancing an object along the curve without deforming it, which is useful for non-bendable segments, lights along a curve, road signs, etc.

|video_rigid_instances|

Note that this GN setup requires a curve as a base. If a curve has a profile, the setup will assume it's a mesh object. Convert a regular Blender curve to a Geometry Nodes object first (using :ref:`this <convertbetween>` Cablerator helper), or use a curve without a profile.

.. |br| raw:: html

   <br />