Struct MeshOneFormQuantity 

pub struct MeshOneFormQuantity { /* private fields */ }

A one-form quantity on a surface mesh.

Stores one scalar value per edge with orientation conventions. Rendered as arrows at edge midpoints, where the arrow direction is along the edge and length is proportional to the value.

Implementations

impl MeshOneFormQuantity

pub fn new( name: impl Into<String>, structure_name: impl Into<String>, values: Vec<f32>, orientations: Vec<bool>, ) -> Self

Creates a new one-form quantity.

pub fn values(&self) -> &[f32]

Returns the per-edge scalar values.

pub fn orientations(&self) -> &[bool]

Returns the edge orientation flags.

pub fn length_scale(&self) -> f32

Gets the length scale.

pub fn set_length_scale(&mut self, scale: f32) -> &mut Self

Sets the length scale.

pub fn radius(&self) -> f32

Gets the radius.

pub fn set_radius(&mut self, r: f32) -> &mut Self

Sets the radius.

pub fn color(&self) -> Vec4

Gets the color.

pub fn set_color(&mut self, c: Vec3) -> &mut Self

Sets the color.

pub fn compute_edge_vectors( &self, vertices: &[Vec3], edges: &[(u32, u32)], ) -> (Vec<Vec3>, Vec<Vec3>)

Convert edge scalars + orientations to vector field for rendering.

Returns (positions, vectors) — one arrow per edge at the edge midpoint. The vector direction is along the edge, scaled by the one-form value.

pub fn auto_scale( &mut self, structure_length_scale: f32, vertices: &[Vec3], edges: &[(u32, u32)], )

Auto-scales length and radius based on the structure’s bounding box diagonal.

pub fn init_gpu_resources( &mut self, device: &Device, bind_group_layout: &BindGroupLayout, camera_buffer: &Buffer, vertices: &[Vec3], edges: &[(u32, u32)], )

Initializes GPU resources for this vector quantity.

Computes edge midpoint positions and direction vectors from the mesh, then creates GPU buffers for arrow rendering.

pub fn render_data(&self) -> Option<&VectorRenderData>

Returns the render data if initialized.

pub fn update_uniforms(&self, queue: &Queue, model: &Mat4)

Updates GPU uniforms with the given model transform.

pub fn build_egui_ui(&mut self, ui: &mut Ui) -> bool

Builds the egui UI for this quantity.

Trait Implementations

impl Quantity for MeshOneFormQuantity

fn as_any(&self) -> &dyn Any

Returns a reference to self as Any for downcasting.

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

Returns a mutable reference to self as Any for downcasting.

fn name(&self) -> &str

Returns the name of this quantity.

fn structure_name(&self) -> &str

Returns the name of the parent structure.

fn kind(&self) -> QuantityKind

Returns the kind of this quantity.

fn is_enabled(&self) -> bool

Returns whether this quantity is currently enabled/visible.

fn set_enabled(&mut self, enabled: bool)

Sets the enabled state of this quantity.

fn build_ui(&mut self, _ui: &dyn Any)

Builds the ImGui UI controls for this quantity.

fn refresh(&mut self)

Refreshes GPU resources after data changes.

fn clear_gpu_resources(&mut self)

Clears GPU render resources so they can be re-initialized with a new device.

fn data_size(&self) -> usize

Returns the number of data elements.

impl EdgeQuantity for MeshOneFormQuantity