Oink
Nodes

IBKGizmo

IBKGizmo: image based keyer.

raw .md

IBKGizmo: image based keyer. Keys the fg input against a clean plate (the c input, usually an IBKColour) with red and blue/green weights, and subtracts the screen so the result is premultiplied and despilled.

NodeIBKGizmo
Type idOC_N_ibkgizmo
MenuKeyer › IBKGizmo
Nuke classIBKGizmoV3 (also imports IBKGizmo)
Codeopencomp_core/nodes/keyer/ibk.py

IBKGizmo properties

Usage

  • st = pick keys against a single colour instead of the c input: Ctrl+click (or Ctrl+Shift+drag) in the Viewer with the panel open picks it from the fg input.
  • Luminance match brings back foreground brighter than the screen.

Inputs and outputs

PortNameType
input 0fgimage
input 1cimage
input 2bgimage
output 0Imageimage

Knobs

Panel tab Ibkgizmo, in panel order.

KnobLabelTypeDefaultRange / valuesNuke knobDescription
stscreen typemenuC-greenC-green, C-blue, pickstC-green, C-blue (use the c input) or pick (use colour).
colourcolourcolour ×30, 1, 00 to 1colourthe screen colour for pick.
red_weightred weightfloat0.50 to 1red_weight
blue_green_weightblue/green weightfloat0.50 to 1blue_green_weight
lm_enableluminance matchboolfalselm_enable
levelscreen rangefloat10 to 2level
lumaluminance levelfloat00 to 1luma
ssscreen subtractionbooltruessscreen subtraction (fg minus the screen times 1 - alpha).
usebguse bkg luminanceboolfalseusebgadd the bg input's luminance where the key is transparent.

Other knobs (Python, .nk and the assistant; not on the panel)

KnobLabelTypeDefaultRange / valuesNuke knobDescription
gl_colorViewer Controls Colorfloat ×30, 0, 00 to 1
postage_stamp_frameStatic Frameint1-2147483648 to 2147483647
lifetimeStartLifetime Startint0-2147483648 to 2147483647
lifetimeEndLifetime Endint100-2147483648 to 2147483647
useLifetimeUse Lifetimebooleanfalse
cachedCachedbooleanfalse
bookmarkBookmarkbooleanfalse
dope_sheetDope Sheetbooleanfalse
clone_groupClone Groupstring
link_sourceLink Sourcestring
link_overridesLink Overridesstring
split_viewsSplit Viewsstring

Nuke equivalent

Imports from and exports to Nuke's IBKGizmoV3 (IBKGizmo also import to it).

Nuke knobs not in this list import as a knob of the same name, or are kept unchanged for export. See .nk import.

Examples

Open these from Help › Examples…, or from the ? menu in this node's Properties panel.

  • IBK: clean plate + difference key (examples/keying/ibk_clean_plate.oink): The image based keyer pair on the Tears of Steel plate 08_3a (CC BY 3.0, Blender Foundation, mango.blender.org). IBKColour erodes the actor out of the screen and fills the hole from the surrounding green, giving a clean plate that follows the screen's uneven light. IBKGizmo keys the plate against it (red / blue-green weights 0.5) and subtracts the screen colour, so the result is premultiplied and despilled. The Viewer shows it over black.

On this page