Skip to content

Blender addon to automate color space assignments of image textures

License

Notifications You must be signed in to change notification settings

NicSJ/FixColorspace

Folders and files

NameName
Last commit message
Last commit date

Latest commit

 

History

34 Commits
 
 
 
 
 
 
 
 
 
 
 
 

Repository files navigation

FixColorSpace

Blender addon that changes the color space of all material image nodes, including World, based on specific image keywords. Designed to be used with the default color spaces or ACES. Compatible with ACES config files for OCIO v1 or OCIO v2. Not tested with custom config files, e.g. Blender default merged with an Aces v1 file. Tested with Blender 2.8 to 4.3. If you using the OCIO v2 configs, I suggest using Blender 3.5.0 or newer.

Extended from the original file posted by Blender Bob Free Color space addon for Blender

Conversion defaults

Color Images Non-Color Images Environment Images
Filmic/AgX sRGB Non-Color Linear (Blender <= 3.6) / Linear Rec.709 (Blender 4.0+)
ACES (OCIO v1) Utility - sRGB - Texture Utility - Raw Utility - Linear - Rec.709
ACES 2 (OCIO v2) sRGB - Texture Raw Linear Rec.709 (sRGB)
ACES 2 (Config 2.1-2.2) sRGB Encoded Rec.709 (sRGB) Raw Linear Rec.709 (sRGB)

Installation

Download the latest version from the Releases section. Open Blender -> Edit -> Preferences -> Add-ons -> Install... Navigate to the location of the .zip that was downoaded. Makes sure the enable checkbox is ticked. In the 3D viewport press N and select the Tool tab. Scroll down untill you find Fix Color Space. Alternatively, you can find the Tool tab in the Properties panel (above the Render tab).

Addon in side panel Addon in properties panel

FAQ

Q: Why do I only see this button:

A: The addon automatically checks the properties panel -> Render -> Color Management -> Display Device (Aces config v1 - will only display "ACES")

or View Transform (Aces config v2 - will have a list of 4 names, 2 starting with "ACES 1.0")

If you don't see either of these options, you are most likely using default Blender and won't see the Aces buttons.


Q: How do I get the Aces options to show up?

A: One option would be to start Blender with a OCIO config file. The following will work on for Windows. Create a text file and name it anything you like. Paste one of the following examples into the file and change the paths to the appropriate locations. Change the file extension from .txt to .bat. Double-click the batch file when you need to run Blender in Aces mode.

REM ACES v1
set OCIO=C:\OpenColorIO-Configs\aces_1.2\config.ocio
start "BLENDER 4.0" "C:\BlenderBuilds\bl_symlink\blender.exe"
REM ACES v2
set "OCIO=G:\OpenColorIO-Configs\aces_2\v2\studio-config-v2.0.0_aces-v1.3_ocio-v2.2.ocio"
start "BLENDER 4.0" "C:\BlenderBuilds\bl_symlink\blender.exe"
REM ACES 2 - Config v2.1 (built into Blender)
rem set "OCIO=ocio://default"
set "OCIO=ocio://studio-config-v2.1.0_aces-v1.3_ocio-v2.3"
start "BLENDER 4.2" "C:\Program Files\Blender Foundation\Blender 4.2\blender.exe"

For more information or Mac scripts, check Blender & ACES 1.2/1.3 OCIO v1 Blender & ACES OCIO v2


Q: Why is the color space of the image texture not converting correctly?

A: The addon looks for the following keywords in the image file name:
'displacement', 'displace', 'disp', 'dsp', 'heightmap', 'height', 'glossiness', 'glossy', 'gloss', 'normal', 'norm', 'nor', 'nrml', 'nrm', 'normalbump', 'bump', 'bmp', 'specularity', 'specular', 'spec', 'spc', 'roughness', 'rough', 'rgh', 'metalness', 'metallic', 'metal', 'mtl', 'ao', 'ambient', 'occlusion', 'sss', 'subsurface', 'transparency', 'opacity', 'alpha', 'transmission', 'thickness', 'curvature', 'curv', '_arm_', '_orm_'

If a keyword is found, the color space will be changed to a raw/non-color variant. Note the 'sss' and 'subsurface' asume the subsurface weight, not the color or radius. If none are found, the color space will be changed to a variant of sRGB. For variations, refer to Conversion defaults above. Textures from sites such as Polyhaven, or generated with Substance 3D Painter, have the keywords in the file names and should work as expected. If you are naming files manually, be sure to add the appropriate keyword to the file. E.g. Bronze_damaged_normal.png

About

Blender addon to automate color space assignments of image textures

Resources

License

Stars

Watchers

Forks

Packages

No packages published

Languages