Expand description
Public Bitneedle BRD1 descriptor wire-format and decoding primitives.
This crate is the authoritative BRD1 carrier-descriptor wire contract. It describes how the record stream is located and encoded in the PNG carrier. It does not define BRS1 payload-entry semantics, programme-time revolution duration, track timing, GAP timing, or the relationship between payload entries and programme revolutions.
It contains no JSON descriptor segments, no Brotli compatibility envelopes, no base64/hex wire representations, and no record-creation policy.
Structs§
- Descriptor
Prefix - Record
Descriptor - Decoded BRD1 carrier descriptor.
- Resolved
Tone Span - Signed
Release Reference - One blanket signed-release reference covering the release commitment
(see
record_core::commitment::release_commitment). SHA-256 and Ed25519 are fixed bySIGNED_RELEASE_REFERENCE_VERSION; there is no per-reference algorithm selector. - Tone
Span Descriptor
Enums§
Constants§
- METADATA_
GRAYSCALE_ NIBBLE_ BASE - PAYLOAD_
ENCODING_ RGB - PAYLOAD_
ENCODING_ RGB_ CODE - PAYLOAD_
ENCODING_ TONED_ V1 - PAYLOAD_
ENCODING_ TONED_ V1_ CODE - RECORD_
DESCRIPTOR_ MAGIC - RECORD_
DESCRIPTOR_ PREFIX_ LENGTH - RECORD_
DESCRIPTOR_ VERSION - RECORD_
PROFILE_ LP - RECORD_
PROFILE_ LP_ CODE - RECORD_
PROFILE_ SINGL E45 - RECORD_
PROFILE_ SINGL E45_ CODE - RELEASE_
ID_ LENGTH - SEGMENT_
ARTIST - SEGMENT_
ARTWORK_ CREDIT - SEGMENT_
BSC_ POINTER - SEGMENT_
CANONICAL_ URL - SEGMENT_
CATALOG_ NUMBER - SEGMENT_
CREATED_ AT - SEGMENT_
DESCRIPTOR_ CRC32 - SEGMENT_
LABEL - SEGMENT_
PAYLOAD_ ENCODING - SEGMENT_
RECORD_ PROFILE - SEGMENT_
RELEASE_ ID - SEGMENT_
SIGNED_ RELEASE_ REFERENCE - SEGMENT_
STREAM_ BYTE_ LENGTH - SEGMENT_
TITLE - SEGMENT_
TONED_ CARRIER_ MAP - SIGNED_
RELEASE_ REFERENCE_ HASH_ LENGTH - SIGNED_
RELEASE_ REFERENCE_ MAX_ KEY_ ID_ LENGTH - SIGNED_
RELEASE_ REFERENCE_ SIGNATURE_ LENGTH - SIGNED_
RELEASE_ REFERENCE_ VERSION - Fixed by the BRD1 v2 format: release commitments are always SHA-256, signatures are always Ed25519. No per-reference algorithm selector.
- TONED_
CARRIER_ MAP_ VERSION - TONED_
MAX_ BITS_ PER_ PIXEL - TONED_
MAX_ SPAN_ COUNT - TONED_
MIN_ BITS_ PER_ PIXEL - TONED_
ORDERING_ BASE_ PROXIMITY - TONED_
ORDERING_ CHROMA_ PROXIMITY
Functions§
- compute_
descriptor_ crc32 - decode_
descriptor_ prefix - decode_
record_ descriptor_ bytes - decode_
signed_ release_ reference - decode_
toned_ carrier_ map - encode_
toned_ carrier_ map - metadata_
byte_ capacity_ for_ pixel_ count - metadata_
bytes_ from_ grayscale_ rgba - metadata_
pixel_ count_ for_ byte_ length - payload_
encoding_ code - payload_
encoding_ from_ code - record_
profile_ code - record_
profile_ from_ code - release_
id_ to_ bytes - Parse a canonical
rel_-tagged ULID string into its 16 raw bytes. - release_
id_ to_ text - Format 16 raw release ULID bytes back into the canonical
rel_-tagged display string. - resolve_
tone_ spans - toned_
pixel_ count - validate_
tone_ span