ra8-firmware 0.1.0
Bare-metal firmware for the Renesas RA8 family (RA8D2 / RA8P1)
Loading...
Searching...
No Matches
jof_audit.h
Go to the documentation of this file.
1
20
21#pragma once
22
23#ifdef __cplusplus
24extern "C" {
25#endif
26
27#include <stddef.h>
28#include <stdint.h>
29
30#include "jof.h"
31#include "ra8_err.h"
32
38typedef struct jof_audit_record_t {
39 uint32_t offset;
40 uint32_t length;
41 uint32_t payload;
42 uint32_t content_hash;
43 uint16_t width;
44 uint16_t height;
45 bool uniform;
47
58
72
85
108 void* pread_ctx,
109 uint64_t total_size,
111
141[[nodiscard]] ra8_err_t jof_audit(jof_pread_fn pread,
142 void* pread_ctx,
143 uint64_t total_size,
144 jof_audit_workspace_t* workspace,
145 jof_audit_result_t* out);
146
147#ifdef __cplusplus
148}
149#endif
JOF band-tile atlas: the display-native normalized image format (#231, shared with the longstrip scro...
ra8_err_t(* jof_pread_fn)(void *ctx, uint64_t offset, uint8_t *buf, size_t len, size_t *got)
Positioned-read seam over an atlas backing store (DIP).
Definition jof.h:241
ra8_err_t jof_audit_requirements(jof_pread_fn pread, void *pread_ctx, uint64_t total_size, jof_audit_requirements_t *out)
Parse an atlas and report exact caller-storage requirements.
Definition jof_audit.c:237
ra8_err_t jof_audit(jof_pread_fn pread, void *pread_ctx, uint64_t total_size, jof_audit_workspace_t *workspace, jof_audit_result_t *out)
Audit coverage, geometry and duplicate-content evidence in bounded RAM.
Definition jof_audit.c:513
Error Code Definitions for ra8-firmware.
ra8_err_codes_t ra8_err_t
Canonical error-return type used by every ra8-firmware API.
Definition ra8_err.h:546
One decoded tile's stored window and content evidence.
Definition jof_audit.h:38
uint16_t height
Edge-clamped decoded height.
Definition jof_audit.h:44
uint32_t length
Stored-stream length.
Definition jof_audit.h:40
uint16_t width
Edge-clamped decoded width.
Definition jof_audit.h:43
uint32_t offset
Absolute stored-stream offset.
Definition jof_audit.h:39
bool uniform
All decoded bytes have the same value.
Definition jof_audit.h:45
uint32_t content_hash
FNV-1a over decoded bytes.
Definition jof_audit.h:42
uint32_t payload
Exact decoded payload bytes.
Definition jof_audit.h:41
Exact caller-storage requirements derived from a parsed atlas.
Definition jof_audit.h:53
uint32_t scratch_bytes
Stored-stream scratch (zero for raw).
Definition jof_audit.h:56
uint32_t record_count
Record entries required.
Definition jof_audit.h:54
uint32_t tile_bytes
Decoded tile-buffer bytes required.
Definition jof_audit.h:55
Geometry plus anomaly counts emitted by a complete audit.
Definition jof_audit.h:78
uint32_t coverage_errors
Gap/overlap/order/end mismatches.
Definition jof_audit.h:81
jof_info_t info
Parsed atlas geometry.
Definition jof_audit.h:79
uint32_t geometry_errors
Decoded size disagreed with tile geometry.
Definition jof_audit.h:82
uint32_t decoded_tiles
Tiles decoded and hashed.
Definition jof_audit.h:80
uint32_t duplicate_candidates
Matching non-uniform hash/size evidence.
Definition jof_audit.h:83
Caller-owned buffers consumed by one audit.
Definition jof_audit.h:64
jof_audit_record_t * records
Tile record array.
Definition jof_audit.h:65
uint32_t tile_cap
Bytes available at tile.
Definition jof_audit.h:68
uint32_t record_cap
Entries available at records.
Definition jof_audit.h:66
uint32_t scratch_cap
Bytes available at scratch.
Definition jof_audit.h:70
uint8_t * tile
Reusable decoded tile.
Definition jof_audit.h:67
uint8_t * scratch
Reusable compressed staging.
Definition jof_audit.h:69
Parsed + validated geometry of one JOF atlas.
Definition jof.h:208