Up to date

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

MeshConvexDecompositionSettings

继承： RefCounted < Object

用于 Mesh 凸分解操作的参数。

描述

用于 Mesh 凸分解操作的参数。

属性

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

---

枚举

enum Mode:

Mode CONVEX_DECOMPOSITION_MODE_VOXEL = 0

常量，表示基于体素的近似凸分解。

Mode CONVEX_DECOMPOSITION_MODE_TETRAHEDRON = 1

常量，表示基于四面体的近似凸分解。

---

属性说明

bool convex_hull_approximation = true

• void set_convex_hull_approximation ( bool value )

• bool get_convex_hull_approximation ( )

如果启用，则在计算凸包时使用近似计算。

---

int convex_hull_downsampling = 4

• void set_convex_hull_downsampling ( int value )

• int get_convex_hull_downsampling ( )

控制凸包生成过程的精度，这个过程发生在选择裁剪平面的阶段。范围从 1 到 16。

---

float max_concavity = 1.0

• void set_max_concavity ( float value )

• float get_max_concavity ( )

最大凹度。范围从 0.0 到 1.0。

---

int max_convex_hulls = 1

• void set_max_convex_hulls ( int value )

• int get_max_convex_hulls ( )

合并操作能够产生的最大凸包数。

---

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 ( )

控制单个凸包的最大三角形数。范围从 4 到 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 ( )

控制生成凸包的自适应采样。范围从 0.0 到 0.01 。

---

Mode mode = 0

• void set_mode ( Mode value )

• Mode get_mode ( )

近似凸分解的模式。

---

bool normalize_mesh = false

• void set_normalize_mesh ( bool value )

• bool get_normalize_mesh ( )

如果启用，则会在应用凸分解前将网格归一化。

---

int plane_downsampling = 4

• void set_plane_downsampling ( int value )

• int get_plane_downsampling ( )

控制搜索“最佳”裁剪平面的颗粒度。范围从 1 到 16。

---

bool project_hull_vertices = true

• void set_project_hull_vertices ( bool value )

• bool get_project_hull_vertices ( )

如果启用，则项目会将凸包顶点输出到来源网格之上，提高结果的浮点数精度。

---

int resolution = 10000

• void set_resolution ( int value )

• int get_resolution ( )

体素化阶段生成的最大体素数量。

---

float revolution_axes_clipping_bias = 0.05

• void set_revolution_axes_clipping_bias ( float value )

• float get_revolution_axes_clipping_bias ( )

控制对沿回转轴裁剪的偏置。范围从 0.0 到 1.0 。

---

float symmetry_planes_clipping_bias = 0.05

• void set_symmetry_planes_clipping_bias ( float value )

• float get_symmetry_planes_clipping_bias ( )

控制对沿对称平面裁剪的偏置。范围从 0.0 到 1.0 。