.. _auto_curve_rotate_increments:

*ROTATE THE POINTS ABOUT A CENTER BY A CERTAIN ANGLE*
=====================================================

Rotates the points of a 2-D curve about a specified center coordinate by a given starting angle, applying incremental rotation steps optionally scaled by a scale factor. Use this worker when you need to sweep or fan out a curve around a pivot point along a chosen axis (X, Y, or XY).

When to use
-----------

Classification: **process**.

Tagged: ``"``, ``2``, ``_``, ``a``, ``c``, ``d``, ``e``, ``f``.

Inputs
------

.. list-table::
   :header-rows: 1
   :widths: 20 20 20 20 20 20

   * - Label
     - ID
     - Type
     - Default
     - Required
     - Description
   * - Curve
     - curve
     - vector
     - —
     - 
     - Input curve (vector of XY point pairs) whose points will be rotated about the specified center; accepts any unitless or dimensioned coordinate curve.
   * - X-Value
     - x-value
     - scalar
     - —
     - 
     - X-coordinate of the center of rotation (same units as the curve's X-axis); defines the pivot point about which the rotation is applied.
   * - Starting Angle
     - starting_angle
     - scalar
     - —
     - 
     - Starting angle of rotation in degrees; sets the initial angular offset applied to the curve points before incremental steps are computed.
   * - Axis
     - axis
     - scalar
     - x
     - 
     - Axis about which the rotation is performed; choose 'x' to rotate around the X-axis, 'y' for the Y-axis, or 'xy' for combined rotation — defaults to 'x'.
   * - Scale Factor
     - scale_factor
     - scalar
     - —
     - 
     - Optional multiplicative scale factor applied to each rotation increment; leave unset (null) to apply unscaled increments, or provide a value to amplify or dampen the step size.

Outputs
-------

.. list-table::
   :header-rows: 1
   :widths: 20 20 20 20

   * - Label
     - ID
     - Type
     - Description
   * - curve_rotate_increments_output_1
     - curve_rotate_increments_output_1
     - vector
     - Resulting curve after all incremental rotations have been applied; a vector of XY point pairs in the same coordinate units as the input curve.

Disciplines
-----------

- data.curve.transform

Runnable example
----------------

A runnable example is registered for this worker. Open the example workflow on the d3VIEW canvas: `/api/workflow/example?id=curve_rotate_increments <https://www.d3view.com/api/workflow/example?id=curve_rotate_increments>`_

.. raw:: html

   <hr style="margin-top:2em">
   <p style="font-size:11px;color:#888">
   Auto-generated from <code>transformation</code> schema. Worker id: <code>curve_rotate_increments</code>. Schema hash: <code>8dc513714f0a</code>. Hand-curated docs in <code>workerexamples/</code> override this page when present.
   </p>