---
title: Dimension Control
url: https://docs.kaltura.com/docs/rich-media-cms-apis/content-management/video-editing-dimension-control
---

## Dimension Control


Control output resolution when composing or concatenating sources with different dimensions.

### Dimension Attribute Types

| Type | Behavior |
|------|----------|
| `KalturaAspectRatioCropAttributes` | Crops source to target aspect ratio (removes edges) |
| `KalturaAspectRatioScaleAttributes` | Scales to fit target ratio with letterbox/pillarbox (adds black bars) |
| `KalturaResolutionCropAttributes` | Crops to exact pixel dimensions |

### Parameters

**KalturaAspectRatioCropAttributes / KalturaAspectRatioScaleAttributes:**

| Parameter | Type | Description |
|-----------|------|-------------|
| `aspectRatioX` | int | Width ratio component (e.g., 16) |
| `aspectRatioY` | int | Height ratio component (e.g., 9) |

**KalturaResolutionCropAttributes:**

| Parameter | Type | Description |
|-----------|------|-------------|
| `width` | int | Target width in pixels |
| `height` | int | Target height in pixels |

### Usage

Dimension attributes apply to `KalturaOperationResources` (multi-clip concat) via the `dimensionsAttributes` field:


```bash
curl -X POST "$KALTURA_SERVICE_URL/service/media/action/addContent" \
  -d "ks=$KALTURA_KS" \
  -d "format=1" \
  -d "entryId=$KALTURA_ENTRY_ID" \
  -d "resource[objectType]=KalturaOperationResources" \
  -d "resource[dimensionsAttributes][objectType]=KalturaAspectRatioCropAttributes" \
  -d "resource[dimensionsAttributes][aspectRatioX]=16" \
  -d "resource[dimensionsAttributes][aspectRatioY]=9" \
  -d "resource[resources][0][objectType]=KalturaOperationResource" \
  -d "resource[resources][0][resource][objectType]=KalturaEntryResource" \
  -d "resource[resources][0][resource][entryId]=$KALTURA_SOURCE_ENTRY_1" \
  -d "resource[resources][0][resource][flavorParamsId]=0" \
  -d "resource[resources][0][operationAttributes][0][objectType]=KalturaClipAttributes" \
  -d "resource[resources][0][operationAttributes][0][offset]=0" \
  -d "resource[resources][0][operationAttributes][0][duration]=10000" \
  -d "resource[resources][1][objectType]=KalturaOperationResource" \
  -d "resource[resources][1][resource][objectType]=KalturaEntryResource" \
  -d "resource[resources][1][resource][entryId]=$KALTURA_SOURCE_ENTRY_2" \
  -d "resource[resources][1][resource][flavorParamsId]=0" \
  -d "resource[resources][1][operationAttributes][0][objectType]=KalturaClipAttributes" \
  -d "resource[resources][1][operationAttributes][0][offset]=0" \
  -d "resource[resources][1][operationAttributes][0][duration]=10000"
```