.. _auto_curve_rotate:

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

Rotates the points of a 2-D curve about a specified center by a given angle, with optional axis selection (X, Y, or XY) and a minimum-X threshold to skip leading points. Use this worker whenever a curve needs a geometric angular transformation before further processing.

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

Classification: **process**.

Tagged: ``2d_transform``, ``angle``, ``axis``, ``center``, ``curve_rotation``, ``geometry``, ``rotate``, ``transformations``.

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 X/Y point pairs) to be rotated; must be supplied as a d3VIEW curve object.
   * - Min X
     - x-value
     - scalar
     - —
     - 
     - Minimum X threshold (scalar): points whose X-value is below this value are excluded from rotation; defaults to the X-coordinate of the first point if left blank.
   * - Angle
     - angle
     - scalar
     - 0
     - 
     - Rotation angle in degrees (scalar); positive values rotate counter-clockwise; defaults to 0 (no rotation).
   * - Axis
     - axis
     - scalar
     - y
     - 
     - Axis of rotation to apply: 'x' rotates about the X-axis, 'y' about the Y-axis, 'xy' applies rotation in both; defaults to 'y'.
   * - Rotation Center - X
     - center_x
     - scalar
     - —
     - 
     - X-coordinate of the rotation center (scalar); defaults to the X-coordinate of the first curve point if not provided.
   * - Rotation Center - Y
     - center_y
     - scalar
     - —
     - 
     - Y-coordinate of the rotation center (scalar); defaults to the Y-coordinate of the first curve point if not provided.

Outputs
-------

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

   * - Label
     - ID
     - Type
     - Description
   * - curve_rotate_output_1
     - curve_rotate_output_1
     - vector
     - Rotated curve (vector of X/Y point pairs) resulting from applying the specified angle, axis, and center transformation to 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 <https://www.d3view.com/api/workflow/example?id=curve_rotate>`_

.. 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</code>. Schema hash: <code>25dccd9693f6</code>. Hand-curated docs in <code>workerexamples/</code> override this page when present.
   </p>