​

Video Cropping Transformations

​

Crop Modes

​

crop - Exact Dimensions

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

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

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

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

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

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

​

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

​

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