- 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
147 lines
4.2 KiB
Markdown
147 lines
4.2 KiB
Markdown
<div align="center">
|
|
|
|
[](https://biohazardvfx.com)
|
|
[](https://www.foundry.com/products/nuke)
|
|
[](#)
|
|
[](#)
|
|
|
|
# Biohazard VFX — Nuke Master Templates
|
|
|
|
Production-ready Nuke templates that standardize workflows, accelerate shot setup, and keep projects consistent.
|
|
|
|
</div>
|
|
|
|
---
|
|
|
|
## Table of Contents
|
|
- [Overview](#overview)
|
|
- [Repository Tree](#repository-tree)
|
|
- [Templates](#templates)
|
|
- [Quick Start](#quick-start)
|
|
- [Conventions](#conventions)
|
|
- [Maintenance](#maintenance)
|
|
- [License](#license)
|
|
|
|
---
|
|
|
|
## 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
|
|
```text
|
|
/
|
|
├─ 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
|
|
|
|
<details>
|
|
<summary><strong>3DE to Nuke Track Converter v2.0</strong> — production tool</summary>
|
|
|
|
* 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:**
|
|
```bash
|
|
cd Scripts
|
|
pip install -r requirements.txt
|
|
python 3de-to-nuke-converter.py # Interactive mode
|
|
```
|
|
|
|
</details>
|
|
|
|
---
|
|
|
|
## Templates
|
|
|
|
<details>
|
|
<summary><strong>Biohazard Master Rev 01</strong> — foundation</summary>
|
|
|
|
* Baseline master graph for general VFX tasks
|
|
* Balanced defaults for comp, color, and IO
|
|
* Safe starting point for new shows and quick turnarounds
|
|
|
|
</details>
|
|
|
|
<details>
|
|
<summary><strong>Biohazard Master Rev 02</strong> — refined</summary>
|
|
|
|
* Optimized node ordering and caching
|
|
* Cleaner label/annotation system
|
|
* <code>LIGHT</code> variant for rapid look-dev and previz
|
|
|
|
</details>
|
|
|
|
<details>
|
|
<summary><strong>Covert Template</strong> — special-purpose</summary>
|
|
|
|
* Alternate layout used on select spots
|
|
* Keeps parity with Biohazard IO and color blocks
|
|
|
|
</details>
|
|
|
|
---
|
|
|
|
## Quick Start
|
|
|
|
```bash
|
|
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.
|