Loading...
Searching...
No Matches
image_exif.c
Go to the documentation of this file.
117 if (exif_read_jpeg(filename, active_workspace->payload, sizeof(active_workspace->payload), &size) != 0
135static int set_coordinate(struct exif_document *exif, uint16_t reference_tag, uint16_t coordinate_tag,
203static int add_shot_tags(struct exif_document *exif, const union dc_shot_union *original, double delay, int compensate,
228 unsigned char *altitude_reference = exif_document_reserve(exif, EXIF_GPS, EXIF_GPS_ALTITUDE_REF,
234 uint64_t altitude_mm = shot->data.alt < 0 ? (uint64_t)(-(int64_t)shot->data.alt) : (uint64_t)shot->data.alt;
236 || exif_document_rational(exif, EXIF_GPS, EXIF_GPS_ALTITUDE, (uint32_t)altitude_mm, 1000) != 0) {
321static int set_tagged_comment(struct exif_document *exif, const char *tag, const char *information)
331 for (size_t index = 0; index < description_length; ++index) saved_description[index] = description.data[index];
333 const int separator_length = tag[0] ? snprintf(separator, sizeof(separator), "\n%s\n", tag) : 0;
343 for (size_t index = 0; index < description_length; ++index) entry[offset++] = saved_description[index];
344 for (size_t index = 0; index < (size_t)separator_length; ++index) entry[offset++] = (unsigned char)separator[index];
349/** @brief Compatibility wrapper for analysis that becomes available after the flight EXIF write.
422 return image_exif_write_complete(filename, shot, capture_delay_s, compensate, timing, NULL, 0, NULL);
433static int add_observation_tags(struct exif_document *exif, const struct capture_timing *timing, bool aligned)
452 observation->earliest_us, observation->latest_us, observation->sequence, observation->sensor_timestamp_ns, boot);
456 if (!isfinite(observation->pose_uncertainty_m) || observation->pose_uncertainty_m < 0) return -1;
489 if (exif_read_jpeg(filename, workspace->payload, sizeof(workspace->payload), &capture_size) == 0
492 for (size_t field = 0; field < sizeof(image_exif_capture_tags) / sizeof(image_exif_capture_tags[0]); ++field) {
494 unsigned char *stored = exif_document_reserve(exif, EXIF_CAMERA, image_exif_capture_tags[field],
527 "; request_groundalt_bfp=%" PRId32 "; request_vground_bfp=%" PRId32 "; request_course_bfp=%" PRId32,
528 (int)description.size, description.data, uncertainty_m, request->data.lat, request->data.lon, request->data.alt,
589 unsigned char *configuration = exif_document_reserve(exif, EXIF_CAMERA, EXIF_COMPONENTS_CONFIGURATION,
596 unsigned char *dimension = exif_document_reserve(exif, EXIF_CAMERA, EXIF_PIXEL_X_DIMENSION, EXIF_LONG, 1);
614 int name_length = snprintf(active_workspace->temporary_name, sizeof(active_workspace->temporary_name),
Read Linux's boot-unique identifier for pose-log session provenance.
static void usher_boot_id(char result[37])
Fill a 36-character boot UUID or the stable fallback "unknown".
Definition boot_id.h:36
static bool capture_timing_valid(const struct capture_timing *timing)
Check whether timing evidence is internally consistent and recent.
Definition capture_timing.h:155
static bool capture_observation_valid(const struct capture_observation *observation)
Check that an observation supplies a usable time interval.
Definition capture_timing.h:63
static const char * capture_time_name(enum capture_time_kind kind)
Get the text label used when recording observation timing.
Definition capture_timing.h:115
static bool capture(struct transport *transport, FILE *file, const struct capture_settings *settings)
Capture to the camera's SD card and download the resulting JPEG.
Definition chdkbridge.c:1463
static int record(const union dc_shot_union *shot)
Retrieve a point and admit a new observation only when its credit is free.
Definition dipla_camera_backend.c:206
Bounded C11 EXIF metadata and JPEG streaming interfaces.
int exif_serialize(const struct exif_document *document, unsigned char *payload, size_t capacity, size_t *size)
Serialize a document into one complete EXIF APP1 payload.
Definition exifite.c:736
void exif_document_init(struct exif_document *document)
Start a fresh upright sRGB/Y-Cb-Cr document with EXIF 2.32 defaults.
Definition exifite.c:412
unsigned char * exif_document_reserve(struct exif_document *document, enum exif_directory directory, uint16_t tag, enum exif_format format, uint32_t count)
Create or replace a field with zeroed, bounded value storage.
Definition exifite.c:508
void exif_encode_long(unsigned char *data, uint32_t value)
Encode a 32-bit value in the writer's little-endian representation.
Definition exifite.c:106
int exif_parse(struct exif_view *view, const unsigned char *payload, size_t size)
Validate an EXIF APP1 payload and create a borrowed view.
Definition exifite.c:257
bool exif_get(const struct exif_view *view, enum exif_directory directory, uint16_t tag, struct exif_value *value)
Look up a directory-local tag without copying its bytes.
Definition exifite.c:310
int exif_read_jpeg(const char *filename, unsigned char *payload, size_t capacity, size_t *size)
Read the single EXIF APP1 segment before the first JPEG scan.
Definition exifite.c:1022
int exif_document_rational(struct exif_document *document, enum exif_directory directory, uint16_t tag, uint32_t numerator, uint32_t denominator)
Store an unsigned measurement as an exact numerator/denominator pair.
Definition exifite.c:572
bool exif_document_get(const struct exif_document *document, enum exif_directory directory, uint16_t tag, struct exif_value *value)
Borrow a field from the current writable document.
Definition exifite.c:447
#define EXIF_MAX_PAYLOAD
APP1 payload ceiling: the JPEG length includes its own two bytes.
Definition exifite.h:51
int exif_jpeg_dimensions(FILE *input, uint32_t *width, uint32_t *height, unsigned *components)
Inspect the frame header without allocating or decoding image pixels.
Definition exifite.c:1309
int exif_document_ascii(struct exif_document *document, enum exif_directory directory, uint16_t tag, const char *text)
Replace an ASCII field, including its terminating NUL byte.
Definition exifite.c:543
int exif_rewrite_jpeg(FILE *input, FILE *output, const unsigned char *payload, size_t size)
Stream a JPEG with one new EXIF segment instead of its old EXIF records.
Definition exifite.c:1518
int exif_update_jpeg(FILE *file, const unsigned char *payload, size_t size)
Replace EXIF in a regular JPEG file without a temporary file.
Definition exifite.c:1649
static int write_tagged_comment(const char *filename, const char *tag, const char *information)
Compatibility wrapper for analysis that becomes available after the flight EXIF write.
Definition image_exif.c:353
int image_exif_write_hotspots(const char *filename, const char *information)
Append structured thermal hotspot/geolocation evidence to JPEG EXIF.
Definition image_exif.c:372
static struct exif_workspace * workspace_acquire(void)
Claim a bounded EXIF editing slot for the current thread.
Definition image_exif.c:73
int image_exif_write_timed(const char *filename, const union dc_shot_union *shot, double capture_delay_s, int compensate)
Add flight metadata with optional capture-delay motion compensation.
Definition image_exif.c:413
static double normalized_degrees(int32_t angle_bfp)
Convert a flight-controller heading to the EXIF angular range.
Definition image_exif.c:172
int image_exif_write_complete(const char *filename, const union dc_shot_union *shot, double capture_delay_s, int compensate, const struct capture_timing *timing, const union dc_shot_union *request, double uncertainty_m, const char *objects)
Write flight provenance and an available object-detection result in one metadata transaction.
Definition image_exif.c:473
static int add_observation_tags(struct exif_document *exif, const struct capture_timing *timing, bool aligned)
Extend the flight description with observation provenance.
Definition image_exif.c:433
static uint32_t scaled_unsigned(double value, double scale)
Form a nonnegative numerator for an EXIF rational.
Definition image_exif.c:184
static int set_tagged_comment(struct exif_document *exif, const char *tag, const char *information)
Write an EXIF UserComment composed of flight and analysis records.
Definition image_exif.c:321
static int add_shot_tags(struct exif_document *exif, const union dc_shot_union *original, double delay, int compensate, const struct capture_timing *timing)
Add GPS fields and the flight-pose description to an editable document.
Definition image_exif.c:203
static void workspace_release(struct exif_workspace *workspace)
Return an editing slot to the shared pool.
Definition image_exif.c:98
static _Thread_local struct exif_workspace * active_workspace
Definition image_exif.c:67
int image_exif_write_capture(const char *filename, const union dc_shot_union *shot, double capture_delay_s, int compensate, const struct capture_timing *timing)
Add flight metadata using authoritative capture timing when available.
Definition image_exif.c:419
static int save_exif(const char *filename, struct exif_document *exif)
Replace metadata while streaming the original compressed payload unchanged.
Definition image_exif.c:556
int image_exif_write_object_detections(const char *filename, const char *information)
Append structured object-detection evidence (AICam) to JPEG EXIF.
Definition image_exif.c:377
static int set_coordinate(struct exif_document *exif, uint16_t reference_tag, uint16_t coordinate_tag, int32_t coordinate, int32_t limit, char positive, char negative)
Encode one signed GPS coordinate as EXIF hemisphere and DMS tags.
Definition image_exif.c:135
int image_exif_write(const char *filename, const union dc_shot_union *shot)
Add standard USHER flight metadata to a JPEG.
Definition image_exif.c:408
static struct exif_workspace exif_workspaces[EXIF_WORKSPACE_COUNT]
Definition image_exif.c:66
int image_exif_write_mock_map(const char *filename, double horizontal_fov, double vertical_fov)
Label a synthetic map fixture with its geometry and provider-neutral XYZ tile scheme.
Definition image_exif.c:382
static struct exif_document * load_exif(const char *filename)
Import an existing JPEG EXIF block into the active editing slot.
Definition image_exif.c:112
Flight, timing, and thermal-analysis metadata writing for captured JPEGs.
static int image_exif_import(struct exif_document *document, const struct exif_view *view)
Import standard metadata plus the application's approved capture evidence.
Definition image_exif.h:58
#define IMAGE_EXIF_ATOMIC_REPLACE
Select sibling-file atomic replacement instead of the default in-place update.
Definition image_exif.h:70
static const uint16_t image_exif_capture_tags[]
Application-owned opaque evidence retained by photo metadata updates.
Definition image_exif.h:35
Advance a position along ground velocity by a bounded elapsed interval.
static int compensate_ground_position(int32_t *latitude, int32_t *longitude, double speed, double course, double delay)
Correct latitude/longitude for horizontal platform motion during capture.
Definition motion_compensation.h:42
Definition capture_timing.h:41
Shared observation evidence with optional LWIR request/frame-delivery timing.
Definition capture_timing.h:133
Borrowed bytes plus enough type information for safe interpretation.
Definition exifite.h:119
Definition image_exif.c:58
Definition usher_protocol.h:51
struct dc_shot_union::@351207206061007345226276304225222200157171312155 data