Resource
继承
简要描述
所有资源的基类。
描述
Resource是所有特定于IdeaXR的资源类型的基类，主要作为数据容器。被引用后计数增加，并且在不在使用时将其释放。它们加载后被添加达到缓存中，因此当使用给定的路径进行加载的时候，都会返回相同的引用（与节点相比，节点可以根据需要多次实例化，并且不被引用计数）。资源可以保存到磁盘上或者绑定到另一个对象，比如节点或者另一个资源。
成员
| 类型 | 属性名 | 默认值 |
|---|---|---|
| bool | resource_local_to_scene | false |
| String | resource_name | "" |
| String | resource_path | "" |
方法
| 返回值类型 | 方法名称 |
|---|---|
| void | _setup_local_to_scene() virtual |
| Resource | duplicate(subresources: bool = false) const |
| Node | get_local_scene() const |
| RID | get_rid() const |
| void | setup_local_to_scene() |
| void | take_over_path(path: String) |
信号
- **changed**
每当资源更改时发出。
常量
成员说明
- bool resource_local_to_scene
| Default | false |
|---|---|
| setter | set_local_to_scene(value) |
| getter | is_local_to_scene |
- String resource_name
| Default | "" |
|---|---|
| setter | set_name(value) |
| getter | get_name |
- String resource_path
| Default | "" |
|---|---|
| setter | set_path(value) |
| getter | get_path |
方法说明
- _setup_local_to_scene _setup_local_to_scene() virtual
可以重写setup_local_to_scene行为值的虚拟函数。
- duplicate duplicate(subresources: bool = false) const
复制资源，返回新资源。默认情况下，子资源在资源与副本之间共享来提高效果，可以通过条件为真传递给子资源来改变子资源。
- get_local_scene get_local_scene() const
如果启用了resource_local_to_scene，并且从PackedScene实例中加载了资源，则返回使用该资源的唯一副本的本地场景。
- get_rid get_rid() const
返回资源的RID（或空RID）。很多资源（例如材质、网格等）是服务器中存储的高级抽象，因此此函数将返回原始RID。
- setup_local_to_scene setup_local_to_scene()
当resource_local_to_scene开启并且从PackedScene实例化，该函数将被调用。该函数可以在脚本中覆盖。
对于大多数资源，此方法不执行任何基本逻辑。ViewportTexture执行自定义逻辑，以在本地视口中正确设置代理纹理和标志。
- take_over_path take_over_path(path: String)
设置资源的路径，可能会覆盖该路径的现有缓存条目。与resource_path的不同，如果给已经给定路径缓存了另一个资源，后者则会出错。