CubemapArray

继承： ImageTextureLayered < TextureLayered < Texture < Resource < RefCounted < Object

Cubemap 数组，存储在一起并使用单个引用。

描述

CubemapArray 由 Cubemap 数组组成。与 Cubemap 一样由多个纹理组成，纹理的数量必须能被 6 整除（对应立方体的各个面）。

CubemapArray 的主要优点是可以使用单个纹理引用在着色器代码中访问。换句话说，你可以使用单个 CubemapArray 将多个 Cubemap 传递到着色器中。这些 Cubemap 在 GPU 上会被分配到相邻缓存区域中，因此用 CubemapArray 存储多个 Cubemap 最为高效。

Godot 内部使用 CubemapArray 来实现许多效果，例如将 ProjectSettings.rendering/reflections/sky_reflections/texture_array_reflections 设置为 true 时的 Sky。

要自己创建这样的纹理文件，请使用 Godot 编辑器的导入预设重新导入图像文件。要使用代码创建 CubemapArray，请在 CubemapArray 类的实例上使用 ImageTextureLayered.create_from_images()。

预期的图像顺序是 X+、X-、Y+、Y-、Z+、Z-（Godot 的坐标系中 Y+ 是“上”、Z- 是“前”）。你可以从下列模板中挑选一个作为基础：

• 2×3 立方体贴图模板（默认布局选项）

• 3×2 立方体贴图模板

• 1×6 立方体贴图模板

• 6×1 立方体贴图模板

使用默认垂直导入选项时多个图层会相互堆叠（第一个图层位于顶部）。你也可以在导入选项中选择水平布局（第一个图层位于左侧）。

注意：由于图形 API 限制，兼容性渲染器不支持 CubemapArray。

方法

Resource

create_placeholder() const

---

方法说明

Resource create_placeholder() const 🔗

创建该资源的占位符版本（PlaceholderCubemapArray）。