Inital push

2026-05-19 14:55:09 -04:00
commit 7f2f0754b3
29 changed files with 3190 additions and 0 deletions
@@ -0,0 +1,81 @@
+# 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.