Class

Driver

Synopsis

RGB colors edited in real-time using imager_color_curves


An imager to control brightness and color curves. Separate curves can be authored for each R, G, or B component, along with the main curve to control the overall luminance response. Curve interpolation and working color space can also be set as needed.

This imager will be more useful if your pixel values have already been tonemapped and are within the 0 to 1 range.



input

Input points to the previous imager operation in the chain (so that you can stack them and apply multiple operations serially).

enable

Enables the imager.

layer_selection

Selects layers processed by this imager with a glob or operator expression. An imager can use a selection to determine what nodes will be selected to be processed by the imager at render time. The selection is an expression that can consist of multiple selections concatenated by: 

  • or (union)
  • and (intersection)
  • not (negation)
  • and not (exclusion)
  • () for nested scoping

 

Each selection uses glob patterns and regular expressions and a node will be processed by the imager if the expression matches the node name. By default, glob matching is used unless the selection is in a regex quote, i.e. r'<my_regex>'. For example:


specular or diffuse
 
not r'sss_(direct|indirect)'
 
r'color_(mask1|mask2)' or r'mask[34]'

r_position, r_value

The position and value arrays for the R (red) component are r_position and r_value. Together, these two float arrays define the points that the color curve will interpolate. This curve defines how colors will be remapped. r_position refers to the old values before the imager runs, and r_value refers to the new values after the imager runs. As an example if r_position = (0,1) and r_value = (0.25, 0.75) the imager will remap 0 to 0.25 and 1 to 0.75, thus decreasing contrast for the red component. The empty default leaves the original curve untouched.

r_position


r_value

r_interpolation

Integer array of interpolation types for each R curve point. The available types are:

g_position, g_value

This works like r_position and r_value but only on the G (green) component.

g_position

g_value

g_interpolation

Integer array of interpolation types for each G curve point. The available types are:

b_position, b_value

This works like r_position and r_value but only on the B (blue) component.

b_position

b_value

b_interpolation

Integer array of interpolation types for each B curve point. The available types are:


rgb_position, rgb_value

This works like r_position and r_value but on the pixel luminance value taking all components into account.

rgb_interpolation

Integer array of interpolation types for each RGB curve point. The available types are:


working_color_space

The image will be converted to this color space before applying the remapping curve, and then converted back to the linear rendering color space. This is useful to apply the curves in a perceptual or roughly perceptual color space. If this is empty no color transform will be applied, and no assumptions are made about what color space the imager is working in.




  • No labels
© 2020-2021 Autodesk. All Rights Reserved / website terms / privacy/cookies / ccpa settings