TextureLayered

Inherits: Resource < Reference < Object

Inherited By: Texture3D, TextureArray

3D 纹理类型的基类。

描述

是 Texture3D 和 TextureArray 的基类。不能直接使用，但包含访问和使用 Texture3D 和 TextureArray 的所有必要功能。数据是以每层为单位设置的。对于 Texture3D，层指定了深度或 Z-index，它们可以被视为一堆二维切片。同样地，对于 TextureArray，层指定了数组层。

属性

Dictionary

data

{“depth”: 0,”flags”: 7,”format”: 37,”height”: 0,”layers”: [  ],”width”: 0}

int

flags

7

方法

int

get_depth ( ) const

Format

get_format ( ) const

int

get_height ( ) const

Image

get_layer_data ( int layer ) const

int

get_width ( ) const

void

set_data_partial ( Image image, int x_offset, int y_offset, int layer, int mipmap=0 )

void

set_layer_data ( Image image, int layer )

枚举

enum Flags:

  • FLAGS_DEFAULT_TEXTURE_ARRAY = 7 —- TextureArray 的默认标记。 启用 FLAG_MIPMAPS、FLAG_REPEAT 和 FLAG_FILTER。

  • FLAGS_DEFAULT_TEXTURE_3D = 4 —- 默认为Texture3D的标记。启用FLAG_FILTER。

  • FLAG_MIPMAPS = 1 —- 纹理将在创建时生成多级渐远纹理。

  • FLAG_REPEAT = 2 —- 当使用的UV超出0-1范围时，纹理将重复。

  • FLAG_FILTER = 4 —- 在从纹理中读取时使用过滤。过滤使像素变得平滑。当你需要访问单个像素时，关闭过滤会稍快一些，也更合适。

  • FLAG_ANISOTROPIC_FILTER = 8 —- 使用各向异性的多级渐远纹理过滤。生成具有不同长宽比的同一纹理的较小版本。

当从斜角观看时，这会产生更好看的纹理。

属性说明

Default

{“depth”: 0,”flags”: 7,”format”: 37,”height”: 0,”layers”: [  ],”width”: 0}

返回字典，其中带有此纹理使用的所有数据。

Default

7

Setter

set_flags(value)

Getter

get_flags()

指定应用于此纹理的 Flags。

方法说明

  • int get_depth ( ) const

返回纹理的深度。深度是第三个维度（通常是 Z 轴）。

返回纹理当前使用的格式。详情见Format。

  • int get_height ( ) const

返回纹理的高度。高度通常由Y轴表示。

  • Image get_layer_data ( int layer ) const

返回一个带有指定layer层数据的Image图像资源。

  • int get_width ( ) const

返回纹理的宽度。宽度通常由X轴表示。

  • void set_data_partial ( Image image, int x_offset, int y_offset, int layer, int mipmap=0 )

通过使用指定的image的数据覆盖来部分设置指定的layer的数据。 x_offset 和 y_offset 确定 Image 在纹理上”stamped” 标记的位置。 image 必须适合纹理。

  • void set_layer_data ( Image image, int layer )

设置指定图层的数据。数据的形式是二维的Image资源。