<WRAP hide>%%<!-- googleoff: index -->%%</WRAP>
<WRAP center notice centeralign>
**⚠️ v4.0 UI Transition Notice - In Process:**
//The release of Total Launcher v4.0 has introduced significant user interface changes. Please note that this 
page does not yet reflect these updates. The new layout paths, folds, and visual maps are currently being 
compiled and will be deployed shortly.//
</WRAP>
<WRAP hide>%%<!-- googleon: index -->%%</WRAP>


----


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

{{ ui:ui-icon_rotate-transform-v4.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>