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.

RID

Resource 的唯一标识符的句柄。

描述

RID Variant 类型用于通过唯一 ID 来访问底层资源。RID 是不透明的,这意味着它们本身并不能直接让你访问到资源。它们主要被底层服务器类所使用,例如 DisplayServer(显示服务器)、RenderingServer(渲染服务器)、TextServer(文本服务器)等。

一个底层资源可能对应着一个高层级的 Resource(资源),比如 Texture(纹理)或 Mesh(网格)。

注意: RID 仅在当前会话期间有用。如果通过网络发送,或者在之后从文件中加载,它将无法对应到相同的资源。

注意: 在布尔值上下文中,如果 RID 是无效 ID 0,它的判断结果将为 false。否则,RID 的判断结果将始终为 true。这等同于调用 is_valid() 方法。

备注

通过 C# 使用该 API 时会有显著不同,详见 C# API 与 GDScript 的差异

构造函数

RID

RID()

RID

RID(from: RID)

方法

int

get_id() const

bool

is_valid() const

运算符

bool

operator !=(right: RID)

bool

operator <(right: RID)

bool

operator <=(right: RID)

bool

operator ==(right: RID)

bool

operator >(right: RID)

bool

operator >=(right: RID)


构造函数说明

RID RID() 🔗

构造空的 RID,内容为无效的 ID 0


RID RID(from: RID)

构造给定 RID 的副本 RID


方法说明

int get_id() const 🔗

返回引用的底层资源的 ID。


bool is_valid() const 🔗

如果该 RID0,则返回 true


运算符说明

bool operator !=(right: RID) 🔗

如果 RID 不相等,则返回 true


bool operator <(right: RID) 🔗

如果该 RID 的 ID 小于右侧 right 的 ID,则返回 true


bool operator <=(right: RID) 🔗

如果该 RID 的 ID 小于等于右侧 right 的 ID,则返回 true


bool operator ==(right: RID) 🔗

如果 RID 相等,则返回 true,表示它们引用的是同一个底层资源。


bool operator >(right: RID) 🔗

如果该 RID 的 ID 大于右侧 right 的 ID,则返回 true


bool operator >=(right: RID) 🔗

如果该 RID 的 ID 大于等于右侧 right 的 ID,则返回 true