Set Render Resolution

Author: Vincenzo Mossuto Creation Date: 26/09/2025
Last Reviewer: Sara Altomare/Rossana Mazza

See the Changelog for the full history of updates.

What it does

This operator automatically adjusts the scene render resolution to match the resolution of the image used in the selected Compositor node.
It ensures that the output render matches exactly the source reference image (e.g., backplates, HDRIs, masks), avoiding mismatches and manual setup.

Prerequisites

• Spaarkly Scripts add-on enabled
• An image node must be selected in the Compositor (e.g., Image, Render Layers, or other node providing image data).

Steps

1. Switch to the Compositor workspace.
2. In the node editor, select an image node whose resolution you want to use.
3. Open the Spaarkly Scripts panel → Render Utilities.
4. Click Set Render Resolution.

• The scripts reads the image resolution (size[0], size[1]) from the selected image node in the Compositor.
• Applies those values to:
  • scene.render.resolution_x
  • scene.render.resolution_y
  • Sets scene.render.resolution_percentage = 100

5. The scene’s render resolution is immediately updated to match the selected image.

Tips & Best Practices

• Always select the correct node before running the operator; otherwise, the resolution may remain unchanged.
• Use this when working with backplates or mask images to prevent scaling and distortion.
• After applying, double-check the aspect ratio in Properties → Output → Resolution.

Troubleshooting

• Nothing happens
  • Ensure that a valid image node is selected in the Compositor.
• Resolution looks wrong
  • Confirm the image file has correct metadata (some formats may not store dimensions properly).
• Operator not available
  • Verify the add-on is enabled and you are inside the Compositor workspace.

---