OpenColorIO - Revision history

Matt: Replaced "skip forward to step 2" with "skip forward to "Restart Terragen...""

2025-07-30T22:13:41Z

Replaced "skip forward to step 2" with "skip forward to "Restart Terragen...""

Matt: Elaborated on what to do if OCIO is already set up.

2025-07-30T22:10:25Z

Elaborated on what to do if OCIO is already set up.

Matt: Using https for the links to zip and tar.gz

2025-07-30T21:55:40Z

Using https for the links to zip and tar.gz

Matt: Linking directly to zipball/master (.zip) and tarball/master (.tar.gz), with the github.com/imageworks/OpenColorIO-Configs link as a backup

2025-07-30T21:50:09Z

Linking directly to zipball/master (.zip) and tarball/master (.tar.gz), with the github.com/imageworks/OpenColorIO-Configs link as a backup

Redmaw: Updated links to OCIO downloads. Previous link no longer available.

2022-11-16T19:01:17Z

Updated links to OCIO downloads. Previous link no longer available.

Matt: Removed "Other Considerations" which applied only to older frontier builds.

2022-02-11T20:02:25Z

Removed "Other Considerations" which applied only to older frontier builds.

Matt: Removed some images from the Other Considerations section. This entire section should be removed at some point.

2021-02-23T22:07:02Z

Removed some images from the Other Considerations section. This entire section should be removed at some point.

Matt at 22:17, 23 December 2020

2020-12-23T22:17:16Z

Matt: Formatting

2020-12-23T22:16:24Z

Formatting

Matt: Added command line arguments

2020-12-23T22:13:40Z

Added command line arguments

@@ Line 16: / Line 16: @@
 '''1. Set up OCIO on your computer'''
-If you're working at a company that uses OCIO, this has probably already been done for you. There should be an environment variable in your system called OCIO which points to a config.ocio file. If so, don't change the setup; skip forward to step 2.
+If you're working at a company that uses OCIO, this has probably already been done for you. There should be an environment variable in your system called OCIO which points to a config.ocio file. If so, don't change the setup; skip forward to "Restart Terragen...".
 If you don't have OCIO set up, follow these instructions:

@@ Line 16: / Line 16: @@
 '''1. Set up OCIO on your computer'''
-If you're working at a company that uses OCIO, this has probably already been done for you.
+If you're working at a company that uses OCIO, this has probably already been done for you. There should be an environment variable in your system called OCIO which points to a config.ocio file. If so, don't change the setup; skip forward to step 2.
 If you don't have OCIO set up, follow these instructions:

@@ Line 22: / Line 22: @@
 <!-- # Download the Sample OCIO Configurations at http://github.com/imageworks/OpenColorIO-Configs/zipball/master -->
 <!-- # Download the Sample OCIO Configurations at https://github.com/AcademySoftwareFoundation/OpenColorIO  or https://opencolorio.readthedocs.io/en/latest/quick_start/downloads.html -->
-# Download the Reference OCIO Configurations: [http://github.com/imageworks/OpenColorIO-Configs/zipball/master .zip] or [http://github.com/imageworks/OpenColorIO-Configs/tarball/master .tar.gz]. (You can also find them at https://github.com/imageworks/OpenColorIO-Configs)
+# Download the Reference OCIO Configurations: [https://github.com/imageworks/OpenColorIO-Configs/zipball/master .zip] or [https://github.com/imageworks/OpenColorIO-Configs/tarball/master .tar.gz]. (You can also find them at https://github.com/imageworks/OpenColorIO-Configs)
 # Extract the contents of the .zip or .tar.gz file to your computer.
 # Decide which configuration you want to use. We recommend the '''aces_1.0.3''' configuration. You should see a file called '''config.ocio''' inside each of the configuration folders.

@@ Line 21: / Line 21: @@
 <!-- # Download the Sample OCIO Configurations at http://github.com/imageworks/OpenColorIO-Configs/zipball/master -->
-# Download the Sample OCIO Configurations at https://github.com/AcademySoftwareFoundation/OpenColorIO  or https://opencolorio.readthedocs.io/en/latest/quick_start/downloads.html
+<!-- # Download the Sample OCIO Configurations at https://github.com/AcademySoftwareFoundation/OpenColorIO  or https://opencolorio.readthedocs.io/en/latest/quick_start/downloads.html -->
-# Extract the contents of the .zip file to your computer.
+# Download the Reference OCIO Configurations: [http://github.com/imageworks/OpenColorIO-Configs/zipball/master .zip] or [http://github.com/imageworks/OpenColorIO-Configs/tarball/master .tar.gz]. (You can also find them at https://github.com/imageworks/OpenColorIO-Configs)
 # Decide which configuration you want to use. We recommend the '''aces_1.0.3''' configuration. You should see a file called '''config.ocio''' inside each of the configuration folders.
 # Set an environment variable in your system called OCIO. The '''OCIO variable should be set to the full path and filename of the config.ocio file you want to use'''.

@@ Line 20: / Line 20: @@
 If you don't have OCIO set up, follow these instructions:
-# Download the Sample OCIO Configurations at http://github.com/imageworks/OpenColorIO-Configs/zipball/master
+<!-- # Download the Sample OCIO Configurations at http://github.com/imageworks/OpenColorIO-Configs/zipball/master -->
 # Extract the contents of the .zip file to your computer.
 # Decide which configuration you want to use. We recommend the '''aces_1.0.3''' configuration. You should see a file called '''config.ocio''' inside each of the configuration folders.

← Older revision		Revision as of 20:02, 11 February 2022
Line 97:		Line 97:
	* Choice of colour space per shader or node. In this version, conversion is done the same for all images that have "convert to linear" checked, and individual colour parameters on shaders are predefined to either be convertible or not.		* Choice of colour space per shader or node. In this version, conversion is done the same for all images that have "convert to linear" checked, and individual colour parameters on shaders are predefined to either be convertible or not.
	* Independent choice of colour space for internal rendering and file output. Until we add this option, EXRs are output using the scene linear values that were generated by the renderer.		* Independent choice of colour space for internal rendering and file output. Until we add this option, EXRs are output using the scene linear values that were generated by the renderer.
−
−
−	~~=== Other Considerations ===~~
−
−	~~'''''This information pertains to Frontier Builds from 4.5.32 up to 4.5.43 only.'''''~~
−
−	The default atmosphere has colours which were chosen for a Rec. 709 (sRGB) pipeline. They don't know about your OCIO config. If you're using an ACES configuration, for example, you might find that the sky looks too green.
−
−	~~<!--~~
−	~~[[File:TG_OCIO_OtherConsiderations_01_DefaultAtmoNoToneMap_NoColMan.jpg\|None\|867px\|Terragen default atmosphere with Terragen tone mapping. Terragen project Colour Management disabled.]]~~
−	~~-->~~
−
−	[[File:TG_OCIO_OtherConsiderations_02_DefaultAtmoNoToneMap_ColManACES.jpg\|None\|867px\|Terragen default atmosphere without Terragen tone mapping. Terragen project Colour Management enabled. Display space is sRGB(ACES).]]
−
−	~~'''''Frontier Builds from 4.5.32 up to 4.5.43 only.'''''~~
−
−
−	~~If this affects you, you might find the following adjustments useful:~~
−
−
−	* '''Bluesky horizon colour''' (on the Main tab): reduce the green channel very slightly so that it's closer to the red value than the blue value. For a less saturated look, simply make it greyscale 0.25 (135, 135, 135).
−
−	~~[[File:TG_OCIO_Atmosphere_Recommended_Settings.PNG\|None\|470px\|Atmosphere Main tab.]]~~
−	~~[[File:TG_OCIO_Atmosphere_ColorPicker_Recommended_Settings.PNG\|None\|280px\|Colour picker values for Bluesky horizon colour.]]~~
−
−
−	* '''Bluesky density colour''' (on the Tweaks tab): increase the red channel so that it's a little closer to the green value.
−
−	~~[[File:TG_OCIO_Atmosphere_BlueskyDensityColour_Recommended.PNG\|None\|470px\|Atmosphere Tweaks tab.]]~~
−	~~[[File:TG_OCIO_Atmosphere_BlueSkyDensityColourPicker.PNG\|None\|280px\|Colour picker values for Bluesky density colour.]]~~

← Older revision		Revision as of 22:07, 23 February 2021
Line 127:		Line 127:
	[[File:TG_OCIO_Atmosphere_BlueskyDensityColour_Recommended.PNG\|None\|470px\|Atmosphere Tweaks tab.]]		[[File:TG_OCIO_Atmosphere_BlueskyDensityColour_Recommended.PNG\|None\|470px\|Atmosphere Tweaks tab.]]
	[[File:TG_OCIO_Atmosphere_BlueSkyDensityColourPicker.PNG\|None\|280px\|Colour picker values for Bluesky density colour.]]		[[File:TG_OCIO_Atmosphere_BlueSkyDensityColourPicker.PNG\|None\|280px\|Colour picker values for Bluesky density colour.]]
−
−
−	Now that the Bluesky adjustments have been made to the atmosphere, we can compare renders of a Terragen project using Colour Management with ACES colour space and a Terragen project with Colour Management disabled.
−
−	~~[[File:TG_OCIO_OtherConsiderations_03_RecommendedAtmo_ColManACES.jpg\|None\|867px\|Terragen recommended atmosphere. Terragen project Colour Management enabled. Display space is sRGB(ACES).]]~~
−
−	~~[[File:TG_OCIO_OtherConsiderations_04_DefaultAtmoToneMap_NoColMan.jpg\|None\|867px\|Terragen default atmosphere with Terragen tone mapping. Terragen project Colour Management disabled.]]~~

@@ Line 34: / Line 34: @@
 === Command Line Arguments (Optional) ===
-OCIO can be force enabled with the command line argument "ocio" or "ocio=yes", as long as there is an environment variable named OCIO pointing to a valid OCIO config file. This command line argument causes Terragen to enable "Use OCIO" in Project Settings at startup and after a project is loaded. Terragen will default to roles which work well with ACES 1.0.3 but might not be compatible with your OCIO configuration, so we recommend testing this feature in the GUI first to see if the default settings are suitable. Please send us feedback if you think our defaults could be better or you need more controls.
+OCIO can be force-enabled with the command line argument "ocio" or "ocio=yes", as long as there is an environment variable named OCIO pointing to a valid OCIO config file. This command line argument causes Terragen to enable "Use OCIO" in Project Settings at startup and after a project is loaded. Terragen will default to roles which work well with ACES 1.0.3 but might not be compatible with your OCIO configuration, so we recommend testing this feature in the GUI first to see if the default settings are suitable. Please send us feedback if you think our defaults could be better or you need more controls.
 OCIO can be disabled with the command line argument "ocio=no". This causes Terragen to disable "Use OCIO" in Project Settings at startup and after a project is loaded.

@@ Line 10: / Line 10: @@
 | [[File:Wiki_TG45_OCIO_RenderACEScg_ViewRec709.jpg|none|400px|Terragen default scene, rendered in ACEScg colour space, viewed in Rec 709 colour space.]] || [[File:Wiki_TG45_OCIO_RenderACEScg_ViewACEScg.jpg|none|400px|Terragen default scene, rendered and viewed in ACEScg colour space.]]
 |}
 === Requirements ===
@@ Line 29: / Line 30: @@
 In Terragen, OCIO is enabled or disabled on a ''per-project (per-scene) basis''. Click on '''Project Settings''' at the lower left of the main window, then turn on '''Use OCIO''' if it is not already on.
 === Command Line Arguments (Optional) ===
@@ Line 35: / Line 37: @@
 OCIO can be disabled with the command line argument "ocio=no". This causes Terragen to disable "Use OCIO" in Project Settings at startup and after a project is loaded.
 === First Tests ===

← Older revision		Revision as of 22:13, 23 December 2020
Line 30:		Line 30:
	In Terragen, OCIO is enabled or disabled on a ''per-project (per-scene) basis''. Click on '''Project Settings''' at the lower left of the main window, then turn on '''Use OCIO''' if it is not already on.		In Terragen, OCIO is enabled or disabled on a ''per-project (per-scene) basis''. Click on '''Project Settings''' at the lower left of the main window, then turn on '''Use OCIO''' if it is not already on.

		+	=== Command Line Arguments (Optional) ===
		+
		+	OCIO can be force enabled with the command line argument "ocio" or "ocio=yes", as long as there is an environment variable named OCIO pointing to a valid OCIO config file. This command line argument causes Terragen to enable "Use OCIO" in Project Settings at startup and after a project is loaded. Terragen will default to roles which work well with ACES 1.0.3 but might not be compatible with your OCIO configuration, so we recommend testing this feature in the GUI first to see if the default settings are suitable. Please send us feedback if you think our defaults could be better or you need more controls.
		+
		+	OCIO can be disabled with the command line argument "ocio=no". This causes Terragen to disable "Use OCIO" in Project Settings at startup and after a project is loaded.

	=== First Tests ===		=== First Tests ===