Motion Image Shot
Motion Image Shot saves a short JPEG series when motion or sound is detected. It is a lightweight alternative to event video clips when you need thumbnails, notification images, evidence snapshots, or recognition-ready frames.
Event snapshots instead of full video
The task listens to upstream detection context and starts a photo series when VIDEO_MOTION_DETECTED or AUDIO_MOTION_DETECTED is set. Every saved JPEG produces a FileCreatedEvent, so snapshots can be used by notification, history, storage, or downstream automation workflows.
Required upstream signals
Capture task is running
The parent media capture task must deliver video frames. Rotation, source resolution, and upstream frame rate affect the saved image.
Motion or sound detection is configured
Place Motion Image Shot after Motion Detection or Sound Detection. The task records what upstream detection marks as an event; it does not filter motion by itself.
Writable file storage is available
Select storage that can handle bursts of small JPEG files. Busy scenes with short intervals and long series can create many files quickly.
Adding the snapshot task
Open the capture task tree
Navigate to the camera or playback source that already has media capture and detection tasks.
Add Motion Image Shot
Add the task after Motion Detection or Sound Detection so it can react to VIDEO_MOTION_DETECTED or AUDIO_MOTION_DETECTED.
Choose storage and naming
Select the target file storage and folder structure. Use millisecond-based patterns when several snapshots can be saved within the same second.
Tune the series
Set photo interval, photos in series, and compression rate according to event speed, required detail, storage budget, and notification size limits.
Configuration parameters
These are the parameters available when configuring Motion Image Shot.
| Parameter | Required | Description | Default |
|---|---|---|---|
ID | Yes | Unique identifier generated automatically for this task instance. Read-only. | Auto |
Restart on failure | Yes | Controls how the task is restarted after an error: stop on failure, immediately, 10 sec, 30 sec, or 1 min. | 10 sec |
Target file storage | Yes | Writable file storage where JPEG snapshots are committed. | None |
Folder structure | Yes | Timestamp-based folder and file naming pattern. Use yyyyMMdd / hh / mmss for normal event snapshots and millisecond patterns when several files can be created in one second. | yyyyMMdd / hh / mmss |
Photo interval (ms) | Yes | Delay between shots in one event series. Valid range is 50 to 5000 ms. | 1000 |
Photos in series | Yes | Number of photos captured for one motion or sound event. Continuous motion can keep re-arming the series. | 3 |
Compression rate | Yes | JPEG quality from 0.1 to 1.0. Higher values preserve more detail but create larger files. | 0.75 |
Shape the series for the event type
Event thumbnail only
Use Photos in series = 1, Photo interval = 1000, and Compression rate = 0.65-0.8 when one representative image is enough.
Balanced event evidence
Use Photos in series = 3, Photo interval = 500-1000, and Compression rate = 0.75-0.85 for normal people, vehicle, and perimeter events.
Fast object movement
Use Photos in series = 5-10, Photo interval = 100-500, and enough storage throughput for bursts of similar frames.
Low-storage snapshots
Use Photos in series = 1-3, Photo interval = 2000-5000, and Compression rate = 0.4-0.65. Tune upstream detection strictly so noise does not create unnecessary series.
High-detail recognition
Use Photos in series = 3-5, Photo interval = 500-1000, and Compression rate = 0.85-0.95. Also check source resolution, focus, lighting, and grabber Rotate image.