Struct Surface 

pub struct Surface {
    pub vertices: Vec<DVec3>,
    pub vertex_colors: Vec<AlphaColor<Srgb>>,
    pub vertex_normals: Vec<DVec3>,
    pub triangle_indices: Vec<u32>,
    pub resolution: (u32, u32),
}

A parametric surface defined by pre-generated mesh data.

Vertices are stored in row-major order: points[i * nv + j] where i is the u-index and j is the v-index.

By default, vertex normals are all-zero, which causes flat shading. To enable smooth shading, call Self::with_smooth_normals or Self::update_smooth_normals to update the normals.

The vertices are expressed in the surface’s local space. To place or animate the surface with an external transform, wrap it in ranim_core::core_item::transformed::Transformed, commonly storing [ranim_core::glam::DAffine3] as the transform representation.

Fields

vertices: Vec<DVec3>

Vertices — nu * nv points in row-major order (local space).

vertex_colors: Vec<AlphaColor<Srgb>>

Per-vertex colors.

vertex_normals: Vec<DVec3>

Per-vertex normals for smooth shading. All-zero → flat shading.

triangle_indices: Vec<u32>

Triangle indices — 6 * (nu-1) * (nv-1) entries.

resolution: (u32, u32)

Grid resolution (nu, nv).

Implementations

impl Surface

pub fn from_uv_func( uv_func: impl Fn(f64, f64) -> DVec3, u_range: (f64, f64), v_range: (f64, f64), resolution: (u32, u32), ) -> Self

Construct a surface by sampling uv_func over a uniform grid.

u_range and v_range define the parameter domain. resolution (nu, nv) must each be >= 2.

pub fn with_vertex_colors(self, colors: Vec<AlphaColor<Srgb>>) -> Self

Set per-vertex colors. Returns self for chaining.

pub fn with_fill_by_z(self, colorscale: &[(AlphaColor<Srgb>, f64)]) -> Self

Set per-vertex colors by mapping the Z coordinate of each vertex through a colorscale.

colorscale is a list of (color, z_value) pairs sorted by ascending z_value. The vertex color is linearly interpolated between adjacent entries.

pub fn with_smooth_normals(self) -> Self

Update per-vertex normals to smooth shading. Returns self for chaining.

pub fn update_smooth_normals(&mut self) -> &mut Self

Update per-vertex normals to smooth shading.

Trait Implementations

impl<G: Into<DAffine3>> ApplyTransform<G> for Surface

fn apply(&mut self, transform: G) -> &mut Self

Bake transform (expressed in world coordinates) into the item’s data, in place.

impl Clone for Surface

fn clone(&self) -> Surface

Returns a duplicate of the value.

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

Performs copy-assignment from source.

impl Debug for Surface

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

Formats the value using the given formatter.

impl Extract for Surface

type Target = CoreItem

Extraction target.

fn extract_into(&self, buf: &mut Vec<Self::Target>)

Append extracted values to buf.

fn extract(&self) -> Vec<Self::Target>

Extract into a newly allocated vector.

impl FillColor for Surface

fn fill_color(&self) -> AlphaColor<Srgb>

Getting fill color of an item

fn set_fill_color(&mut self, color: AlphaColor<Srgb>) -> &mut Self

Setting fill color(rgba) of an item

fn set_fill_opacity(&mut self, opacity: f32) -> &mut Self

Setting fill opacity of an item

impl From<Sphere> for Surface

fn from(value: Sphere) -> Self

Converts to this type from the input type.

impl From<Surface> for MeshItem

fn from(value: Surface) -> Self

Converts to this type from the input type.

impl Interpolatable for Surface

fn lerp(&self, target: &Self, t: f64) -> Self

Lerping between values

impl Opacity for Surface

fn set_opacity(&mut self, opacity: f32) -> &mut Self

Setting opacity of an item

impl PartialEq for Surface

fn eq(&self, other: &Surface) -> bool

Equality operator ==.

fn ne(&self, other: &Rhs) -> bool

Inequality operator !=.

impl StructuralPartialEq for Surface