====== Rotate & Transform ======

{{ :ui:ui-icon_rotate-transform.webp?direct&100 |}}

This feature allows for the manipulation of object orientation, ranging from simple 2D spins to complex 3D perspective distortions.

This option is located within the ++Object Design Menu|{{:ui:ui-icon_object_design_menu_bottom.webp?400}}++ (bottom).

Total Launcher distinguishes between two types of manipulation:

  * **Rotate:** Spins an object on a flat 2D plane (Z-axis), similar to turning a piece of paper on a desk.
  * **Transform:** Manipulates objects in 3D space, changing spatial geometry and perspective.

===== The Interface (Modes) =====
The behavior of the adjustment sliders depends entirely on the selected **Mode**. The screen is controlled by a radio button toggle:

|  Θ Rotate  |  Θ Transform  |
|{{:ui:ui-object_design_menu-rotate.webp?200}}|{{:ui:ui-object_design_menu-transform.webp?200}}|

  * Select **Rotate** to adjust angles (Degrees).
  * Select **Transform** to adjust spatial position and distortion (Size/Depth).

<WRAP tip>
**Manual Entry:** Tap any slider icon once to open the numeric input dialog. This allows you to type exact values for precise alignment.
</WRAP>

===== Rotate Mode (Angles) =====
When the **Rotate** radio button is selected, the sliders control the angle of the object along three axes.

^ Slider ^ Axis ^ Technical Action ^ Visual Effect ^
| **Top** |  **Z-Axis** (Roll)  | Spins the object around its center point.\\ [-180 to +180] | **Clockwise Spin:** The object rotates on the flat 2D plane of the screen like a clock face. |
| **Side** |  **Y-Axis** (Pitch)  | Pivots the object around its horizontal center.\\ [-180 to +180]  | **Tilt Forward/Back:** The object tilts into 3D space; the top appears further away and the bottom appears closer to the viewer. |
| **Bottom** |  **X-Axis** (Yaw)  | Pivots the object around its vertical center.\\ [-180 to +180] | **Swing Left/Right:** The object rotates horizontally; one side is pushed back while the other is pulled forward. |

<WRAP note>
**Pivot Point:** All rotations occur around the object's **center point**. You cannot currently change the anchor point to the edge (e.g., to make a door swing from its hinges).
</WRAP>

<WRAP tip>
**Note:** If the object looks "flat" (skewed) rather than 3D after rotating the X or Y axis, check the **Perspective** settings in the main launcher options. Without perspective, 3D rotations appear as simple 2D skewing.
</WRAP>

===== Transform Mode (Distortion) =====
When the **Transform** radio button is selected, the sliders control the size, position, and 3D depth of the object.

^ Slider ^ Function ^ Technical Action ^ Visual Effect ^
| **Top** |  **Scale**  | Uniform scaling/compression.\\ [+10 to +100]  | **Zoom:** Increases or decreases the overall size of the object.  |
| **Side** |  **X-Position**  | X-axis translation.\\ [-200 to +200]  | **Shift:** Moves the object's anchor point along the horizontal plane (e.g., lower-left).  |
| **Bottom** |  **Z-Depth**  | Magnification/Proximity.\\ [-200 to +200] | **Perspective Depth:** massively enlarges or skews the object, stretching it toward the viewer as if moving the camera closer.  |

<WRAP tip>
**Scale vs. Resize:** The **Scale** slider (Top) adjusts the visual zoom of the object content, distinct from changing the object's bounding box on the grid.
</WRAP>

==== Critical Rule: The "Rotate First" Requirement ====

<WRAP center round tip>
<WRAP centeralign>
**Rule: Rotation is Prerequisite**
</WRAP>
<WRAP centeralign>
A rotation must be applied first for the transform (depth) effect to become visible.
</WRAP>
</WRAP>

Increasing the **Transform (Z-Depth/Perspective)** slider without changing the **Rotate (Angle)** causes the object to appear squished or resized rather than 3D.

**Correct Sequence for 3D Effects:**
  - Switch to **Rotate Mode** and move the Side or Bottom slider to establish an angle.
  - Switch to **Transform Mode** and increase the Bottom (Z-Depth) slider to generate depth.

===== Compatibility & Limitations =====

Not all objects support 3D manipulation.

^ Object Type ^ Rotate? ^ Transform? ^ Notes ^
| **TL Objects** (Text, Image, Shape) |  Yes  |  **Yes**  | Fully supports 3D manipulation.  |
| **App Widgets** (Gmail, Calendar) |  Yes  |  **No**  | **Do not use Transform.** Android restricts widgets to 2D rectangles; the effect will fail or look like a resize.  |
| **Groups** |  Yes  |  **Yes**  | **Workaround:** If an object will not transform, place it within a Group and apply the transform to the Group container.  |

<WRAP warning>
**Group Warning:** A transformed object, if added to a group *after* being transformed, will lose its transformation settings.
</WRAP>

===== Troubleshooting =====
If the **Transform** tool appears inactive:
  - **Verify Angle:** Ensure the Rotate X or Rotate Y slider is not set to 0.
  - **Verify Object:** Confirm the target is not a standard Android App Widget.

<WRAP noprint>{{page>site:site-footer-comment_feedback_block}}</WRAP>