Struct MusicNoteComponent 

pub struct MusicNoteComponent {
    pub note: MusicNote,
    pub target_source: Option<ComponentRef>,
    pub target_resolved: Option<ComponentId>,
    pub scheduled_beat: Option<f64>,
    pub play_on_attach: bool,
    /* private fields */
}

Fields

note: MusicNote

target_source: Option<ComponentRef>

Pre-authored target audio source (audio_source per spec §6.4.1). Durable ref preserved through serde / MMS dump. target_resolved is the runtime cache filled by resolve_target. When both are None, dispatch falls back to ancestor-walk per docs/spec/audio-sources.md §6.6 rank 5 (the executor caches the result back here).

target_resolved: Option<ComponentId>

Runtime cache of the resolved target. Skipped by serde — fresh loads re-resolve from target_source (or ancestor walk) on first use, then this stays populated.

scheduled_beat: Option<f64>

Pre-authored default beat (scheduled_beat per spec §6.4.1). When None, .play() fires immediately (beat_offset = 0).

play_on_attach: bool

Fire AudioSchedulePlay automatically when this component initializes. Defaults to false — silent unless explicitly triggered.

Implementations

impl MusicNoteComponent

pub fn new(note: MusicNote) -> Self

pub fn from_note(note: MusicNote) -> Self

pub fn with_target_source(self, source: ComponentRef) -> Self

pub fn with_scheduled_beat(self, beat: f64) -> Self

pub fn with_play_on_attach(self, on: bool) -> Self

pub fn id(&self) -> Option<ComponentId>

pub fn resolve_target(&mut self, world: &mut World) -> Option<ComponentId>

Resolve a target for this note following the current runtime precedence: cached → explicit target_source (Guid/Query). Returns None when nothing resolves — the executor’s subtree / ancestor audio-source walk handles that case and writes the result back to target_resolved afterward.

Trait Implementations

impl Clone for MusicNoteComponent

fn clone(&self) -> MusicNoteComponent

Returns a duplicate of the value.

fn clone_from(&mut self, source: &Self)

Performs copy-assignment from source.

impl Component for MusicNoteComponent

fn set_id(&mut self, component: ComponentId)

fn name(&self) -> &'static str

Short debug/type name for this component kind (e.g. “transform”, “camera”).

fn as_any(&self) -> &dyn Any

fn as_any_mut(&mut self) -> &mut dyn Any

fn init(&mut self, emit: &mut dyn SignalEmitter, component: ComponentId)

Called when component is added to the World

fn to_mms_ast(&self, _world: &World) -> ComponentExpression

Encode this component as an MMS Component Expression AST node.

fn cleanup(&mut self, _emit: &mut dyn SignalEmitter, _component: ComponentId)

Called when component is removed from the World.

fn encode(&self) -> HashMap<String, Value>

Encode component data to a HashMap for serialization.

fn decode(&mut self, _data: &HashMap<String, Value>) -> Result<(), String>

Decode component data from a HashMap after deserialization.

impl Debug for MusicNoteComponent

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

Formats the value using the given formatter.

impl Default for MusicNoteComponent

fn default() -> Self

Returns the “default value” for a type.

impl<'de> Deserialize<'de> for MusicNoteComponent

fn deserialize<__D>(__deserializer: __D) -> Result<Self, __D::Error>

where __D: Deserializer<'de>,

Deserialize this value from the given Serde deserializer.

impl Serialize for MusicNoteComponent

fn serialize<__S>(&self, __serializer: __S) -> Result<__S::Ok, __S::Error>

where __S: Serializer,

Serialize this value into the given Serde serializer.