Files
Video-Processing-Scripts/Create-ShortClip.ini
T
2026-05-19 14:55:09 -04:00

82 lines
3.4 KiB
INI

# Output clip video file specifications section
[Clip]
# Format: Output aspect ratio. Default: Portrait.
# - Portrait: 9:16 aspect ratio
# - Square: 1:1 aspect ratio
Format=Portrait
# Height: Vertical height in pixels. Width is computed based on format. Default: 1920.
Height=1920
# Padding: Vertical padding position when input height < output height. Default: Center.
# - Top: All padding at top
# - Bottom: All padding at bottom
# - Center: Padding split evenly top and bottom
# - None: No padding; scale video to fill output height and crop horizontally
Padding=Center
# Color: Padding color name or RGB value. Default: black.
# - Named colors: black, white, red, blue, etc.
# - Hex format: #RRGGBB (e.g., #1a1a1a)
# - FFmpeg format: 0xRRGGBB
Color=black
# Overlay: Path to PNG file with transparency to overlay on each cropped frame. Default: none.
# Example: Overlay=border.png
# Overlay=
# Audio: Copy audio from input video. Default: Yes.
# - Yes: Include audio
# - No: Video only
Audio=Yes
# Position: Reference point for numeric cropping offset values. Default: Center.
# - Left: Numeric values represent absolute pixel offset from left edge
# - Center: Numeric values represent pixel offset from center (value - output_width/2)
# - Right: Numeric values represent pixel offset from right edge (value - output_width)
Position=Left
# Smoothing: Mode for adjusting cropping transition length to control speed. Default: None.
# - None: No smoothing, use calculated interpolation as-is
# - Up: Extend transition by incrementing upper frame until speed limit is met
# - Center: Extend transition by adjusting frame closest to center until speed limit is met
# - Down: Extend transition by decrementing lower frame until speed limit is met
Smoothing=None
# Speed: Maximum cropping transition speed in pixels per frame. Default: 10, minimum: 1.
# Controls how fast the crop position can change between frames.
# If interpolated speed exceeds this value, smoothing extends the transition.
Speed=10
# Horizontal cropping keyframes section
[Cropping]
# Defines horizontal cropping keyframes with automatic interpolation.
# Format: frame_number=position
#
# Position values:
# - Left: Crop from left edge (offset = 0)
# - Center: Crop from center (offset = (input_width - output_width) / 2)
# - Right: Crop from right edge (offset = input_width - output_width)
# - number: Absolute pixel offset (capped at Right value)
#
# Behavior:
# - Frame numbers must be in ascending order
# - Intermediate frames are automatically interpolated with smooth transitions
# - Frames after the last keyframe use the last defined offset
# - If section is empty or missing, defaults to '0=Center'
#
# Example: Input video is 1920x1088, output video is 1080x1920, total frames: 100
0=Left
10=200
50=Center
75=Center
91=Right
# Calculated offsets:
# Frame 0: 0 (Left)
# Frames 1-9: Linear interpolation from 0 to 200
# Frame 1: 20, Frame 2: 40, ..., Frame 9: 180
# Frame 10: 200
# Frames 11-49: Linear interpolation from 200 to 420 (Center = (1920-1080)/2)
# Frame 11: 194.5, Frame 12: 189, ..., Frame 49: 425.5
# Frame 50: 420 (Center)
# Frames 51-74: No change (Center to Center)
# All frames: 420
# Frame 75: 420 (Center)
# Frames 76-90: Linear interpolation from 420 to 840 (Right = 1920-1080)
# Frame 76: 448, Frame 77: 476, ..., Frame 90: 812
# Frame 91: 840 (Right)
# Frames 92-99: 840 (last known value)
#
# All fractional values are rounded to nearest pixel.