unreal.CompositePassColorKeyer

class unreal.CompositePassColorKeyer(outer: Object | None = None, name: Name | str = 'None')

Bases: CompositePassBase

Color keyer with clean plate & spill removal support.

C++ Source:

  • Plugin: Composite

  • Module: Composite

  • File: CompositePassColorKeyer.h

Editor Properties: (see get_editor_property/set_editor_property)

  • alpha_threshold (Vector2f): [Read-Write] Thresholds any alpha value outside the specified range to zero or one respectively, with linear interpolation in-between.

  • blue_weight (float): [Read-Write] Weight of the foreground blue channel contributing to the key matte hardness.

  • clean_plate (Texture): [Read-Write] Clean plate background for calculating color differences per pixel, instead of the static key color. Resolution must match the composite actor render resolution.

  • denoise_method (CompositeDenoiseMethod): [Read-Write] Denoising method applied before the keyer.

  • despill_strength (float): [Read-Write] Strength of the spill reduction, 0.0: none, 1.0: full.

  • devignette_strength (float): [Read-Write] Strength of the vignette removal. Used to improve plate uniformity & remove darker corners.

  • display_name (str): [Read-Write] The display name of the pass

  • green_weight (float): [Read-Write] Weight of the foreground green channel contributing to the key matte hardness.

  • invert_alpha (bool): [Read-Write] Invert the alpha key.

  • is_enabled (bool): [Read-Write] Whether or not the pass is active.

  • key_color (LinearColor): [Read-Write] Static background key color.

  • preserve_vignette_after_key (bool): [Read-Write] When enabled, we undo devignetting before outputting the keyed plate.

  • red_weight (float): [Read-Write] Weight of the foreground red channel contributing to the key matte hardness.

  • screen_type (CompositeColorKeyerScreenType): [Read-Write] Type of screen color (required). The keyer works best against red, green or blue backgrounds.

  • visualization (CompositeColorKeyerVisualization): [Read-Write] Vizualize the alpha key or fill.

property alpha_threshold: Vector2f

[Read-Write] Thresholds any alpha value outside the specified range to zero or one respectively, with linear interpolation in-between.

Type:

(Vector2f)

property blue_weight: float

[Read-Write] Weight of the foreground blue channel contributing to the key matte hardness.

Type:

(float)

property clean_plate: Texture

[Read-Write] Clean plate background for calculating color differences per pixel, instead of the static key color. Resolution must match the composite actor render resolution.

Type:

(Texture)

property denoise_method: CompositeDenoiseMethod

[Read-Write] Denoising method applied before the keyer.

Type:

(CompositeDenoiseMethod)

property despill_strength: float

none, 1.0: full.

Type:

(float)

Type:

[Read-Write] Strength of the spill reduction, 0.0

property devignette_strength: float

[Read-Write] Strength of the vignette removal. Used to improve plate uniformity & remove darker corners.

Type:

(float)

property green_weight: float

[Read-Write] Weight of the foreground green channel contributing to the key matte hardness.

Type:

(float)

property invert_alpha: bool

[Read-Write] Invert the alpha key.

Type:

(bool)

property key_color: LinearColor

[Read-Write] Static background key color.

Type:

(LinearColor)

property preserve_vignette_after_key: bool

[Read-Write] When enabled, we undo devignetting before outputting the keyed plate.

Type:

(bool)

property red_weight: float

[Read-Write] Weight of the foreground red channel contributing to the key matte hardness.

Type:

(float)

property screen_type: CompositeColorKeyerScreenType

[Read-Write] Type of screen color (required). The keyer works best against red, green or blue backgrounds.

Type:

(CompositeColorKeyerScreenType)

property visualization: CompositeColorKeyerVisualization

[Read-Write] Vizualize the alpha key or fill.

Type:

(CompositeColorKeyerVisualization)