STMap Extension

A BlinkScript-driven utility designed to extrapolate and pad cropped ST maps beyond their original bounding boxes.

First submitted: 29 April 2026

Author: Marty Blumen

Website: https://www.martyblumen.com/

Compatible Nuke versions: 14.0 or later

Compatibility: Source

ST Map Overscan

Description: A BlinkScript-driven utility designed to extrapolate and pad cropped ST maps beyond their original bounding boxes.

Standard UV pipelines often break down when lens distortion maps or baked UV passes are heavily cropped or fail to cover a required overscan area. This tool places the source ST map into a new, larger format and mathematically synthesizes the missing UV coordinates outside the original boundaries.

Core Features:

  • Format & Positioning: Defines a new output format. The source map can be automatically centered within the new canvas or manually offset via X/Y pixel controls.

  • Extrapolation Modes:

    • Linear (Default): Calculates the per-axis slope of the outermost pixels and projects the gradient outward. This maintains the trajectory of lens distortion or surface UVs into the padded region.

    • Clamp: Repeats the outermost pixel values (standard edge extend behavior).

    • Zero: Fills the extended area with [0, 0] values.

    • Fade: Generates a linear falloff from the edge values down to zero based on the padding distance.

  • Edge Smoothing: A critical control for linear mode. It averages pixel samples tangent to the bounding box edge before calculating the outward slope. This prevents microscopic input noise or aliasing at the crop line from being multiplied into infinite streaks across the extrapolated area.

Technical Notes:

  • Bbox Aware: The internal BlinkScript kernel reads directly from src.bounds. Any upstream Crop nodes will be strictly respected as the extrapolation boundary.

  • Lens Distortion: When extending real-world lens maps, keep the Edge Smoothing parameter modest (8-16 pixels). Excessive smoothing will average out the mathematical curvature required at the edges of the lens.

  • Performance: Fully GPU-accelerated via an ePixelWise BlinkScript kernel. No compiled NDK plugins required.

Installation: Simply copy and paste the provided code directly into your Nuke Node Graph, or save it as a .gizmo or ToolSet within your pipeline environment.

OpenSource:
https://github.com/bratgot/STMapExtension

MIT License

Copyright (c) [2026] [Marten Blumen]

Permission is hereby granted, free of charge, to any person obtaining a copy
of this software and associated documentation files (the "Software"), to deal
in the Software without restriction, including without limitation the rights
to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
copies of the Software, and to permit persons to whom the Software is
furnished to do so, subject to the following conditions:

The above copyright notice and this permission notice shall be included in all
copies or substantial portions of the Software.

THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
SOFTWARE.

or register to download or rate.

Comments

or register to join the conversation.

Download Verification