Struct MilkContext 

pub struct MilkContext {
    context: HashMapContext,
    hot: HotVars,
    q_vars: [f64; 64],
    q_values_mirror: [Value; 64],
    cold: ColdSlab,
}

Execution context containing all Milkdrop variables.

Fields

context: HashMapContext

Math function registry (sin, cos, gmegabuf, …). Cold variables no longer live here — they’re in ColdSlab for index-based access from the bytecode VM.

hot: HotVars

Hot per-point / per-vertex / per-shape scratch slots — see HotVars.

q_vars: [f64; 64]

q1..q64 channel storage. q_vars is the f64 fast path the bytecode VM addresses by index; q_values_mirror is kept in sync so evalexpr’s Context::get_value can return &Value.

q_values_mirror: [Value; 64]

cold: ColdSlab

Index-based slab for cold variables — used by the bytecode VM (resolved at compile time) and by the evalexpr API (resolved on every get_value/set_value call).

Implementations

impl MilkContext

pub fn new() -> Self

Create a new context with default values.

pub fn cold_intern(&mut self, name: &str) -> usize

Intern a cold-variable name into the slab and return its index. Called by the bytecode compiler so Op::LoadCold(idx) / Op::StoreCold(idx) can address the slot directly at run time.

pub fn cold_get_idx(&self, idx: usize) -> f64

Bytecode-VM fast path: read a cold-variable slot by index.

pub fn cold_set_idx(&mut self, idx: usize, val: f64)

Bytecode-VM fast path: write a cold-variable slot by index.

fn seed_cold_defaults(cold: &mut ColdSlab)

Pre-seed the cold slab with MD2’s documented default values. Mirrors the old init_defaults behaviour (which used to write into the HashMapContext) but routes the values through the slab so the bytecode VM and the evalexpr Context impls below see the same initial state.

pub fn set(&mut self, name: &str, value: f64)

Set a variable value.

pub fn get(&self, name: &str) -> Option<f64>

Get a variable value.

pub fn hot_get_idx(&self, idx: usize) -> f64

Bytecode-VM fast path: read a hot var by slot index (one of the HOT_* constants). One f64 array load — no enum-tag match.

pub fn hot_set_idx(&mut self, idx: usize, value: f64)

Bytecode-VM fast path: write a hot var by slot index. Updates the f64 array used by Self::hot_get_idx and the parallel Value mirror used by evalexpr’s Context::get_value contract.

pub fn q_get_idx(&self, idx: usize) -> f64

Bytecode-VM fast path: read q[idx] where idx is 0..63 (so q_get_idx(0) returns the value of q1).

pub fn q_set_idx(&mut self, idx: usize, value: f64)

Bytecode-VM fast path: write q[idx]. Updates the f64 array used by Self::q_get_idx and the parallel Value mirror used by evalexpr’s Context::get_value contract.

pub fn inner(&self) -> &HashMapContext

Get the internal evalexpr context (cold vars + math functions).

pub fn inner_mut(&mut self) -> &mut HashMapContext

Get a mutable reference to the internal evalexpr context. Most call sites should instead pass &mut MilkContext directly to evalexpr (the Context / ContextWithMutableVariables impls below route hot-path reads/writes to HotVars without a String alloc).

pub fn q_vars(&self) -> [f64; 64]

Get a snapshot of all 64 q variables as f64. The internal storage is [Value; 64] (to support evalexpr’s &Value return type for q-channel reads), so this conversion is on demand.

pub fn set_pixel(&mut self, x: f64, y: f64, rad: f64, ang: f64)

Set pixel position for per-pixel evaluation.

pub fn set_var(&mut self, name: &str, value: f64)

Set a variable (alias for set).

pub fn set_time(&mut self, time: f64)

Set time variable.

pub fn set_frame(&mut self, frame: f64)

Set frame variable.

pub fn set_audio(&mut self, bass: f64, mid: f64, treb: f64)

Set audio variables (bass, mid, treble).

pub fn get_var(&self, name: &str) -> Option<f64>

Get a variable value (alias for get).

Trait Implementations

impl Clone for MilkContext

fn clone(&self) -> MilkContext

Returns a duplicate of the value.

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

Performs copy-assignment from source.

impl Context for MilkContext

type NumericTypes = DefaultNumericTypes

The numeric types used for evaluation.

fn get_value(&self, identifier: &str) -> Option<&Value>

Returns the value that is linked to the given identifier.

fn call_function( &self, identifier: &str, argument: &Value, ) -> EvalexprResultValue

Calls the function that is linked to the given identifier with the given argument. If no function with the given identifier is found, this method returns EvalexprError::FunctionIdentifierNotFound.

fn are_builtin_functions_disabled(&self) -> bool

Checks if builtin functions are disabled.

fn set_builtin_functions_disabled( &mut self, disabled: bool, ) -> EvalexprResult<(), Self::NumericTypes>

Disables builtin functions if disabled is true, and enables them otherwise. If the context does not support enabling or disabling builtin functions, an error is returned.

impl ContextWithMutableVariables for MilkContext

fn set_value( &mut self, identifier: String, value: Value, ) -> EvalexprResult<(), Self::NumericTypes>

Sets the variable with the given identifier to the given value.

fn remove_value( &mut self, identifier: &str, ) -> EvalexprResult<Option<Value>, Self::NumericTypes>

Removes the variable with the given identifier from the context.

impl Debug for MilkContext

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

Formats the value using the given formatter.

impl Default for MilkContext

fn default() -> Self

Returns the “default value” for a type.