Loading...
Searching...
No Matches
photo_exif.h
Go to the documentation of this file.
130 check(exif_document_ascii(&document_, EXIF_GPS, referenceTag, reference), "Set EXIF GPS hemisphere");
148 if (!captureUtcSampleValid(utc, camera.utcAbsoluteSeconds, camera.utcRead100ns, camera.frame100ns))
159 check(exif_document_ascii(&document_, EXIF_PRIMARY, 0x0132, timestamp.c_str()), "Set EXIF DateTime");
161 check(exif_document_ascii(&document_, EXIF_CAMERA, static_cast<std::uint16_t>(tag), timestamp.c_str()),
167 check(exif_document_ascii(&document_, EXIF_CAMERA, static_cast<std::uint16_t>(tag), subsecond.str().c_str()),
219 const auto altitudeMm = static_cast<std::uint32_t>(std::llround(std::abs(position.altitudeAmsl) * 1000));
236 << (camera && camera->piAiCamera ? "simconnect_observed_camera" : "simconnect_commanded_camera")
264 const auto shutterUs = static_cast<std::uint32_t>(std::llround(c.exifSettings.shutterSeconds * 1000000));
276 << (c.exifSettings.hardwareIdentifier.empty() ? "undefined" : c.exifSettings.hardwareIdentifier);
279 if (std::abs(position.groundAmsl) > static_cast<double>(std::numeric_limits<std::int32_t>::max()) / 256)
284 if (!std::all_of(std::begin(fields), std::end(fields), [](double value) { return std::isfinite(value); }) ||
335 const double direction = std::fmod(std::fmod(c.commandedHeading + c.imageRotationDegrees, 360.0) + 360.0, 360.0);
340 check(exif_document_ascii(&document_, EXIF_GPS, EXIF_GPS_SPEED_REF, "K"), "Set GPS speed units");
344 << (c.piAiCamera ? "raspberry_pi_ai_nominal" : (c.narrowAngle ? "narrow_angle_mapping" : "normal"))
345 << "; camera.lens_model=" << (c.piAiCamera ? "brown_conrady_estimated_v1" : "ideal_rectilinear")
375 comment << "; camera.calibrated=false; camera.distortion_basis=engineering_estimate_not_measured"
Optical profiles and EXIF settings for simulated survey cameras.
Build bounded EXIF payloads for simulator-generated source photos.
Definition photo_exif.h:91
Payload build(const PhotoPosition &position, int width, int height, const std::optional< PhotoCamera > &camera={})
Construct EXIF from validated photo position and optional camera evidence.
Definition photo_exif.h:194
void captureTime(const PhotoCamera &camera)
Write simulator-observed UTC into consistent EXIF and GPS fields.
Definition photo_exif.h:146
std::array< unsigned char, EXIF_MAX_PAYLOAD > payload_
Definition photo_exif.h:94
static std::string jsonString(const std::string &text)
Escape a string as a JSON string literal.
Definition photo_exif.h:456
void coordinate(double degrees, std::uint16_t referenceTag, std::uint16_t valueTag, char positive, char negative)
Encode a validated geographic coordinate as EXIF GPS rationals.
Definition photo_exif.h:127
unsigned char * reserve(exif_directory directory, std::uint16_t tag, exif_format format, std::uint32_t count)
Allocate one field in the bounded EXIF document.
Definition photo_exif.h:112
static void check(int result, const char *operation)
Convert a C EXIF status into the mapper's error path.
Definition photo_exif.h:100
static uint64_t milliseconds(void)
Read elapsed-time evidence unaffected by changes to civil time.
Definition dipla_camera_backend.c:59
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_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
#define EXIF_MAX_PAYLOAD
APP1 payload ceiling: the JPEG length includes its own two bytes.
Definition exifite.h:51
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
void exif_encode_short(unsigned char *data, uint16_t value)
Encode a 16-bit value in the writer's little-endian representation.
Definition exifite.c:99
Convert between WGS-84 coordinates and one local UTM grid.
Definition camera_optics.h:32
bool captureUtcSampleValid(const UtcDateTime &target, double actual, long long read100ns, long long frame100ns)
Validate that a frame's UTC readback is recent and in the locked second.
Definition utc_time.h:202
User-supplied exposure labels written to simulated-photo EXIF.
Definition camera_optics.h:38
Engineering lens-distortion and lateral colour-scale parameters.
Definition camera_optics.h:56
Camera and timing provenance required for a simulated-photo EXIF record.
Definition photo_exif.h:62
double rotationBoundDegrees
Definition photo_exif.h:81
double imageRotationDegrees
Definition photo_exif.h:81
std::optional< unsigned long long > photoNumber
Definition photo_exif.h:82
std::optional< UtcDateTime > captureUtc
Definition photo_exif.h:77
Borrowed serialized EXIF bytes held in this object's workspace.
Definition photo_exif.h:180
Photo location with AMSL camera and ground heights in metres.
Definition photo_exif.h:50
static constexpr double focalPixels
Definition camera_optics.h:73
static constexpr double greenScale
Definition camera_optics.h:75