davinci-resolve-mcp 2.57.4 → 2.58.0

package/resolve-advanced/vendor/fusion-codec/templates/lower-third.js

@@ -0,0 +1,241 @@
+/**
+ * Lower Third Template — Name/title overlay
+ *
+ * Generates a lower third with primary text, subtitle,
+ * background bar with mask, and Merge chain back to MediaIn/MediaOut.
+ */
+
+module.exports = {
+  label: 'Lower Third',
+  description: 'Animated lower third with name and title text over a semi-transparent bar.',
+  parameters: {
+    text: { type: 'string', default: 'Name', description: 'Primary text (name)' },
+    subtitle: { type: 'string', default: 'Title', description: 'Secondary text (title/role)' },
+    font: { type: 'string', default: 'Open Sans', description: 'Font family' },
+    fontSize: { type: 'number', default: 0.065, description: 'Primary text size (0-1 relative)' },
+    position: { type: 'string', default: 'bottom-left', description: 'Preset position: bottom-left, bottom-center, bottom-right' },
+    textColor: { type: 'object', default: { r: 1, g: 1, b: 1 }, description: 'Text color RGB (0-1)' },
+    barColor: { type: 'object', default: { r: 0.08, g: 0.08, b: 0.12 }, description: 'Bar background color RGB (0-1)' },
+    barOpacity: { type: 'number', default: 0.75, description: 'Bar opacity (0-1)' },
+    accentColor: { type: 'object', default: { r: 0.9, g: 0.65, b: 0.2 }, description: 'Accent line color RGB (0-1)' },
+    width: { type: 'number', default: 1920, description: 'Frame width' },
+    height: { type: 'number', default: 1080, description: 'Frame height' },
+  },
+
+  generate(params = {}) {
+    const {
+      text = 'Name',
+      subtitle = 'Title',
+      font = 'Open Sans',
+      fontSize = 0.065,
+      position = 'bottom-left',
+      textColor = { r: 1, g: 1, b: 1 },
+      barColor = { r: 0.08, g: 0.08, b: 0.12 },
+      barOpacity = 0.75,
+      accentColor = { r: 0.9, g: 0.65, b: 0.2 },
+      width = 1920,
+      height = 1080,
+    } = params;
+
+    // Position presets
+    const positions = {
+      'bottom-left': { barX: 0.22, barY: 0.12, textX: 0.06, nameY: 0.145, subtitleY: 0.095 },
+      'bottom-center': { barX: 0.5, barY: 0.12, textX: 0.35, nameY: 0.145, subtitleY: 0.095 },
+      'bottom-right': { barX: 0.78, barY: 0.12, textX: 0.63, nameY: 0.145, subtitleY: 0.095 },
+    };
+    const pos = positions[position] || positions['bottom-left'];
+
+    return {
+      nodes: [
+        // MediaIn — auto-created by Resolve, but we reference it
+        {
+          type: 'MediaIn',
+          name: 'MediaIn1',
+          inputs: {},
+          viewX: 0, viewY: 0,
+        },
+
+        // Background bar
+        {
+          type: 'Background',
+          name: 'BG_Bar',
+          inputs: {
+            TopLeftRed: barColor.r,
+            TopLeftGreen: barColor.g,
+            TopLeftBlue: barColor.b,
+            TopLeftAlpha: barOpacity,
+            Width: width,
+            Height: height,
+            UseFrameFormatSettings: 0,
+            Type: 'Solid',
+          },
+          viewX: 110, viewY: -33,
+        },
+
+        // Rectangle mask for the bar
+        {
+          type: 'RectangleMask',
+          name: 'Mask_Bar',
+          inputs: {
+            Center: { x: pos.barX, y: pos.barY },
+            Width: 0.4,
+            Height: 0.07,
+            CornerRadius: 0.003,
+            SoftEdge: 0.002,
+            MaskWidth: width,
+            MaskHeight: height,
+          },
+          viewX: 220, viewY: -66,
+        },
+
+        // Accent line (thin colored bar on left edge)
+        {
+          type: 'Background',
+          name: 'BG_Accent',
+          inputs: {
+            TopLeftRed: accentColor.r,
+            TopLeftGreen: accentColor.g,
+            TopLeftBlue: accentColor.b,
+            TopLeftAlpha: 1,
+            Width: width,
+            Height: height,
+            UseFrameFormatSettings: 0,
+          },
+          viewX: 110, viewY: -99,
+        },
+
+        // Thin accent line mask
+        {
+          type: 'RectangleMask',
+          name: 'Mask_Accent',
+          inputs: {
+            Center: { x: pos.barX - 0.195, y: pos.barY },
+            Width: 0.004,
+            Height: 0.06,
+            SoftEdge: 0.001,
+            MaskWidth: width,
+            MaskHeight: height,
+          },
+          viewX: 220, viewY: -132,
+        },
+
+        // Primary text (name)
+        {
+          type: 'TextPlus',
+          name: 'Text_Name',
+          inputs: {
+            StyledText: text,
+            Font: font,
+            Style: 'Bold',
+            Size: fontSize,
+            Center: { x: pos.textX, y: pos.nameY },
+            Red1: textColor.r,
+            Green1: textColor.g,
+            Blue1: textColor.b,
+            HorizontalJustificationNew: 0, // left-aligned
+            VerticalJustificationNew: 1,   // center
+            Width: width,
+            Height: height,
+          },
+          viewX: 110, viewY: 33,
+        },
+
+        // Subtitle text (title/role)
+        {
+          type: 'TextPlus',
+          name: 'Text_Subtitle',
+          inputs: {
+            StyledText: subtitle,
+            Font: font,
+            Style: 'Regular',
+            Size: fontSize * 0.6,
+            Center: { x: pos.textX, y: pos.subtitleY },
+            Red1: textColor.r * 0.7,
+            Green1: textColor.g * 0.7,
+            Blue1: textColor.b * 0.7,
+            HorizontalJustificationNew: 0,
+            VerticalJustificationNew: 1,
+            Width: width,
+            Height: height,
+          },
+          viewX: 110, viewY: 66,
+        },
+
+        // Merge bar over source
+        {
+          type: 'Merge',
+          name: 'Merge_Bar',
+          inputs: {},
+          connections: {
+            Background: 'MediaIn1.Output',
+            Foreground: 'BG_Bar.Output',
+          },
+          effectMask: 'Mask_Bar.Mask',
+          viewX: 330, viewY: 0,
+        },
+
+        // Merge accent over bar
+        {
+          type: 'Merge',
+          name: 'Merge_Accent',
+          inputs: {},
+          connections: {
+            Background: 'Merge_Bar.Output',
+            Foreground: 'BG_Accent.Output',
+          },
+          effectMask: 'Mask_Accent.Mask',
+          viewX: 440, viewY: 0,
+        },
+
+        // Merge name text
+        {
+          type: 'Merge',
+          name: 'Merge_Name',
+          inputs: {},
+          connections: {
+            Background: 'Merge_Accent.Output',
+            Foreground: 'Text_Name.Output',
+          },
+          viewX: 550, viewY: 0,
+        },
+
+        // Merge subtitle text
+        {
+          type: 'Merge',
+          name: 'Merge_Subtitle',
+          inputs: {},
+          connections: {
+            Background: 'Merge_Name.Output',
+            Foreground: 'Text_Subtitle.Output',
+          },
+          viewX: 660, viewY: 0,
+        },
+
+        // MediaOut
+        {
+          type: 'MediaOut',
+          name: 'MediaOut1',
+          inputs: {},
+          connections: {
+            Input: 'Merge_Subtitle.Output',
+          },
+          viewX: 770, viewY: 0,
+        },
+      ],
+
+      keyframes: [
+        // Bar width animates in (wipe from left)
+        { tool: 'Mask_Bar', input: 'Width', time: 0, value: 0 },
+        { tool: 'Mask_Bar', input: 'Width', time: 12, value: 0.4 },
+        // Accent fades in slightly after bar
+        { tool: 'Merge_Accent', input: 'Blend', time: 0, value: 0 },
+        { tool: 'Merge_Accent', input: 'Blend', time: 8, value: 1 },
+        // Text fades in after bar reveals
+        { tool: 'Merge_Name', input: 'Blend', time: 6, value: 0 },
+        { tool: 'Merge_Name', input: 'Blend', time: 14, value: 1 },
+        { tool: 'Merge_Subtitle', input: 'Blend', time: 10, value: 0 },
+        { tool: 'Merge_Subtitle', input: 'Blend', time: 18, value: 1 },
+      ],
+    };
+  },
+};

package/resolve-advanced/vendor/fusion-codec/templates/picture-in-picture.js

@@ -0,0 +1,188 @@
+/**
+ * Picture-in-Picture Template — Scaled inset with border
+ *
+ * Creates a PiP overlay by transforming the foreground (MediaIn)
+ * scaled and positioned as an inset. Requires two clips composited
+ * via a Merge — designed to work with Fusion's multi-input system.
+ *
+ * Note: In practice, the "background" connection would need to be
+ * wired to a second input (Loader or another MediaIn). This template
+ * generates the node structure — the user connects the second source.
+ */
+
+module.exports = {
+  label: 'Picture in Picture',
+  description: 'Scaled inset overlay with optional border/shadow for PiP layouts.',
+  parameters: {
+    scale: { type: 'number', default: 0.3, description: 'PiP scale (0-1, e.g. 0.3 = 30%)' },
+    position: { type: 'string', default: 'bottom-right', description: 'Preset: top-left, top-right, bottom-left, bottom-right' },
+    borderWidth: { type: 'number', default: 3, description: 'Border width in pixels (0 for none)' },
+    borderColor: { type: 'object', default: { r: 1, g: 1, b: 1 }, description: 'Border color RGB' },
+    shadowEnabled: { type: 'boolean', default: true, description: 'Add drop shadow' },
+    shadowOffset: { type: 'number', default: 5, description: 'Shadow offset pixels' },
+    shadowOpacity: { type: 'number', default: 0.5, description: 'Shadow opacity (0-1)' },
+    cornerRadius: { type: 'number', default: 0.008, description: 'Corner radius (0 for square)' },
+    width: { type: 'number', default: 1920, description: 'Frame width' },
+    height: { type: 'number', default: 1080, description: 'Frame height' },
+  },
+
+  generate(params = {}) {
+    const {
+      scale = 0.3,
+      position = 'bottom-right',
+      borderWidth = 3,
+      borderColor = { r: 1, g: 1, b: 1 },
+      shadowEnabled = true,
+      shadowOffset = 5,
+      shadowOpacity = 0.5,
+      cornerRadius = 0.008,
+      width = 1920,
+      height = 1080,
+    } = params;
+
+    const margin = 0.03;
+    const halfScale = scale / 2;
+    const posMap = {
+      'top-left':     { x: margin + halfScale, y: 1 - margin - halfScale },
+      'top-right':    { x: 1 - margin - halfScale, y: 1 - margin - halfScale },
+      'bottom-left':  { x: margin + halfScale, y: margin + halfScale },
+      'bottom-right': { x: 1 - margin - halfScale, y: margin + halfScale },
+    };
+    const pos = posMap[position] || posMap['bottom-right'];
+
+    const nodes = [
+      {
+        type: 'MediaIn',
+        name: 'MediaIn1',
+        inputs: {},
+        viewX: 0, viewY: 0,
+      },
+
+      // Transform to scale and position the PiP
+      {
+        type: 'Transform',
+        name: 'Transform_PiP',
+        inputs: {
+          Center: { x: pos.x, y: pos.y },
+          Size: scale,
+        },
+        connections: {
+          Input: 'MediaIn1.Output',
+        },
+        viewX: 110, viewY: 0,
+      },
+
+      // Background (this is where the "main" video would connect)
+      // Using a black BG as placeholder — user replaces with their source
+      {
+        type: 'Background',
+        name: 'BG_Main',
+        inputs: {
+          TopLeftRed: 0,
+          TopLeftGreen: 0,
+          TopLeftBlue: 0,
+          TopLeftAlpha: 1,
+          Width: width,
+          Height: height,
+          UseFrameFormatSettings: 0,
+        },
+        viewX: 0, viewY: -66,
+      },
+    ];
+
+    let lastMerge;
+
+    // Border (optional)
+    if (borderWidth > 0) {
+      const borderScale = scale + (borderWidth * 2 / width);
+      nodes.push({
+        type: 'Background',
+        name: 'BG_Border',
+        inputs: {
+          TopLeftRed: borderColor.r,
+          TopLeftGreen: borderColor.g,
+          TopLeftBlue: borderColor.b,
+          TopLeftAlpha: 1,
+          Width: width,
+          Height: height,
+          UseFrameFormatSettings: 0,
+        },
+        viewX: 110, viewY: -33,
+      });
+
+      nodes.push({
+        type: 'RectangleMask',
+        name: 'Mask_Border',
+        inputs: {
+          Center: { x: pos.x, y: pos.y },
+          Width: borderScale * (width / height), // adjust for aspect
+          Height: borderScale,
+          CornerRadius: cornerRadius,
+          SoftEdge: 0.001,
+          MaskWidth: width,
+          MaskHeight: height,
+        },
+        viewX: 220, viewY: -66,
+      });
+
+      nodes.push({
+        type: 'Merge',
+        name: 'Merge_Border',
+        inputs: {},
+        connections: {
+          Background: 'BG_Main.Output',
+          Foreground: 'BG_Border.Output',
+        },
+        effectMask: 'Mask_Border.Mask',
+        viewX: 330, viewY: -33,
+      });
+
+      lastMerge = 'Merge_Border';
+    } else {
+      lastMerge = 'BG_Main';
+    }
+
+    // Merge PiP over background
+    nodes.push({
+      type: 'Merge',
+      name: 'Merge_PiP',
+      inputs: {},
+      connections: {
+        Background: `${lastMerge}.Output`,
+        Foreground: 'Transform_PiP.Output',
+      },
+      viewX: 440, viewY: 0,
+    });
+
+    // Shadow (optional)
+    if (shadowEnabled) {
+      nodes.push({
+        type: 'Shadow',
+        name: 'Shadow_PiP',
+        inputs: {
+          ShadowOffset: shadowOffset / width,
+          Softness: 0.01,
+          ShadowAlpha: shadowOpacity,
+        },
+        connections: {
+          Input: 'Merge_PiP.Output',
+        },
+        viewX: 550, viewY: 0,
+      });
+    }
+
+    const finalNode = shadowEnabled ? 'Shadow_PiP' : 'Merge_PiP';
+
+    nodes.push({
+      type: 'MediaOut',
+      name: 'MediaOut1',
+      inputs: {},
+      connections: {
+        Input: `${finalNode}.Output`,
+      },
+      viewX: 660, viewY: 0,
+    });
+
+    return { nodes, keyframes: [] };
+  },
+};

package/resolve-advanced/vendor/fusion-codec/templates/text-overlay.js

@@ -0,0 +1,161 @@
+/**
+ * Text Overlay Template — Simple text burn-in
+ *
+ * Timecode, date, watermark text, or any simple text overlay.
+ * Single TextPlus merged over source.
+ */
+
+module.exports = {
+  label: 'Text Overlay',
+  description: 'Simple text burn-in for timecode, dates, labels, or any overlay text.',
+  parameters: {
+    text: { type: 'string', default: 'OVERLAY TEXT', description: 'Text to display' },
+    font: { type: 'string', default: 'Courier New', description: 'Font family' },
+    fontSize: { type: 'number', default: 0.04, description: 'Font size (0-1)' },
+    position: { type: 'string', default: 'top-left', description: 'Preset: top-left, top-center, top-right, bottom-left, bottom-center, bottom-right, center' },
+    textColor: { type: 'object', default: { r: 1, g: 1, b: 1 }, description: 'Text color RGB' },
+    opacity: { type: 'number', default: 0.6, description: 'Text opacity (0-1)' },
+    bgEnabled: { type: 'boolean', default: false, description: 'Add background box behind text' },
+    bgColor: { type: 'object', default: { r: 0, g: 0, b: 0 }, description: 'Background box color' },
+    bgOpacity: { type: 'number', default: 0.5, description: 'Background box opacity' },
+    width: { type: 'number', default: 1920, description: 'Frame width' },
+    height: { type: 'number', default: 1080, description: 'Frame height' },
+  },
+
+  generate(params = {}) {
+    const {
+      text = 'OVERLAY TEXT',
+      font = 'Courier New',
+      fontSize = 0.04,
+      position = 'top-left',
+      textColor = { r: 1, g: 1, b: 1 },
+      opacity = 0.6,
+      bgEnabled = false,
+      bgColor = { r: 0, g: 0, b: 0 },
+      bgOpacity = 0.5,
+      width = 1920,
+      height = 1080,
+    } = params;
+
+    const positionMap = {
+      'top-left':      { x: 0.08, y: 0.92, hJust: 0 },
+      'top-center':    { x: 0.5,  y: 0.92, hJust: 1 },
+      'top-right':     { x: 0.92, y: 0.92, hJust: 2 },
+      'bottom-left':   { x: 0.08, y: 0.08, hJust: 0 },
+      'bottom-center': { x: 0.5,  y: 0.08, hJust: 1 },
+      'bottom-right':  { x: 0.92, y: 0.08, hJust: 2 },
+      'center':        { x: 0.5,  y: 0.5,  hJust: 1 },
+    };
+    const pos = positionMap[position] || positionMap['top-left'];
+
+    const nodes = [
+      {
+        type: 'MediaIn',
+        name: 'MediaIn1',
+        inputs: {},
+        viewX: 0, viewY: 0,
+      },
+      {
+        type: 'TextPlus',
+        name: 'Text_Overlay',
+        inputs: {
+          StyledText: text,
+          Font: font,
+          Style: 'Bold',
+          Size: fontSize,
+          Center: { x: pos.x, y: pos.y },
+          Red1: textColor.r,
+          Green1: textColor.g,
+          Blue1: textColor.b,
+          HorizontalJustificationNew: pos.hJust,
+          VerticalJustificationNew: 1,
+          Width: width,
+          Height: height,
+        },
+        viewX: 110, viewY: 33,
+      },
+      {
+        type: 'Merge',
+        name: 'Merge_Text',
+        inputs: {
+          Blend: opacity,
+        },
+        connections: {
+          Background: 'MediaIn1.Output',
+          Foreground: 'Text_Overlay.Output',
+        },
+        viewX: 220, viewY: 0,
+      },
+    ];
+
+    let lastMerge = 'Merge_Text';
+
+    // Optional background box
+    if (bgEnabled) {
+      // Insert background elements before the text merge
+      nodes.splice(1, 0,
+        {
+          type: 'Background',
+          name: 'BG_TextBox',
+          inputs: {
+            TopLeftRed: bgColor.r,
+            TopLeftGreen: bgColor.g,
+            TopLeftBlue: bgColor.b,
+            TopLeftAlpha: bgOpacity,
+            Width: width,
+            Height: height,
+            UseFrameFormatSettings: 0,
+          },
+          viewX: 110, viewY: -33,
+        },
+        {
+          type: 'RectangleMask',
+          name: 'Mask_TextBox',
+          inputs: {
+            Center: { x: pos.x, y: pos.y },
+            Width: 0.25,
+            Height: 0.05,
+            CornerRadius: 0.003,
+            SoftEdge: 0.002,
+            MaskWidth: width,
+            MaskHeight: height,
+          },
+          viewX: 220, viewY: -66,
+        }
+      );
+
+      // Insert box merge before text merge
+      const textMergeIdx = nodes.findIndex(n => n.name === 'Merge_Text');
+      nodes.splice(textMergeIdx, 0, {
+        type: 'Merge',
+        name: 'Merge_Box',
+        inputs: {},
+        connections: {
+          Background: 'MediaIn1.Output',
+          Foreground: 'BG_TextBox.Output',
+        },
+        effectMask: 'Mask_TextBox.Mask',
+        viewX: 330, viewY: 0,
+      });
+
+      // Update text merge to use box output as background
+      const textMerge = nodes.find(n => n.name === 'Merge_Text');
+      textMerge.connections.Background = 'Merge_Box.Output';
+      textMerge.viewX = 440;
+    }
+
+    // MediaOut
+    nodes.push({
+      type: 'MediaOut',
+      name: 'MediaOut1',
+      inputs: {},
+      connections: {
+        Input: `${lastMerge}.Output`,
+      },
+      viewX: nodes[nodes.length - 1].viewX + 110,
+      viewY: 0,
+    });
+
+    return { nodes, keyframes: [] };
+  },
+};