Oink
IBKGizmofgcbg IBKGizmo

IBKGizmo

Image based keyer.

raw .md

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
MenuKeyer › IBKGizmo
Names in each format
.oink comp (JSON)"type": "OC_N_ibkgizmo"
.nk scriptIBKGizmoV3, also imports IBKGizmo (how .nk import works)
Pythonnuke.createNode("IBKGizmoV3")
Assistant (MCP)create_node(type="IBKGizmo")
Tab searchibkgizmo, or its initials ibkg

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 / values.nk 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 / values.nk 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

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