Up to date

This page is up to date for Godot 4.2. If you still find outdated information, please open an issue.

MeshConvexDecompositionSettings

Inherits: RefCounted < Object

Parameters to be used with a Mesh convex decomposition operation.

Description

Parameters to be used with a Mesh convex decomposition operation.

Properties

bool	convex_hull_approximation	true
int	convex_hull_downsampling	4
float	max_concavity	1.0
int	max_convex_hulls	1
int	max_num_vertices_per_convex_hull	32
float	min_volume_per_convex_hull	0.0001
Mode	mode	0
bool	normalize_mesh	false
int	plane_downsampling	4
bool	project_hull_vertices	true
int	resolution	10000
float	revolution_axes_clipping_bias	0.05
float	symmetry_planes_clipping_bias	0.05

---

Enumerations

enum Mode:

Mode CONVEX_DECOMPOSITION_MODE_VOXEL = 0

Constant for voxel-based approximate convex decomposition.

Mode CONVEX_DECOMPOSITION_MODE_TETRAHEDRON = 1

Constant for tetrahedron-based approximate convex decomposition.

---

Property Descriptions

bool convex_hull_approximation = true

• void set_convex_hull_approximation ( bool value )

• bool get_convex_hull_approximation ( )

If enabled uses approximation for computing convex hulls.

---

int convex_hull_downsampling = 4

• void set_convex_hull_downsampling ( int value )

• int get_convex_hull_downsampling ( )

Controls the precision of the convex-hull generation process during the clipping plane selection stage. Ranges from 1 to 16.

---

float max_concavity = 1.0

• void set_max_concavity ( float value )

• float get_max_concavity ( )

Maximum concavity. Ranges from 0.0 to 1.0.

---

int max_convex_hulls = 1

• void set_max_convex_hulls ( int value )

• int get_max_convex_hulls ( )

The maximum number of convex hulls to produce from the merge operation.

---

int max_num_vertices_per_convex_hull = 32

• void set_max_num_vertices_per_convex_hull ( int value )

• int get_max_num_vertices_per_convex_hull ( )

Controls the maximum number of triangles per convex-hull. Ranges from 4 to 1024.

---

float min_volume_per_convex_hull = 0.0001

• void set_min_volume_per_convex_hull ( float value )

• float get_min_volume_per_convex_hull ( )

Controls the adaptive sampling of the generated convex-hulls. Ranges from 0.0 to 0.01.

---

Mode mode = 0

• void set_mode ( Mode value )

• Mode get_mode ( )

Mode for the approximate convex decomposition.

---

bool normalize_mesh = false

• void set_normalize_mesh ( bool value )

• bool get_normalize_mesh ( )

If enabled normalizes the mesh before applying the convex decomposition.

---