Skip to main content

qualia_core_db/audio/qac/metadata/
mod.rs

1//! Signal metadata tables with CONTROL-approved schema210 allocation.
2mod registry;
3mod transform;
4use crate::q42::{
5    field_envelope::{Block, Field},
6    field_semantics::{self as sem, FieldRule},
7};
8pub use registry::{SignalRegistry, SHAPE_SCHEMA, SIGNAL_SCHEMA, TRANSFORM_SCHEMA};
9pub use transform::{FrequencyOffset, OriginBasis, Transform, TransformKind, WindowKind};
10pub(crate) const fn r(key: u16, tag: u8, count: Option<u32>, required: bool) -> FieldRule {
11    FieldRule {
12        key,
13        type_tag: tag,
14        count,
15        required,
16    }
17}
18pub(crate) fn get<'a>(b: Block<'a>, key: u16) -> Result<Field<'a>, sem::Error> {
19    sem::field(b, key).ok_or(sem::Error::MissingField)
20}
21pub(crate) fn u32v(b: Block<'_>, key: u16) -> Result<u32, sem::Error> {
22    let f = get(b, key)?;
23    if ![1, 8, 9].contains(&f.type_tag()) || f.value().len() != 4 {
24        return Err(sem::Error::FieldType);
25    }
26    Ok(u32::from_le_bytes(f.value().try_into().unwrap()))
27}
28pub(crate) fn u64v(b: Block<'_>, key: u16) -> Result<u64, sem::Error> {
29    let f = get(b, key)?;
30    if ![2, 3].contains(&f.type_tag()) || f.value().len() != 8 {
31        return Err(sem::Error::FieldType);
32    }
33    Ok(u64::from_le_bytes(f.value().try_into().unwrap()))
34}
35pub(crate) fn f64v(b: Block<'_>, key: u16) -> Result<f64, sem::Error> {
36    let f = get(b, key)?;
37    if f.type_tag() != 5 || f.value().len() != 8 {
38        return Err(sem::Error::FieldType);
39    }
40    Ok(f64::from_le_bytes(f.value().try_into().unwrap()))
41}
42pub(crate) fn text<'a>(b: Block<'a>, key: u16) -> Result<&'a str, sem::Error> {
43    let f = get(b, key)?;
44    if f.type_tag() != 6 {
45        return Err(sem::Error::FieldType);
46    }
47    let s = std::str::from_utf8(f.value()).map_err(|_| sem::Error::Value)?;
48    if s.is_empty() || s.chars().any(char::is_control) {
49        return Err(sem::Error::Value);
50    }
51    Ok(s)
52}