Attention: Here be dragons

This is the latest (unstable) version of this documentation, which may document features not available in or compatible with released stable versions of Godot.

Checking the stable version of the documentation...

OpenXRRenderModelExtension

继承： OpenXRExtensionWrapper < Object

这个类实现了 OpenXR 渲染模型扩展。

描述

这个类实现了 OpenXR 渲染模型扩展，启用后会维护活动渲染模型列表，提供渲染模型数据接口。

方法

bool	is_active() const
RID	render_model_create(render_model_id: int)
void	render_model_destroy(render_model: RID)
Array[RID]	render_model_get_all()
int	render_model_get_animatable_node_count(render_model: RID) const
String	render_model_get_animatable_node_name(render_model: RID, index: int) const
Transform3D	render_model_get_animatable_node_transform(render_model: RID, index: int) const
TrackingConfidence	render_model_get_confidence(render_model: RID) const
Transform3D	render_model_get_root_transform(render_model: RID) const
PackedStringArray	render_model_get_subaction_paths(render_model: RID)
String	render_model_get_top_level_path(render_model: RID) const
bool	render_model_is_animatable_node_visible(render_model: RID, index: int) const
Node3D	render_model_new_scene_instance(render_model: RID) const

信号

render_model_added(render_model: RID) 🔗

添加新的渲染模型时发出。

render_model_removed(render_model: RID) 🔗

移除渲染模型时发出。

render_model_top_level_path_changed(render_model: RID) 🔗

与渲染模型关联的顶层路径发生改变时发出。

方法说明

bool is_active() const 🔗

如果支持且已启用 OpenXR 的渲染模型，则返回 true。

注意：这仅在 OpenXR 已被初始化后返回一个有效值。

RID render_model_create(render_model_id: int) 🔗

在 OpenXR 中使用渲染模型 ID 创建一个渲染模型对象。

注意：该函数是为提供渲染模型 ID 的依赖 OpenXR 扩展公开的，以便与渲染模型扩展一起使用。

void render_model_destroy(render_model: RID) 🔗

销毁在 OpenXR 中之前使用 render_model_create() 创建的渲染模型对象。

注意：该函数是为提供渲染模型 ID 的依赖 OpenXR 扩展公开的，以便与渲染模型扩展一起使用。

Array[RID] render_model_get_all() 🔗

返回已向该扩展注册的所有当前活动的渲染模型数组。

int render_model_get_animatable_node_count(render_model: RID) const 🔗

返回该渲染模型中包含的可动画节点数。

String render_model_get_animatable_node_name(render_model: RID, index: int) const 🔗

返回给定可动画节点的名称。

Transform3D render_model_get_animatable_node_transform(render_model: RID, index: int) const 🔗

返回可动画节点的当前局部变换。每帧都会更新。

TrackingConfidence render_model_get_confidence(render_model: RID) const 🔗

返回渲染模型跟踪数据的跟踪置信度。

Transform3D render_model_get_root_transform(render_model: RID) const 🔗

返回渲染模型的根变换。这是跟踪的位置，相对于 XROrigin3D 节点。

PackedStringArray render_model_get_subaction_paths(render_model: RID) 🔗

返回 render_model 的活动子动作路径列表。

注意：如果与动作绑定的设备与建议的交互绑定不同，则返回的信息显示的是与该设备模拟的交互绑定相关的路径。

String render_model_get_top_level_path(render_model: RID) const 🔗

返回与 render_model 关联的顶级路径。如果提供了该信息，则可以识别渲染模型是否与玩家的手或其他身体部位相关联。

bool render_model_is_animatable_node_visible(render_model: RID, index: int) const 🔗

如果动画节点应当可见，则返回 true。

Node3D render_model_new_scene_instance(render_model: RID) const 🔗

返回包含显示渲染模型所需的所有 MeshInstance3D 的子场景实例。