Preview Image - No Save (IMGNR):
PreviewImageBase64Node displays an image preview in the node interface without saving a file to disk. It converts the preview to PNG data carried directly in the interface response, making it useful when you want to inspect a result without creating an output file. The node also passes image and mask data onward, so you can keep working with the result after previewing it. The displayed preview is made from the first image in a batch.
Preview Image - No Save (IMGNR) Input Parameters:
images
The required IMAGE input supplies the image or batch of images to preview and pass onward. The node uses the first image to create the displayed PNG preview, while the full batch remains available through the image output. No minimum, maximum, or default value is specified in the node interface.
mask
The optional MASK input controls transparency in the preview and returned image: mask values are inverted to form the image’s alpha channel, so higher mask values produce more transparency. If you provide one mask for a batch, the node repeats it across the images; if its dimensions differ from the images, the node resizes it using nearest-neighbor interpolation. A supplied mask takes precedence over any alpha channel already present in the images. If you leave this input disconnected, the node derives the returned mask from an existing image alpha channel, or returns an all-zero mask for images without alpha. No minimum, maximum, or default mask value is specified; leaving it disconnected is the optional state.
prompt
This hidden PROMPT input is supplied by the application rather than configured as a visible control. The node passes it to its preview processing and includes it in preview metadata when available. You do not need to connect or set it manually. No minimum, maximum, or default value is specified.
extra_pnginfo
This hidden EXTRA_PNGINFO input is supplied by the application rather than configured as a visible control. The node passes it to its preview processing; this node does not expose a setting to save or embed that information in a file. You do not need to connect or set it manually. No minimum, maximum, or default value is specified.
Preview Image - No Save (IMGNR) Output Parameters:
image
The IMAGE output passes the full input batch onward. When you supply a mask, the node combines each image’s first three color channels with an alpha channel calculated from that mask. Without a supplied mask, images that already have an alpha channel retain it, while images without one remain unchanged. The interface preview shows only the first image, so use this output to continue working with the full batch.
mask
The MASK output represents the transparency used for the returned images. With a connected mask, it returns that mask after any batch repetition or resizing needed to match the images. Without a connected mask, it returns the inverse of an existing image alpha channel, or an all-zero mask if the images have no alpha channel. In this node’s convention, higher mask values correspond to greater transparency.
Preview Image - No Save (IMGNR) Usage Tips:
- Connect
imageswhen you want a quick visual check without creating a saved image file. Connectimageto another node if your workflow needs to continue after the preview. - Connect
maskwhen you want the preview to show transparent areas. If your image already has the transparency you want, leavemaskdisconnected so the node preserves its existing alpha channel. - For a batch, remember that the displayed preview represents the first image only. Check the batch elsewhere if you need to inspect every image.
- If mask edges or placement matter, supply a mask that already matches the image dimensions. The node can resize a mismatched mask, but nearest-neighbor resizing may change its appearance.
Preview Image - No Save (IMGNR) Common Errors and Solutions:
[IMGNR_Preview] Error: <details>
- Explanation: The node logs this message if an error occurs while converting the prepared image to a PNG preview or building the preview data. The text after
Error:provides the specific cause. The preview may be absent even though the node returns its image and mask data. - Solution: Read the details in the application log. Check that
imagescontains valid image data, and, ifmaskis connected, try a mask with dimensions matching the images.
Missing required input: images
- Explanation: The node requires an
IMAGEconnection; it cannot create a preview without image data. The exact validation wording depends on the application. - Solution: Connect an image-producing node to
imagesand run the workflow again.
Mask shape or size error
- Explanation: A mask with an unsupported shape, or one that cannot be repeated or resized to match the images, may cause processing to fail. The exact error text depends on the mask and the operation that fails.
- Solution: Supply a standard
MASKoutput and, if possible, make its width and height match the images. For a batch, use one mask for all images or a corresponding mask for each image.
No preview appears for every image in a batch
- Explanation: This is expected behavior, not an error: the node creates its displayed PNG preview from the first image only.
- Solution: Preview batch images individually if you need to inspect each one; the
imageoutput still carries the full batch onward.
