Struct ark_api::world::WorldMesh

pub struct WorldMesh { /* private fields */ }

Represents a reference to a mesh registered with the world.

Implementations

impl WorldMesh

pub fn create(mesh: Mesh) -> Self

Creates a WorldMesh from the passed-in raw mesh data.

pub fn create_with_material(mesh: Mesh, material: WorldMaterial) -> Self

Creates a WorldMesh from the passed-in raw mesh data.

pub fn create_from_gltf( debug_name: &str, gltf_data: &[u8], buffer_data: &[u8], flags: GltfFlags ) -> Self

Creates a WorldMesh from GLTF data and additional buffer data. Supports .gltf and .glb, and a single additional buffer file.

pub fn create_from_gltf_resource( debug_name: &str, gltf_resource: ResourceHandleRepr, buffer_resource: Option<ResourceHandleRepr>, flags: GltfFlags ) -> Self

Creates a WorldMesh from a GLTF resource handle and additional buffer resource handle

pub fn get_properties(&self) -> MeshProperties

Gets some properties of the mesh, such as its internal bounding box and sphere.

pub fn get_morph_target_names(&self) -> Vec<String>

Gets the names of all morph target associated with the mesh.

It is recommended to store the return value instead of calling it every frame.

pub fn get_material_descs(&self) -> Vec<MaterialDesc>

Obtain all materials associated with the mesh.

It is recommended to store the return value instead of calling it every frame.

pub fn get_material_descs_with_names( &self ) -> Vec<(Option<String>, MaterialDesc)>

Obtain all materials and their name associated with the mesh.

It is recommended to store the return value instead of calling it every frame.

pub fn get_dominant_colors_with_area(&self) -> Vec<(ColorRgba8, f32)>

Get the dominant vertex colors of each mesh section and the area they occupy in vertex space

A mesh section is a part of the mesh that has its own material index.

pub fn get_section_material_index(&self, section_idx: usize) -> usize

Get the material index assigned to a mesh section

pub fn set_debug_name(&self, name: &str)

Sets a debug name of this data object. Useful for debugging memory usage and leaks.

pub fn as_ffi(&self) -> DataHandle

Gets the DataHandle of this mesh.

pub fn from_ffi(handle: DataHandle) -> Self

Adopts a raw data handle and increases its ref count.

pub fn try_from_ffi(handle: DataHandle) -> Option<Self>

Adopts a raw data handle and increases its ref count if it is a valid data object.

pub fn is_valid(&self) -> bool

Returns true if this is a valid mesh. This should always be the case unless something has gone very wrong, such as the case where a user created this object from

pub fn simplify( &self, threshold: f32, target_error: f32, min_triangle_count: u32, max_triangle_count: u32, flags: MeshSimplifiedFlags ) -> Self

Returns this mesh as a simplified WorldMesh using target_error and threshold parameters. threshold meaning what percentage (0-1) of the original primitives it should keep. target_error is an approximate measure of the deviation from the original mesh using distance normalized to 0..1 (so 1e-2f means that simplifier will try to maintain the error to be below 1% of the mesh extents). Note that because of topological restrictions and error bounds simplifier isn’t guaranteed to reach the target index count and can stop earlier. min_triangle_count and max_triangle_count can be used instead of threshold or in conjunction to define a minimum limit and maximum budget. If this range is outside of the number of triangles for the mesh no simplification will be done (target triangle count will be equal to the amount of triangles in the mesh)

pub fn simplify_to_num_triangles( &self, target_triangle_count: u32, max_error: f32, flags: MeshSimplifiedFlags ) -> Self

Returns a new mesh simplified to target_triangle_count, as long as it can keep the error below max_error. max_error is an approximate measure of the deviation from the original mesh using distance normalized to 0..1 (so 1e-2f means that simplifier will try to maintain the error to be below 1% of the mesh extents).

pub fn simplify_to_error( &self, target_error: f32, flags: MeshSimplifiedFlags ) -> Self

Returns a new mesh simplified as much as it can while not exceeding target_error. target_error is an approximate measure of the deviation from the original mesh using distance normalized to 0..1 (so 1e-2f means that simplifier will try to maintain the error to be below 1% of the mesh extents).

Trait Implementations

impl Clone for WorldMesh

fn clone(&self) -> WorldMesh

Returns a copy of the value.

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

Performs copy-assignment from source.

impl Debug for WorldMesh

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

Formats the value using the given formatter.

impl Hash for WorldMesh

fn hash<__H: Hasher>(&self, state: &mut __H)

Feeds this value into the given Hasher.

fn hash_slice<H>(data: &[Self], state: &mut H)where H: Hasher, Self: Sized,

Feeds a slice of this type into the given Hasher.

impl PartialEq<WorldMesh> for WorldMesh

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

This method tests for self and other values to be equal, and is used by ==.

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

This method tests for !=. The default implementation is almost always sufficient, and should not be overridden without very good reason.

impl ValueConverterTrait<WorldMesh> for ValueConverter

fn into_value(v: WorldMesh) -> Value

Wraps the passed-in value in a Value enum.

fn from_value(v: &Value) -> WorldMesh

Extracts the value from a Value enum.

impl Eq for WorldMesh

impl StructuralEq for WorldMesh

impl StructuralPartialEq for WorldMesh