Struct WireframeMaterial 

pub struct WireframeMaterial {
    pub color: LinearRgba,
    pub line_width: f32,
}

A material that renders geometry as a wireframe for debugging and editor visualization.

Wireframe materials are essential for debug views, editor gizmos, and understanding the underlying geometry of meshes. This material will integrate with the future EditorGizmo RenderLane (issue #167) and is designed for development and debugging, not production rendering.

Performance Note

Wireframe rendering typically requires either:

• A geometry shader to generate line primitives
• Barycentric coordinates in the fragment shader

The exact implementation will depend on the graphics backend capabilities. This material is intended for debug/editor contexts where performance is less critical.

Examples

use khora_core::asset::WireframeMaterial;
use khora_core::math::LinearRgba;

// Create a green wireframe for debug visualization
let debug_wireframe = WireframeMaterial {
    color: LinearRgba::new(0.0, 1.0, 0.0, 1.0),
    line_width: 1.5,
};

// Create a thin white wireframe for mesh inspection
let mesh_inspector = WireframeMaterial {
    color: LinearRgba::new(1.0, 1.0, 1.0, 1.0),
    line_width: 1.0,
};

Fields

color: LinearRgba

The color of the wireframe lines.

This color is used for all edges of the geometry. Typically bright colors like green, cyan, or white are used for maximum visibility against the scene.

line_width: f32

The width of the wireframe lines in pixels.

Note that line width support varies by platform and graphics backend:

• Vulkan: Limited support for line widths other than 1.0
• Metal/DX12: Good support for varying line widths
• WebGPU: Limited to 1.0 pixel lines

For maximum compatibility, use 1.0. The rendering system may clamp this value based on backend capabilities.

Trait Implementations

impl<'__de, __Context> BorrowDecode<'__de, __Context> for WireframeMaterial

fn borrow_decode<__D: BorrowDecoder<'__de, Context = __Context>>( decoder: &mut __D, ) -> Result<Self, DecodeError>

Attempt to decode this type with the given BorrowDecode.

impl Clone for WireframeMaterial

fn clone(&self) -> WireframeMaterial

Returns a duplicate of the value.

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

Performs copy-assignment from source.

impl Debug for WireframeMaterial

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

Formats the value using the given formatter.

impl<__Context> Decode<__Context> for WireframeMaterial

fn decode<__D: Decoder<Context = __Context>>( decoder: &mut __D, ) -> Result<Self, DecodeError>

Attempt to decode this type with the given Decode.

impl Default for WireframeMaterial

fn default() -> Self

Returns the “default value” for a type.

impl<'de> Deserialize<'de> for WireframeMaterial

fn deserialize<__D>(__deserializer: __D) -> Result<Self, __D::Error>

where __D: Deserializer<'de>,

Deserialize this value from the given Serde deserializer.

impl Encode for WireframeMaterial

fn encode<__E: Encoder>(&self, encoder: &mut __E) -> Result<(), EncodeError>

Encode a given type.

impl Material for WireframeMaterial

fn base_color(&self) -> LinearRgba

Returns the base color (albedo or diffuse) of the material. Default implementation is White.

fn emissive_color(&self) -> LinearRgba

Returns the emissive color of the material. Default implementation is Black.

fn specular_power(&self) -> f32

Returns the specular power or roughness conversion for the material. Default implementation is 32.0.

fn ambient_color(&self) -> LinearRgba

Returns the ambient color modifier for the material. Default implementation is (0.1, 0.1, 0.1, 0.0).

fn metallic(&self) -> f32

Returns the metallic factor (0.0 = dielectric, 1.0 = metal). Default implementation is 0.0.

fn roughness(&self) -> f32

Returns the roughness factor (0.0 = smooth, 1.0 = rough). Default implementation is 1.0.

fn base_color_texture(&self) -> Option<AssetUUID>

Returns the UUID of the base-color (albedo) texture, if any. Default implementation is None (untextured).

fn metallic_roughness_texture(&self) -> Option<AssetUUID>

Returns the UUID of the metallic-roughness texture, if any (glTF convention: B=metallic, G=roughness). Default implementation is None.

fn normal_map(&self) -> Option<AssetUUID>

Returns the UUID of the tangent-space normal map, if any. Default implementation is None.

fn emissive_texture(&self) -> Option<AssetUUID>

Returns the UUID of the emissive texture, if any. Default implementation is None.

fn occlusion_map(&self) -> Option<AssetUUID>

Returns the UUID of the ambient-occlusion map, if any (red channel). Attenuates the indirect (ambient/IBL) term only, never direct light. Default implementation is None.

fn alpha_mode(&self) -> AlphaMode

Returns the material’s alpha (transparency) mode. For AlphaMode::Mask the contained value is the alpha-cutoff threshold: fragments below it are discarded. Default implementation is AlphaMode::Opaque.

fn double_sided(&self) -> bool

Whether the material is rendered double-sided (back faces not culled). false (the default) culls back faces for correctly-wound meshes.

impl Serialize for WireframeMaterial

fn serialize<__S>(&self, __serializer: __S) -> Result<__S::Ok, __S::Error>

where __S: Serializer,

Serialize this value into the given Serde serializer.

impl Asset for WireframeMaterial