AColorManager

Convert colors and bitmaps in your 3ds Max scenes from/to color profile or gamma value.

Get Pro Version:

Buy AColorManager Pro

Follow AvizStudioTools:

YouTube Facebook Twitter

Contact us:

Email

About

With AColorManager you can convert colors and bitmaps in your 3ds Max scenes from/to specified color profile or gamma value.

Convert From/To Color Profiles:
Color Profile
Standard monitors have gamut close to sRGB color space and the new wide gamut monitors are close to Adobe RGB (1998) color space. This is the reason why old scenes look oversaturated on wide gamut monitors and scenes created on wide gamut monitor look wash out on sRGB monitors. With AColorManager you can easily convert from old color profile to the new using external apps like Adobe Photoshop, ImageMagick or other installed application with support of command line interface.

Convert From/To Gamma:
Color Gamma
All digital images and colors that we see on a monitor are usually in gamma 2.2 and most of the 3d softwares render and "see" colors in gamma 1.0. This is the reason why if you don’t translate your color information into the native gamma of 3ds Max (Linear Work Flow – LWF), you will get unnatural light distribution. With AColorManager you can easily convert from gamma 2.2 to 1.0 (or any other values) all the colors in your scene and all or only those bitmaps that are not handle correctly from the built into 3ds Max gamma system (like misplacement , bump and so on maps).

Standard version has all the functions of the Pro version but has limited bitmaps and colors count per conversion.

Download & Install

This script works with 3ds Max 7 or later. Script is free for commercial and non-commercial projects. You are not allowed to sell or distribute this script or any parts of it. We are not responsible for any damages or incompatibilities that may result by using this script.

Versions :

How to install:

  • Download, extract and install the latest version.
  • Restart 3ds Max.
  • From 3ds Max menu, select: Customize > Customize User Interface… > in "Keyboard" or "Toolbar" tab select Group: "Main UI" and Category: "AvizStudioTools". From the list below assign keyboard shortcut to "AColorManager" from "Keyboard" tab or from "Toolbar" tab drag and drop "AColorManager" to a toolbar to create UI button for the script.

Videos

Interface

Profile Mode

[Profile] button – press to select profile mode

Convert With Photoshop – Convert color profile using Adobe Photoshop (should be installed in your system). It’s recommended to set Photoshop Color Management Policies as follows:

Color Management Policies

Options Photoshop – First three options are the same as options in Photoshop preferences.

Assign Profile Only if Missing* – Assign profile only if image has no color profile information. For this option to work correctly set Photoshop Color Management Policies, as shown above. Open any image without color profile and when dialog ask you for missing profile – select "Leave as is":

Missing Profile

Convert With ImageMagick – Convert color profile using ImageMagick (should be installed in your system).
Options ImageMagick – Option to remove embedded profile of image file before assigning or converting file.

Convert With Custom Application – Convert with other custom application that support command line interface.
Options Custom Application – Option to set and edit command string.

[System Profiles] button – Read profiles installed in the system and load the names of the profiles in drop-down menus below.
[Folder Profiles] button – Read profiles from custom folder and load the names of the profiles in drop-down menus below.

Assign Profiles Checkbox – Select to assign profile to colors.
Assign Profiles Dropdown Menu – select which profile to assign.
Assign Profiles Text Field – Enter the name of the profile for Photoshop or select a file for ImageMagick and custom application. Delete field to access the drop-down menu above.

Convert To Profiles Checkbox – Select to convert colors to profile.
Convert To Profiles Dropdown Menu – select to which profile to convert.
Convert To Profiles Text Field – Enter the name of the profile for Photoshop or select a file for ImageMagick and custom application. Delete field to access the drop-down menu above.

Gamma Mode

System Gamma Preferences – Show current system preferences settings.
Set New System Values – Set system gamma values for display, input and output. To set new values press [Set] button.
Convert From Gamma – Set gamma value of current colors and bitmaps.
Convert To Gamma – Set new gamma value.
Only Excl. Bitmaps – Inverse – Convert only bitmaps that match the exclude patterns with inverse from/to gamma.
Save New Bitmap Files As – Select the file type converted bitmaps.

New Files Options

New Files To Folder Checkbox – Select to place converted files to folder.
Add Suffix To New File Name Checkbox – Select to add suffix entered below.

Buttons

[Convert File] button – Convert single file.
[Convert Colors] button – Convert up to 10 custom colors.
[Convert SCENE/SELECTION To Profile/Gamma] button – Convert scene or selection of objects.

[Load] button – Load saved settings from file.
[Save] button – Save current settings to text file.
[About] button – About this script, register license key (Pro version only).

Filters

Convert Scene – Selection – Select to convert entire scene or selection of objects.
Convert Bitmaps – Select to convert bitmaps.
Convert Colors – Select to convert colors.

Search Objects – Search objects for bitmaps/colors (for example color of light object).
Search Materials – Search scene materials for bitmaps/colors.
Search Modifiers – Search modifiers for bitmaps/colors (for example displace modifier).
Search Mat. Editor – Search material editor for bitmaps/colors.
Search Wire Color* – Convert objects wirecolor (this parameter is not affected by patterns below).
Search Environment* – Convert environment colors – background and global lighting colors (this parameter is not affected by patterns below).

Include Patterns Path – If this option is enabled, every pattern from the list below will be tested against every step of the path to the current color or bitmap. If this option is disabled, only the name of the color or bitmap field will be tested against pattern list.
Include Patterns – Include list of text patterns (read more for "Paths And Patterns" below). If a match is found the value will be converted. Delete all patterns to include all colors and bitmaps.

Exclude Patterns Path – If this option is enabled, every pattern from the list below will be tested against every step of the path to the current color or bitmap. If this option is disabled only the name of the color or bitmap field will be tested against pattern list.
Exclude Patterns – Exclude list of text patterns (read more for "Paths And Patterns" below). If a match is found the value will not be converted.
Info – Show progress and information for last conversion.

Path And Patterns

Matching patterns and the path to the colors or bitmap files are powerful ways to select only the parameters that you want to convert.

The Path is an array of names that represents the steps from the class of the parent object to the name of the target color or bitmap:
[Class of parent object] , [step1] , [step3] , [step…N] , [Name of Color or Bitmap field]

Path examples:
1. A standard 3ds Max material with Checker Map in diffuseMap slot and Gradient Map in map1 slot of the Checker Map has path to color1 in Gradient Map as follows:
[Standardmaterial] , [diffuseMap] , [map1] , [color1]
2. The RGB color of Omni light has path:
[Omnilight] , [rgb]
3. The path to the texture map in a VRayDisplacementMod modifier is:
[VRayDisplacementMod] , [texmap]

You can see the different steps of the path by enabling MacroRecord in MAXScript Listener window and changing the value you want to convert (to see the result, drag down the line at the top of the white field in the Listener window). For "Path example 1" the result of changing color 1 in gradient map will be:
meditMaterials[1].diffuseMap.map1.color1 = color 128 128 128

The Patterns is a list of wild-card names to match against path steps of a color or a bitmap values. They may or may not have special characters like "*" or "?":

1. A pattern "color" will return true for every tested value from a path array that is equal to "color".
2. A pattern "color?" will return true for every tested value from a path array that begin with "color" and after that has one more character. For example: "color1", "color2","colorA".
3. A pattern "color*" will return true for every tested value from a path array that begin with "color". For example: "color1", "color_top","color_diff".

Tips & Shortcuts

Patterns [+] button – Press Ctrl + plus button to load default patterns list or press Alt + plus button to save current patterns list as text file.
Patterns [-] button – Press Shift + minus button to delete all patterns in the list below.