.. |video_rope| raw:: html

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

.. |video_spiral| raw:: html

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

.. |video_chain| raw:: html

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

.. |video_hanging| raw:: html

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



.. _curve_presets:

Curve Presets
================================

Curve presets are premade Geometry Nodes setups that generate common cable-like objects along an existing path that are available in the Presets submenu (update 1.5.0).
They create a simple, editable base object that you can tweak further in the Geometry Nodes modifier.

The following presets are available:

* :ref:`Rope <preset_rope>`: a multi-strand twisted rope that follows a curve, requires a curve to be selected;
* :ref:`Spiral Phone Cable <preset_spiral>`: a coiled, spring-like cable along a curve, requires a curve to be selected;
* :ref:`Chain <preset_chain>`: well: a chain, requires a curve or a mesh line to be selected and a link object;
* :ref:`Hanging Cables <hanging_preset>`: hanging cables, something you can see beween posts;

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

Using Curve Presets
--------------------------------

* For ``Rope`` and ``Spiral Phone Cable`` use a curve object that defines the path of the cable, the preset will be added as a separate object with a GN modifier following the path, similar to :ref:`Mesh Cable<meshCable>`;
* ``Rope`` and ``Spiral Phone Cable`` have an additional ``CBL GN Length Remap Modifier`` GN modifier dedicated to remapping of the thread length. This is mostly useful for the Phone Cable setup to generate a more twisted/fiddled cable with a variation in "density" of the spirals;
* For ``Chain`` use either a curve or a mesh line, the preset will be added directly on the selected object;

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

.. _preset_rope:

Ropes
--------------------------------

* Select a curve and run the ``Rope`` preset;
* The preset will be added with the default values which could be too big or too small depending on the scale you're working on. Feel free to modify the default nodes settings in the ``nodes.blend`` file you'll find in the Cablerator extension folder;
* Most of the values can be modified on the Uber GN Modifier.

|br|\

|video_rope|

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

.. _preset_spiral:

Spiral Phone Cable
--------------------------------

* Select a curve and run the ``Spiral Cable`` preset;
* The preset will be added with the default values which could be too big or too small depending on the scale you're working on. Feel free to modify the default nodes settings in the ``nodes.blend`` file you'll find in the Cablerator extension folder;
* Most of the values can be modified on the Uber GN Modifier;

|br|\

Using the spiral cable preset with the Length Remap Modifier:

|video_spiral|

Applying the Geometry Nodes modifier will convert the preset to regular geometry if you need fixed, non-procedural meshes for further modifications.

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

.. _preset_chain:

Chain
---------------------------------

* Select a curve or a mesh line and run the ``Chain`` preset;
* The preset will be added on the active objects that could be a curve or a mesh edge strip;
* select the chain link, adjust the distance between links and optionally angle of the chains;

If necessary, chain links can be converted to separate objects with Instances to Objects command (Blender 4.5+).

|video_chain|

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

.. _hanging_preset:

Hanging Cables
--------------------------------

* Select a curve or a mesh line and run the ``Hanging Cable`` preset;
* Run :ref:`Convert a Curve to a Geometry Nodes Object<curvetogn>` or :ref:`Convert to Geometry Nodes Multicable<curvetomultign>` Geo Node helper or add any other Geo Node mod to add thickness or any sort of profile to the curves;
* ``Output Mesh`` option will convert the output to Mesh so that after applying the modifier the resulting object will be a mesh that can be :ref:`Refit to a Bezier Curve<refit_16>`

|video_hanging|



.. |br| raw:: html

   <br />