Skip to main content

SurfaceStyle3d

Struct SurfaceStyle3d 

Source
pub struct SurfaceStyle3d { /* private fields */ }
Expand description

Validated surface tint, alpha policy and projected face visibility.

Blend objects are sorted back-to-front by transformed model-bounds-center camera-forward distance, with insertion-order ties. This does not solve intersecting/cyclic overlap or triangle ordering inside one mesh. Blend surfaces do not occlude mathematical hidden-line edges; edges render last. Positive-scale transforms preserve source orientation; reflections are not accepted by Transform3d. Lighting and fog are explicit opt-ins; no physically based glass, shadows or automatic normals are implied.

Implementations§

Source§

impl SurfaceStyle3d

Source

pub fn opaque(color: Color) -> Result<Self, Mesh3dStyleError>

Creates the legacy normalized opaque tint, rejecting alpha other than one. Vertex/texture alpha is ignored by this surface mode, with depth writes.

Source

pub fn mask(color: Color, cutoff: f32) -> Result<Self, Mesh3dStyleError>

Creates alpha-cutout coverage with a cutoff that is zero or a normal finite value in 0..=1. Combined surface/vertex/texture/material alpha below cutoff is discarded; equality survives and writes alpha one/depth. Filtering happens before the comparison; no alpha-to-coverage or automatic coverage preservation.

Source

pub fn blend(color: Color) -> Result<Self, Mesh3dStyleError>

Creates normalized straight-linear RGBA blending with depth-test/no-write. Combined alpha zero produces no color coverage and never writes depth.

Source

pub const fn with_sidedness(self, sidedness: SurfaceSidedness3d) -> Self

Selects projected face culling without changing mathematical display edges.

Source

pub const fn with_lighting(self, lighting: SurfaceLighting3d) -> Self

Selects RGB illumination. Lambert requires application-supplied model normals. Two-sided back-facing fragments reverse the interpolated shading normal.

Source

pub const fn lighting(self) -> SurfaceLighting3d

Returns illumination policy; Unlit is the default and bypasses normal math.

Source

pub const fn with_fog(self, enabled: bool) -> Self

Selects scene fog participation independently of lighting; disabled by default.

Source

pub const fn fog_enabled(self) -> bool

Returns explicit participation in optional scene fog.

Source

pub const fn color(self) -> Color

Returns the normalized straight-linear multiplicative RGBA tint.

Source

pub const fn alpha_mode(self) -> SurfaceAlphaMode3d

Returns the surface coverage/depth mode.

Source

pub const fn mask_cutoff(self) -> Option<f32>

Returns the alpha cutoff only for masked surfaces.

Source

pub const fn sidedness(self) -> SurfaceSidedness3d

Returns viewer-relative face visibility; defaults to both sides.

Trait Implementations§

Source§

impl Clone for SurfaceStyle3d

Source§

fn clone(&self) -> SurfaceStyle3d

Returns a duplicate of the value. Read more
1.0.0 (const: unstable) · Source§

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

Performs copy-assignment from source. Read more
Source§

impl Copy for SurfaceStyle3d

Source§

impl Debug for SurfaceStyle3d

Source§

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

Formats the value using the given formatter. Read more
Source§

impl PartialEq for SurfaceStyle3d

Source§

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

Equality operator ==. Read more
1.0.0 (const: unstable) · Source§

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

Inequality operator !=. Read more
Source§

impl StructuralPartialEq for SurfaceStyle3d

Auto Trait Implementations§

Blanket Implementations§

Source§

impl<T> Any for T
where T: 'static + ?Sized,

Source§

fn type_id(&self) -> TypeId

Gets the TypeId of self. Read more
Source§

impl<T> Borrow<T> for T
where T: ?Sized,

Source§

fn borrow(&self) -> &T

Immutably borrows from an owned value. Read more
Source§

impl<T> BorrowMut<T> for T
where T: ?Sized,

Source§

fn borrow_mut(&mut self) -> &mut T

Mutably borrows from an owned value. Read more
Source§

impl<ST, DT> CastableFrom<ST, Initialized, Initialized> for DT
where ST: ?Sized, DT: ?Sized,

Source§

impl<ST, DT> CastableFrom<ST, Uninit, Uninit> for DT
where ST: ?Sized, DT: ?Sized,

Source§

impl<T> CloneToUninit for T
where T: Clone,

Source§

unsafe fn clone_to_uninit(&self, dest: *mut u8)

🔬This is a nightly-only experimental API. (clone_to_uninit)
Performs copy-assignment from self to dest. Read more
Source§

impl<T> Downcast<T> for T

Source§

fn downcast(&self) -> &T

Source§

impl<T> From<T> for T

Source§

fn from(t: T) -> T

Returns the argument unchanged.

Source§

impl<T, U> Into<U> for T
where U: From<T>,

Source§

fn into(self) -> U

Calls U::from(self).

That is, this conversion is whatever the implementation of From<T> for U chooses to do.

Source§

impl<T> Read<Exclusive, BecauseExclusive> for T
where T: ?Sized,

Source§

impl<T> ToOwned for T
where T: Clone,

Source§

type Owned = T

The resulting type after obtaining ownership.
Source§

fn to_owned(&self) -> T

Creates owned data from borrowed data, usually by cloning. Read more
Source§

fn clone_into(&self, target: &mut T)

Uses borrowed data to replace owned data, usually by cloning. Read more
Source§

impl<T, U> TryFrom<U> for T
where U: Into<T>,

Source§

type Error = !

The type returned in the event of a conversion error.
Source§

fn try_from(value: U) -> Result<T, !>

Performs the conversion.
Source§

impl<T, U> TryInto<U> for T
where U: TryFrom<T>,

Source§

type Error = <U as TryFrom<T>>::Error

The type returned in the event of a conversion error.
Source§

fn try_into(self) -> Result<U, <U as TryFrom<T>>::Error>

Performs the conversion.
Source§

impl<T> Upcast<T> for T

Source§

fn upcast(&self) -> Option<&T>

Source§

impl<T> WasmNotSend for T
where T: Send,

Source§

impl<T> WasmNotSendSync for T

Source§

impl<T> WasmNotSync for T
where T: Sync,