Struct SparqlMmHandler 

pub struct SparqlMmHandler<'a> {
    pub quins: &'a [NQuin],
    pub windows: [TimeWindow; 64],
    pub window_count: u8,
    pub media_fragments: [MediaFragment; 128],
    pub fragment_count: u8,
}

SPARQL-MM Media Handler

Fields

quins: &'a [NQuin]

windows: [TimeWindow; 64]

window_count: u8

media_fragments: [MediaFragment; 128]

fragment_count: u8

Implementations

impl<'a> SparqlMmHandler<'a>

pub fn new(quins: &'a [NQuin]) -> Self

pub fn make_media_fragment( media_uri: u64, dimensions: &[MediaFragmentDimension], ) -> Result<MediaFragment, String>

Build a media fragment from explicit dimensions (no hash-derived pseudo-parse).

Callers that only have a media URI hash must pass dimensions separately — inventing temporal/spatial ranges from hash bits is forbidden (design §6.3.6).

pub fn parse_media_fragment( &mut self, fragment_uri: u64, ) -> Result<MediaFragment, String>

Legacy entry: returns a fragment with media_uri only (no invented dimensions). Prefer make_media_fragment with explicit temporal/spatial/track dims.

pub fn pack_spatial_u64(x: u32, y: u32, width: u32, height: u32) -> u64

Pack xywh into a single object payload (same layout as vision pack_bbox family).

pub fn unpack_spatial_u64(v: u64) -> (u32, u32, u32, u32)

pub fn spatial_intersects( ax: u32, ay: u32, aw: u32, ah: u32, bx: u32, by: u32, bw: u32, bh: u32, ) -> bool

Axis-aligned box intersection (x,y,w,h).

pub fn media_time_ms(quin: &NQuin) -> Option<u64>

Media time from a quin that uses ma_ont::MEDIA_TIME_MS (object = ms), not the Lamport field in metadata.

pub fn get_ma_property( &self, media_uri: u64, predicate: u64, ) -> Result<u64, String>

Get MA Ontology property for a media resource

pub fn get_temporal_fragment( &self, media_uri: u64, ) -> Result<(u64, u64), String>

Get temporal fragment using MA Ontology

pub fn get_spatial_fragment( &self, media_uri: u64, ) -> Result<(u32, u32, u32, u32), String>

Get spatial fragment using MA Ontology

pub fn get_track_fragment(&self, media_uri: u64) -> Result<(u64, u32), String>

Get track fragment using MA Ontology

pub fn add_media_fragment( &mut self, fragment: MediaFragment, ) -> Result<u8, String>

Add a media fragment

pub fn create_tumbling_window( &mut self, size_ms: u64, start_ms: u64, ) -> Result<u8, String>

Create a tumbling time window

pub fn create_sliding_window( &mut self, size_ms: u64, slide_ms: u64, start_ms: u64, ) -> Result<u8, String>

Create a sliding time window

pub fn create_session_window( &mut self, gap_ms: u64, start_ms: u64, ) -> Result<u8, String>

Create a session window

pub fn query_window( &self, window_id: u8, _timestamp_field: u64, ) -> Result<Vec<&NQuin>, String>

Query quins within a time window (heap-compatible wrapper). Prefer query_window_into on hot paths.

pub fn query_window_into( &'a self, window_id: u8, out: &mut [Option<&'a NQuin>], ) -> Result<usize, String>

Caller-buffered window query. Uses media time when predicate == MEDIA_TIME_MS; otherwise falls back to metadata low 29 bits with the understanding that that path is Lamport-mixed (not pure media time).

pub fn query_media_fragment( &self, fragment_id: u8, ) -> Result<Vec<&NQuin>, String>

Query media fragment (heap wrapper). Prefer query_media_fragment_into.

pub fn query_media_fragment_into( &'a self, fragment_id: u8, out: &mut [Option<&'a NQuin>], ) -> Result<usize, String>

Caller-buffered media-fragment query with real spatial intersection.

pub fn get_media_duration(&self, media_uri: u64) -> Result<u64, String>

Get media duration using MA Ontology

pub fn get_media_dimensions(&self, media_uri: u64) -> Result<(u32, u32), String>

Get media dimensions using MA Ontology

pub fn get_media_format(&self, media_uri: u64) -> Result<u64, String>

Get media format using MA Ontology

pub fn get_media_mime_type(&self, media_uri: u64) -> Result<u64, String>

Get media MIME type using MA Ontology

pub fn get_media_codec(&self, media_uri: u64) -> Result<u64, String>

Get media codec using MA Ontology

pub fn get_media_bitrate(&self, media_uri: u64) -> Result<u64, String>

Get media bitrate using MA Ontology

pub fn get_media_framerate(&self, media_uri: u64) -> Result<u64, String>

Get media framerate using MA Ontology

pub fn get_credential(&self, media_uri: u64) -> Result<u64, String>

C2PA: Get content credential for media

pub fn get_manifest(&self, media_uri: u64) -> Result<u64, String>

C2PA: Get manifest for media

pub fn get_signature(&self, media_uri: u64) -> Result<u64, String>

C2PA: Get signature for media

pub fn get_provenance(&self, media_uri: u64) -> Result<u64, String>

C2PA: Get provenance for media

pub fn is_verified(&self, media_uri: u64) -> Result<bool, String>

C2PA: Check if media is cryptographically verified.

Honest policy: a stored isVerified=1 edge is not sufficient. Returns Ok(true) only when status is SignatureVerified or TrustChainEvaluated. Today this engine never reaches those levels → typically Ok(false) or Err.

pub fn c2pa_status( &self, media_uri: u64, ) -> Result<C2paVerificationStatus, String>

Honest verification ladder for C2PA (design §6.3.7).

pub fn get_verification_status(&self, media_uri: u64) -> Result<u64, String>

C2PA: Get verification status as u64 enum discriminant.

pub fn get_created_at(&self, media_uri: u64) -> Result<u64, String>

C2PA: Get creation timestamp

pub fn get_created_by(&self, media_uri: u64) -> Result<u64, String>

C2PA: Get creator

pub fn get_modified_at(&self, media_uri: u64) -> Result<u64, String>

C2PA: Get modification timestamp

pub fn get_modified_by(&self, media_uri: u64) -> Result<u64, String>

C2PA: Get modifier

pub fn get_tool(&self, media_uri: u64) -> Result<u64, String>

C2PA: Get tool used to create media

pub fn get_derived_from(&self, media_uri: u64) -> Result<u64, String>

C2PA: Get source asset (derived from)

pub fn get_component_of(&self, media_uri: u64) -> Result<u64, String>

C2PA: Get parent asset (component of)

pub fn get_components(&self, media_uri: u64) -> Result<Vec<u64>, String>

C2PA: Get component assets

pub fn verify_signature(&self, media_uri: u64) -> Result<bool, String>

C2PA: Verify content signature. Unsupported in this build — always returns Ok(false) if a signature edge exists (ParsedOnly), or Err if missing. Never claims crypto success.

pub fn window_aggregate( &self, window_id: u8, aggregate_fn: fn(&[&NQuin]) -> u64, ) -> Result<u64, String>

Aggregate over time window

Trait Implementations

impl<'a> Default for SparqlMmHandler<'a>

fn default() -> Self

Returns the “default value” for a type.