`image_rotate`

Rotate a single image by 90-degree increments.

Parameters

pathstringone of path or source_key: Source image path
source_keystringone of path or source_key: Context key containing a source path, artifact URI/descriptor, or explicit Base64 object
output_pathstringrequired: Destination image path
anglenumberdefault 90: One of 90, 180, 270
formatstringdefault inferred / png: png or jpeg/jpg
output_keystringdefault "rotated_image": Prefix for output values

Artifact inputs are opened and SHA-256 verified inside the tracked blocking worker; decoding consumes that same rewound handle rather than a resolved store pathname.

Supported source formats are BMP, Farbfeld, GIF, HDR, ICO, JPEG, PNG, PNM, QOI, TGA, TIFF, and WebP. Output remains restricted to PNG or JPEG.

Context Output

<output_key> — output file path
<output_key>_angle — angle used
<output_key>_width / <output_key>_height — output dimensions
<output_key>_source_width / <output_key>_source_height
<output_key>_format
<output_key>_success

Example

local flow = Flow.new("image_rotate_demo")

flow:step("rotate", nodes.image_rotate({
    path = "examples/fixtures/ironflow-sample.png",
    angle = 90,
    output_path = "output/sample_front_rotated.png",
    output_key = "rotated"
}))

flow:step("log", nodes.log({
    message = "Rotated image: ${ctx.rotated_width}x${ctx.rotated_height}"
})):depends_on("rotate")

return flow

Resource contract

The encoded source, decoded pixels/allocation, and rotated output buffer are checked against IRONFLOW_MAX_IMAGE_ENCODED_BYTES (50 MiB), IRONFLOW_MAX_IMAGE_PIXELS (25 million), and IRONFLOW_MAX_IMAGE_DECODE_ALLOCATION_BYTES (128 MiB). The working estimate includes retained source plus rotated output. Decode, rotation, and encode run on a tracked blocking worker with cancellation checkpoints between opaque operations.