Skip to content

About

GPU-accelerated ST-Map (UV remap) node for Blackmagic Design Fusion — the missing Nuke STMap equivalent

Resources

Stars

0 stars

Watchers

0 watching

Forks

Latest commit

 

History

7 Commits

Folders and files

NameName
Last commit message
Last commit date
 
 
 
 
 
 
 
 
 
 

Repository files navigation

ST-Map for Blackmagic Fusion

A GPU-accelerated ST-Map (UV remap) node for Blackmagic Design Fusion — the equivalent of Nuke's STMap node.

Fusion License Buy Me a BitCoffee Regular Coffee

What It Does

Accepts a source image and a float ST-Map (where Red = U and Green = V encode normalized sampling coordinates), and warps the source image accordingly. Essential for lens distortion workflows with matchmoving software.

Use cases:

  • Apply lens undistortion/redistortion from 3DEqualizer, PFTrack, SynthEyes
  • Bake arbitrary warps into a reusable map
  • Any per-pixel coordinate remapping

Installation

Copy Fuses/STMap.fuse to your Fuses directory:

Fusion Studio

OS Path
macOS ~/Library/Application Support/Blackmagic Design/Fusion/Fuses/
Windows %AppData%\Blackmagic Design\Fusion\Fuses\
Linux ~/.fusion/BlackmagicDesign/Fusion/Fuses/

DaVinci Resolve (Fusion Page)

OS Path
macOS ~/Library/Application Support/Blackmagic Design/DaVinci Resolve/Fusion/Fuses/
Windows %AppData%\Blackmagic Design\DaVinci Resolve\Fusion\Fuses\
Linux ~/.local/share/DaVinciResolve/Fusion/Fuses/

Restart Fusion / DaVinci Resolve. The node appears under Transform > Distort > ST-Map (search shortcut: STM).

Usage

  1. Add the ST-Map node to your comp
  2. Connect your plate to the Source input (first/orange arrow)
  3. Connect your ST-Map EXR to the ST Map input (second/green arrow)
  4. The output resolution matches the ST-Map

Controls

Control Description
U Channel Which ST-Map channel drives horizontal lookup (default: Red)
V Channel Which ST-Map channel drives vertical lookup (default: Green)
Invert U Flip horizontal axis
Invert V Flip vertical axis — enable for ST-Maps from After Effects
Transparent Background When checked, out-of-range areas are transparent (alpha=0) for compositing. Default is opaque black.

Requirements

  • ST-Maps must be 32-bit float EXR. 8-bit or 16-bit maps will produce visible stepping artifacts due to insufficient coordinate precision.
  • GPU with OpenCL/Metal support for real-time performance. Falls back to CPU automatically if unavailable (functional but slower).

Coordinate Convention

Fusion and Nuke share the same bottom-left origin with V-axis pointing up. ST-Maps from Nuke, 3DEqualizer, PFTrack, and SynthEyes work directly without any axis flipping. Enable Invert V for maps originating from After Effects or other top-left-origin applications.

How It Works

The node reads normalized UV coordinates from the ST-Map's color channels and uses them to sample the source image at those positions. On GPU, this uses Fusion's DVIPComputeNode with hardware texture sampling for real-time performance. On CPU, it falls back to Fusion's built-in SamplePixelB bilinear interpolation.

License

MIT License — see LICENSE for details.

About

GPU-accelerated ST-Map (UV remap) node for Blackmagic Design Fusion — the missing Nuke STMap equivalent

Resources

Stars

0 stars

Watchers

0 watching

Forks

Releases

Packages

Contributors