nuke-compositing

nuke-compositing

Version: 1.0.0 Last Updated: 2025-12-03 Dependencies: Nuke (Foundry), NukeMCPLogger

---

Overview

Node graph compositing workflows for Nuke including plate ingestion, grading, layer merging, keying, and multi-layer comp patterns. Uses NukeMCPLogger for structured output.

Key Patterns:

• Basic comp structure (Read -> Grade -> Merge -> Write)
• Multi-layer workflows with AOVs
• Keying and integration
• Batch processing setup

---

Quick Start

Basic Comp Workflow

from nuke_mcp_logger import NukeMCPLogger
import nuke

log = NukeMCPLogger(session_name="BasicComp")

try:
    # Read plate
    read_node = nuke.createNode("Read")
    read_node['file'].setValue("D:/Plates/Shot001_%04d.exr")
    read_node.setName("BG_Plate")
    log.increment_stat("nodes_created")

    # Grade
    grade_node = nuke.createNode("Grade")
    grade_node.setName("MainGrade")
    log.increment_stat("nodes_created")

    # Write output
    write_node = nuke.createNode("Write")
    write_node['file'].setValue("D:/Output/Shot001_comp_%04d.exr")
    write_node.setName("MainOut")
    log.increment_stat("nodes_created")

    log.success(f"Comp setup complete: {log.stats['nodes_created']} nodes")

except Exception as e:
    log.error("Comp setup failed", e)

result = log.get_results()

Expected Result:

• 3 nodes created (Read -> Grade -> Write)
• Automatic connection in linear graph
• Ready for render

---

Standard Workflows

Workflow 1: Plate + Grade + Write (Simplest Comp)

Use When: Basic color correction comp

def setup_basic_comp(plate_path: str, output_path: str, frame_range: tuple):
    """
    Create basic Read -> Grade -> Write comp for ANY project.

    Args:
        plate_path: Input image sequence path
        output_path: Output render path
        frame_range: (first, last) frame tuple

    Returns:
        dict: Logger results
    """
    import nuke
    from nuke_mcp_logger import NukeMCPLogger

    log = NukeMCPLogger(session_name="BasicComp")

    try:
        # Clear script
        nuke.scriptClear()

        # Read plate
        read_node = nuke.createNode("Read")
        read_node['file'].setValue(plate_path)
        read_node['first'].setValue(frame_range[0])
        read_node['last'].setValue(frame_range[1])
        read_node.setName("BG_Plate")
        log.increment_stat("nodes_created")

        # Grade
        grade_node = nuke.createNode("Grade")
        grade_node.setName("MainGrade")
        log.increment_stat("nodes_created")

        # Write
        write_node = nuke.createNode("Write")
        write_node['file'].setValue(output_path)
        write_node['file_type'].setValue("exr")
        write_node.setName("MainOut")
        log.increment_stat("nodes_created")

        log.success(f"Basic comp: {log.stats['nodes_created']} nodes")
        return log.get_results()

    except Exception as e:
        log.error("Setup failed", e)
        return log.get_results()