How to use Surface Warp node in Oraphim

Type ID: fusion.meshwarp
Category: Distort

What this node does

The Surface Warp node is registered in Oraphim's Distort category and performs the graph operation represented by its sockets and controls below.

The current Oraphim runtime registers 2 sockets and 90 properties for this node. Its main registered inputs are Input; 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

Outputs

Socket	Key	Type
Output	out_color	Image

Controls

Control	Key	Type	Group	Registry default
Effect Type	effectType	String	Internal	fx_bezier_warp
Coordinate Space	coordinateSpace	String	Surface	Auto
Strength	strength	Float	Surface	100.0
Solver Iterations	solverIterations	Float	Quality	14.0
Edge Mode	edgeMode	String	Edges	Transparent
Quality	quality	String	Quality	High
Preserve Alpha	preserveAlpha	Bool	Alpha	1.0
Knot 1 X	knot1X	Float	Flow Knots	0.3333333432674408
Knot 1 Y	knot1Y	Float	Flow Knots	0.5
Amount 1	amount1	Float	Flow Knots	0.0
Knot 2 X	knot2X	Float	Flow Knots	0.6666666865348816
Knot 2 Y	knot2Y	Float	Flow Knots	0.5
Amount 2	amount2	Float	Flow Knots	0.0
Influence	influence	Float	Flow Knots	0.3499999940395355
Horizontal Scale	horizontalScale	Float	Grid Tiles	100.0
Vertical Scale	verticalScale	Float	Grid Tiles	100.0
Tile Size	tileSize	Float	Grid Tiles	64.0
Rotation	rotation	Float	Grid Tiles	0.0
Cut Tiles	cutTiles	Bool	Grid Tiles	1.0
Brush Mode	brushMode	String	Liquify Brush	Forward Warp
Brush Strokes	brushStrokes	String	Liquify Brush	0.0
Brush Size	brushSize	Float	Liquify Brush	100.0
Brush Pressure	brushPressure	Float	Liquify Brush	50.0
Brush Density	brushDensity	Float	Liquify Brush	50.0
Brush Rate	brushRate	Float	Liquify Brush	50.0
Distortion	distortionPercentage	Float	Liquify Mesh	100.0
Reconstruct	reconstruct	Float	Liquify Mesh	0.0
Freeze Strength	freezeStrength	Float	Liquify Freeze	100.0
Mode	reshapeMode	String	Reshape Solver	Smooth
Correspondence Points	correspondencePoints	String	Reshape Solver	0.0
Smoothness	smoothness	Float	Reshape Solver	35.0
Boundary Strength	boundaryStrength	Float	Reshape Boundary	100.0
Mask Threshold	maskThreshold	Float	Reshape Masks	10.0
Boundary Samples	sampleCount	Float	Reshape Masks	24.0
Top Left X	cornerTLX	Float	Bezier Corners	0.0
Top Left Y	cornerTLY	Float	Bezier Corners	0.0
Top Right X	cornerTRX	Float	Bezier Corners	1.0
Top Right Y	cornerTRY	Float	Bezier Corners	0.0
Bottom Right X	cornerBRX	Float	Bezier Corners	1.0
Bottom Right Y	cornerBRY	Float	Bezier Corners	1.0
Bottom Left X	cornerBLX	Float	Bezier Corners	0.0
Bottom Left Y	cornerBLY	Float	Bezier Corners	1.0
Top Handle 1 X	top1X	Float	Bezier Top	0.3333333432674408
Top Handle 1 Y	top1Y	Float	Bezier Top	0.0
Top Handle 2 X	top2X	Float	Bezier Top	0.6666666865348816
Top Handle 2 Y	top2Y	Float	Bezier Top	0.0
Right Handle 1 X	right1X	Float	Bezier Right	1.0
Right Handle 1 Y	right1Y	Float	Bezier Right	0.3333333432674408
Right Handle 2 X	right2X	Float	Bezier Right	1.0
Right Handle 2 Y	right2Y	Float	Bezier Right	0.6666666865348816
Bottom Handle 1 X	bottom1X	Float	Bezier Bottom	0.3333333432674408
Bottom Handle 1 Y	bottom1Y	Float	Bezier Bottom	1.0
Bottom Handle 2 X	bottom2X	Float	Bezier Bottom	0.6666666865348816
Bottom Handle 2 Y	bottom2Y	Float	Bezier Bottom	1.0
Left Handle 1 X	left1X	Float	Bezier Left	0.0
Left Handle 1 Y	left1Y	Float	Bezier Left	0.3333333432674408
Left Handle 2 X	left2X	Float	Bezier Left	0.0
Left Handle 2 Y	left2Y	Float	Bezier Left	0.6666666865348816
Mesh R1 C1 X	mesh00X	Float	Mesh Row 1	0.0
Mesh R1 C1 Y	mesh00Y	Float	Mesh Row 1	0.0
Mesh R1 C2 X	mesh01X	Float	Mesh Row 1	0.3333333432674408
Mesh R1 C2 Y	mesh01Y	Float	Mesh Row 1	0.0
Mesh R1 C3 X	mesh02X	Float	Mesh Row 1	0.6666666865348816
Mesh R1 C3 Y	mesh02Y	Float	Mesh Row 1	0.0
Mesh R1 C4 X	mesh03X	Float	Mesh Row 1	1.0
Mesh R1 C4 Y	mesh03Y	Float	Mesh Row 1	0.0
Mesh R2 C1 X	mesh10X	Float	Mesh Row 2	0.0
Mesh R2 C1 Y	mesh10Y	Float	Mesh Row 2	0.3333333432674408
Mesh R2 C2 X	mesh11X	Float	Mesh Row 2	0.3333333432674408
Mesh R2 C2 Y	mesh11Y	Float	Mesh Row 2	0.3333333432674408
Mesh R2 C3 X	mesh12X	Float	Mesh Row 2	0.6666666865348816
Mesh R2 C3 Y	mesh12Y	Float	Mesh Row 2	0.3333333432674408
Mesh R2 C4 X	mesh13X	Float	Mesh Row 2	1.0
Mesh R2 C4 Y	mesh13Y	Float	Mesh Row 2	0.3333333432674408
Mesh R3 C1 X	mesh20X	Float	Mesh Row 3	0.0
Mesh R3 C1 Y	mesh20Y	Float	Mesh Row 3	0.6666666865348816
Mesh R3 C2 X	mesh21X	Float	Mesh Row 3	0.3333333432674408
Mesh R3 C2 Y	mesh21Y	Float	Mesh Row 3	0.6666666865348816
Mesh R3 C3 X	mesh22X	Float	Mesh Row 3	0.6666666865348816
Mesh R3 C3 Y	mesh22Y	Float	Mesh Row 3	0.6666666865348816
Mesh R3 C4 X	mesh23X	Float	Mesh Row 3	1.0
Mesh R3 C4 Y	mesh23Y	Float	Mesh Row 3	0.6666666865348816
Mesh R4 C1 X	mesh30X	Float	Mesh Row 4	0.0
Mesh R4 C1 Y	mesh30Y	Float	Mesh Row 4	1.0
Mesh R4 C2 X	mesh31X	Float	Mesh Row 4	0.3333333432674408
Mesh R4 C2 Y	mesh31Y	Float	Mesh Row 4	1.0
Mesh R4 C3 X	mesh32X	Float	Mesh Row 4	0.6666666865348816
Mesh R4 C3 Y	mesh32Y	Float	Mesh Row 4	1.0
Mesh R4 C4 X	mesh33X	Float	Mesh Row 4	1.0
Mesh R4 C4 Y	mesh33Y	Float	Mesh Row 4	1.0

How to use it

1. Add Surface Warp from node search. Use fusion.meshwarp 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 Coordinate Space, Strength, Solver Iterations 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 Surface Warp. Feed a compatible source into Input. Change Coordinate Space 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

• CC Blobbylize — fusion.blobbylize
• Detail-preserving Upscale — fusion.detailpreservingupscale
• Displacement Map — fusion.displacementmap
• Page Turn — fusion.pageturn
• Perspective Effect — fusion.perspectiveeffect

Return to the complete Oraphim node reference.