Illustrated C/C++ source sheets, symbol index, API relationship graph, compiler console and debug trace

LIVE AI / FLEXIBLE SENSING / FLIGHT CONTEXT

Sensoraia API

Live AI and sensing, connected to the flight.
See, listen, inspect and return supported results while airborne.

Loading...
Searching...
No Matches
camera_capture_ops Struct Reference

Driver capabilities whose table must outlive every pending image. More...

#include <camera_capture.h>

Data Fields

int(* acquire )(struct camera_pending *pending, int image_number)
 Retain one exposure without waiting for its final JPEG publication.
int(* finish )(struct camera_pending *pending, char *filename, size_t size, const volatile sig_atomic_t *running)
 Finish the exact acquisition represented by pending.
bool(* has_capacity )(void)
 Nonblocking capacity snapshot; acquisition remains the admission authority.
unsigned max_in_flight

Detailed Description

Driver capabilities whose table must outlive every pending image.

USHER snapshots the table pointer with the image, not the currently selected camera. This keeps a later backend switch from finishing the wrong job. Acquisition is serialized by the camera owner; finish may overlap later captures. Implementations must synchronize their shared state and bound memory and waits.

Definition at line 73 of file camera_capture.h.

Field Documentation

◆ acquire

int(* camera_capture_ops::acquire) (struct camera_pending *pending, int image_number)

Retain one exposure without waiting for its final JPEG publication.

Parameters
[out]pendingOwnership record filled by the driver.
image_numberOriginal USHER shot number.
Returns
Zero with acquired set when pixels are owned; positive for synchronous fallback before any exposure; negative for failure without a duplicate retry.

Definition at line 80 of file camera_capture.h.

◆ finish

int(* camera_capture_ops::finish) (struct camera_pending *pending, char *filename, size_t size, const volatile sig_atomic_t *running)

Finish the exact acquisition represented by pending.

Parameters
[in,out]pendingRecord to release, including admission accounting, on every exit.
[out]filenamePublished filename on success; empty on failure.
sizeFilename capacity including its terminating NUL.
runningOptional shutdown flag to check during bounded waits.
Returns
Zero for a verified published file, negative on failure or cancellation.
Warning
Failure is not permission to discard an existing original or recapture using the old pose. Preserve recoverable private files and report the failure.

Definition at line 90 of file camera_capture.h.

◆ has_capacity

bool(* camera_capture_ops::has_capacity) (void)

Nonblocking capacity snapshot; acquisition remains the admission authority.

Returns
True when another capture may be attempted. NULL means no extra readiness gate.

Definition at line 95 of file camera_capture.h.

◆ max_in_flight

unsigned camera_capture_ops::max_in_flight

Per-camera limit, currently 1..2; not a whole-MORA memory budget.

Definition at line 96 of file camera_capture.h.


The documentation for this struct was generated from the following file: