How to use Matte Refinement node in Oraphim

Type ID: fusion.mattecleanup
Category: Keying

What this node does

The Matte Refinement node is registered in Oraphim's Keying category and performs the graph operation represented by its sockets and controls below.

The current Oraphim runtime registers 3 sockets and 32 properties for this node. Its main registered inputs are Input, Previous Matte; its main outputs are Output. The tables below are generated from the runtime registry rather than a handwritten approximation.

Inputs

Socket	Key	Type
Input	in_color	Image
Previous Matte	in_previous_matte	Image

Outputs

Socket	Key	Type
Output	out_color	Image

Controls

Control	Key	Type	Group	Registry default
Matte Effect	effectType	String	Effect	fx_matte_cleanup
Clip Black	clipBlack	Float	Legacy Matte Cleanup	0.07999999821186066
Clip White	clipWhite	Float	Legacy Matte Cleanup	0.9200000166893005
Gamma	gamma	Float	Legacy Matte Cleanup	1.0
Shrink / Grow	shrinkGrow	Float	Legacy Matte Cleanup	0.0
Blur	blur	Float	Legacy Matte Cleanup	0.0
Choke Matte	simpleChoke	Float	Simple Choker	0.0
Geometric Softness 1	stage1GeometricSoftness	Float	Matte Choker - Stage 1	10.0
Choke 1	stage1Choke	Float	Matte Choker - Stage 1	0.0
Gray Level Softness 1	stage1GraySoftness	Float	Matte Choker - Stage 1	0.0
Geometric Softness 2	stage2GeometricSoftness	Float	Matte Choker - Stage 2	10.0
Choke 2	stage2Choke	Float	Matte Choker - Stage 2	0.0
Gray Level Softness 2	stage2GraySoftness	Float	Matte Choker - Stage 2	0.0
Iterations	iterations	Float	Matte Choker	1.0
Smooth	smooth	Float	Refine Matte - Edge	0.0
Feather	feather	Float	Refine Matte - Edge	0.0
Contrast	contrast	Float	Refine Matte - Edge	0.0
Shift Edge	shiftEdge	Float	Refine Matte - Edge	0.0
Reduce Chatter	reduceChatter	Float	Refine Matte - Temporal	0.0
Edge Recovery	edgeRecovery	Float	Refine Soft Matte	0.0
Edge Radius	edgeRadius	Float	Refine Matte - Edge	3.0
Decontaminate Edge Colors	decontaminateEdgeColors	Bool	Refine Matte - Edge Colors	0.0
Decontamination Radius	decontaminationRadius	Float	Refine Matte - Edge Colors	4.0
Decontamination Amount	decontaminationAmount	Float	Refine Matte - Edge Colors	100.0
Motion Blur	motionBlur	Bool	Refine Matte - Motion Blur	0.0
Shutter Angle	shutterAngle	Float	Refine Matte - Motion Blur	180.0
Motion Direction	motionDirection	Float	Refine Matte - Motion Blur	0.0
Motion Samples	motionSamples	Float	Refine Matte - Motion Blur	8.0
Invert Matte	invert	Bool	Output	0.0
Show Matte	showMatte	Bool	Output	0.0
Preserve RGB	preserveRgb	Bool	Output	1.0
Quality	quality	String	Quality	High

How to use it

1. Add Matte Refinement from node search. Use fusion.mattecleanup when you need the exact registry entry.
2. Connect a compatible Image source to Input. Add the other inputs only when the operation needs them.
3. Start with the registry defaults and adjust Matte Effect, Clip Black, Clip White first so you can see the node's effect in isolation.
4. Route Output (Image) into a compatible downstream node, viewer, or output path.
5. Preview a representative frame, change one input/control at a time, and save/reopen reusable graphs to verify persistence.

Practical example

Create a small test graph with Matte Refinement. Feed a compatible source into Input. Change Matte Effect away from its registry default and compare the result. Connect Output to a compatible downstream stage so the result is visible. Keeping this test graph small makes socket-type, context, and parameter mistakes easier to diagnose before the node is used in a production graph.

Troubleshooting

• If a connection is rejected, compare the exact socket data types in the tables above; Oraphim graph connections are typed.
• If the result looks unchanged, confirm this node is on the active path to the viewer/output and that the expected graph/resource is selected.
• If a control is unavailable, check required inputs and whether the property belongs to an internal or mode-dependent group.
• If a saved graph behaves differently later, reopen it and verify node identity, connections, and edited property values before rendering.

Related nodes

• Delta Keyer — fusion.deltakeyer
• Despill — fusion.despill
• Keying — fusion.chromakeyer
• Luma Keyer — fusion.lumakeyer
• 3D Camera Tracker — fusion.cameratracker

Return to the complete Oraphim node reference.