qualia_core_db/audio/qac/metadata/
mod.rs1mod 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}