Skip to main content
View source

Thumbnail

View as Markdown

A RocketRide image filter that turns an existing image or Image document into a compact 128×128 PNG thumbnail. Choose it when downstream preview, storage, or vision work needs a fixed-size image rather than the source resolution.

About Pillow

Pillow is a Python imaging library. This node uses the shared Pillow-based image helper to decode input images, resize them, crop a thumbnail, and encode PNG output.

What it does

The node accepts raw images on the image lane and Image documents on the documents lane, then produces thumbnail versions for the lanes declared by the pipeline. It is a pure transform with no configuration or agent-tool surface. Use it after an image is already available and you need a compact, consistently sized derivative; it does not select frames or acquire images from another source.

Lanes

Lane inLane outDescription
imagedocumentsEmit the thumbnail as an Image document.
imageimageEmit the thumbnail as a raw PNG image stream.
documentsdocumentsReplace each supported Image document with its thumbnail.

Configuration

This node has no configuration fields. Its output size is fixed by the implementation, so connect the input and only attach the output lane or lanes your pipeline needs.

Notes

Thumbnail output

The shared image helper works on a copy, progressively reduces very large images, preserves aspect ratio during its resize step, then center-crops the result to exactly 128×128 pixels. Both raw-image and document paths encode the result as PNG; the raw-image output therefore announces image/png even if the input used a different MIME type.

Raw image streams

The image lane buffers the input from BEGIN through WRITE and processes it at END. If documents is connected, it emits one base64-encoded Image document with new thumbnail metadata and preserved source provenance. If image is connected, it emits an enriched PNG stream with the thumbnail width and height. When both lanes have listeners, it emits both forms.

Image documents

Only documents whose type is Image and whose page_content is non-empty are processed. Unsupported documents, empty content, and document-level decode or processing errors produce a warning and are skipped, while the node continues processing the remaining documents in the batch. The emitted document keeps a copy of the original metadata and adds an image-source layer for the new thumbnail.

Upstream docs


Schema

No configuration fields.