From 7c302ecee9bdb7a53b2fc03d9d63693996566010 Mon Sep 17 00:00:00 2001
From: Dennis Fink
Date: Tue, 24 Feb 2026 21:08:38 +0100
Subject: docs: document all variables available to presets

Previously only output_pixel_format was mentioned. All three variables
(input_codec, input_pixel_format, output_pixel_format) are now listed
with descriptions in the script header comment, the README, and the
man page.
---
 transcode.sh.1 | 24 +++++++++++++++++++++---
 1 file changed, 21 insertions(+), 3 deletions(-)

(limited to 'transcode.sh.1')

diff --git a/transcode.sh.1 b/transcode.sh.1
index fe38c21..a22b802 100644
--- a/transcode.sh.1
+++ b/transcode.sh.1
@@ -153,10 +153,28 @@ array variable named
 .B ffargs
 containing additional arguments for
 .BR ffmpeg (1).
-The variable
+The following variables are available to presets at source time:
+.RS
+.TP
+.B input_codec
+The video codec of the input file as reported by
+.BR ffprobe (1)
+(e.g.\&
+.IR h264 ,
+.IR hevc ).
+.TP
+.B input_pixel_format
+The pixel format of the input file after
+.I yuvj*
+normalisation (e.g.\&
+.IR yuv420p ,
+.IR yuv444p10le ).
+.TP
 .B output_pixel_format
-is available to presets and contains the automatically selected output
-pixel format string.
+The recommended output pixel format, automatically derived from the
+input to preserve chroma subsampling (4:2:0, 4:2:2, 4:4:4) and bit
+depth (8, 10, 12, 16\-bit).
+.RE
 .IP
 Before the preset's
 .B ffargs
-- 
cgit v1.3.1