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
soda_object_postprocess.h
Go to the documentation of this file.
1/*
2 * Copyright 2026 OpenUAS
3 * SPDX-License-Identifier: Apache-2.0
4 *
5 * Licensed under the Apache License, Version 2.0 (the "License");
6 * you may not use this file except in compliance with the License.
7 * You may obtain a copy of the License at
8 *
9 * http://www.apache.org/licenses/LICENSE-2.0
10 *
11 * Unless required by applicable law or agreed to in writing, software
12 * distributed under the License is distributed on an "AS IS" BASIS,
13 * WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
14 * See the License for the specific language governing permissions and
15 * limitations under the License.
16 */
17
18/**
19 * @file soda_object_postprocess.h
20 * @brief EXIF-driven object-hit post-processing for SODA. */
21#ifndef SODA_OBJECT_POSTPROCESS_H
22#define SODA_OBJECT_POSTPROCESS_H
23
24/**
25 * @brief Post-process a captured image for an object-detection hit, if it has one.
26 * @param image_path Path to the JPEG SODA was invoked on.
27 * @return true when there was nothing to do (no AICAM_OBJECTS_V1 hit in EXIF, or the
28 * marker couldn't be read at all -- the common case for every non-spottercam shot) or
29 * every post-processing step for a real hit succeeded; false only when a hit was found but
30 * at least one downstream step (full-frame copy, crop, or CSV row) failed.
31 * @details No-op beyond one EXIF read unless @p image_path carries an AICAM_OBJECTS_V1
32 * record (written by usher's image_exif_write_object_detections()) reporting count >= 1.
33 * On a hit, copies the image into a sibling `objects_captured/` directory, saves a padded
34 * crop of the detected box into a sibling `tight_crop_objects/` directory, and appends one
35 * row to `objects_captured/detections.csv`. Both directories are derived from
36 * @p image_path's own directory -- there is no separately configured base directory.
37 */
38bool soda_process_object_detection(const char *image_path);
39
40#endif // SODA_OBJECT_POSTPROCESS_H
bool soda_process_object_detection(const char *image_path)
Post-process a captured image for an object-detection hit, if it has one.