Overview

The Save GIF node allows for saving a GIF when a specific condition is met. This functionality is useful for applications requiring dynamic media capture based on real-time data or events.

Inputs & Outputs

Input media: Raw Video.
Output media: Raw Video.
Output metadata: None.

Pipeline usage

Place metadata-producing nodes before Save GIF so capture_trigger and end_trigger can evaluate their outputs. The pre-trigger buffer retains recent frames before capture begins, while max_duration guarantees eventual completion when no end trigger fires. capture_interval controls how often source frames are sampled; playback_interval controls how long each sampled frame is shown, so they need not match. Cloud files appear in Lumeo outputs; local files remain on the gateway and are limited by max_edge_files.

Properties

Property	Description	Type	Default	Required
`save_location`	Save location. Options: Lumeo Cloud (`cloud`): Access files via Lumeo API or the output files tab of the deployment; Local disk (`local`): Access from the specified folder of the gateway.	`enum`	`cloud`	Yes
`max_edge_files`	Max. number of files. Conditional on `save_location` being `local`.	`number`	`5`	Yes
`capture_trigger`	Start capturing and add a frame to the GIF when this condition evaluates to true.	trigger-condition	`null`	Yes
`end_trigger`	Save the GIF when this condition evaluates to true or max. duration is reached.	trigger-condition	`null`	No
`max_duration`	Max. GIF duration. Unit: seconds.	`float`	`5`	Yes
`pre_trigger_duration`	Capture duration before the Capture trigger evalutes to true. Unit: seconds.	`float`	`0`	Yes
`capture_interval`	Capture frames at this interval. Unit: seconds/frame.	`float`	`2`	Yes
`playback_interval`	Playback frames at this interval. Unit: seconds/frame.	`float`	`2`	Yes
`resolution`	Resolution. Options: Default (stream resolution) (`default`); 1280x720 (`1280x720`); 640x360 (`640x360`); 320x180 (`320x180`).	`enum`	`default`	Yes

Output Metadata

Node does not insert any output metadata; upstream metadata continues through the pipeline