Nuke-Templates/README.md
NicholaiVogel 3c83039a71 Add 3DE to Nuke Track Converter v2.0
- Complete rewrite with beautiful Rich TUI interface
- Interactive and CLI modes for flexibility
- Robust error handling with clear, helpful messages
- Gap filling with linear interpolation support
- Coordinate system transforms (pixels/normalized)
- Auto-generated output filenames from input
- Configurable resolution and Nuke versions
- Batch processing support via CLI
- Comprehensive documentation in Scripts/README_CONVERTER.md
- Updated main README.md with Scripts section
2025-10-07 21:14:33 -06:00

4.2 KiB

Biohazard VFX NukeX Status License

Biohazard VFX — Nuke Master Templates

Production-ready Nuke templates that standardize workflows, accelerate shot setup, and keep projects consistent.


Table of Contents


Overview

A curated set of master templates for Nuke/NukeX. Each .nk ships with sensible defaults, labeled node graphs, and project-ready structure.


Repository Tree

/
├─ Scripts/
│  ├─ 3de-to-nuke-converter.py          # 3DE track converter v2.0
│  ├─ export-2d-tracks-from-3de-to-nuke.py  # legacy converter
│  ├─ requirements.txt                   # Python dependencies
│  └─ README_CONVERTER.md                # converter documentation
├─ Shot_Templates/
│  ├─ Biohazard Master Rev 01/
│  │  ├─ Biohazard Master Rev 01.nk
│  │  ├─ Biohazard Master Rev 01.nk~    # backup
│  │  └─ desktop.ini
│  ├─ Biohazard Master Rev 02/
│  │  ├─ Biohazard Master Rev 02 LIGHT.nk  # lightweight preset
│  │  ├─ Biohazard Master Rev 02.nk
│  │  └─ desktop.ini
│  └─ Covert Template/
│     ├─ Covert Template.nk
│     ├─ Covert Template.nk~             # backup
│     └─ desktop.ini
└─ README.md

Scripts

3DE to Nuke Track Converter v2.0 — production tool
  • Professional converter for 3DEqualizer 2D tracks to Nuke Tracker4 nodes
  • Beautiful terminal UI with progress bars and interactive prompts
  • Features:
    • CLI and interactive modes for flexibility
    • Robust error handling with clear messages
    • Gap filling with linear interpolation
    • Coordinate system transforms (pixels/normalized)
    • Auto-generated output filenames
    • Configurable resolution and Nuke versions
    • Batch processing support
  • See Scripts/README_CONVERTER.md for full documentation

Quick Start:

cd Scripts
pip install -r requirements.txt
python 3de-to-nuke-converter.py  # Interactive mode

Templates

Biohazard Master Rev 01 — foundation
  • Baseline master graph for general VFX tasks
  • Balanced defaults for comp, color, and IO
  • Safe starting point for new shows and quick turnarounds
Biohazard Master Rev 02 — refined
  • Optimized node ordering and caching
  • Cleaner label/annotation system
  • LIGHT variant for rapid look-dev and previz
Covert Template — special-purpose
  • Alternate layout used on select spots
  • Keeps parity with Biohazard IO and color blocks

Quick Start

git clone https://git.biohazardvfx.com/BiohazardVFX/Nuke-Templates.git
  1. Open NukeX and load a template .nk as your starting script.
  2. Update project paths, write nodes, and show tags in the designated setup group.
  3. Save as your shot file; do not overwrite the master.

Conventions

  • Color Management — ACES-ready blocks; confirm show IDT/ODT in the config section.
  • IO — Write nodes named per show spec; versioned outputs .../renders/{shot}/{task}/v###.
  • Structure — Inputs → Prep → Comp → Look/FX → QC → IO.
  • Notes — Critical ops are annotated; use TODO tags for per-shot items.

Maintenance

  • Changes to masters require a new Rev directory and a short changelog in commit message.
  • Keep backup files (.nk~) out of delivery packages.
  • Report issues via internal tracker; attach script fragment or screenshot.

License

Internal Biohazard VFX use only. Redistribution or external use is prohibited.