Changes between Version 15 and Version 16 of colorspace

Timestamp:

May 2, 2024, 7:26:21 PM (2 years ago)

Author:

MasterQuestionable

Comment:

Early release: "color_primaries". Complete rewrite planned later.

colorspace

@@ -47 +47 @@
 == How to use FFmpeg to convert the colorspace ==
 
-Pixel format conversion is often performed by [https://ffmpeg.org/libswscale.html libswscale], which you will most likely access through the [https://ffmpeg.org/ffmpeg-scaler.html FFmpeg Scaler] or the scale [https://ffmpeg.org/ffmpeg-filters.html#scale-1 video filter]. 
+Pixel format conversion is often performed by [https://ffmpeg.org/libswscale.html libswscale], which you will most likely access through the [https://ffmpeg.org/ffmpeg-scaler.html FFmpeg Scaler] or the scale [https://ffmpeg.org/ffmpeg-filters.html#scale-1 video filter].
 
 Other video filters include:
@@ -56 +56 @@
 === Comparing and contrasting `colorspace`, `colormatrix`, libswscale, and `zscale` ===
 
-- `colorspace` and `colormatrix` can only convert YUV to YUV 
+- `colorspace` and `colormatrix` can only convert YUV to YUV
 - libswscale can convert between YUV and RGB
 - `colormatrix` only supports 8bpc (8-bit per component) pixel formats
 - `colorspace` supports 8bpc, 10bpc, and 12bpc
-- `colormatrix` does not apply gamma and primaries correction (i.e. which exact color "red", "green", and "blue" each is) 
+- `colormatrix` does not apply gamma and primaries correction (i.e. which exact color "red", "green", and "blue" each is)
 - `colorspace` applies gamma and primaries correction by default. (Use `fast=1` to disable this for faster conversion or to make output compatible with output produced by `colormatrix`.)
 - `colormatrix` is C only, whereas `colorspace` uses x86 SIMD so it's faster
 - `colormatrix` produces horrible quality for 10bpc and 12bpc
-- `colorspace` produces something decent for 10bpc 
-- For 8bpc, `colorspace` seems to produce slightly better quality than `colormatrix` 
+- `colorspace` produces something decent for 10bpc
+- For 8bpc, `colorspace` seems to produce slightly better quality than `colormatrix`
 - `zscale` produces better results at all bit depths
 
@@ -84 +84 @@
 See also [https://stackoverflow.com/a/69251961 F.X.'s HDR answer] and [https://stackoverflow.com/a/55411219 Gyan's sRGB output answer]. If `srgb` does not work, try the more academic name `iec61966-2-1`.
 
+=== "color_primaries" ===
+
+͏    Quick reference for somewhat cryptic "color_primaries" names:\\
+͏    1: "bt709" (BT.709)\\
+͏    5: "bt470bg" / "gamma28" (BT.470 BG)\\
+͏    6: "smpte170m" (SMPTE 170 M)\\
+͏    (alike for "colorspace" "color_trc")\\
+͏    .\\
+͏    See also:\\
+(!`ffmpeg -h full` derived)\\
+[[
+{{{
+-color_range <int>  color range (from 0 to INT_MAX) (default unknown)
+  0 unknown          Unspecified
+    unspecified
+  1 tv               MPEG (( 219 * 2^( n - 8 ) ))
+    mpeg
+    limited
+  2 pc               JPEG (( 2^( n - 1 ) ))
+    jpeg
+    full
+
+-colorspace <int>      color space (from 0 to INT_MAX) (default unknown)
+   0 rgb                RGB
+   1 bt709              BT.709
+   2 unknown            Unspecified
+     unspecified
+   4 fcc                FCC
+   5 bt470bg            BT.470 BG
+   6 smpte170m          SMPTE 170 M
+   7 smpte240m          SMPTE 240 M
+   8 ycgco              YCGCO
+     ycocg
+   9 bt2020nc           BT.2020 NCL
+     bt2020_ncl
+  10 bt2020c            BT.2020 CL
+     bt2020_cl
+  11 smpte2085          SMPTE 2085
+  12 chroma-derived-nc  Chroma-derived NCL
+  13 chroma-derived-c   Chroma-derived CL
+  14 ictcp              ICtCp
+  15 ipt-c2             IPT-C2
+  16 ycgco-re           YCGCO-R (even add)
+  17 ycgco-ro           YCGCO-R (odd add)
+
+-color_primaries <int>  color primaries (from 1 to INT_MAX) (default unknown)
+   1 bt709               BT.709
+   2 unknown             Unspecified
+     unspecified
+   4 bt470m              BT.470 M
+   5 bt470bg             BT.470 BG
+   6 smpte170m           SMPTE 170 M
+   7 smpte240m           SMPTE 240 M
+   8 film                Film
+   9 bt2020              BT.2020
+  10 smpte428            SMPTE 428-1
+     smpte428_1
+  11 smpte431            SMPTE 431-2
+  12 smpte432            SMPTE 422-1
+  22 jedec-p22           JEDEC P22
+     ebu3213             EBU 3213-E
+
+-color_trc <int>  color transfer characteristics (from 1 to INT_MAX) (default unknown)
+   1 bt709         BT.709
+   2 unknown       Unspecified
+     unspecified
+   4 gamma22       BT.470 M
+   5 gamma28       BT.470 BG
+   6 smpte170m     SMPTE 170 M
+   7 smpte240m     SMPTE 240 M
+   8 linear        Linear
+   9 log100        Log
+     log
+  10 log316        Log square root
+     log_sqrt
+  11 iec61966-2-4  IEC 61966-2-4
+     iec61966_2_4
+  12 bt1361e       BT.1361
+     bt1361
+  13 iec61966-2-1  IEC 61966-2-1
+     iec61966_2_1
+  14 bt2020-10     BT.2020 10-bit
+     bt2020_10bit
+  15 bt2020-12     BT.2020 12-bit
+     bt2020_12bit
+  16 smpte2084     SMPTE 2084
+  17 smpte428      SMPTE 428-1
+     smpte428_1
+  18 arib-std-b67  ARIB STD-B67
+}}}
+]]\\
+͏    [ Still cryptic whatsoever... ]
+
 == Examples (Made using [https://zeranoe.com/builds/win64/static/ffmpeg-20190416-e2f766e-win64-static.zip zeranoe 20190416]) ==
 
@@ -105 +198 @@
 [[BR]]
 ==== `colorspace` (yuv444p10le): ====
-Note: SSIM > 99.98% with [#Theinputsourcergb24: The input source (rgb24)]. Should be 100% if the conversion algorithms are improved, though. 
+Note: SSIM > 99.98% with [#Theinputsourcergb24: The input source (rgb24)]. Should be 100% if the conversion algorithms are improved, though.
 {{{
 ffmpeg -i "origin(rgb24).png" -c:v libx264 -preset placebo -qp 0 -x264-params "keyint=15:no-deblock=1" -pix_fmt yuv444p10le -sws_flags spline+accurate_rnd+full_chroma_int -vf "colorspace=bt709:iall=bt601-6-625:fast=1" -color_range 1 -colorspace 1 -color_primaries 1 -color_trc 1 "colorspace_yuv444p10le.avi"