Skip to main content

qualia_core_db/audio/qac/signal/
encode.rs

1use super::*;
2use crate::q42::{
3    field_envelope::{EnvelopeInput, Family, StructuralView},
4    field_semantics,
5};
6/// Explicit candidate writer using caller-owned staging and final output. All
7/// bytes/metadata are preserved exactly. On every error final output is unchanged;
8/// staging may change and must never be published on error. No hidden allocation.
9pub fn encode(
10    input: EnvelopeInput<'_>,
11    envelope_limits: crate::q42::field_envelope::Limits,
12    shared_limits: field_semantics::Limits,
13    limits: Limits,
14    scratch: &mut field_semantics::Scratch<'_>,
15    staging: &mut [u8],
16    out: &mut [u8],
17) -> Result<usize, Error> {
18    if input.family != Family::QacV1Candidate {
19        return Err(Error::Unsupported);
20    }
21    let n = input.encoded_len(envelope_limits)?;
22    if out.len() < n {
23        return Err(Error::Envelope(crate::q42::field_envelope::Error::Extent));
24    }
25    let encoded = input.encode_into(staging, envelope_limits)?;
26    let view = StructuralView::open(encoded, Family::QacV1Candidate, envelope_limits)?;
27    admit(&view, 1, scratch, shared_limits, limits)?;
28    out[..n].copy_from_slice(encoded);
29    Ok(n)
30}