Struct SamplePanel 

pub struct SamplePanel {
    pub attack: Level,
    pub decay_release: Level,
    pub number: u8,
    pub id: SampleRef,
    pub dynamics: RangedU8<3>,
    pub filter: bool,
    /* private fields */
}

The sample panel: which sample plays, its envelope, and its level.

Unclaimed bits, kept verbatim through a re-encode: 57..=63.

The body’s map, in offset order:

bytes	bits	field	type
0x00 bits 7..1	0..=6	attack	Level
0x00 bit 0; 0x01 bits 7..2	7..=13	decay_release	Level
0x01 bits 1..0; 0x02 bits 7..2	14..=21	number	u8
0x02 bits 1..0; 0x03 bits 7..0; 0x04 bits 7..0; 0x05 bits 7..0; 0x06 bits 7..2	22..=53	id	SampleRef
0x06 bits 1..0	54..=55	dynamics	RangedU8<3>
0x07 bit 7	56..=56	filter	bool
0x07 bits 6..0	57..=63	—	unclaimed

Fields

attack: Level

Bits 0..=6 (byte 0x00, bits 7..1).

decay_release: Level

Bits 7..=13 (byte 0x00, bit 0; byte 0x01, bits 7..2).

number: u8

Zero-based slot in the instrument’s Samp Lib — the panel number minus one. A position, not an identity: adding or deleting samples renumbers it. Use id to resolve the dependency.

Bits 14..=21 (byte 0x01, bits 1..0; byte 0x02, bits 7..2).

id: SampleRef

The sample (.nsmp) this program depends on, laid out exactly as [PianoPanel::id].

Bits 22..=53 (byte 0x02, bits 1..0; byte 0x03, bits 7..0; byte 0x04, bits 7..0; byte 0x05, bits 7..0; byte 0x06, bits 7..2).

dynamics: RangedU8<3>

Bits 54..=55 (byte 0x06, bits 1..0).

filter: bool

Bits 56..=56 (byte 0x07, bit 7).

Implementations

impl SamplePanel

pub fn field_values(&self) -> Vec<FieldValue>

Every registered field’s current value, under its full path, in declaration order — nested bodies inline where their field sits. Describes the same fields as Self::field_specs, so callers may zip the two positionally.

pub fn field_specs() -> Vec<FieldSpec>

pub fn fields(&self) -> Vec<Field>

Every settable field, described under its full path.

pub fn set_field(&mut self, path: &str, value: &str) -> Result<(), FieldError>

Set one field by its full path.

Trait Implementations

impl Body for SamplePanel

const LEN: Option<u64>

Fixed body length, when the format has one; checked on read and write.

fn read<R: Read + Seek>( r: &mut BodyReader<'_, R>, _: &Header, ) -> Result<Self, Error>

Decode from r, which is scoped to the body: position 0 is the first body byte and BodyReader::len is known. header is for version gating and location/aux interpretation, not for layout — the container already consumed the header bytes.

fn write<W: Write + Seek>(&self, w: &mut BodyWriter<'_, W>) -> Result<(), Error>

Encode to w in one forward pass.

impl BodyLayout for SamplePanel

fn layout() -> &'static [LayoutField]

Every placed field, in declaration order. Bits no field claims are preserved by the codec but have no entry here — there is no name to report them under.

impl Debug for SamplePanel

The decoded values; the backing bytes are not printed.

fn fmt(&self, f: &mut Formatter<'_>) -> Result

Formats the value using the given formatter.

impl Default for SamplePanel

fn default() -> SamplePanel

Returns the “default value” for a type.

impl From<&SamplePanel> for [u8; 8]

fn from(p: &SamplePanel) -> Self

Converts to this type from the input type.

impl TryFrom<[u8; 8]> for SamplePanel

type Error = ParseError

The type returned in the event of a conversion error.

fn try_from(raw: [u8; 8]) -> Result<Self, Self::Error>

Performs the conversion.