Visual component "ColorStretcher"

GrossGrade

Topic:  GrossGrade for Expert > Components >

Visual component "ColorStretcher"

Previous page Parent topic Next page

 

The ColorStretcher component allows you to specify one or more areas on the color plane within which you can compress/stretch the chrome and color hue, as well as make color offset.

 

Visual part

Visual part of the component

 

You can create many color points on the color plane of the selected color space. Each such point has a certain area of influence around it.

component_ColorStretcher_visual8

 

The borders of this area can be adjusted with the mouse:

component_ColorStretcher_visual4

 

Inside the impact area of the point there are two additional compression/stretch sliders, which can also be controlled with the mouse:

component_ColorStretcher_visual5

The straight slider affects the distribution of chroma within the area. The arc slider affects the distribution of hue within the area. With these sliders, you can compress/stretch these color components.

There is an easier way to control two sliders at the same time. For this it is necessary to hold down the center point with the middle mouse button and start to move. Horizontal movement will control the straight slider and vertical movement will control the arc slider. If you hold down the center point with the middle mouse button and start moving with the Shift key held down, you can also change the distribution of lightness, but this will only have an effect if you set some color offset within the area (see below).

 

If you disable the "Fix offsets" option, you can use the mouse to set some offset of the base color for this area. If you make an offset with the Shift key held down, you can specify an offset in lightness:

component_ColorStretcher_visual6

 

While the "Fix offsets" option is disabled, it will be impossible to move the area. If you enable this option again, the offsets will be fixed, compression/stretch sliders will appear on the area, and the area can be moved around the color plane again:

component_ColorStretcher_visual7

 

If any color offset is specified for the selected color area, the 3D ball in the center of the component will be divided into two halves, where the left-bottom will represent the shades of the original color, and the right-top will represent the shades of the resulting color.

component_ColorStretcher_visual2

 

If more than one color point-area is created, multiple selections can be made. To add another point to the current selection, you can click on it with the Shift key pressed. You can also use a rectangular selection with the mouse:

component_ColorStretcher_visual3

 

Context menu

The context menu is available by right-clicking on any free area of the component.

 

component_ColorStretcher_contextmenu1_ENG

"Add color point" - add a new color point in the place where this context menu was called.

"Add sample color point" - a drop-down menu that has some set of standard points for quick adding.

"Delete all points" - delete all existing points.

 

"Color space" group

 

Contains the available color spaces in which the component can operate. Only perceptual color spaces are represented here.

 

"Options" group

 

"Separate areas" - separate areas so that there are no intersections between them. This option is not available in current version of the application.

"Always show areas" - always show the borders of the areas of influence of color points, even if the points are not selected.

"Mask mode" - when this option is activated, the component starts to output a mask as an image, in which the existing color areas are represented in white.

 

The context menu for a particular color point is available by right-clicking on one of the existing points.

 

component_ColorStretcher_contextmenu2_ENG

"Color point #/#" group

 

"Enable color point" - enable/disable the effect of this color point-area.

"Fix offsets" - to lock/release the offsets. If you enable the option, you can control the area as a whole, and if you disable the option, you can set the color offset within the area.

"Flip offsets" - swap the point of the original color and the point of the resulting color (if any offset is specified).

"Reset offsets" - reset the offset of the source / result color (if specified).

"Equalize lightness" - remove the difference in lightness (if specified) between the point of the original color and the point of the resulting color.

"Reset lightness gamma" - reset the change in the distribution of lightness (if specified).

 

"Delete color point" - delete this color point.

Parameters inside the component node

Component node

Nonvisual part of the component

 

"Show cloud" option - enables / disables the display of the image color distribution cloud inside the color circle.

"Affect cloud" option - enables / disables the effect of color correction created by this component on the cloud.

"Affect color fill" option - enables / disables the effect of the color correction created by this component on the color fill of the circle.

"Logarithmic scale" parameter - allows you to set the nonlinearity relative to the center of the component (only for viewing convenience). Valid values are from 0 (linear scale) to 1 (logarithmic scale).

"Apply log scale to cloud" option - allows you to apply nonlinearity to the color distribution cloud as well, if the cloud is enabled.

 

 

Click toggle to expand/collapse hidden blockInput ports

Port name

Port type

Description

show mask

boolean

Activate/deactivate mask display mode

show pts.mask

boolean

Activate/deactivate per-point mask display mode only for color points activated by port 'act.pt.mask'

act.pt.mask

boolean

(replicable)

Activate/deactivate color point for per-point mask display mode

point mask

weighting function

(replicable)

Mask for particular point (each port replication determines the mask / weighting function for individual color point)

point color

color

(replicable)

Point color (each port replication corresponds to a particular color point)

point c.area

weight

(replicable)

Point affect area size by chroma (each port replication corresponds to a particular color point)

point h.area

weight

(replicable)

Point affect area size by hue (each port replication corresponds to a particular color point)

point chroma

weight

(replicable)

Particular point chroma (each port replication determines the chroma value for individual color point)

point hue

weight

(replicable)

Particular point hue (each port replication determines the hue value for individual color point)

point C-curve

weight

(replicable)

Particular point chroma dustribution curve (each port replication determines the chroma dustribution curve for individual color point)

point H-curve

weight

(replicable)

Particular point hue dustribution curve (each port replication determines the hue dustribution curve for individual color point)

show cloud

boolean

Show image color cloud

affect cloud

boolean

Affect color distribution cloud with current color orrection

affect fill

boolean

Affect background color fill with current color orrection

log scale

weight

Logarithmic scale for the polar distance nonlinearity (values in 0..1 range)

Standard ports are not listed here because these ports and their functions are equal for all components (see " Standard ports").

 

Click toggle to expand/collapse hidden blockOutput ports

Port name

Port type

Description

mask

weighting function

Merged mask composed of stretching areas of all color points

i.mask

weighting function

Merged mask (inverted) composed of stretching areas of all color points

pts.mask

weighting function

Merged mask composed of stretching areas of all color points, that activated by port 'act.pt.mask'

pts.i.mask

weighting function

Merged mask (inverted) composed of stretching areas of all color points, that activated by port 'act.pt.mask'

point color

color

(replicable)

Mask for particular color point stretching area (each port replication corresponds to an individual color point)

Standard ports are not listed here because these ports and their functions are equal for all components (see " Standard ports").

 

 


See also

Components