​
Video Cropping Transformations

​
Crop Modes

Control how your video is cropped using the c_{mode} parameter. Each mode handles dimensions differently:

​
crop - Exact Dimensions

Crops the video to exactly match the specified dimensions, removing excess pixels. 
tr-w_500,h_300,c_crop
  • Best for: Fixed-size video players where exact dimensions are required
  • Behavior: May remove parts of the video to achieve exact size
  • Example use: Social media videos, video thumbnails

​
fill - Resize and Crop

Resizes the video to fill the specified dimensions while maintaining aspect ratio, then crops excess pixels. 
tr-w_800,h_600,c_fill
  • Best for: Hero videos, featured content
  • Behavior: Ensures entire space is filled without distortion
  • Example use: Website headers, video backgrounds

​
fit - Preserve Content

Resizes video to fit within specified dimensions while maintaining aspect ratio, with no cropping. 
tr-w_400,h_300,c_fit
  • Best for: Product videos, instructional content
  • Behavior: May leave empty space on sides or top/bottom
  • Example use: Video galleries, educational content

​
scale - Simple Resize

Basic resize that may change aspect ratio to match exact dimensions. 
tr-w_500,h_300,c_scale
  • Best for: When aspect ratio isn’t critical
  • Behavior: May stretch or compress video
  • Example use: Background videos, non-critical content

​
limit - Downscale Only

Only scales down videos that are larger than specified dimensions. 
tr-w_800,h_600,c_limit
  • Best for: User-uploaded content
  • Behavior: Never enlarges small videos
  • Example use: Forum attachments, user galleries

​
pad - Add Padding

Resizes within dimensions and adds padding to reach exact size. 
tr-w_400,h_400,c_pad,b_000000
  • Best for: Consistent layouts requiring exact dimensions
  • Behavior: Adds padding to maintain aspect ratio
  • Example use: Video grids, multi-video layouts
  • Supports background options (solid color or blur)

​
Gravity Control

Use g_{position} to control the focal point during cropping. Only works with crop and fill modes:

​
Standard Positions

tr-c_crop,g_center        # Default
tr-c_crop,g_north        # Top center
tr-c_crop,g_south        # Bottom center
tr-c_crop,g_east         # Right center
tr-c_crop,g_west         # Left center
tr-c_crop,g_north_east   # Top right
tr-c_crop,g_north_west   # Top left
tr-c_crop,g_south_east   # Bottom right
tr-c_crop,g_south_west   # Bottom left

​
Background Options

When using pad mode, control the padding appearance:

​
Solid Color Background

tr-c_pad,b_000000    # Black background
tr-c_pad,b_FFFFFF    # White background
tr-c_pad,b_FF0000    # Red background

​
Blurred Background

tr-c_pad,b_blur      # Blurred edges from video content