Struct CoordinateEditor 

pub struct CoordinateEditor { /* private fields */ }

A private coordinate copy that becomes a new structure only on commit.

The original structure remains immutable and every view into it stays valid. Dropping an editor discards the transaction.

Implementations

impl CoordinateEditor

pub fn positions_mut(&mut self, model: ModelIndex) -> Option<&mut [[f32; 3]]>

Mutable positions of one dense model.

Ragged models are independent structures and must be edited through the corresponding value returned by Structure::ragged_models.

pub fn try_positions_mut( &mut self, model: ModelIndex, ) -> Result<&mut [[f32; 3]], Diagnostic>

Mutable positions of one dense model, with a diagnostic on failure.

This is the fallible form for callers that must preserve molframe’s diagnostic contract across an FFI boundary.

Errors

Returns E6003 when model is not a dense frame of this structure.

pub fn commit(self) -> Result<Structure, Vec<Diagnostic>>

Validates the transaction and returns a new immutable snapshot.

Errors

Returns every violated structural invariant. The original snapshot is unaffected whether the commit succeeds or fails.

pub fn snapshot(&self) -> Result<Structure, Vec<Diagnostic>>

Builds a validated snapshot that shares the editor’s coordinate buffer.

Nothing is copied, so the snapshot and the editor see the same coordinates: use it only when the editor is not written to afterwards. A caller that keeps a writable view of the buffer must use Self::snapshot_detached.

Errors

Returns every violated structural invariant.

impl CoordinateEditor

pub fn snapshot_detached( &self, context: &ExecutionContext, ) -> Result<Structure, Vec<Diagnostic>>

Builds a validated snapshot with a coordinate buffer of its own.

The copy is charged to context’s memory budget before anything is allocated. Writing to the editor, or to a foreign view of its buffer, afterwards cannot change the published structure.

Errors

Returns a memory diagnostic when the copy does not fit the budget, or every violated structural invariant.

Trait Implementations

impl Debug for CoordinateEditor

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

Formats the value using the given formatter.