# item.set_transform

> Sets the position, scale, rotation or opacity of a visual item.

Source: https://alexgalhardo.github.io/vukem-video/docs/reference/commands/item.set_transform/

Sets the given properties, rounded to 3 decimals. Scale 1, rotation 0 and opacity 1 clear the stored value. A property that has keyframes cannot be set; use keyframe.set or keyframe.clear.

## Arguments

| Argument | Type | Required | Description |
| --- | --- | --- | --- |
| `item_id` | `string` | yes | A clip, text, caption or shape item. |
| `opacity` | `number` | no | 0 to 1. min 0; max 1 |
| `rotation` | `number` | no | Degrees clockwise. |
| `scale` | `number` | no | Uniform scale, greater than 0 and at most 20. max 20 |
| `x` | `number` | no | Centre of the item in pixels. |
| `y` | `number` | no | Centre of the item in pixels. |

## Example

As one operation of an `edit` batch (the `edit` tool of MCP, `vukem-video edit --ops`, or `POST /api/v1/projects/{id}/edit`):

```json
{
  "op": "item.set_transform",
  "args": {
    "item_id": "itm_s6t7v8w9x0",
    "scale": 1.5,
    "x": 540
  }
}
```

## Errors

[`E_VALIDATION`](/docs/reference/error-codes#e_validation), [`E_NOT_FOUND`](/docs/reference/error-codes#e_not_found), [`E_TYPE_MISMATCH`](/docs/reference/error-codes#e_type_mismatch), [`E_INVALID_STATE`](/docs/reference/error-codes#e_invalid_state)

## Scope and phase

Scope `edit`, phase `alpha`. Run `vukem-video command:help item.set_transform` for the same description from the binary.
