Skip to content

Commit 261efda

Browse files
authored
Updating indexes and adding additional references to OCIO filter. (#118)
Signed-off-by: Sam.Richards@taurich.org <Sam.Richards@taurich.org>
1 parent 5b61d99 commit 261efda

File tree

4 files changed

+22
-9
lines changed

4 files changed

+22
-9
lines changed

EncodingOverview.md

Lines changed: 2 additions & 2 deletions
Original file line numberDiff line numberDiff line change
@@ -18,7 +18,7 @@ We will break the encoding process into three parts:
1818

1919
# Color space conversion. <a name="Color-space-conversion"></a>
2020

21-
FFmpeg is not a great tool for colorspace conversion. We recommend that any color space conversion be done using tools such as [Nuke](https://www.foundry.com/products/nuke-family/nuke) or [oiiotool](https://openimageio.readthedocs.io/en/latest/oiiotool.html) using [OCIO](https://opencolorio.org/). We strongly recommend using the ACES configuration whenever possible, since it provides a good baseline for colorspace conversion. Note, we may mention the use of Nuke a number of times, there are now a large number of 3rd party tools that will also do great at this color space conversion using OCIO.
21+
FFmpeg is not a great tool for colorspace conversion. We recommend that any color space conversion be done using tools such as [Nuke](https://www.foundry.com/products/nuke-family/nuke) or [oiiotool](https://openimageio.readthedocs.io/en/latest/oiiotool.html) using [OCIO](https://opencolorio.org/), or using [FFmpeg OCIO Filter](FfmpegOcio.html). We strongly recommend using the ACES configuration whenever possible, since it provides a good baseline for colorspace conversion. Note, we may mention the use of Nuke a number of times, there are now a large number of 3rd party tools that will also do great at this color space conversion using OCIO.
2222

2323
Typically, we would assume that an intermediate file would get written out, such as PNG, TIF or DPX for processing in ffmpeg.
2424

@@ -28,7 +28,7 @@ Hint: by default the nuke PNG writer will have the slow compression enabled, thi
2828

2929
Two options for building ffmpeg include:
3030

31-
* [rocky-ffmpeg-8.1](docker/rocky-ffmpeg-8.1).
31+
* [rocky-ffmpeg-8.1](docker/rocky-ffmpeg-8.1), will build ffmpeg, oiiotool and OCIO (including the OCIO filter for ffmpeg).
3232
* [conan](conan/README.md) directory that can be used to build ffmpeg with OCIO support on MacOS, linux and windows.
3333

3434
## Quick introduction to color conversion using oiiotool

Quickstart.md

Lines changed: 1 addition & 1 deletion
Original file line numberDiff line numberDiff line change
@@ -68,7 +68,7 @@ ffmpeg -r 24 -start_number 1 -i inputfile.%04d.png -pix_fmt yuv420p10le \
6868

6969
The combination of this and in_color_matrix will mean the color encoding will match the source media. If you are only adding one set of flags, this is the one, otherwise it will default to an output colorspace of bt601, which is a standard definition spec from the last century, and not suitable for sRGB or HD displays.
7070

71-
Separately, if you are converting from exr's in other colorspaces, **please use [OCIO](https://opencolorio.org/) to do the color space conversions.** [oiiotool](https://openimageio.readthedocs.io/en/latest/oiiotool.html) is an excellent open-source tool for this.
71+
Separately, if you are converting from exr's in other colorspaces, **please use [OCIO](https://opencolorio.org/) to do the color space conversions.** [oiiotool](https://openimageio.readthedocs.io/en/latest/oiiotool.html) is an excellent open-source tool for this. But there is now also an OCIO filter for ffmpeg (see [FFmpeg OCIO Filter](FfmpegOcio.html)).
7272

7373
For more details see:
7474

conan/README.md

Lines changed: 9 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -7,13 +7,16 @@ parent: Encoding Overview
77

88
# Conan Build System
99

10+
If you need a static build of ffmpeg, and do not need OpenColorIO, you may be quite happy with the [BtbN builds](https://github.com/BtbN/FFmpeg-Builds/releases/tag/latest).
11+
1012
[Conan](https://conan.io) is a multi-platform C/C++ package manager. While its typically used to help build applications, it does provide a nice way to build mutiple versions of applications that can easily be run side by side. For example, you can have multiple versions of ffmpeg installed, and you can switch between them by running the conanrun.bat script in a shell.
1113

1214
We have build profiles for MacOS, Linux and Windows.
1315

1416
## OSX
1517

1618
```bash
19+
git clone https://github.com/AcademySoftwareFoundation/EncodingGuidelines.git
1720
cd EncodingGuidelines/conan
1821
source linux-osx-setup.sh # sets up environment variables, installs conan and imports some additional conan recipes for vmaf, OCIO and and updated ffmpeg one to include the OCIO filter
1922
source ffmpeg-8.1-osx-build.sh # Runs the conan build.
@@ -33,6 +36,7 @@ source ./create-osx-bundle.sh
3336
If you are building for RHEL 9 / Rocky 9:
3437

3538
```bash
39+
git clone https://github.com/AcademySoftwareFoundation/EncodingGuidelines.git
3640
cd EncodingGuidelines/conan
3741
source linux-osx-setup.sh # sets up environment variables, installs conan and imports some additional conan recipes for vmaf, OCIO and and updated ffmpeg one to include the OCIO filter
3842
source ffmpeg-8.1-rhel9-build.sh # Runs the conan build.
@@ -64,6 +68,11 @@ Its worth noting, that the this process works with x86_64, but not with arm64 (a
6468

6569
I would recommend checking out the [Encoding Guidelines](https://github.com/AcademySoftwareFoundation/EncodingGuidelines) and then going to the conan folder.
6670

71+
```bash
72+
pacman -S git # If you dont have it.
73+
git clone https://github.com/AcademySoftwareFoundation/EncodingGuidelines.git
74+
```
75+
6776
There you can run windows_setup.sh to install the required tools and conan.
6877

6978
Once you have that running, you want to run:

index.md

Lines changed: 10 additions & 6 deletions
Original file line numberDiff line numberDiff line change
@@ -37,12 +37,16 @@ You can see the default ffmpeg conversion introduces a dramatic color shift that
3737
5. [Media Encoding with ffmpeg](ColorPreservation.html#encodestart)
3838
1. [Frame sequence specification](FfmpegInputs.html)
3939
2. [RGB to YCrCb Conversion](ColorPreservation.html#yuv)
40-
3. [TV vs. Full range.](ColorPreservation.html#tvfull)
41-
4. [RGB encode](RGBEncoding.html)
42-
5. [Useful Ffmpeg Filters.](OtherFfmpegArgs.html)
43-
6. [HDR Encoding](enctests/HDR_Encoding.html)
44-
7. [Adding Timecode and Editorial Workflow](EditorialWorkflow.html)
45-
8. [Adding Metadata](EncodingMetadata.html)
40+
3. [Adding Timecode and Editorial Workflow](EditorialWorkflow.html)
41+
4. [Web Color Preservation](WebColorPreservation.html)
42+
5. [FFmpeg OCIO Filter](FfmpegOcio.html)
43+
6. [FFmpeg Scaling Options](EncodeSwsScale.html)
44+
7. [Useful Ffmpeg Filters.](OtherFfmpegArgs.html)
45+
8. [Building FFmpeg in Docker](docker/README.html)
46+
9. [Building FFmpeg with Conan](conan/README.html)
47+
10. [HDR Encoding](enctests/HDR_Encoding.html)
48+
11. [RGB encode](RGBEncoding.html)
49+
12. [Adding Metadata](EncodingMetadata.html)
4650
6. [Codec Comparisons](Encoding.html#encode)
4751
1. [h264](Encodeh264.html)
4852
2. [ProRes](EncodeProres.html)

0 commit comments

Comments
 (0)