Up to date

This page is up to date for Godot 4.2. If you still find outdated information, please open an issue.

RenderingDevice

继承: Object

用于处理现代低阶图形 API 的抽象。

描述

RenderingDevice 是用来使用 Vulkan 等现代低阶图形 API 的抽象。与(适用于 Godot 自有渲染子系统的)RenderingServer 相比,RenderingDevice 所处的层级更低,能够更加直接地使用底层图形 API。Godot 使用 RenderingDevice 来支持部分现代低阶图形 API,能够减少所需的重复代码。你也可以在自己的项目中使用 RenderingDevice,从而执行 RenderingServer 和高阶节点未暴露的功能,例如使用计算着色器。

启动时,Godot 会创建一个全局的 RenderingDevice,可以使用 RenderingServer.get_rendering_device 获取。这个全局的 RenderingDevice 进行的是屏幕绘图。

局部 RenderingDevice:你可以使用 RenderingServer.create_local_rendering_device 创建“次级”渲染设备,在单独的线程中进行渲染和 GPU 计算操作。

注意:使用 RenderingDevice 需要对 Vulkan、Direct3D 12、Metal 或 WebGPU 有中等水平的知识。这些图形 API 比 OpenGL 和 Direct3D 所处的层级更低,能够执行原本由图形驱动自己实现的功能。如果这个类中所使用的概念你理解起来有困难,请学习 Vulkan 教程Vulkan 指南。在尝试学习低阶图形 API 之前,建议先学习现代 OpenGL 或 Direct3D 11 相关的知识。

注意:使用无头模式运行或使用 Compatibility 渲染方法时,RenderingDevice 不可用。

教程

方法

void

barrier ( BitField<BarrierMask> from=32767, BitField<BarrierMask> to=32767 )

Error

buffer_clear ( RID buffer, int offset, int size_bytes, BitField<BarrierMask> post_barrier=32767 )

PackedByteArray

buffer_get_data ( RID buffer, int offset_bytes=0, int size_bytes=0 )

Error

buffer_update ( RID buffer, int offset, int size_bytes, PackedByteArray data, BitField<BarrierMask> post_barrier=32767 )

void

capture_timestamp ( String name )

void

compute_list_add_barrier ( int compute_list )

int

compute_list_begin ( bool allow_draw_overlap=false )

void

compute_list_bind_compute_pipeline ( int compute_list, RID compute_pipeline )

void

compute_list_bind_uniform_set ( int compute_list, RID uniform_set, int set_index )

void

compute_list_dispatch ( int compute_list, int x_groups, int y_groups, int z_groups )

void

compute_list_end ( BitField<BarrierMask> post_barrier=32767 )

void

compute_list_set_push_constant ( int compute_list, PackedByteArray buffer, int size_bytes )

RID

compute_pipeline_create ( RID shader, RDPipelineSpecializationConstant[] specialization_constants=[] )

bool

compute_pipeline_is_valid ( RID compute_pipeline )

RenderingDevice

create_local_device ( )

void

draw_command_begin_label ( String name, Color color )

void

draw_command_end_label ( )

void

draw_command_insert_label ( String name, Color color )

int

draw_list_begin ( RID framebuffer, InitialAction initial_color_action, FinalAction final_color_action, InitialAction initial_depth_action, FinalAction final_depth_action, PackedColorArray clear_color_values=PackedColorArray(), float clear_depth=1.0, int clear_stencil=0, Rect2 region=Rect2(0, 0, 0, 0), RID[] storage_textures=[] )

int

draw_list_begin_for_screen ( int screen=0, Color clear_color=Color(0, 0, 0, 1) )

PackedInt64Array

draw_list_begin_split ( RID framebuffer, int splits, InitialAction initial_color_action, FinalAction final_color_action, InitialAction initial_depth_action, FinalAction final_depth_action, PackedColorArray clear_color_values=PackedColorArray(), float clear_depth=1.0, int clear_stencil=0, Rect2 region=Rect2(0, 0, 0, 0), RID[] storage_textures=[] )

void

draw_list_bind_index_array ( int draw_list, RID index_array )

void

draw_list_bind_render_pipeline ( int draw_list, RID render_pipeline )

void

draw_list_bind_uniform_set ( int draw_list, RID uniform_set, int set_index )

void

draw_list_bind_vertex_array ( int draw_list, RID vertex_array )

void

draw_list_disable_scissor ( int draw_list )

void

draw_list_draw ( int draw_list, bool use_indices, int instances, int procedural_vertex_count=0 )

void

draw_list_enable_scissor ( int draw_list, Rect2 rect=Rect2(0, 0, 0, 0) )

void

draw_list_end ( BitField<BarrierMask> post_barrier=32767 )

void

draw_list_set_blend_constants ( int draw_list, Color color )

void

draw_list_set_push_constant ( int draw_list, PackedByteArray buffer, int size_bytes )

int

draw_list_switch_to_next_pass ( )

PackedInt64Array

draw_list_switch_to_next_pass_split ( int splits )

RID

framebuffer_create ( RID[] textures, int validate_with_format=-1, int view_count=1 )

RID

framebuffer_create_empty ( Vector2i size, TextureSamples samples=0, int validate_with_format=-1 )

RID

framebuffer_create_multipass ( RID[] textures, RDFramebufferPass[] passes, int validate_with_format=-1, int view_count=1 )

int

framebuffer_format_create ( RDAttachmentFormat[] attachments, int view_count=1 )

int

framebuffer_format_create_empty ( TextureSamples samples=0 )

int

framebuffer_format_create_multipass ( RDAttachmentFormat[] attachments, RDFramebufferPass[] passes, int view_count=1 )

TextureSamples

framebuffer_format_get_texture_samples ( int format, int render_pass=0 )

int

framebuffer_get_format ( RID framebuffer )

bool

framebuffer_is_valid ( RID framebuffer ) const

void

free_rid ( RID rid )

void

full_barrier ( )

int

get_captured_timestamp_cpu_time ( int index ) const

int

get_captured_timestamp_gpu_time ( int index ) const

String

get_captured_timestamp_name ( int index ) const

int

get_captured_timestamps_count ( ) const

int

get_captured_timestamps_frame ( ) const

String

get_device_name ( ) const

String

get_device_pipeline_cache_uuid ( ) const

String

get_device_vendor_name ( ) const

int

get_driver_resource ( DriverResource resource, RID rid, int index )

int

get_frame_delay ( ) const

int

get_memory_usage ( MemoryType type ) const

RID

index_array_create ( RID index_buffer, int index_offset, int index_count )

RID

index_buffer_create ( int size_indices, IndexBufferFormat format, PackedByteArray data=PackedByteArray(), bool use_restart_indices=false )

int

limit_get ( Limit limit ) const

RID

render_pipeline_create ( RID shader, int framebuffer_format, int vertex_format, RenderPrimitive primitive, RDPipelineRasterizationState rasterization_state, RDPipelineMultisampleState multisample_state, RDPipelineDepthStencilState stencil_state, RDPipelineColorBlendState color_blend_state, BitField<PipelineDynamicStateFlags> dynamic_state_flags=0, int for_render_pass=0, RDPipelineSpecializationConstant[] specialization_constants=[] )

bool

render_pipeline_is_valid ( RID render_pipeline )

RID

sampler_create ( RDSamplerState state )

bool

sampler_is_format_supported_for_filter ( DataFormat format, SamplerFilter sampler_filter ) const

int

screen_get_framebuffer_format ( ) const

int

screen_get_height ( int screen=0 ) const

int

screen_get_width ( int screen=0 ) const

void

set_resource_name ( RID id, String name )

PackedByteArray

shader_compile_binary_from_spirv ( RDShaderSPIRV spirv_data, String name="" )

RDShaderSPIRV

shader_compile_spirv_from_source ( RDShaderSource shader_source, bool allow_cache=true )

RID

shader_create_from_bytecode ( PackedByteArray binary_data, RID placeholder_rid=RID() )

RID

shader_create_from_spirv ( RDShaderSPIRV spirv_data, String name="" )

RID

shader_create_placeholder ( )

int

shader_get_vertex_input_attribute_mask ( RID shader )

RID

storage_buffer_create ( int size_bytes, PackedByteArray data=PackedByteArray(), BitField<StorageBufferUsage> usage=0 )

void

submit ( )

void

sync ( )

RID

texture_buffer_create ( int size_bytes, DataFormat format, PackedByteArray data=PackedByteArray() )

Error

texture_clear ( RID texture, Color color, int base_mipmap, int mipmap_count, int base_layer, int layer_count, BitField<BarrierMask> post_barrier=32767 )

Error

texture_copy ( RID from_texture, RID to_texture, Vector3 from_pos, Vector3 to_pos, Vector3 size, int src_mipmap, int dst_mipmap, int src_layer, int dst_layer, BitField<BarrierMask> post_barrier=32767 )

RID

texture_create ( RDTextureFormat format, RDTextureView view, PackedByteArray[] data=[] )

RID

texture_create_from_extension ( TextureType type, DataFormat format, TextureSamples samples, BitField<TextureUsageBits> usage_flags, int image, int width, int height, int depth, int layers )

RID

texture_create_shared ( RDTextureView view, RID with_texture )

RID

texture_create_shared_from_slice ( RDTextureView view, RID with_texture, int layer, int mipmap, int mipmaps=1, TextureSliceType slice_type=0 )

PackedByteArray

texture_get_data ( RID texture, int layer )

RDTextureFormat

texture_get_format ( RID texture )

int

texture_get_native_handle ( RID texture )

bool

texture_is_format_supported_for_usage ( DataFormat format, BitField<TextureUsageBits> usage_flags ) const

bool

texture_is_shared ( RID texture )

bool

texture_is_valid ( RID texture )

Error

texture_resolve_multisample ( RID from_texture, RID to_texture, BitField<BarrierMask> post_barrier=32767 )

Error

texture_update ( RID texture, int layer, PackedByteArray data, BitField<BarrierMask> post_barrier=32767 )

RID

uniform_buffer_create ( int size_bytes, PackedByteArray data=PackedByteArray() )

RID

uniform_set_create ( RDUniform[] uniforms, RID shader, int shader_set )

bool

uniform_set_is_valid ( RID uniform_set )

RID

vertex_array_create ( int vertex_count, int vertex_format, RID[] src_buffers, PackedInt64Array offsets=PackedInt64Array() )

RID

vertex_buffer_create ( int size_bytes, PackedByteArray data=PackedByteArray(), bool use_as_storage=false )

int

vertex_format_create ( RDVertexAttribute[] vertex_descriptions )


枚举

enum DeviceType:

DeviceType DEVICE_TYPE_OTHER = 0

渲染设备的类型与其他枚举值均不匹配,或者未知。

DeviceType DEVICE_TYPE_INTEGRATED_GPU = 1

渲染设备为集成 GPU,通常(但不一定)比独立 GPU(DEVICE_TYPE_DISCRETE_GPU)要慢。在 Android 和 iOS 上,渲染设备的类型始终为 DEVICE_TYPE_INTEGRATED_GPU

DeviceType DEVICE_TYPE_DISCRETE_GPU = 2

渲染设备为独立 GPU,通常(但不一定)比集成 GPU(DEVICE_TYPE_INTEGRATED_GPU)要快。

DeviceType DEVICE_TYPE_VIRTUAL_GPU = 3

渲染设备为虚拟环境中的模拟 GPU。通常比主机 GPU 要慢很多,这意味着独立 GPU 的预期性能等级大概与 DEVICE_TYPE_INTEGRATED_GPU 等价。使用虚拟机 GPU 穿透(例如 VFIO)时,设备类型不会被汇报为 DEVICE_TYPE_VIRTUAL_GPU。而是会汇报主机 GPU 的设备类型,就好像使用的不是模拟 GPU 一样。

DeviceType DEVICE_TYPE_CPU = 4

渲染设备由软件模拟提供(例如 Lavapipe 或 SwiftShader)。这是可用的渲染设备中最慢的一种;通常比 DEVICE_TYPE_INTEGRATED_GPU 要慢很多。

DeviceType DEVICE_TYPE_MAX = 5

代表 DeviceType 枚举的大小。


enum DriverResource:

DriverResource DRIVER_RESOURCE_VULKAN_DEVICE = 0

Vulkan 设备驱动资源。这是一种“全局”资源,会忽略传入的 RID

DriverResource DRIVER_RESOURCE_VULKAN_PHYSICAL_DEVICE = 1

物理设备(显卡)驱动资源。

DriverResource DRIVER_RESOURCE_VULKAN_INSTANCE = 2

Vulkan 实例驱动资源。

DriverResource DRIVER_RESOURCE_VULKAN_QUEUE = 3

Vulkan 队列驱动资源。

DriverResource DRIVER_RESOURCE_VULKAN_QUEUE_FAMILY_INDEX = 4

Vulkan 队列族索引驱动资源。

DriverResource DRIVER_RESOURCE_VULKAN_IMAGE = 5

Vulkan 图像驱动资源。

DriverResource DRIVER_RESOURCE_VULKAN_IMAGE_VIEW = 6

Vulkan 图像查看驱动资源。

DriverResource DRIVER_RESOURCE_VULKAN_IMAGE_NATIVE_TEXTURE_FORMAT = 7

Vulkan 图像原生纹理格式驱动资源。

DriverResource DRIVER_RESOURCE_VULKAN_SAMPLER = 8

Vulkan 采样器驱动资源。

DriverResource DRIVER_RESOURCE_VULKAN_DESCRIPTOR_SET = 9

Vulkan 描述符集驱动资源。

DriverResource DRIVER_RESOURCE_VULKAN_BUFFER = 10

Vulkan 缓冲驱动资源。

DriverResource DRIVER_RESOURCE_VULKAN_COMPUTE_PIPELINE = 11

Vulkan 计算管线驱动资源。

DriverResource DRIVER_RESOURCE_VULKAN_RENDER_PIPELINE = 12

Vulkan 渲染管线驱动资源。


enum DataFormat:

DataFormat DATA_FORMAT_R4G4_UNORM_PACK8 = 0

每通道 4 位的红、绿通道数据格式,紧缩在 8 个比特位中。取值均在 [0.0, 1.0] 的范围内。

注意:所有数据格式的更多信息可以在 Vulkan 规格说明的 Identification of formats 章节和 VkFormat 枚举中找到。

DataFormat DATA_FORMAT_R4G4B4A4_UNORM_PACK16 = 1

每通道 4 位的红、绿、蓝、Alpha 通道数据格式,紧缩在 16 个比特位中。取值均在 [0.0, 1.0] 的范围内。

DataFormat DATA_FORMAT_B4G4R4A4_UNORM_PACK16 = 2

每通道 4 位的蓝、绿、红、Alpha 通道数据格式,紧缩在 16 个比特位中。取值均在 [0.0, 1.0] 的范围内。

DataFormat DATA_FORMAT_R5G6B5_UNORM_PACK16 = 3

红、绿、蓝通道数据格式,红占 5 位、绿占 6 位、蓝占 5 位,紧缩在 16 个比特位中。取值均在 [0.0, 1.0] 的范围内。

DataFormat DATA_FORMAT_B5G6R5_UNORM_PACK16 = 4

蓝、绿、红通道数据格式,蓝占 5 位、绿占 6 位、红占 5 位,紧缩在 16 个比特位中。取值均在 [0.0, 1.0] 的范围内。

DataFormat DATA_FORMAT_R5G5B5A1_UNORM_PACK16 = 5

红、绿、蓝、Alpha 通道数据格式,红占 5 位、绿占 6 位、蓝占 5 位、Alpha 占 1 位,紧缩在 16 个比特位中。取值均在 [0.0, 1.0] 的范围内。

DataFormat DATA_FORMAT_B5G5R5A1_UNORM_PACK16 = 6

蓝、绿、红、Alpha 通道数据格式,蓝占 5 位、绿占 6 位、红占 5 位、Alpha 占 1 位,紧缩在 16 个比特位中。取值均在 [0.0, 1.0] 的范围内。

DataFormat DATA_FORMAT_A1R5G5B5_UNORM_PACK16 = 7

Alpha、红、绿、蓝通道数据格式,Alpha 占 1 位、红占 5 位、绿占 6 位、蓝占 5 位,紧缩在 16 个比特位中。取值均在 [0.0, 1.0] 的范围内。

DataFormat DATA_FORMAT_R8_UNORM = 8

每通道 8 位的无符号浮点数红通道数据格式,使用归一化的值。取值均在 [0.0, 1.0] 的范围内。

DataFormat DATA_FORMAT_R8_SNORM = 9

每通道 8 位的带符号浮点数红通道数据格式,使用归一化的值。取值均在 [-1.0, 1.0] 的范围内。

DataFormat DATA_FORMAT_R8_USCALED = 10

每通道 8 位的无符号浮点数红通道数据格式,使用缩放后的值(值从整数转换为浮点数)。取值均在 [0.0, 255.0] 的范围内。

DataFormat DATA_FORMAT_R8_SSCALED = 11

每通道 8 位的带符号浮点数红通道数据格式,使用缩放后的值(值从整数转换为浮点数)。取值均在 [-127.0, 127.0] 的范围内。

DataFormat DATA_FORMAT_R8_UINT = 12

每通道 8 位的无符号整数红通道数据格式。取值均在 [0, 255] 的范围内。

DataFormat DATA_FORMAT_R8_SINT = 13

每通道 8 位的带符号整数红通道数据格式。取值均在 [-127, 127] 的范围内。

DataFormat DATA_FORMAT_R8_SRGB = 14

每通道 8 位的无符号浮点数红通道数据格式,使用归一化的值、非线性 sRGB 编码。取值均在 [0.0, 1.0] 的范围内。

DataFormat DATA_FORMAT_R8G8_UNORM = 15

每通道 8 位的无符号浮点数红、绿通道数据格式,使用归一化的值。取值均在 [0.0, 1.0] 的范围内。

DataFormat DATA_FORMAT_R8G8_SNORM = 16

每通道 8 位的带符号浮点数红、绿通道数据格式,使用归一化的值。取值均在 [-1.0, 1.0] 的范围内。

DataFormat DATA_FORMAT_R8G8_USCALED = 17

每通道 8 位的无符号浮点数红、绿通道数据格式,使用缩放后的值(值从整数转换为浮点数)。取值均在 [0.0, 255.0] 的范围内。

DataFormat DATA_FORMAT_R8G8_SSCALED = 18

每通道 8 位的带符号浮点数红、绿通道数据格式,使用缩放后的值(值从整数转换为浮点数)。取值均在 [-127.0, 127.0] 的范围内。

DataFormat DATA_FORMAT_R8G8_UINT = 19

每通道 8 位的无符号整数红、绿通道数据格式。取值均在 [0, 255] 的范围内。

DataFormat DATA_FORMAT_R8G8_SINT = 20

每通道 8 位的带符号整数红、绿通道数据格式。取值均在 [-127, 127] 的范围内。

DataFormat DATA_FORMAT_R8G8_SRGB = 21

每通道 8 位的无符号浮点数红、绿通道数据格式,使用归一化的值、非线性 sRGB 编码。取值均在 [0.0, 1.0] 的范围内。

DataFormat DATA_FORMAT_R8G8B8_UNORM = 22

每通道 8 位的无符号浮点数红、绿、蓝通道数据格式,使用归一化的值。取值均在 [0.0, 1.0] 的范围内。

DataFormat DATA_FORMAT_R8G8B8_SNORM = 23

每通道 8 位的带符号浮点数红、绿、蓝通道数据格式,使用归一化的值。取值均在 [-1.0, 1.0] 的范围内。

DataFormat DATA_FORMAT_R8G8B8_USCALED = 24

每通道 8 位的无符号浮点数红、绿、蓝通道数据格式,使用缩放后的值(值从整数转换为浮点数)。取值均在 [0.0, 255.0] 的范围内。

DataFormat DATA_FORMAT_R8G8B8_SSCALED = 25

每通道 8 位的带符号浮点数红、绿、蓝通道数据格式,使用缩放后的值(值从整数转换为浮点数)。取值均在 [-127.0, 127.0] 的范围内。

DataFormat DATA_FORMAT_R8G8B8_UINT = 26

每通道 8 位的无符号整数红、绿、蓝通道数据格式。取值均在 [0, 255] 的范围内。

DataFormat DATA_FORMAT_R8G8B8_SINT = 27

每通道 8 位的带符号整数红、绿、蓝通道数据格式。取值均在 [-127, 127] 的范围内。

DataFormat DATA_FORMAT_R8G8B8_SRGB = 28

每通道 8 位的无符号浮点数红、绿、蓝通道数据格式,使用归一化的值、非线性 sRGB 编码。取值均在 [0.0, 1.0] 的范围内。

DataFormat DATA_FORMAT_B8G8R8_UNORM = 29

每通道 8 位的无符号浮点数蓝、绿、红通道数据格式,使用归一化的值。取值均在 [0.0, 1.0] 的范围内。

DataFormat DATA_FORMAT_B8G8R8_SNORM = 30

每通道 8 位的带符号浮点数蓝、绿、红通道数据格式,使用归一化的值。取值均在 [-1.0, 1.0] 的范围内。

DataFormat DATA_FORMAT_B8G8R8_USCALED = 31

每通道 8 位的无符号浮点数蓝、绿、红通道数据格式,使用缩放后的值(值从整数转换为浮点数)。取值均在 [0.0, 255.0] 的范围内。

DataFormat DATA_FORMAT_B8G8R8_SSCALED = 32

每通道 8 位的带符号浮点数蓝、绿、红通道数据格式,使用缩放后的值(值从整数转换为浮点数)。取值均在 [-127.0, 127.0] 的范围内。

DataFormat DATA_FORMAT_B8G8R8_UINT = 33

每通道 8 位的无符号整数蓝、绿、红通道数据格式。取值均在 [0, 255] 的范围内。

DataFormat DATA_FORMAT_B8G8R8_SINT = 34

每通道 8 位的带符号整数蓝、绿、红通道数据格式。取值均在 [-127, 127] 的范围内。

DataFormat DATA_FORMAT_B8G8R8_SRGB = 35

每通道 8 位的无符号浮点数蓝、绿、红通道数据格式,使用归一化的值、非线性 sRGB 编码。取值均在 [0.0, 1.0] 的范围内。

DataFormat DATA_FORMAT_R8G8B8A8_UNORM = 36

每通道 8 位的无符号浮点数红、绿、蓝、Alpha 通道数据格式,使用归一化的值。取值均在 [0.0, 1.0] 的范围内。

DataFormat DATA_FORMAT_R8G8B8A8_SNORM = 37

每通道 8 位的带符号浮点数红、绿、蓝、Alpha 通道数据格式,使用归一化的值。取值均在 [-1.0, 1.0] 的范围内。

DataFormat DATA_FORMAT_R8G8B8A8_USCALED = 38

每通道 8 位的无符号浮点数红、绿、蓝、Alpha 通道数据格式,使用缩放后的值(值从整数转换为浮点数)。取值均在 [0.0, 255.0] 的范围内。

DataFormat DATA_FORMAT_R8G8B8A8_SSCALED = 39

每通道 8 位的带符号浮点数红、绿、蓝、Alpha 通道数据格式,使用缩放后的值(值从整数转换为浮点数)。取值均在 [-127.0, 127.0] 的范围内。

DataFormat DATA_FORMAT_R8G8B8A8_UINT = 40

每通道 8 位的无符号整数红、绿、蓝、Alpha 通道数据格式。取值均在 [0, 255] 的范围内。

DataFormat DATA_FORMAT_R8G8B8A8_SINT = 41

每通道 8 位的带符号整数红、绿、蓝、Alpha 通道数据格式。取值均在 [-127, 127] 的范围内。

DataFormat DATA_FORMAT_R8G8B8A8_SRGB = 42

每通道 8 位的无符号浮点数红、绿、蓝、Alpha 通道数据格式,使用归一化的值、非线性 sRGB 编码。取值均在 [0.0, 1.0] 的范围内。

DataFormat DATA_FORMAT_B8G8R8A8_UNORM = 43

每通道 8 位的无符号浮点数蓝、绿、红、Alpha 通道数据格式,使用归一化的值。取值均在 [0.0, 1.0] 的范围内。

DataFormat DATA_FORMAT_B8G8R8A8_SNORM = 44

每通道 8 位的带符号浮点数蓝、绿、红、Alpha 通道数据格式,使用归一化的值。取值均在 [-1.0, 1.0] 的范围内。

DataFormat DATA_FORMAT_B8G8R8A8_USCALED = 45

每通道 8 位的无符号浮点数蓝、绿、红、Alpha 通道数据格式,使用缩放后的值(值从整数转换为浮点数)。取值均在 [0.0, 255.0] 的范围内。

DataFormat DATA_FORMAT_B8G8R8A8_SSCALED = 46

每通道 8 位的带符号浮点数蓝、绿、红、Alpha 通道数据格式,使用缩放后的值(值从整数转换为浮点数)。取值均在 [-127.0, 127.0] 的范围内。

DataFormat DATA_FORMAT_B8G8R8A8_UINT = 47

每通道 8 位的无符号整数蓝、绿、红、Alpha 通道数据格式。取值均在 [0, 255] 的范围内。

DataFormat DATA_FORMAT_B8G8R8A8_SINT = 48

每通道 8 位的带符号整数蓝、绿、红、Alpha 通道数据格式。取值均在 [-127, 127] 的范围内。

DataFormat DATA_FORMAT_B8G8R8A8_SRGB = 49

每通道 8 位的无符号浮点数蓝、绿、红、Alpha 通道数据格式,使用归一化的值、非线性 sRGB 编码。取值均在 [0.0, 1.0] 的范围内。

DataFormat DATA_FORMAT_A8B8G8R8_UNORM_PACK32 = 50

每通道 8 位的无符号浮点数 Alpha、红、绿、蓝通道数据格式,使用归一化的值,紧缩在 32 个比特位中。取值均在 [0.0, 1.0] 的范围内。

DataFormat DATA_FORMAT_A8B8G8R8_SNORM_PACK32 = 51

每通道 8 位的带符号浮点数 Alpha、红、绿、蓝通道数据格式,使用归一化的值,紧缩在 32 个比特位中。取值均在 [-1.0, 1.0] 的范围内。

DataFormat DATA_FORMAT_A8B8G8R8_USCALED_PACK32 = 52

每通道 8 位的无符号浮点数 Alpha、红、绿、蓝通道数据格式,使用缩放后的值(值从整数转换为浮点数),紧缩在 32 个比特位中。取值均在 [0.0, 255.0] 的范围内。

DataFormat DATA_FORMAT_A8B8G8R8_SSCALED_PACK32 = 53

每通道 8 位的带符号浮点数 Alpha、红、绿、蓝通道数据格式,使用缩放后的值(值从整数转换为浮点数),紧缩在 32 个比特位中。取值均在 [-127.0, 127.0] 的范围内。

DataFormat DATA_FORMAT_A8B8G8R8_UINT_PACK32 = 54

每通道 8 位的无符号整数 Alpha、红、绿、蓝通道数据格式,紧缩在 32 个比特位中。取值均在 [0, 255] 的范围内。

DataFormat DATA_FORMAT_A8B8G8R8_SINT_PACK32 = 55

每通道 8 位的带符号整数 Alpha、红、绿、蓝通道数据格式,紧缩在 32 个比特位中。取值均在 [-127, 127] 的范围内。

DataFormat DATA_FORMAT_A8B8G8R8_SRGB_PACK32 = 56

每通道 8 位的无符号浮点数 Alpha、红、绿、蓝通道数据格式,使用归一化的值、非线性 sRGB 编码,紧缩在 32 个比特位中。取值均在 [0.0, 1.0] 的范围内。

DataFormat DATA_FORMAT_A2R10G10B10_UNORM_PACK32 = 57

无符号浮点数 Alpha、红、绿、蓝通道数据格式,使用归一化的值,紧缩在 32 个比特位中。格式中包含 2 位 Alpha、10 位红、10 位绿、10 位蓝。取值均在 [0.0, 1.0] 的范围内。

DataFormat DATA_FORMAT_A2R10G10B10_SNORM_PACK32 = 58

带符号浮点数 Alpha、红、绿、蓝通道数据格式,使用归一化的值,紧缩在 32 个比特位中。格式中包含 2 位 Alpha、10 位红、10 位绿、10 位蓝。取值均在 [-1.0, 1.0] 的范围内。

DataFormat DATA_FORMAT_A2R10G10B10_USCALED_PACK32 = 59

无符号浮点数 Alpha、红、绿、蓝通道数据格式,使用归一化的值,紧缩在 32 个比特位中。格式中包含 2 位 Alpha、10 位红、10 位绿、10 位蓝。红、绿、蓝的取值在 [0.0, 1023.0] 的范围内,Alpha 的取值在 [0.0, 3.0] 的范围内。

DataFormat DATA_FORMAT_A2R10G10B10_SSCALED_PACK32 = 60

带符号浮点数 Alpha、红、绿、蓝通道数据格式,使用归一化的值,紧缩在 32 个比特位中。格式中包含 2 位 Alpha、10 位红、10 位绿、10 位蓝。红、绿、蓝的取值在 [-511.0, 511.0] 的范围内,Alpha 的取值在 [-1.0, 1.0] 的范围内。

DataFormat DATA_FORMAT_A2R10G10B10_UINT_PACK32 = 61

无符号整数 Alpha、红、绿、蓝通道数据格式,使用归一化的值,紧缩在 32 个比特位中。格式中包含 2 位 Alpha、10 位红、10 位绿、10 位蓝。红、绿、蓝的取值在 [0, 1023] 的范围内,Alpha 的取值在 [0, 3] 的范围内。

DataFormat DATA_FORMAT_A2R10G10B10_SINT_PACK32 = 62

带符号整数 Alpha、红、绿、蓝通道数据格式,使用归一化的值,紧缩在 32 个比特位中。格式中包含 2 位 Alpha、10 位红、10 位绿、10 位蓝。红、绿、蓝的取值在 [-511, 511] 的范围内,Alpha 的取值在 [-1, 1] 的范围内。

DataFormat DATA_FORMAT_A2B10G10R10_UNORM_PACK32 = 63

无符号浮点数 Alpha、蓝、绿、红通道数据格式,使用归一化的值,紧缩在 32 个比特位中。格式中包含 2 位 Alpha、10 位蓝、10 位绿、10 位红。取值均在 [0.0, 1.0] 的范围内。

DataFormat DATA_FORMAT_A2B10G10R10_SNORM_PACK32 = 64

带符号浮点数 Alpha、蓝、绿、红通道数据格式,使用归一化的值,紧缩在 32 个比特位中。格式中包含 2 位 Alpha、10 位蓝、10 位绿、10 位红。取值均在 [-1.0, 1.0] 的范围内。

DataFormat DATA_FORMAT_A2B10G10R10_USCALED_PACK32 = 65

无符号浮点数 Alpha、蓝、绿、红通道数据格式,使用归一化的值,紧缩在 32 个比特位中。格式中包含 2 位 Alpha、10 位蓝、10 位绿、10 位红。蓝、绿、红的取值在 [0.0, 1023.0] 的范围内,Alpha 的取值在 [0.0, 3.0] 的范围内。

DataFormat DATA_FORMAT_A2B10G10R10_SSCALED_PACK32 = 66

带符号浮点数 Alpha、蓝、绿、红通道数据格式,使用归一化的值,紧缩在 32 个比特位中。格式中包含 2 位 Alpha、10 位蓝、10 位绿、10 位红。蓝、绿、红的取值在 [-511.0, 511.0] 的范围内,Alpha 的取值在 [-1.0, 1.0] 的范围内。

DataFormat DATA_FORMAT_A2B10G10R10_UINT_PACK32 = 67

无符号整数 Alpha、蓝、绿、红通道数据格式,使用归一化的值,紧缩在 32 个比特位中。格式中包含 2 位 Alpha、10 位蓝、10 位绿、10 位红。蓝、绿、红的取值在 [0, 1023] 的范围内,Alpha 的取值在 [0, 3] 的范围内。

DataFormat DATA_FORMAT_A2B10G10R10_SINT_PACK32 = 68

带符号整数 Alpha、蓝、绿、红通道数据格式,使用归一化的值,紧缩在 32 个比特位中。格式中包含 2 位 Alpha、10 位蓝、10 位绿、10 位红。蓝、绿、红的取值在 [-511, 511] 的范围内,Alpha 的取值在 [-1, 1] 的范围内。

DataFormat DATA_FORMAT_R16_UNORM = 69

每通道 16 位的无符号浮点数红通道数据格式,使用归一化的值。取值均在 [0.0, 1.0] 的范围内。

DataFormat DATA_FORMAT_R16_SNORM = 70

每通道 16 位的带符号浮点数红通道数据格式,使用归一化的值。取值均在 [-1.0, 1.0] 的范围内。

DataFormat DATA_FORMAT_R16_USCALED = 71

每通道 16 位的无符号浮点数红通道数据格式,使用缩放后的值(值从整数转换为浮点数)。取值均在 [0.0, 65535.0] 的范围内。

DataFormat DATA_FORMAT_R16_SSCALED = 72

每通道 16 位的带符号浮点数红通道数据格式,使用缩放后的值(值从整数转换为浮点数)。取值均在 [-32767.0, 32767.0] 的范围内。

DataFormat DATA_FORMAT_R16_UINT = 73

每通道 16 位的无符号整数红通道数据格式。取值均在 [0.0, 65535] 的范围内。

DataFormat DATA_FORMAT_R16_SINT = 74

每通道 16 位的带符号整数红通道数据格式。取值均在 [-32767, 32767] 的范围内。

DataFormat DATA_FORMAT_R16_SFLOAT = 75

每通道 16 位的带符号浮点数红通道数据格式,数值原样存储。

DataFormat DATA_FORMAT_R16G16_UNORM = 76

每通道 16 位的无符号浮点数红、绿通道数据格式,使用归一化的值。取值均在 [0.0, 1.0] 的范围内。

DataFormat DATA_FORMAT_R16G16_SNORM = 77

每通道 16 位的带符号浮点数红、绿通道数据格式,使用归一化的值。取值均在 [-1.0, 1.0] 的范围内。

DataFormat DATA_FORMAT_R16G16_USCALED = 78

每通道 16 位的无符号浮点数红、绿通道数据格式,使用缩放后的值(值从整数转换为浮点数)。取值均在 [0.0, 65535.0] 的范围内。

DataFormat DATA_FORMAT_R16G16_SSCALED = 79

每通道 16 位的带符号浮点数红、绿通道数据格式,使用缩放后的值(值从整数转换为浮点数)。取值均在 [-32767.0, 32767.0] 的范围内。

DataFormat DATA_FORMAT_R16G16_UINT = 80

每通道 16 位的无符号整数红、绿通道数据格式。取值均在 [0.0, 65535] 的范围内。

DataFormat DATA_FORMAT_R16G16_SINT = 81

每通道 16 位的带符号整数红、绿通道数据格式。取值均在 [-32767, 32767] 的范围内。

DataFormat DATA_FORMAT_R16G16_SFLOAT = 82

每通道 16 位的带符号浮点数红、绿通道数据格式,数值原样存储。

DataFormat DATA_FORMAT_R16G16B16_UNORM = 83

每通道 16 位的无符号浮点数红、绿、蓝通道数据格式,使用归一化的值。取值均在 [0.0, 1.0] 的范围内。

DataFormat DATA_FORMAT_R16G16B16_SNORM = 84

每通道 16 位的带符号浮点数红、绿、蓝通道数据格式,使用归一化的值。取值均在 [-1.0, 1.0] 的范围内。

DataFormat DATA_FORMAT_R16G16B16_USCALED = 85

每通道 16 位的无符号浮点数红、绿、蓝通道数据格式,使用缩放后的值(值从整数转换为浮点数)。取值均在 [0.0, 65535.0] 的范围内。

DataFormat DATA_FORMAT_R16G16B16_SSCALED = 86

每通道 16 位的带符号浮点数红、绿、蓝通道数据格式,使用缩放后的值(值从整数转换为浮点数)。取值均在 [-32767.0, 32767.0] 的范围内。

DataFormat DATA_FORMAT_R16G16B16_UINT = 87

每通道 16 位的无符号整数红、绿、蓝通道数据格式。取值均在 [0.0, 65535] 的范围内。

DataFormat DATA_FORMAT_R16G16B16_SINT = 88

每通道 16 位的带符号整数红、绿、蓝通道数据格式。取值均在 [-32767, 32767] 的范围内。

DataFormat DATA_FORMAT_R16G16B16_SFLOAT = 89

每通道 16 位的带符号浮点数红、绿、蓝通道数据格式,数值原样存储。

DataFormat DATA_FORMAT_R16G16B16A16_UNORM = 90

每通道 16 位的无符号浮点数红、绿、蓝、Alpha 通道数据格式,使用归一化的值。取值均在 [0.0, 1.0] 的范围内。

DataFormat DATA_FORMAT_R16G16B16A16_SNORM = 91

每通道 16 位的带符号浮点数红、绿、蓝、Alpha 通道数据格式,使用归一化的值。取值均在 [-1.0, 1.0] 的范围内。

DataFormat DATA_FORMAT_R16G16B16A16_USCALED = 92

每通道 16 位的无符号浮点数红、绿、蓝、Alpha 通道数据格式,使用缩放后的值(值从整数转换为浮点数)。取值均在 [0.0, 65535.0] 的范围内。

DataFormat DATA_FORMAT_R16G16B16A16_SSCALED = 93

每通道 16 位的带符号浮点数红、绿、蓝、Alpha 通道数据格式,使用缩放后的值(值从整数转换为浮点数)。取值均在 [-32767.0, 32767.0] 的范围内。

DataFormat DATA_FORMAT_R16G16B16A16_UINT = 94

每通道 16 位的无符号整数红、绿、蓝、Alpha 通道数据格式。取值均在 [0.0, 65535] 的范围内。

DataFormat DATA_FORMAT_R16G16B16A16_SINT = 95

每通道 16 位的带符号整数红、绿、蓝、Alpha 通道数据格式。取值均在 [-32767, 32767] 的范围内。

DataFormat DATA_FORMAT_R16G16B16A16_SFLOAT = 96

每通道 16 位的带符号浮点数红、绿、蓝、Alpha 通道数据格式,数值原样存储。

DataFormat DATA_FORMAT_R32_UINT = 97

每通道 32 位的无符号整数红通道数据格式。取值均在 [0, 2^32 - 1] 的范围内。

DataFormat DATA_FORMAT_R32_SINT = 98

每通道 32 位的带符号整数红通道数据格式。取值均在 [2^31 + 1, 2^31 - 1] 的范围内。

DataFormat DATA_FORMAT_R32_SFLOAT = 99

每通道 32 位的带符号整数红通道数据格式,数值原样存储。

DataFormat DATA_FORMAT_R32G32_UINT = 100

每通道 32 位的无符号整数红、绿通道数据格式。取值均在 [0, 2^32 - 1] 的范围内。

DataFormat DATA_FORMAT_R32G32_SINT = 101

每通道 32 位的带符号整数红、绿通道数据格式。取值均在 [2^31 + 1, 2^31 - 1] 的范围内。

DataFormat DATA_FORMAT_R32G32_SFLOAT = 102

每通道 32 位的带符号整数红、绿通道数据格式,数值原样存储。

DataFormat DATA_FORMAT_R32G32B32_UINT = 103

每通道 32 位的无符号整数红、绿、蓝通道数据格式。取值均在 [0, 2^32 - 1] 的范围内。

DataFormat DATA_FORMAT_R32G32B32_SINT = 104

每通道 32 位的带符号整数红、绿、蓝通道数据格式。取值均在 [2^31 + 1, 2^31 - 1] 的范围内。

DataFormat DATA_FORMAT_R32G32B32_SFLOAT = 105

每通道 32 位的带符号整数红、绿、蓝通道数据格式,数值原样存储。

DataFormat DATA_FORMAT_R32G32B32A32_UINT = 106

每通道 32 位的无符号整数红、绿、蓝、Alpha 通道数据格式。取值均在 [0, 2^32 - 1] 的范围内。

DataFormat DATA_FORMAT_R32G32B32A32_SINT = 107

每通道 32 位的带符号整数红、绿、蓝、Alpha 通道数据格式。取值均在 [2^31 + 1, 2^31 - 1] 的范围内。

DataFormat DATA_FORMAT_R32G32B32A32_SFLOAT = 108

每通道 32 位的带符号整数红、绿、蓝、Alpha 通道数据格式,数值原样存储。

DataFormat DATA_FORMAT_R64_UINT = 109

每通道 64 位的无符号整数红通道数据格式。取值均在 [0, 2^64 - 1] 的范围内。

DataFormat DATA_FORMAT_R64_SINT = 110

每通道 64 位的带符号整数红通道数据格式。取值均在 [2^63 + 1, 2^63 - 1] 的范围内。

DataFormat DATA_FORMAT_R64_SFLOAT = 111

每通道 64 位的带符号整数红通道数据格式,数值原样存储。

DataFormat DATA_FORMAT_R64G64_UINT = 112

每通道 64 位的无符号整数红、绿通道数据格式。取值均在 [0, 2^64 - 1] 的范围内。

DataFormat DATA_FORMAT_R64G64_SINT = 113

每通道 64 位的带符号整数红、绿通道数据格式。取值均在 [2^63 + 1, 2^63 - 1] 的范围内。

DataFormat DATA_FORMAT_R64G64_SFLOAT = 114

每通道 64 位的带符号整数红、绿通道数据格式,数值原样存储。

DataFormat DATA_FORMAT_R64G64B64_UINT = 115

每通道 64 位的无符号整数红、绿、蓝通道数据格式。取值均在 [0, 2^64 - 1] 的范围内。

DataFormat DATA_FORMAT_R64G64B64_SINT = 116

每通道 64 位的带符号整数红、绿、蓝通道数据格式。取值均在 [2^63 + 1, 2^63 - 1] 的范围内。

DataFormat DATA_FORMAT_R64G64B64_SFLOAT = 117

每通道 64 位的带符号整数红、绿、蓝通道数据格式,数值原样存储。

DataFormat DATA_FORMAT_R64G64B64A64_UINT = 118

每通道 64 位的无符号整数红、绿、蓝、Alpha 通道数据格式。取值均在 [0, 2^64 - 1] 的范围内。

DataFormat DATA_FORMAT_R64G64B64A64_SINT = 119

每通道 64 位的带符号整数红、绿、蓝、Alpha 通道数据格式。取值均在 [2^63 + 1, 2^63 - 1] 的范围内。

DataFormat DATA_FORMAT_R64G64B64A64_SFLOAT = 120

每通道 64 位的带符号整数红、绿、蓝、Alpha 通道数据格式,数值原样存储。

DataFormat DATA_FORMAT_B10G11R11_UFLOAT_PACK32 = 121

无符号浮点数蓝、绿、红数据格式,数值原样存储,紧缩在 32 个比特位中。该格式的精度为蓝通道 10 位、绿通道 11 位、红通道 11 位。

DataFormat DATA_FORMAT_E5B9G9R9_UFLOAT_PACK32 = 122

无符号浮点数曝光、蓝、绿、红数据格式,数值原样存储,紧缩在 32 个比特位中。该格式的精度为曝光 5 位、蓝通道 9 位、绿通道 9 位、红通道 9 位。

DataFormat DATA_FORMAT_D16_UNORM = 123

16 位无符号浮点数深度数据格式,使用归一化的值。取值均在 [0.0, 1.0] 的范围内。

DataFormat DATA_FORMAT_X8_D24_UNORM_PACK32 = 124

24 位无符号浮点数深度数据格式,使用归一化的值,另有 8 位未使用,紧缩在 32 个比特位中。深度取值在 [0.0, 1.0] 的范围内。

DataFormat DATA_FORMAT_D32_SFLOAT = 125

32 位无符号浮点数深度数据格式,数值原样存储。

DataFormat DATA_FORMAT_S8_UINT = 126

8 位无符号整数模板数据格式。

DataFormat DATA_FORMAT_D16_UNORM_S8_UINT = 127

16 位无符号浮点数深度数据格式,使用归一化的值,另有 8 位使用无符号整数格式的模板。深度取值在 [0.0, 1.0] 的范围内。模板取值在 [0, 255] 的范围内。

DataFormat DATA_FORMAT_D24_UNORM_S8_UINT = 128

24 位无符号浮点数深度数据格式,使用归一化的值,另有 8 位使用无符号整数格式的模板。深度取值在 [0.0, 1.0] 的范围内。模板取值在 [0, 255] 的范围内。

DataFormat DATA_FORMAT_D32_SFLOAT_S8_UINT = 129

32 位无符号浮点数深度数据格式,数值原样存储,另有 8 位使用无符号整数格式的模板。模板取值在 [0, 255] 的范围内。

DataFormat DATA_FORMAT_BC1_RGB_UNORM_BLOCK = 130

显存压缩的无符号红、绿、蓝通道数据格式,使用归一化的值。取值均在 [0.0, 1.0] 的范围内。该格式的精度为红通道 5 位、绿通道 6 位、蓝通道 5 位。使用 BC1 纹理压缩(也叫 S3TC DXT1)。

DataFormat DATA_FORMAT_BC1_RGB_SRGB_BLOCK = 131

显存压缩的无符号红、绿、蓝通道数据格式,使用归一化的值、非线性 sRGB 编码。取值均在 [0.0, 1.0] 的范围内。该格式的精度为红通道 5 位、绿通道 6 位、蓝通道 5 位。使用 BC1 纹理压缩(也叫 S3TC DXT1)。

DataFormat DATA_FORMAT_BC1_RGBA_UNORM_BLOCK = 132

显存压缩的无符号红、绿、蓝、Alpha 通道数据格式,使用归一化的值。取值均在 [0.0, 1.0] 的范围内。该格式的精度为红通道 5 位、绿通道 6 位、蓝通道 5 位、Alpha 通道 1 位。使用 BC1 纹理压缩(也叫 S3TC DXT1)。

DataFormat DATA_FORMAT_BC1_RGBA_SRGB_BLOCK = 133

显存压缩的无符号红、绿、蓝、Alpha 通道数据格式,使用归一化的值、非线性 sRGB 编码。取值均在 [0.0, 1.0] 的范围内。该格式的精度为红通道 5 位、绿通道 6 位、蓝通道 5 位、Alpha 通道 1 位。使用 BC1 纹理压缩(也叫 S3TC DXT1)。

DataFormat DATA_FORMAT_BC2_UNORM_BLOCK = 134

显存压缩的无符号红、绿、蓝、Alpha 通道数据格式,使用归一化的值。取值均在 [0.0, 1.0] 的范围内。该格式的精度为红通道 5 位、绿通道 6 位、蓝通道 5 位、Alpha 通道 4 位。使用 BC2 纹理压缩(也叫 S3TC DXT3)。

DataFormat DATA_FORMAT_BC2_SRGB_BLOCK = 135

显存压缩的无符号红、绿、蓝、Alpha 通道数据格式,使用归一化的值、非线性 sRGB 编码。取值均在 [0.0, 1.0] 的范围内。该格式的精度为红通道 5 位、绿通道 6 位、蓝通道 5 位、Alpha 通道 4 位。使用 BC2 纹理压缩(也叫 S3TC DXT3)。

DataFormat DATA_FORMAT_BC3_UNORM_BLOCK = 136

显存压缩的无符号红、绿、蓝、Alpha 通道数据格式,使用归一化的值。取值均在 [0.0, 1.0] 的范围内。该格式的精度为红通道 5 位、绿通道 6 位、蓝通道 5 位、Alpha 通道 8 位。使用 BC3 纹理压缩(也叫 S3TC DXT5)。

DataFormat DATA_FORMAT_BC3_SRGB_BLOCK = 137

显存压缩的无符号红、绿、蓝、Alpha 通道数据格式,使用归一化的值、非线性 sRGB 编码。取值均在 [0.0, 1.0] 的范围内。该格式的精度为红通道 5 位、绿通道 6 位、蓝通道 5 位、Alpha 通道 8 位。使用 BC3 纹理压缩(也叫 S3TC DXT5)。

DataFormat DATA_FORMAT_BC4_UNORM_BLOCK = 138

显存压缩的无符号红通道数据格式,使用归一化的值。取值均在 [0.0, 1.0] 的范围内。该格式的精度为红通道 8 位。使用 BC4 纹理压缩。

DataFormat DATA_FORMAT_BC4_SNORM_BLOCK = 139

显存压缩的带符号红通道数据格式,使用归一化的值。取值均在 [-1.0, 1.0] 的范围内。该格式的精度为红通道 8 位。使用 BC4 纹理压缩。

DataFormat DATA_FORMAT_BC5_UNORM_BLOCK = 140

显存压缩的无符号红、绿通道数据格式,使用归一化的值。取值均在 [0.0, 1.0] 的范围内。该格式的精度为红通道 8 位、绿通道 8 位。使用 BC5 纹理压缩(也叫 S3TC RGTC)。

DataFormat DATA_FORMAT_BC5_SNORM_BLOCK = 141

显存压缩的带符号红、绿通道数据格式,使用归一化的值。取值均在 [-1.0, 1.0] 的范围内。该格式的精度为红通道 8 位、绿通道 8 位。使用 BC5 纹理压缩(也叫 S3TC RGTC)。

DataFormat DATA_FORMAT_BC6H_UFLOAT_BLOCK = 142

显存压缩的无符号红、绿、蓝通道数据格式,浮点数值原样存储。该格式的精度为红通道 8 位、绿通道 8 位。使用 BC6H 纹理压缩(也叫 BPTC HDR)。

DataFormat DATA_FORMAT_BC6H_SFLOAT_BLOCK = 143

显存压缩的带符号红、绿、蓝通道数据格式,浮点数值原样存储。该格式的精度为红、绿、蓝通道在 4 到 7 位之间,Alpha 通道在 0 到 8 位之间。使用 BC7 纹理压缩(也叫 BPTC HDR)。

DataFormat DATA_FORMAT_BC7_UNORM_BLOCK = 144

显存压缩的无符号红、绿、蓝、Alpha 通道数据格式,使用归一化的值。取值均在 [0.0, 1.0] 的范围内。该格式的精度为红、绿、蓝通道在 4 到 7 位之间,Alpha 通道在 0 到 8 位之间。使用 BC7 纹理压缩。也叫 BPTC HDR。

DataFormat DATA_FORMAT_BC7_SRGB_BLOCK = 145

显存压缩的无符号红、绿、蓝、Alpha 通道数据格式,使用归一化的值、非线性 sRGB 编码。取值均在 [0.0, 1.0] 的范围内。该格式的精度为红、绿、蓝通道在 4 到 7 位之间,Alpha 通道在 0 到 8 位之间。使用 BC7 纹理压缩。也叫 BPTC HDR。

DataFormat DATA_FORMAT_ETC2_R8G8B8_UNORM_BLOCK = 146

显存压缩的无符号红、绿、蓝通道数据格式,使用归一化的值。取值均在 [0.0, 1.0] 的范围内。使用 ETC2 纹理压缩。

DataFormat DATA_FORMAT_ETC2_R8G8B8_SRGB_BLOCK = 147

显存压缩的无符号红、绿、蓝通道数据格式,使用归一化的值、非线性 sRGB 编码。取值均在 [0.0, 1.0] 的范围内。使用 ETC2 纹理压缩。

DataFormat DATA_FORMAT_ETC2_R8G8B8A1_UNORM_BLOCK = 148

显存压缩的无符号红、绿、蓝、Alpha 通道数据格式,使用归一化的值。取值均在 [0.0, 1.0] 的范围内。红、绿、蓝均使用 8 位精度,Alpha 使用 1 位精度。使用 ETC2 纹理压缩。

DataFormat DATA_FORMAT_ETC2_R8G8B8A1_SRGB_BLOCK = 149

显存压缩的无符号红、绿、蓝、Alpha 通道数据格式,使用归一化的值、非线性 sRGB 编码。取值均在 [0.0, 1.0] 的范围内。红、绿、蓝均使用 8 位精度,Alpha 使用 1 位精度。使用 ETC2 纹理压缩。

DataFormat DATA_FORMAT_ETC2_R8G8B8A8_UNORM_BLOCK = 150

显存压缩的无符号红、绿、蓝、Alpha 通道数据格式,使用归一化的值。取值均在 [0.0, 1.0] 的范围内。红、绿、蓝均使用 8 位精度,Alpha 使用 8 位精度。使用 ETC2 纹理压缩。

DataFormat DATA_FORMAT_ETC2_R8G8B8A8_SRGB_BLOCK = 151

显存压缩的无符号红、绿、蓝、Alpha 通道数据格式,使用归一化的值、非线性 sRGB 编码。取值均在 [0.0, 1.0] 的范围内。红、绿、蓝均使用 8 位精度,Alpha 使用 8 位精度。使用 ETC2 纹理压缩。

DataFormat DATA_FORMAT_EAC_R11_UNORM_BLOCK = 152

11 位显存压缩的无符号红通道数据格式,使用归一化的值。取值均在 [0.0, 1.0] 的范围内。使用 ETC2 纹理压缩。

DataFormat DATA_FORMAT_EAC_R11_SNORM_BLOCK = 153

11 位显存压缩的带符号红通道数据格式,使用归一化的值。取值均在 [0.0, 1.0] 的范围内。使用 ETC2 纹理压缩。

DataFormat DATA_FORMAT_EAC_R11G11_UNORM_BLOCK = 154

11 位显存压缩的无符号红、绿通道数据格式,使用归一化的值。取值均在 [0.0, 1.0] 的范围内。使用 ETC2 纹理压缩。

DataFormat DATA_FORMAT_EAC_R11G11_SNORM_BLOCK = 155

11 位显存压缩的带符号红、绿通道数据格式,使用归一化的值。取值均在 [0.0, 1.0] 的范围内。使用 ETC2 纹理压缩。

DataFormat DATA_FORMAT_ASTC_4x4_UNORM_BLOCK = 156

显存压缩的无符号浮点数数据格式,使用归一化的值,紧缩在 4x4 的区块内(质量最高)。取值均在 [0.0, 1.0] 的范围内。使用 ASTC 压缩。

DataFormat DATA_FORMAT_ASTC_4x4_SRGB_BLOCK = 157

显存压缩的无符号浮点数数据格式,使用归一化的值、非线性 sRGB 编码,紧缩在 4x4 的区块内(质量最高)。取值均在 [0.0, 1.0] 的范围内。使用 ASTC 压缩。

DataFormat DATA_FORMAT_ASTC_5x4_UNORM_BLOCK = 158

显存压缩的无符号浮点数数据格式,使用归一化的值,紧缩在 5x4 的区块内。取值均在 [0.0, 1.0] 的范围内。使用 ASTC 压缩。

DataFormat DATA_FORMAT_ASTC_5x4_SRGB_BLOCK = 159

显存压缩的无符号浮点数数据格式,使用归一化的值、非线性 sRGB 编码,紧缩在 5x4 的区块内。取值均在 [0.0, 1.0] 的范围内。使用 ASTC 压缩。

DataFormat DATA_FORMAT_ASTC_5x5_UNORM_BLOCK = 160

显存压缩的无符号浮点数数据格式,使用归一化的值,紧缩在 5x5 的区块内。取值均在 [0.0, 1.0] 的范围内。使用 ASTC 压缩。

DataFormat DATA_FORMAT_ASTC_5x5_SRGB_BLOCK = 161

显存压缩的无符号浮点数数据格式,使用归一化的值、非线性 sRGB 编码,紧缩在 5x5 的区块内。取值均在 [0.0, 1.0] 的范围内。使用 ASTC 压缩。

DataFormat DATA_FORMAT_ASTC_6x5_UNORM_BLOCK = 162

显存压缩的无符号浮点数数据格式,使用归一化的值,紧缩在 6x5 的区块内。取值均在 [0.0, 1.0] 的范围内。使用 ASTC 压缩。

DataFormat DATA_FORMAT_ASTC_6x5_SRGB_BLOCK = 163

显存压缩的无符号浮点数数据格式,使用归一化的值、非线性 sRGB 编码,紧缩在 6x5 的区块内。取值均在 [0.0, 1.0] 的范围内。使用 ASTC 压缩。

DataFormat DATA_FORMAT_ASTC_6x6_UNORM_BLOCK = 164

显存压缩的无符号浮点数数据格式,使用归一化的值,紧缩在 6x6 的区块内。取值均在 [0.0, 1.0] 的范围内。使用 ASTC 压缩。

DataFormat DATA_FORMAT_ASTC_6x6_SRGB_BLOCK = 165

显存压缩的无符号浮点数数据格式,使用归一化的值、非线性 sRGB 编码,紧缩在 6x6 的区块内。取值均在 [0.0, 1.0] 的范围内。使用 ASTC 压缩。

DataFormat DATA_FORMAT_ASTC_8x5_UNORM_BLOCK = 166

显存压缩的无符号浮点数数据格式,使用归一化的值,紧缩在 8x5 的区块内。取值均在 [0.0, 1.0] 的范围内。使用 ASTC 压缩。

DataFormat DATA_FORMAT_ASTC_8x5_SRGB_BLOCK = 167

显存压缩的无符号浮点数数据格式,使用归一化的值、非线性 sRGB 编码,紧缩在 8x5 的区块内。取值均在 [0.0, 1.0] 的范围内。使用 ASTC 压缩。

DataFormat DATA_FORMAT_ASTC_8x6_UNORM_BLOCK = 168

显存压缩的无符号浮点数数据格式,使用归一化的值,紧缩在 8x6 的区块内。取值均在 [0.0, 1.0] 的范围内。使用 ASTC 压缩。

DataFormat DATA_FORMAT_ASTC_8x6_SRGB_BLOCK = 169

显存压缩的无符号浮点数数据格式,使用归一化的值、非线性 sRGB 编码,紧缩在 8x6 的区块内。取值均在 [0.0, 1.0] 的范围内。使用 ASTC 压缩。

DataFormat DATA_FORMAT_ASTC_8x8_UNORM_BLOCK = 170

显存压缩的无符号浮点数数据格式,使用归一化的值,紧缩在 8x8 的区块内。取值均在 [0.0, 1.0] 的范围内。使用 ASTC 压缩。

DataFormat DATA_FORMAT_ASTC_8x8_SRGB_BLOCK = 171

显存压缩的无符号浮点数数据格式,使用归一化的值、非线性 sRGB 编码,紧缩在 8x8 的区块内。取值均在 [0.0, 1.0] 的范围内。使用 ASTC 压缩。

DataFormat DATA_FORMAT_ASTC_10x5_UNORM_BLOCK = 172

显存压缩的无符号浮点数数据格式,使用归一化的值,紧缩在 10x5 的区块内。取值均在 [0.0, 1.0] 的范围内。使用 ASTC 压缩。

DataFormat DATA_FORMAT_ASTC_10x5_SRGB_BLOCK = 173

显存压缩的无符号浮点数数据格式,使用归一化的值、非线性 sRGB 编码,紧缩在 10x5 的区块内。取值均在 [0.0, 1.0] 的范围内。使用 ASTC 压缩。

DataFormat DATA_FORMAT_ASTC_10x6_UNORM_BLOCK = 174

显存压缩的无符号浮点数数据格式,使用归一化的值,紧缩在 10x6 的区块内。取值均在 [0.0, 1.0] 的范围内。使用 ASTC 压缩。

DataFormat DATA_FORMAT_ASTC_10x6_SRGB_BLOCK = 175

显存压缩的无符号浮点数数据格式,使用归一化的值、非线性 sRGB 编码,紧缩在 10x6 的区块内。取值均在 [0.0, 1.0] 的范围内。使用 ASTC 压缩。

DataFormat DATA_FORMAT_ASTC_10x8_UNORM_BLOCK = 176

显存压缩的无符号浮点数数据格式,使用归一化的值,紧缩在 10x8 的区块内。取值均在 [0.0, 1.0] 的范围内。使用 ASTC 压缩。

DataFormat DATA_FORMAT_ASTC_10x8_SRGB_BLOCK = 177

显存压缩的无符号浮点数数据格式,使用归一化的值、非线性 sRGB 编码,紧缩在 10x8 的区块内。取值均在 [0.0, 1.0] 的范围内。使用 ASTC 压缩。

DataFormat DATA_FORMAT_ASTC_10x10_UNORM_BLOCK = 178

显存压缩的无符号浮点数数据格式,使用归一化的值,紧缩在 10x10 的区块内。取值均在 [0.0, 1.0] 的范围内。使用 ASTC 压缩。

DataFormat DATA_FORMAT_ASTC_10x10_SRGB_BLOCK = 179

显存压缩的无符号浮点数数据格式,使用归一化的值、非线性 sRGB 编码,紧缩在 10x10 的区块内。取值均在 [0.0, 1.0] 的范围内。使用 ASTC 压缩。

DataFormat DATA_FORMAT_ASTC_12x10_UNORM_BLOCK = 180

显存压缩的无符号浮点数数据格式,使用归一化的值,紧缩在 12x10 的区块内。取值均在 [0.0, 1.0] 的范围内。使用 ASTC 压缩。

DataFormat DATA_FORMAT_ASTC_12x10_SRGB_BLOCK = 181

显存压缩的无符号浮点数数据格式,使用归一化的值、非线性 sRGB 编码,紧缩在 12x10 的区块内。取值均在 [0.0, 1.0] 的范围内。使用 ASTC 压缩。

DataFormat DATA_FORMAT_ASTC_12x12_UNORM_BLOCK = 182

显存压缩的无符号浮点数数据格式,使用归一化的值,紧缩在 12 个区块内(质量最低)。取值均在 [0.0, 1.0] 的范围内。使用 ASTC 压缩。

DataFormat DATA_FORMAT_ASTC_12x12_SRGB_BLOCK = 183

显存压缩的无符号浮点数数据格式,使用归一化的值、非线性 sRGB 编码,紧缩在 12 个区块内(质量最低)。取值均在 [0.0, 1.0] 的范围内。使用 ASTC 压缩。

DataFormat DATA_FORMAT_G8B8G8R8_422_UNORM = 184

每通道 8 位的无符号浮点数绿、蓝、红通道数据格式,使用归一化的值。取值均在 [0.0, 1.0] 的范围内。蓝、红通道数据横向半分辨率存储(即两个横向相邻的像素共享同一个蓝、红通道数值)。

DataFormat DATA_FORMAT_B8G8R8G8_422_UNORM = 185

每通道 8 位的无符号浮点数蓝、绿、红通道数据格式,使用归一化的值。取值均在 [0.0, 1.0] 的范围内。蓝、红通道数据横向半分辨率存储(即两个横向相邻的像素共享同一个蓝、红通道数值)。

DataFormat DATA_FORMAT_G8_B8_R8_3PLANE_420_UNORM = 186

每通道 8 位的无符号浮点数绿、蓝、红通道数据格式,使用归一化的值,分别在三个独立平面存储(绿 + 蓝 + 红)。取值均在 [0.0, 1.0] 的范围内。蓝、红通道数据纵横半分辨率存储(即 2x2 相邻的像素共享同一个蓝、红通道数值)。

DataFormat DATA_FORMAT_G8_B8R8_2PLANE_420_UNORM = 187

每通道 8 位的无符号浮点数绿、蓝、红通道数据格式,使用归一化的值,分别在两个独立平面存储(绿 + 蓝、红)。取值均在 [0.0, 1.0] 的范围内。蓝、红通道数据纵横半分辨率存储(即 2x2 相邻的像素共享同一个蓝、红通道数值)。

DataFormat DATA_FORMAT_G8_B8_R8_3PLANE_422_UNORM = 188

每通道 8 位的无符号浮点数绿、蓝、红通道数据格式,使用归一化的值,分别在两个独立平面存储(绿 + 蓝 + 红)。取值均在 [0.0, 1.0] 的范围内。蓝、红通道数据横向半分辨率存储(即两个横向相邻的像素共享同一个蓝、红通道数值)。

DataFormat DATA_FORMAT_G8_B8R8_2PLANE_422_UNORM = 189

每通道 8 位的无符号浮点数绿、蓝、红通道数据格式,使用归一化的值,分别在两个独立平面存储(绿 + 蓝、红)。取值均在 [0.0, 1.0] 的范围内。蓝、红通道数据横向半分辨率存储(即两个横向相邻的像素共享同一个蓝、红通道数值)。

DataFormat DATA_FORMAT_G8_B8_R8_3PLANE_444_UNORM = 190

每通道 8 位的无符号浮点数绿、蓝、红通道数据格式,使用归一化的值,分别在三个独立平面存储。取值均在 [0.0, 1.0] 的范围内。

DataFormat DATA_FORMAT_R10X6_UNORM_PACK16 = 191

每通道 10 位的无符号浮点数红通道数据,使用归一化的值,另有 6 位未使用,紧缩在 16 个比特位中。取值均在 [0.0, 1.0] 的范围内。

DataFormat DATA_FORMAT_R10X6G10X6_UNORM_2PACK16 = 192

每通道 10 位的无符号浮点数红、绿通道数据,使用归一化的值,每个通道均另有 6 位未使用,紧缩在 2x16 个比特位中。取值均在 [0.0, 1.0] 的范围内。

DataFormat DATA_FORMAT_R10X6G10X6B10X6A10X6_UNORM_4PACK16 = 193

每通道 10 位的无符号浮点数红、绿、蓝、Alpha 通道数据,使用归一化的值,每个通道均另有 6 位未使用,紧缩在 4x16 个比特位中。取值均在 [0.0, 1.0] 的范围内。

DataFormat DATA_FORMAT_G10X6B10X6G10X6R10X6_422_UNORM_4PACK16 = 194

每通道 10 位的无符号浮点数绿、蓝、绿、红通道数据,使用归一化的值,每个通道均另有 6 位未使用,紧缩在 4x16 个比特位中。取值均在 [0.0, 1.0] 的范围内。蓝、红通道数据横向半分辨率存储(即两个横向相邻的像素共享同一个蓝、红通道数值)。绿通道出现两次,但包含不同的值,因此能够表示为完整的分辨率。

DataFormat DATA_FORMAT_B10X6G10X6R10X6G10X6_422_UNORM_4PACK16 = 195

每通道 10 位的无符号浮点数蓝、绿、红、绿通道数据,使用归一化的值,每个通道均另有 6 位未使用,紧缩在 4x16 个比特位中。取值均在 [0.0, 1.0] 的范围内。蓝、红通道数据横向半分辨率存储(即两个横向相邻的像素共享同一个蓝、红通道数值)。绿通道出现两次,但包含不同的值,因此能够表示为完整的分辨率。

DataFormat DATA_FORMAT_G10X6_B10X6_R10X6_3PLANE_420_UNORM_3PACK16 = 196

每通道 10 位的无符号浮点数绿、蓝、红通道数据,使用归一化的值,每个通道均另有 6 位未使用,紧缩在 3x16 个比特位中,分别在两个独立平面存储(绿 + 蓝 + 红)。取值均在 [0.0, 1.0] 的范围内。蓝、红通道数据纵横半分辨率存储(即 2x2 相邻的像素共享同一个蓝、红通道数值)。

DataFormat DATA_FORMAT_G10X6_B10X6R10X6_2PLANE_420_UNORM_3PACK16 = 197

每通道 10 位的无符号浮点数绿、蓝、红通道数据,使用归一化的值,每个通道均另有 6 位未使用,紧缩在 3x16 个比特位中,分别在两个独立平面存储(绿 + 蓝、红)。取值均在 [0.0, 1.0] 的范围内。蓝、红通道数据纵横半分辨率存储(即 2x2 相邻的像素共享同一个蓝、红通道数值)。

DataFormat DATA_FORMAT_G10X6_B10X6_R10X6_3PLANE_422_UNORM_3PACK16 = 198

每通道 10 位的无符号浮点数绿、蓝、红通道数据,使用归一化的值,每个通道均另有 6 位未使用,紧缩在 3x16 个比特位中,分别在三个独立平面存储(绿 + 蓝 + 红)。取值均在 [0.0, 1.0] 的范围内。蓝、红通道数据横向半分辨率存储(即两个横向相邻的像素共享同一个蓝、红通道数值)。

DataFormat DATA_FORMAT_G10X6_B10X6R10X6_2PLANE_422_UNORM_3PACK16 = 199

每通道 10 位的无符号浮点数绿、蓝、红通道数据,使用归一化的值,每个通道均另有 6 位未使用,紧缩在 3x16 个比特位中,分别在三个独立平面存储(绿 + 蓝、红)。取值均在 [0.0, 1.0] 的范围内。蓝、红通道数据横向半分辨率存储(即两个横向相邻的像素共享同一个蓝、红通道数值)。

DataFormat DATA_FORMAT_G10X6_B10X6_R10X6_3PLANE_444_UNORM_3PACK16 = 200

每通道 10 位的无符号浮点数绿、蓝、红通道数据,使用归一化的值,每个通道均另有 6 位未使用,紧缩在 3x16 个比特位中,分别在三个独立平面存储(绿 + 蓝 + 红)。取值均在 [0.0, 1.0] 的范围内。

DataFormat DATA_FORMAT_R12X4_UNORM_PACK16 = 201

每通道 12 位的无符号浮点数红通道数据,使用归一化的值,另有 6 位未使用,紧缩在 16 个比特位中。取值均在 [0.0, 1.0] 的范围内。

DataFormat DATA_FORMAT_R12X4G12X4_UNORM_2PACK16 = 202

每通道 12 位的无符号浮点数红、绿通道数据,使用归一化的值,每个通道均另有 6 位未使用,紧缩在 2x16 个比特位中。取值均在 [0.0, 1.0] 的范围内。

DataFormat DATA_FORMAT_R12X4G12X4B12X4A12X4_UNORM_4PACK16 = 203

每通道 12 位的无符号浮点数红、绿、蓝、Alpha 通道数据,使用归一化的值,每个通道均另有 6 位未使用,紧缩在 4x16 个比特位中。取值均在 [0.0, 1.0] 的范围内。

DataFormat DATA_FORMAT_G12X4B12X4G12X4R12X4_422_UNORM_4PACK16 = 204

每通道 12 位的无符号浮点数绿、蓝、绿、红通道数据,使用归一化的值,每个通道均另有 6 位未使用,紧缩在 4x16 个比特位中。取值均在 [0.0, 1.0] 的范围内。蓝、红通道数据横向半分辨率存储(即两个横向相邻的像素共享同一个蓝、红通道数值)。绿通道出现两次,但包含不同的值,因此能够表示为完整的分辨率。

DataFormat DATA_FORMAT_B12X4G12X4R12X4G12X4_422_UNORM_4PACK16 = 205

每通道 12 位的无符号浮点数蓝、绿、红、绿通道数据,使用归一化的值,每个通道均另有 6 位未使用,紧缩在 4x16 个比特位中。取值均在 [0.0, 1.0] 的范围内。蓝、红通道数据横向半分辨率存储(即两个横向相邻的像素共享同一个蓝、红通道数值)。绿通道出现两次,但包含不同的值,因此能够表示为完整的分辨率。

DataFormat DATA_FORMAT_G12X4_B12X4_R12X4_3PLANE_420_UNORM_3PACK16 = 206

每通道 12 位的无符号浮点数绿、蓝、红通道数据,使用归一化的值,每个通道均另有 6 位未使用,紧缩在 3x16 个比特位中,分别在两个独立平面存储(绿 + 蓝 + 红)。取值均在 [0.0, 1.0] 的范围内。蓝、红通道数据纵横半分辨率存储(即 2x2 相邻的像素共享同一个蓝、红通道数值)。

DataFormat DATA_FORMAT_G12X4_B12X4R12X4_2PLANE_420_UNORM_3PACK16 = 207

每通道 12 位的无符号浮点数绿、蓝、红通道数据,使用归一化的值,每个通道均另有 6 位未使用,紧缩在 3x16 个比特位中,分别在两个独立平面存储(绿 + 蓝、红)。取值均在 [0.0, 1.0] 的范围内。蓝、红通道数据纵横半分辨率存储(即 2x2 相邻的像素共享同一个蓝、红通道数值)。

DataFormat DATA_FORMAT_G12X4_B12X4_R12X4_3PLANE_422_UNORM_3PACK16 = 208

每通道 12 位的无符号浮点数绿、蓝、红通道数据,使用归一化的值,每个通道均另有 6 位未使用,紧缩在 3x16 个比特位中,分别在三个独立平面存储(绿 + 蓝 + 红)。取值均在 [0.0, 1.0] 的范围内。蓝、红通道数据横向半分辨率存储(即两个横向相邻的像素共享同一个蓝、红通道数值)。

DataFormat DATA_FORMAT_G12X4_B12X4R12X4_2PLANE_422_UNORM_3PACK16 = 209

每通道 12 位的无符号浮点数绿、蓝、红通道数据,使用归一化的值,每个通道均另有 6 位未使用,紧缩在 3x16 个比特位中,分别在三个独立平面存储(绿 + 蓝、红)。取值均在 [0.0, 1.0] 的范围内。蓝、红通道数据横向半分辨率存储(即两个横向相邻的像素共享同一个蓝、红通道数值)。

DataFormat DATA_FORMAT_G12X4_B12X4_R12X4_3PLANE_444_UNORM_3PACK16 = 210

每通道 12 位的无符号浮点数绿、蓝、红通道数据,使用归一化的值,每个通道均另有 6 位未使用,紧缩在 3x16 个比特位中,分别在三个独立平面存储(绿 + 蓝 + 红)。取值均在 [0.0, 1.0] 的范围内。

DataFormat DATA_FORMAT_G16B16G16R16_422_UNORM = 211

每通道 16 位的无符号浮点数绿、蓝、红通道数据格式,使用归一化的值。取值均在 [0.0, 1.0] 的范围内。蓝、红通道数据横向半分辨率存储(即两个横向相邻的像素共享同一个蓝、红通道数值)。

DataFormat DATA_FORMAT_B16G16R16G16_422_UNORM = 212

每通道 16 位的无符号浮点数蓝、绿、红通道数据格式,使用归一化的值。取值均在 [0.0, 1.0] 的范围内。蓝、红通道数据横向半分辨率存储(即两个横向相邻的像素共享同一个蓝、红通道数值)。

DataFormat DATA_FORMAT_G16_B16_R16_3PLANE_420_UNORM = 213

每通道 16 位的无符号浮点数绿、蓝、红通道数据,使用归一化的值,每个通道均另有 6 位未使用。分别在两个独立平面存储(绿 + 蓝 + 红)。取值均在 [0.0, 1.0] 的范围内。蓝、红通道数据纵横半分辨率存储(即 2x2 相邻的像素共享同一个蓝、红通道数值)。

DataFormat DATA_FORMAT_G16_B16R16_2PLANE_420_UNORM = 214

每通道 16 位的无符号浮点数绿、蓝、红通道数据,使用归一化的值,每个通道均另有 6 位未使用。分别在两个独立平面存储(绿 + 蓝、红)。取值均在 [0.0, 1.0] 的范围内。蓝、红通道数据纵横半分辨率存储(即 2x2 相邻的像素共享同一个蓝、红通道数值)。

DataFormat DATA_FORMAT_G16_B16_R16_3PLANE_422_UNORM = 215

每通道 16 位的无符号浮点数绿、蓝、红通道数据,使用归一化的值,每个通道均另有 6 位未使用。分别在三个独立平面存储(绿 + 蓝 + 红)。取值均在 [0.0, 1.0] 的范围内。蓝、红通道数据横向半分辨率存储(即两个横向相邻的像素共享同一个蓝、红通道数值)。

DataFormat DATA_FORMAT_G16_B16R16_2PLANE_422_UNORM = 216

每通道 16 位的无符号浮点数绿、蓝、红通道数据,使用归一化的值,每个通道均另有 6 位未使用。分别在三个独立平面存储(绿 + 蓝、红)。取值均在 [0.0, 1.0] 的范围内。蓝、红通道数据横向半分辨率存储(即两个横向相邻的像素共享同一个蓝、红通道数值)。

DataFormat DATA_FORMAT_G16_B16_R16_3PLANE_444_UNORM = 217

每通道 16 位的无符号浮点数绿、蓝、红通道数据,使用归一化的值,每个通道均另有 6 位未使用。分别在三个独立平面存储(绿 + 蓝 + 红)。取值均在 [0.0, 1.0] 的范围内。

DataFormat DATA_FORMAT_MAX = 218

代表 DataFormat 枚举的大小。


flags BarrierMask:

BarrierMask BARRIER_MASK_VERTEX = 1

顶点着色器屏障掩码。

BarrierMask BARRIER_MASK_FRAGMENT = 8

片段着色器屏障掩码。

BarrierMask BARRIER_MASK_COMPUTE = 2

计算屏障掩码。

BarrierMask BARRIER_MASK_TRANSFER = 4

传输屏障掩码。

BarrierMask BARRIER_MASK_RASTER = 9

光栅屏障掩码(顶点及片段)。等价于 BARRIER_MASK_VERTEX | BARRIER_MASK_FRAGMENT

BarrierMask BARRIER_MASK_ALL_BARRIERS = 32767

所有类型的屏障掩码(顶点、片段、计算、传输)。

BarrierMask BARRIER_MASK_NO_BARRIER = 32768

任何类型都没有屏障。


enum TextureType:

TextureType TEXTURE_TYPE_1D = 0

一维纹理。

TextureType TEXTURE_TYPE_2D = 1

二维纹理。

TextureType TEXTURE_TYPE_3D = 2

三维纹理。

TextureType TEXTURE_TYPE_CUBE = 3

Cubemap 纹理。

TextureType TEXTURE_TYPE_1D_ARRAY = 4

一维纹理数组。

TextureType TEXTURE_TYPE_2D_ARRAY = 5

二维纹理数组。

TextureType TEXTURE_TYPE_CUBE_ARRAY = 6

Cubemap 纹理数组。

TextureType TEXTURE_TYPE_MAX = 7

代表 TextureType 枚举的大小。


enum TextureSamples:

TextureSamples TEXTURE_SAMPLES_1 = 0

执行 1 次纹理采样(最快,但抗锯齿质量最低)。

TextureSamples TEXTURE_SAMPLES_2 = 1

执行 2 次纹理采样。

TextureSamples TEXTURE_SAMPLES_4 = 2

执行 4 次纹理采样。

TextureSamples TEXTURE_SAMPLES_8 = 3

执行 8 次纹理采样。移动 GPU 不支持(包括 Apple Silicon)。

TextureSamples TEXTURE_SAMPLES_16 = 4

执行 16 次纹理采样。移动 GPU 及许多桌面 GPU 均不支持。

TextureSamples TEXTURE_SAMPLES_32 = 5

执行 32 次纹理采样。大多数 GPU 均不支持。

TextureSamples TEXTURE_SAMPLES_64 = 6

执行 64 次纹理采样(最慢,但抗锯齿质量最高)。大多数 GPU 均不支持。

TextureSamples TEXTURE_SAMPLES_MAX = 7

代表 TextureSamples 枚举的大小。


flags TextureUsageBits:

TextureUsageBits TEXTURE_USAGE_SAMPLING_BIT = 1

纹理可以采样。

TextureUsageBits TEXTURE_USAGE_COLOR_ATTACHMENT_BIT = 2

纹理可以用作帧缓冲的颜色附件。

TextureUsageBits TEXTURE_USAGE_DEPTH_STENCIL_ATTACHMENT_BIT = 4

纹理可以用作帧缓冲的深度/模板附件。

TextureUsageBits TEXTURE_USAGE_STORAGE_BIT = 8

纹理可以用作存储图像

TextureUsageBits TEXTURE_USAGE_STORAGE_ATOMIC_BIT = 16

纹理可以用作支持原子操作的存储图像

TextureUsageBits TEXTURE_USAGE_CPU_READ_BIT = 32

纹理可以在 CPU 上使用 texture_get_data 读取,比不设置这一位要快,因为会始终在系统内存中保留。

TextureUsageBits TEXTURE_USAGE_CAN_UPDATE_BIT = 64

纹理可以使用 texture_update 更新。

TextureUsageBits TEXTURE_USAGE_CAN_COPY_FROM_BIT = 128

纹理可以作为 texture_copy 的来源。

TextureUsageBits TEXTURE_USAGE_CAN_COPY_TO_BIT = 256

纹理可以作为 texture_copy 的目标。

TextureUsageBits TEXTURE_USAGE_INPUT_ATTACHMENT_BIT = 512

纹理可以用作帧缓冲的输入附件


enum TextureSwizzle:

TextureSwizzle TEXTURE_SWIZZLE_IDENTITY = 0

原样返回采样数值。

TextureSwizzle TEXTURE_SWIZZLE_ZERO = 1

采样时使用返回 0.0

TextureSwizzle TEXTURE_SWIZZLE_ONE = 2

采样时使用返回 1.0

TextureSwizzle TEXTURE_SWIZZLE_R = 3

对红色通道进行采样。

TextureSwizzle TEXTURE_SWIZZLE_G = 4

对绿色通道进行采样。

TextureSwizzle TEXTURE_SWIZZLE_B = 5

对蓝色通道进行采样。

TextureSwizzle TEXTURE_SWIZZLE_A = 6

对 Alpha 通道进行采样。

TextureSwizzle TEXTURE_SWIZZLE_MAX = 7

代表 TextureSwizzle 枚举的大小。


enum TextureSliceType:

TextureSliceType TEXTURE_SLICE_2D = 0

二维纹理切片。

TextureSliceType TEXTURE_SLICE_CUBEMAP = 1

立方体贴图纹理切片。

TextureSliceType TEXTURE_SLICE_3D = 2

三维纹理切片。


enum SamplerFilter:

SamplerFilter SAMPLER_FILTER_NEAREST = 0

最近邻采样器过滤。按照比源更高分辨率采样时,会产生像素化的效果。

SamplerFilter SAMPLER_FILTER_LINEAR = 1

双线性采样器过滤。按照比源更高分辨率采样时,会产生模糊的效果。


enum SamplerRepeatMode:

SamplerRepeatMode SAMPLER_REPEAT_MODE_REPEAT = 0

启用重复采样。

SamplerRepeatMode SAMPLER_REPEAT_MODE_MIRRORED_REPEAT = 1

启用镜像重复采样。对 [0.0, 1.0] 范围外进行采样时,返回采样器的镜像版本。如果采样的是更远的位置,则会对镜像版本再次镜像,并按照这样的规律无限重复下去。

SamplerRepeatMode SAMPLER_REPEAT_MODE_CLAMP_TO_EDGE = 2

禁用重复采样。对 [0.0, 1.0] 范围外进行采样时,返回边缘上最后一个像素的颜色。

SamplerRepeatMode SAMPLER_REPEAT_MODE_CLAMP_TO_BORDER = 3

禁用重复采样。对 [0.0, 1.0] 范围外进行采样时,返回指定的边框颜色 RDSamplerState.border_color

SamplerRepeatMode SAMPLER_REPEAT_MODE_MIRROR_CLAMP_TO_EDGE = 4

启用单次镜像重复采样。对 [-1.0, 0.0] 范围进行采样时,返回采样器的镜像版本。对 [-1.0, 1.0] 范围外进行采样时,返回边缘上最后一个像素的颜色。

SamplerRepeatMode SAMPLER_REPEAT_MODE_MAX = 5

代表 SamplerRepeatMode 枚举的大小。


enum SamplerBorderColor:

SamplerBorderColor SAMPLER_BORDER_COLOR_FLOAT_TRANSPARENT_BLACK = 0

[0.0, 1.0] 范围外进行采样时,返回浮点型的透明黑色。仅在采样器的重复模式为 SAMPLER_REPEAT_MODE_CLAMP_TO_BORDER 时有效。

SamplerBorderColor SAMPLER_BORDER_COLOR_INT_TRANSPARENT_BLACK = 1

[0.0, 1.0] 范围外进行采样时,返回整型的透明黑色。仅在采样器的重复模式为 SAMPLER_REPEAT_MODE_CLAMP_TO_BORDER 时有效。

SamplerBorderColor SAMPLER_BORDER_COLOR_FLOAT_OPAQUE_BLACK = 2

[0.0, 1.0] 范围外进行采样时,返回浮点型的不透明黑色。仅在采样器的重复模式为 SAMPLER_REPEAT_MODE_CLAMP_TO_BORDER 时有效。

SamplerBorderColor SAMPLER_BORDER_COLOR_INT_OPAQUE_BLACK = 3

[0.0, 1.0] 范围外进行采样时,返回整型的不透明黑色。仅在采样器的重复模式为 SAMPLER_REPEAT_MODE_CLAMP_TO_BORDER 时有效。

SamplerBorderColor SAMPLER_BORDER_COLOR_FLOAT_OPAQUE_WHITE = 4

[0.0, 1.0] 范围外进行采样时,返回浮点型的不透明白色。仅在采样器的重复模式为 SAMPLER_REPEAT_MODE_CLAMP_TO_BORDER 时有效。

SamplerBorderColor SAMPLER_BORDER_COLOR_INT_OPAQUE_WHITE = 5

[0.0, 1.0] 范围外进行采样时,返回整型的不透明白色。仅在采样器的重复模式为 SAMPLER_REPEAT_MODE_CLAMP_TO_BORDER 时有效。

SamplerBorderColor SAMPLER_BORDER_COLOR_MAX = 6

代表 SamplerBorderColor 枚举的大小。


enum VertexFrequency:

VertexFrequency VERTEX_FREQUENCY_VERTEX = 0

顶点属性寻址是顶点的功能。用于指定从缓冲中拉取顶点属性的频率。

VertexFrequency VERTEX_FREQUENCY_INSTANCE = 1

顶点属性寻址是实例索引的功能。用于指定从缓冲中拉取顶点属性的频率。


enum IndexBufferFormat:

IndexBufferFormat INDEX_BUFFER_FORMAT_UINT16 = 0

16 位无符号整数格式的索引缓冲。对可指定索引最大值的限制为 65535

IndexBufferFormat INDEX_BUFFER_FORMAT_UINT32 = 1

32 位无符号整数格式的索引缓冲。对可指定索引最大值的限制为 4294967295


flags StorageBufferUsage:

StorageBufferUsage STORAGE_BUFFER_USAGE_DISPATCH_INDIRECT = 1


enum UniformType:

UniformType UNIFORM_TYPE_SAMPLER = 0

采样器 uniform。

UniformType UNIFORM_TYPE_SAMPLER_WITH_TEXTURE = 1

带有纹理的采样器 uniform。

UniformType UNIFORM_TYPE_TEXTURE = 2

纹理 uniform。

UniformType UNIFORM_TYPE_IMAGE = 3

图像 uniform。

UniformType UNIFORM_TYPE_TEXTURE_BUFFER = 4

纹理缓冲 uniform。

UniformType UNIFORM_TYPE_SAMPLER_WITH_TEXTURE_BUFFER = 5

带有纹理缓冲的采样器 uniform。

UniformType UNIFORM_TYPE_IMAGE_BUFFER = 6

图像缓冲 uniform。

UniformType UNIFORM_TYPE_UNIFORM_BUFFER = 7

Uniform 缓冲区 uniform。

UniformType UNIFORM_TYPE_STORAGE_BUFFER = 8

存储缓冲区 uniform。

UniformType UNIFORM_TYPE_INPUT_ATTACHMENT = 9

输入附件 uniform。

UniformType UNIFORM_TYPE_MAX = 10

表示 UniformType 枚举的大小。


enum RenderPrimitive:

RenderPrimitive RENDER_PRIMITIVE_POINTS = 0

渲染点的图元(大小为常量,和与相机之间的距离无关)。

RenderPrimitive RENDER_PRIMITIVE_LINES = 1

渲染线段列表的图元。线段在绘制时是彼此独立的。

RenderPrimitive RENDER_PRIMITIVE_LINES_WITH_ADJACENCY = 2

渲染线段列表的图元,提供邻接数据。

注意:邻接数据仅在几何着色器中有用,但 Godot 并没有暴露。

RenderPrimitive RENDER_PRIMITIVE_LINESTRIPS = 3

渲染线段条带的图元。绘制的线段与它的前一个顶点是相连的。

RenderPrimitive RENDER_PRIMITIVE_LINESTRIPS_WITH_ADJACENCY = 4

渲染线段条带的图元,提供邻接数据。

注意:邻接数据仅在几何着色器中有用,但 Godot 并没有暴露。

RenderPrimitive RENDER_PRIMITIVE_TRIANGLES = 5

渲染三角形列表的图元。三角形在绘制时是彼此独立的。

RenderPrimitive RENDER_PRIMITIVE_TRIANGLES_WITH_ADJACENCY = 6

渲染三角形列表的图元,提供邻接数据。

注意:邻接数据仅在几何着色器中有用,但 Godot 并没有暴露。

RenderPrimitive RENDER_PRIMITIVE_TRIANGLE_STRIPS = 7

渲染三角形条带的图元。绘制的三角形与它的前一个三角形是相连的。

RenderPrimitive RENDER_PRIMITIVE_TRIANGLE_STRIPS_WITH_AJACENCY = 8

渲染三角形条带的图元,提供邻接数据。

注意:邻接数据仅在几何着色器中有用,但 Godot 并没有暴露。

RenderPrimitive RENDER_PRIMITIVE_TRIANGLE_STRIPS_WITH_RESTART_INDEX = 9

渲染三角形条带的图元,启用图元重启。绘制的三角形与它的前一个三角形是相连的,但是在绘制前可以指定图元重启索引,这样在指定索引之后就会再创建一条三角形条带。

注意:仅兼容索引绘图。

RenderPrimitive RENDER_PRIMITIVE_TESSELATION_PATCH = 10

曲面细分面片渲染图元。仅对曲面细分着色器有用,可以将面片变形。

RenderPrimitive RENDER_PRIMITIVE_MAX = 11

代表 RenderPrimitive 枚举的大小。


enum PolygonCullMode:

PolygonCullMode POLYGON_CULL_DISABLED = 0

不使用多边形的正面和背面剔除。

PolygonCullMode POLYGON_CULL_FRONT = 1

使用多边形的正面剔除(隐藏正对相机的面)。

PolygonCullMode POLYGON_CULL_BACK = 2

使用多边形的背面剔除(隐藏背对相机的面)。


enum PolygonFrontFace:

PolygonFrontFace POLYGON_FRONT_FACE_CLOCKWISE = 0

决定多边形面为是否为正面时,使用顺时针缠绕顺序。

PolygonFrontFace POLYGON_FRONT_FACE_COUNTER_CLOCKWISE = 1

决定多边形面为是否为正面时,使用逆时针缠绕顺序。


enum StencilOperation:

StencilOperation STENCIL_OP_KEEP = 0

保留当前的模板值。

StencilOperation STENCIL_OP_ZERO = 1

将模板值设置为 0

StencilOperation STENCIL_OP_REPLACE = 2

将现有的模板值替换为新值。

StencilOperation STENCIL_OP_INCREMENT_AND_CLAMP = 3

将现有的模板值加一,到达能够表示的最大无符号值之后就不会再增长。会将模板位视作无符号整数。

StencilOperation STENCIL_OP_DECREMENT_AND_CLAMP = 4

将现有的模板值减一,到达最小值之后就不会再降低。会将模板位视作无符号整数。

StencilOperation STENCIL_OP_INVERT = 5

将现有的模板值按位取反。

StencilOperation STENCIL_OP_INCREMENT_AND_WRAP = 6

将现有的模板值加一,到达能够表示的最大无符号值之后环绕至 0。会将模板位视作无符号整数。

StencilOperation STENCIL_OP_DECREMENT_AND_WRAP = 7

将现有的模板值减一,到达最小值之后环绕至能够表示的最大无符号值。会将模板位视作无符号整数。

StencilOperation STENCIL_OP_MAX = 8

代表 StencilOperation 枚举的大小。


enum CompareOperator:

CompareOperator COMPARE_OP_NEVER = 0

“永不”比较(与 COMPARE_OP_ALWAYS 相对)。

CompareOperator COMPARE_OP_LESS = 1

“小于”比较。

CompareOperator COMPARE_OP_EQUAL = 2

“等于”比较。

CompareOperator COMPARE_OP_LESS_OR_EQUAL = 3

“小于等于”比较。

CompareOperator COMPARE_OP_GREATER = 4

“大于”比较。

CompareOperator COMPARE_OP_NOT_EQUAL = 5

“不等于”比较。

CompareOperator COMPARE_OP_GREATER_OR_EQUAL = 6

“大于等于”比较。

CompareOperator COMPARE_OP_ALWAYS = 7

“始终”比较(与 COMPARE_OP_NEVER 相对)。

CompareOperator COMPARE_OP_MAX = 8

代表 CompareOperator 枚举的大小。


enum LogicOperation:

LogicOperation LOGIC_OP_CLEAR = 0

逻辑清除运算(结果始终为 0)。另见 LOGIC_OP_SET

LogicOperation LOGIC_OP_AND = 1

逻辑与(AND)运算。

LogicOperation LOGIC_OP_AND_REVERSE = 2

逻辑与(AND)运算,翻转目标操作数。另见 LOGIC_OP_AND_INVERTED

LogicOperation LOGIC_OP_COPY = 3

逻辑复制运算(保留来源的值)。另见 LOGIC_OP_COPY_INVERTEDLOGIC_OP_NO_OP

LogicOperation LOGIC_OP_AND_INVERTED = 4

逻辑与(AND)运算,翻转来源操作数。另见 LOGIC_OP_AND_REVERSE

LogicOperation LOGIC_OP_NO_OP = 5

逻辑空运算(保留目标值)。另见 LOGIC_OP_COPY

LogicOperation LOGIC_OP_XOR = 6

逻辑异或(XOR)运算。

LogicOperation LOGIC_OP_OR = 7

逻辑或(OR)运算。

LogicOperation LOGIC_OP_NOR = 8

逻辑非或(NOR)运算。

LogicOperation LOGIC_OP_EQUIVALENT = 9

逻辑非异或(XNOR)运算。

LogicOperation LOGIC_OP_INVERT = 10

逻辑翻转运算。

LogicOperation LOGIC_OP_OR_REVERSE = 11

逻辑或(OR)运算,翻转目标操作数。另见 LOGIC_OP_OR_REVERSE

LogicOperation LOGIC_OP_COPY_INVERTED = 12

逻辑非(NOT)运算(将值翻转)。另见 LOGIC_OP_COPY

LogicOperation LOGIC_OP_OR_INVERTED = 13

逻辑或(OR)运算,翻转来源操作数。另见 LOGIC_OP_OR_REVERSE

LogicOperation LOGIC_OP_NAND = 14

逻辑非与(NAND)运算。

LogicOperation LOGIC_OP_SET = 15

逻辑设置运算(结果始终为 1)。另见 LOGIC_OP_CLEAR

LogicOperation LOGIC_OP_MAX = 16

代表 LogicOperation 枚举的大小。


enum BlendFactor:

BlendFactor BLEND_FACTOR_ZERO = 0

混合系数常量 0.0

BlendFactor BLEND_FACTOR_ONE = 1

混合系数常量 1.0

BlendFactor BLEND_FACTOR_SRC_COLOR = 2

颜色混合系数为 source color。Alpha 混合系数为 source alpha

BlendFactor BLEND_FACTOR_ONE_MINUS_SRC_COLOR = 3

颜色混合系数为 1.0 - source color。Alpha 混合系数为 1.0 - source alpha

BlendFactor BLEND_FACTOR_DST_COLOR = 4

颜色混合系数为 destination color。Alpha 混合系数为 destination alpha

BlendFactor BLEND_FACTOR_ONE_MINUS_DST_COLOR = 5

颜色混合系数为 1.0 - destination color。Alpha 混合系数为 1.0 - destination alpha

BlendFactor BLEND_FACTOR_SRC_ALPHA = 6

颜色混合和 Alpha 混合系数为 source alpha

BlendFactor BLEND_FACTOR_ONE_MINUS_SRC_ALPHA = 7

颜色混合和 Alpha 混合系数为 1.0 - source alpha

BlendFactor BLEND_FACTOR_DST_ALPHA = 8

颜色混合和 Alpha 混合系数为 destination alpha

BlendFactor BLEND_FACTOR_ONE_MINUS_DST_ALPHA = 9

颜色混合和 Alpha 混合系数为 1.0 - destination alpha

BlendFactor BLEND_FACTOR_CONSTANT_COLOR = 10

颜色混合系数为 blend constant color。Alpha 混合系数为 blend constant alpha(见 draw_list_set_blend_constants)。

BlendFactor BLEND_FACTOR_ONE_MINUS_CONSTANT_COLOR = 11

颜色混合系数为 1.0 - blend constant color。Alpha 混合系数为 1.0 - blend constant alpha(见 draw_list_set_blend_constants)。

BlendFactor BLEND_FACTOR_CONSTANT_ALPHA = 12

颜色混合和 Alpha 混合系数为 blend constant alpha(见 draw_list_set_blend_constants)。

BlendFactor BLEND_FACTOR_ONE_MINUS_CONSTANT_ALPHA = 13

颜色混合和 Alpha 混合系数为 1.0 - blend constant alpha(见 draw_list_set_blend_constants)。

BlendFactor BLEND_FACTOR_SRC_ALPHA_SATURATE = 14

颜色混合系数为 min(source alpha, 1.0 - destination alpha)。Alpha 混合系数为 1.0

BlendFactor BLEND_FACTOR_SRC1_COLOR = 15

颜色混合系数为 second source color。Alpha 混合系数为 second source alpha。仅适用于双源混合。

BlendFactor BLEND_FACTOR_ONE_MINUS_SRC1_COLOR = 16

颜色混合系数为 1.0 - second source color。Alpha 混合系数为 1.0 - second source alpha。仅适用于双源混合。

BlendFactor BLEND_FACTOR_SRC1_ALPHA = 17

颜色混合和 Alpha 混合系数为 second source alpha。仅适用于双源混合。

BlendFactor BLEND_FACTOR_ONE_MINUS_SRC1_ALPHA = 18

颜色混合和 Alpha 混合系数为 1.0 - second source alpha。仅适用于双源混合。

BlendFactor BLEND_FACTOR_MAX = 19

代表 BlendFactor 枚举的大小。


enum BlendOperation:

BlendOperation BLEND_OP_ADD = 0

加法混合运算(source + destination)。

BlendOperation BLEND_OP_SUBTRACT = 1

减法混合运算(source - destination)。

BlendOperation BLEND_OP_REVERSE_SUBTRACT = 2

逆减法混合运算(destination - source)。

BlendOperation BLEND_OP_MINIMUM = 3

最小混合运算(保留两者之间的较小值)。

BlendOperation BLEND_OP_MAXIMUM = 4

最大混合运算(保留两者之间的较大值)。

BlendOperation BLEND_OP_MAX = 5

代表 BlendOperation 枚举的大小。


flags PipelineDynamicStateFlags:

PipelineDynamicStateFlags DYNAMIC_STATE_LINE_WIDTH = 1

PipelineDynamicStateFlags DYNAMIC_STATE_DEPTH_BIAS = 2

PipelineDynamicStateFlags DYNAMIC_STATE_BLEND_CONSTANTS = 4

PipelineDynamicStateFlags DYNAMIC_STATE_DEPTH_BOUNDS = 8

PipelineDynamicStateFlags DYNAMIC_STATE_STENCIL_COMPARE_MASK = 16

PipelineDynamicStateFlags DYNAMIC_STATE_STENCIL_WRITE_MASK = 32

PipelineDynamicStateFlags DYNAMIC_STATE_STENCIL_REFERENCE = 64


enum InitialAction:

InitialAction INITIAL_ACTION_CLEAR = 0

开始渲染并清空整个帧缓冲。

InitialAction INITIAL_ACTION_CLEAR_REGION = 1

开始渲染并清空帧缓冲里的指定区域。

InitialAction INITIAL_ACTION_CLEAR_REGION_CONTINUE = 2

继续渲染并清空帧缓冲里的指定区域。帧缓冲必须在之前的最后一次动作后停留在 FINAL_ACTION_CONTINUE 状态。

InitialAction INITIAL_ACTION_KEEP = 3

开始渲染但保留附加颜色纹理的内容。如果帧缓冲之前用于在着色器中读取,此操作会自动插入布局过渡。

InitialAction INITIAL_ACTION_DROP = 4

开始渲染,忽略原有内容;在内容上覆盖。当你会写入所有像素并且不需要清屏颜色时,这通常是最快的选项。

InitialAction INITIAL_ACTION_CONTINUE = 5

继续渲染。帧缓冲必须在之前的最后一次动作后停留在 FINAL_ACTION_CONTINUE 状态。

InitialAction INITIAL_ACTION_MAX = 6

代表 InitialAction 枚举的大小。


enum FinalAction:

FinalAction FINAL_ACTION_READ = 0

以读取为目的存储纹理,如果设置了 TEXTURE_USAGE_SAMPLING_BIT 位则将其设为只读(仅适用于颜色、深度、模板附件)。

FinalAction FINAL_ACTION_DISCARD = 1

丢弃纹理数据,如果设置了 TEXTURE_USAGE_SAMPLING_BIT 位则将其设为只读(仅适用于颜色、深度、模板附件)。

FinalAction FINAL_ACTION_CONTINUE = 2

存储纹理并继续后续处理。与 FINAL_ACTION_READ 类似,但不会在设置了 TEXTURE_USAGE_SAMPLING_BIT 位时将其设为只读。

FinalAction FINAL_ACTION_MAX = 3

代表 FinalAction 枚举的大小。


enum ShaderStage:

ShaderStage SHADER_STAGE_VERTEX = 0

顶点着色器阶段。可用于在着色器中操作顶点(但无法新建顶点)。

ShaderStage SHADER_STAGE_FRAGMENT = 1

片段着色器阶段(Direct3D 中成为“像素着色器”)。可用于在着色器中操作像素。

ShaderStage SHADER_STAGE_TESSELATION_CONTROL = 2

曲面细分控制着色器阶段。可用于在着色器中创建额外的几何体。

ShaderStage SHADER_STAGE_TESSELATION_EVALUATION = 3

曲面细分求值着色器阶段。可用于在着色器中创建额外的几何体。

ShaderStage SHADER_STAGE_COMPUTE = 4

计算着色器阶段。可用于在着色器中执行任意计算任务,在 GPU 而不是 CPU 上进行计算。

ShaderStage SHADER_STAGE_MAX = 5

代表 ShaderStage 枚举的大小。

ShaderStage SHADER_STAGE_VERTEX_BIT = 1

顶点着色器阶段位(另见 SHADER_STAGE_VERTEX)。

ShaderStage SHADER_STAGE_FRAGMENT_BIT = 2

片段着色器阶段位(另见 SHADER_STAGE_FRAGMENT)。

ShaderStage SHADER_STAGE_TESSELATION_CONTROL_BIT = 4

曲面细分控制着色器阶段位(另见 SHADER_STAGE_TESSELATION_CONTROL)。

ShaderStage SHADER_STAGE_TESSELATION_EVALUATION_BIT = 8

曲面细分求值着色器阶段位(另见 SHADER_STAGE_TESSELATION_EVALUATION)。

ShaderStage SHADER_STAGE_COMPUTE_BIT = 16

计算着色器阶段位(另见 SHADER_STAGE_COMPUTE)。


enum ShaderLanguage:

ShaderLanguage SHADER_LANGUAGE_GLSL = 0

Khronos 的 GLSL 着色语言(OpenGL 和 Vulkan 原生使用)。这是核心 Godot 着色器所使用的语言。

ShaderLanguage SHADER_LANGUAGE_HLSL = 1

Microsoft 的高级着色器语言(Direct3D 原生使用,Vulkan 中也能使用)。


enum PipelineSpecializationConstantType:

PipelineSpecializationConstantType PIPELINE_SPECIALIZATION_CONSTANT_TYPE_BOOL = 0

布尔型特化常量。

PipelineSpecializationConstantType PIPELINE_SPECIALIZATION_CONSTANT_TYPE_INT = 1

整型特化常量。

PipelineSpecializationConstantType PIPELINE_SPECIALIZATION_CONSTANT_TYPE_FLOAT = 2

浮点型特化常量。


enum Limit:

Limit LIMIT_MAX_BOUND_UNIFORM_SETS = 0

能够同时绑定的最大 uniform 集的数量。

Limit LIMIT_MAX_FRAMEBUFFER_COLOR_ATTACHMENTS = 1

能够同时使用的最大颜色帧缓冲附件的数量。

Limit LIMIT_MAX_TEXTURES_PER_UNIFORM_SET = 2

单个 uniform 集能够使用的最大纹理数量。

Limit LIMIT_MAX_SAMPLERS_PER_UNIFORM_SET = 3

单个 uniform 集能够使用的最大采样器数量。

Limit LIMIT_MAX_STORAGE_BUFFERS_PER_UNIFORM_SET = 4

单个 uniform 集的最大存储缓冲数量。

Limit LIMIT_MAX_STORAGE_IMAGES_PER_UNIFORM_SET = 5

单个 uniform 集的最大存储图像数量。

Limit LIMIT_MAX_UNIFORM_BUFFERS_PER_UNIFORM_SET = 6

单个 uniform 集的最大 uniform 缓冲数量。

Limit LIMIT_MAX_DRAW_INDEXED_INDEX = 7

索引绘图指令的最大索引。

Limit LIMIT_MAX_FRAMEBUFFER_HEIGHT = 8

帧缓冲的最大高度(单位为像素)。

Limit LIMIT_MAX_FRAMEBUFFER_WIDTH = 9

帧缓冲的最大宽度(单位为像素)。

Limit LIMIT_MAX_TEXTURE_ARRAY_LAYERS = 10

纹理数组的最大层数。

Limit LIMIT_MAX_TEXTURE_SIZE_1D = 11

支持的一维纹理的最大尺寸(单轴像素数)。

Limit LIMIT_MAX_TEXTURE_SIZE_2D = 12

支持的二维纹理的最大尺寸(单轴像素数)。

Limit LIMIT_MAX_TEXTURE_SIZE_3D = 13

支持的三维纹理的最大尺寸(单轴像素数)。

Limit LIMIT_MAX_TEXTURE_SIZE_CUBE = 14

支持的立方体贴图纹理的最大尺寸(单轴像素数)。

Limit LIMIT_MAX_TEXTURES_PER_SHADER_STAGE = 15

每个着色器阶段的最大纹理数。

Limit LIMIT_MAX_SAMPLERS_PER_SHADER_STAGE = 16

每个着色器阶段的最大采样器数。

Limit LIMIT_MAX_STORAGE_BUFFERS_PER_SHADER_STAGE = 17

每个着色器阶段的最大存储缓冲数。

Limit LIMIT_MAX_STORAGE_IMAGES_PER_SHADER_STAGE = 18

每个着色器阶段的最大存储图像数。

Limit LIMIT_MAX_UNIFORM_BUFFERS_PER_SHADER_STAGE = 19

单个 uniform 集的最大 uniform 缓冲数量。

Limit LIMIT_MAX_PUSH_CONSTANT_SIZE = 20

推送常量的最大大小。许多设备都有 128 字节的限制,所以即便你的 GPU 汇报的值更大,也请尝试避免让推送常量超过 127 字节,从而确保兼容性。

Limit LIMIT_MAX_UNIFORM_BUFFER_SIZE = 21

Uniform 缓冲的最大大小。

Limit LIMIT_MAX_VERTEX_INPUT_ATTRIBUTE_OFFSET = 22

顶点输入属性的最大偏移。

Limit LIMIT_MAX_VERTEX_INPUT_ATTRIBUTES = 23

顶点输入属性的最大数量。

Limit LIMIT_MAX_VERTEX_INPUT_BINDINGS = 24

顶点输入绑定的最大数量。

Limit LIMIT_MAX_VERTEX_INPUT_BINDING_STRIDE = 25

顶点输入绑定的最大步幅。

Limit LIMIT_MIN_UNIFORM_BUFFER_OFFSET_ALIGNMENT = 26

Uniform 缓冲的最小偏移对齐。

Limit LIMIT_MAX_COMPUTE_SHARED_MEMORY_SIZE = 27

计算着色器的最大共享内存大小。

Limit LIMIT_MAX_COMPUTE_WORKGROUP_COUNT_X = 28

计算着色器在 X 轴上的最大工作组数量。

Limit LIMIT_MAX_COMPUTE_WORKGROUP_COUNT_Y = 29

计算着色器在 Y 轴上的最大工作组数量。

Limit LIMIT_MAX_COMPUTE_WORKGROUP_COUNT_Z = 30

计算着色器在 Z 轴上的最大工作组数量。

Limit LIMIT_MAX_COMPUTE_WORKGROUP_INVOCATIONS = 31

计算着色器的最大工作组调用数量。

Limit LIMIT_MAX_COMPUTE_WORKGROUP_SIZE_X = 32

计算着色器在 X 轴上的最大工作组大小。

Limit LIMIT_MAX_COMPUTE_WORKGROUP_SIZE_Y = 33

计算着色器在 Y 轴上的最大工作组大小。

Limit LIMIT_MAX_COMPUTE_WORKGROUP_SIZE_Z = 34

计算着色器在 Z 轴上的最大工作组大小。

Limit LIMIT_MAX_VIEWPORT_DIMENSIONS_X = 35

视口的最大宽度(单位为像素)。

Limit LIMIT_MAX_VIEWPORT_DIMENSIONS_Y = 36

视口的最大高度(单位为像素)。


enum MemoryType:

MemoryType MEMORY_TEXTURES = 0

纹理占用的内存。

MemoryType MEMORY_BUFFERS = 1

缓冲区占用的内存。

MemoryType MEMORY_TOTAL = 2

内存中占用。比 MEMORY_TEXTURESMEMORY_BUFFERS 的总和要大,因为还会包含其他杂项内存占用。


常量

INVALID_ID = -1

返回 ID 的函数会在值无效时返回此值。

INVALID_FORMAT_ID = -1

返回格式 ID 的函数会在值无效时返回此值。


方法说明

void barrier ( BitField<BarrierMask> from=32767, BitField<BarrierMask> to=32767 )

原地放置一个内存屏障。内存屏障可用于进行同步,避免数据竞争。另见 full_barrier,可能更适合调试。


Error buffer_clear ( RID buffer, int offset, int size_bytes, BitField<BarrierMask> post_barrier=32767 )

清除 buffer 的内容,清除 size_bytes 字节,从 offset 开始。总是会造成内存障碍。

如果出现以下情况,则打印错误:

  • 大小不是四的倍数

  • offset + size_bytes 指定的区域超出缓冲区

  • 绘制列表当前处于活动状态(由 draw_list_begin 创建)

  • 计算列表当前处于活动状态(由 compute_list_begin 创建)


PackedByteArray buffer_get_data ( RID buffer, int offset_bytes=0, int size_bytes=0 )

返回指定 buffer 中数据的副本,还可以设置 offset_bytessize_bytes,仅复制缓冲区的某一部分。


Error buffer_update ( RID buffer, int offset, int size_bytes, PackedByteArray data, BitField<BarrierMask> post_barrier=32767 )

使用指定的 data 更新缓冲区中从 offset 开始的 size_bytes 字节区块。引发一个内存屏障,除非 post_barrier 被设置为 BARRIER_MASK_NO_BARRIER

如果出现以下情况,则打印错误:

  • offset + size_bytes 指定的区块超出该缓冲区

  • 绘制列表当前处于活动状态(由 draw_list_begin 创建)

  • 计算列表当前处于活动状态(由 compute_list_begin 创建)


void capture_timestamp ( String name )

使用指定的名称 name 创建时间戳标记。用于 get_captured_timestamp_cpu_timeget_captured_timestamp_gpu_timeget_captured_timestamp_name 等方法的性能汇报。


void compute_list_add_barrier ( int compute_list )

在指定的 compute_list 中引发 Vulkan 计算屏障。


int compute_list_begin ( bool allow_draw_overlap=false )

开始由 compute_* 方法创建的计算命令列表。应该将返回值传递给其他 compute_list_* 函数。

如果 allow_draw_overlaptrue,就可以在执行绘图列表的同时执行计算列表。无法同时创建多个计算列表;你必须先使用 compute_list_end 把之前的计算列表完成。

简易的计算操作类似于下面这样(代码不是完整的示例):

var rd = RenderingDevice.new()
var compute_list = rd.compute_list_begin()

rd.compute_list_bind_compute_pipeline(compute_list, compute_shader_dilate_pipeline)
rd.compute_list_bind_uniform_set(compute_list, compute_base_uniform_set, 0)
rd.compute_list_bind_uniform_set(compute_list, dilate_uniform_set, 1)

for i in atlas_slices:
    rd.compute_list_set_push_constant(compute_list, push_constant, push_constant.size())
    rd.compute_list_dispatch(compute_list, group_size.x, group_size.y, group_size.z)
    # 没有屏障,一起执行。

rd.compute_list_end()

void compute_list_bind_compute_pipeline ( int compute_list, RID compute_pipeline )

告诉 GPU 在处理计算列表时使用什么计算管道。如果自上次调用该函数以来着色器发生了更改,Godot 将取消绑定所有描述符集,并在 compute_list_dispatch 中重新绑定它们。


void compute_list_bind_uniform_set ( int compute_list, RID uniform_set, int set_index )

uniform_set 绑定到该 compute_list。Godot 确保统一集中的所有纹理都具有正确的 Vulkan 访问蒙版。如果 Godot 必须更改纹理的访问蒙版,则会引发 Vulkan 图像内存障碍。


void compute_list_dispatch ( int compute_list, int x_groups, int y_groups, int z_groups )

将计算列表提交给 GPU 处理。相当于是计算版本的 draw_list_draw


void compute_list_end ( BitField<BarrierMask> post_barrier=32767 )

结束由 compute_* 方法创建的计算命令列表。


void compute_list_set_push_constant ( int compute_list, PackedByteArray buffer, int size_bytes )

为指定的 compute_list 设置 buffer 的推送常量数据。如何使用这个二进制数据由着色器决定。另外还必须在 size_bytes 中指定缓冲的字节大小(可以通过对 buffer 调用 PackedByteArray.size 获取)。


RID compute_pipeline_create ( RID shader, RDPipelineSpecializationConstant[] specialization_constants=[] )

新建计算管线。可以通过返回的 RID 进行访问。

RID 使用结束后,应该使用 RenderingServer 的 free_rid 方法进行释放。


bool compute_pipeline_is_valid ( RID compute_pipeline )

如果由 compute_pipeline RID 指定的计算管线有效,则返回 true,否则返回 false


RenderingDevice create_local_device ( )

新建局部 RenderingDevice。主要用于在 GPU 上执行计算操作,独立于引擎的其他部分。


void draw_command_begin_label ( String name, Color color )

创建命令缓冲调试标签区域,能够在 RenderDoc 等第三方工具中显示。所有的区域都应该调用 draw_command_end_label 结束。观察单个队列的线性提交序列时,draw_command_begin_label 必须有与之对应的 draw_command_end_label

Vulkan 扩展 VK_EXT_DEBUG_UTILS_EXTENSION_NAME 必须可用并启用,这样命令缓冲调试标签区域才能正常工作。另见 draw_command_insert_labeldraw_command_end_label


void draw_command_end_label ( )

结束命令缓冲调试标签区域,该区域由 draw_command_begin_label 调用开启。


void draw_command_insert_label ( String name, Color color )

在当前的命令缓冲中插入命令缓冲调试标签区域。与 draw_command_begin_label 不同,不应该调用 draw_command_end_label 来结束这个区域。


int draw_list_begin ( RID framebuffer, InitialAction initial_color_action, FinalAction final_color_action, InitialAction initial_depth_action, FinalAction final_depth_action, PackedColorArray clear_color_values=PackedColorArray(), float clear_depth=1.0, int clear_stencil=0, Rect2 region=Rect2(0, 0, 0, 0), RID[] storage_textures=[] )

开始由 draw_* 方法创建的栅格绘图命令列表。应该将返回值传递给其他 draw_list_* 函数。

无法同时创建多个绘图列表;你必须先使用 draw_list_end 把之前的绘图列表完成。

简易的绘图操作类似于下面这样(代码不是完整的示例):

var rd = RenderingDevice.new()
var clear_colors = PackedColorArray([Color(0, 0, 0, 0), Color(0, 0, 0, 0), Color(0, 0, 0, 0)])
var draw_list = rd.draw_list_begin(framebuffers[i], RenderingDevice.INITIAL_ACTION_CLEAR, RenderingDevice.FINAL_ACTION_READ, RenderingDevice.INITIAL_ACTION_CLEAR, RenderingDevice.FINAL_ACTION_DISCARD, clear_colors)

# 实心绘制。
rd.draw_list_bind_render_pipeline(draw_list, raster_pipeline)
rd.draw_list_bind_uniform_set(draw_list, raster_base_uniform, 0)
rd.draw_list_set_push_constant(draw_list, raster_push_constant, raster_push_constant.size())
rd.draw_list_draw(draw_list, false, 1, slice_triangle_count[i] * 3)
# 线框绘制。
rd.draw_list_bind_render_pipeline(draw_list, raster_pipeline_wire)
rd.draw_list_bind_uniform_set(draw_list, raster_base_uniform, 0)
rd.draw_list_set_push_constant(draw_list, raster_push_constant, raster_push_constant.size())
rd.draw_list_draw(draw_list, false, 1, slice_triangle_count[i] * 3)

rd.draw_list_end()

int draw_list_begin_for_screen ( int screen=0, Color clear_color=Color(0, 0, 0, 1) )

draw_list_begin 的高阶变体,会针对绘制到 screen ID 指定的窗口上自动调整参数。

注意:局部 RenderingDevice 没有屏幕,所以无法使用。如果在局部 RenderingDevice 上调用,draw_list_begin_for_screen 会返回 INVALID_ID


PackedInt64Array draw_list_begin_split ( RID framebuffer, int splits, InitialAction initial_color_action, FinalAction final_color_action, InitialAction initial_depth_action, FinalAction final_depth_action, PackedColorArray clear_color_values=PackedColorArray(), float clear_depth=1.0, int clear_stencil=0, Rect2 region=Rect2(0, 0, 0, 0), RID[] storage_textures=[] )

draw_list_begin 的变体,支持多个拆分。splits 参数决定创建多少拆分。


void draw_list_bind_index_array ( int draw_list, RID index_array )

index_array 绑定到指定的 draw_list


void draw_list_bind_render_pipeline ( int draw_list, RID render_pipeline )

render_pipeline 绑定到指定的 draw_list


void draw_list_bind_uniform_set ( int draw_list, RID uniform_set, int set_index )

uniform_set 绑定到指定的 draw_list。还必须指定 set_index,这是从 0 开始的标识符,必须与绘制列表中所需要的相匹配。


void draw_list_bind_vertex_array ( int draw_list, RID vertex_array )

vertex_array 绑定到指定的 draw_list


void draw_list_disable_scissor ( int draw_list )

为指定的 draw_list 移除并禁用裁剪矩形。另见 draw_list_enable_scissor


void draw_list_draw ( int draw_list, bool use_indices, int instances, int procedural_vertex_count=0 )

draw_list 提交给 GPU 渲染。相当于是栅格版本的 compute_list_dispatch


void draw_list_enable_scissor ( int draw_list, Rect2 rect=Rect2(0, 0, 0, 0) )

创建裁剪矩形并为指定的 draw_list 启用。裁剪矩形可以用来实现裁剪,会丢弃落在屏幕上指定矩形范围之外的片段。另见 draw_list_disable_scissor

注意:指定的 rect 会自动与屏幕尺寸求交集,也就是说裁剪矩形无法超出屏幕的范围。


void draw_list_end ( BitField<BarrierMask> post_barrier=32767 )

结束由 draw_* 方法创建的栅格绘图命令列表。


void draw_list_set_blend_constants ( int draw_list, Color color )

将指定 draw_list 的混合常量设置为 color。创建图形管线时设置了 DYNAMIC_STATE_BLEND_CONSTANTS 标志时才会使用混合常量。


void draw_list_set_push_constant ( int draw_list, PackedByteArray buffer, int size_bytes )

为指定的 draw_list 设置 buffer 的推送常量数据。如何使用这个二进制数据由着色器决定。另外还必须在 size_bytes 中指定缓冲的字节大小(可以通过对 buffer 调用 PackedByteArray.size 获取)。


int draw_list_switch_to_next_pass ( )

切换到下一个绘制阶段并返回拆分 ID。等价于调用 draw_list_switch_to_next_pass_split 时将 splits 设为 1


PackedInt64Array draw_list_switch_to_next_pass_split ( int splits )

切换到下一个绘制阶段,分配的拆分数在 splits 中指定。返回值是一个数组,包含各个拆分的 ID。如果使用的是单个拆分,请参阅 draw_list_switch_to_next_pass


RID framebuffer_create ( RID[] textures, int validate_with_format=-1, int view_count=1 )

新建帧缓冲。可以通过返回的 RID 进行访问。

RID 使用结束后,应该使用 RenderingServer 的 free_rid 方法进行释放。


RID framebuffer_create_empty ( Vector2i size, TextureSamples samples=0, int validate_with_format=-1 )

新建空的帧缓冲。可以通过返回的 RID 进行访问。

RID 使用结束后,应该使用 RenderingServer 的 free_rid 方法进行释放。


RID framebuffer_create_multipass ( RID[] textures, RDFramebufferPass[] passes, int validate_with_format=-1, int view_count=1 )

新建多阶段帧缓冲。可以通过返回的 RID 进行访问。

RID 使用结束后,应该使用 RenderingServer 的 free_rid 方法进行释放。


int framebuffer_format_create ( RDAttachmentFormat[] attachments, int view_count=1 )

新建帧缓冲格式,附件为 attachments、视图数为 view_count。返回的是新帧缓冲的唯一帧缓冲格式 ID。

如果 view_count 大于等于 2,则会针对 VR 渲染启用多视图。要求支持 Vulkan 的多视图扩展。


int framebuffer_format_create_empty ( TextureSamples samples=0 )

新建空的帧缓冲格式并返回其 ID,采样数为 samples


int framebuffer_format_create_multipass ( RDAttachmentFormat[] attachments, RDFramebufferPass[] passes, int view_count=1 )

创建多阶段帧缓冲格式并返回其 ID,附件为 attachments、阶段数为 passes、视图数为 view_count。如果 view_count 大于等于 2,则会针对 VR 渲染启用多视图。要求支持 Vulkan 的多视图扩展。


TextureSamples framebuffer_format_get_texture_samples ( int format, int render_pass=0 )

返回给定帧缓冲格式 ID format 所使用的纹理采样数量(格式由 framebuffer_get_format 返回)。


int framebuffer_get_format ( RID framebuffer )

返回由帧缓冲 RID framebuffer 指定的帧缓冲的格式 ID。相同格式下,这个 ID 一定是唯一的,不需要释放。


bool framebuffer_is_valid ( RID framebuffer ) const

返回由帧缓冲 RID framebuffer 指定的帧缓冲有效,则返回 true,否则返回 false


void free_rid ( RID rid )

尝试释放 RenderingDevice 中的某个对象。为了防止内存泄漏,对象使用完后就应该调用这个方法,因为直接使用 RenderingDevice 时并不会自动进行内存管理。


void full_barrier ( )

原地放置一个完整的内存屏障。这是启用了所有标志的 barrierfull_barrier 应该仅用于调试,因为对性能的影响极大。


int get_captured_timestamp_cpu_time ( int index ) const

返回渲染步骤的 CPU 时间戳(引擎启动后经过的毫秒数),渲染步骤由 index 指定。另见 get_captured_timestamp_gpu_timecapture_timestamp


int get_captured_timestamp_gpu_time ( int index ) const

返回渲染步骤的 GPU 时间戳(引擎启动后经过的毫秒数),渲染步骤由 index 指定。另见 get_captured_timestamp_cpu_timecapture_timestamp


String get_captured_timestamp_name ( int index ) const

返回渲染步骤的时间戳的名称,渲染步骤由 index 指定。另见 capture_timestamp


int get_captured_timestamps_count ( ) const

返回能够进行性能分析的时间戳(渲染步骤)总数。


int get_captured_timestamps_frame ( ) const

返回能够进行渲染时间戳查询的最后一个渲染帧的索引。


String get_device_name ( ) const

返回视频适配器的名称(例如 "GeForce GTX 1080/PCIe/SSE2")。等价于 RenderingServer.get_video_adapter_name。另见 get_device_vendor_name


String get_device_pipeline_cache_uuid ( ) const

返回管线缓存的通用唯一标识符。用于将着色器文件缓存到磁盘,避免后续运行引擎时进行着色器的重新编译。这个 UUID 会根据显卡型号以及驱动版本的不同而不同。因此,更新图形驱动会使着色器缓存失效。


String get_device_vendor_name ( ) const

返回视频适配器的供应商(例如 "NVIDIA Corporation")。等价于 RenderingServer.get_video_adapter_vendor。另见 get_device_name


int get_driver_resource ( DriverResource resource, RID rid, int index )

返回指定 rid 的驱动资源 resource 的唯一标识符。部分驱动资源类型会忽略指定的 rid(说明见 DriverResource)。index 始终会被忽略,但仍然必须指定。


int get_frame_delay ( ) const

返回图形 API 所记录的帧数。值越高输入延迟就越高,但吞吐量也更一致。对于主 RenderingDevice 而言,帧会进行循环(启用三缓冲垂直同步时通常为 3)。但是局部 RenderingDevice 只有 1 帧。


int get_memory_usage ( MemoryType type ) const

返回与类型 type 对应的内存用量,单位为字节。使用 Vulkan 时,会通过 Vulkan Memory Allocator 计算这些统计信息。


RID index_array_create ( RID index_buffer, int index_offset, int index_count )

新建索引数组。可以通过返回的 RID 进行访问。

RID 使用结束后,应该使用 RenderingServer 的 free_rid 方法进行释放。


RID index_buffer_create ( int size_indices, IndexBufferFormat format, PackedByteArray data=PackedByteArray(), bool use_restart_indices=false )

新建索引缓冲。可以通过返回的 RID 进行访问。

RID 使用结束后,应该使用 RenderingServer 的 free_rid 方法进行释放。


int limit_get ( Limit limit ) const

返回指定 limit 的值。这个极限值取决于当前的图形硬件(有时也和驱动版本有关)。如果超出了给定的极限,则会发生渲染错误。

各种图形硬件的极限可以在 Vulkan 硬件数据库中找到。


RID render_pipeline_create ( RID shader, int framebuffer_format, int vertex_format, RenderPrimitive primitive, RDPipelineRasterizationState rasterization_state, RDPipelineMultisampleState multisample_state, RDPipelineDepthStencilState stencil_state, RDPipelineColorBlendState color_blend_state, BitField<PipelineDynamicStateFlags> dynamic_state_flags=0, int for_render_pass=0, RDPipelineSpecializationConstant[] specialization_constants=[] )

新建渲染管线。可以通过返回的 RID 进行访问。

RID 使用结束后,应该使用 RenderingServer 的 free_rid 方法进行释放。


bool render_pipeline_is_valid ( RID render_pipeline )

如果由 render_pipeline RID 指定的渲染管线有效则返回 true,否则返回 false


RID sampler_create ( RDSamplerState state )

新建采样器。可以通过返回的 RID 进行访问。

RID 使用结束后,应该使用 RenderingServer 的 free_rid 方法进行释放。


bool sampler_is_format_supported_for_filter ( DataFormat format, SamplerFilter sampler_filter ) const

如果实现支持使用格式为 formatsampler_filter 采样过滤的纹理,则返回 true


int screen_get_framebuffer_format ( ) const

返回屏幕帧缓冲的格式。

注意:只有 RenderingServer.get_rendering_device 返回的主 RenderingDevice 有格式。对局部 RenderingDevice 调用时,这个方法会输出错误并返回 INVALID_ID


int screen_get_height ( int screen=0 ) const

返回与给定窗口 ID 图形 API 上下文相匹配的窗口高度(单位为像素)。虽然参数的名字叫 screen,但返回的是窗口的大小。另见 screen_get_width

注意:只有 RenderingServer.get_rendering_device 返回的主 RenderingDevice 有高度。如果对局部 RenderingDevice 调用,则会输出错误并返回 INVALID_ID


int screen_get_width ( int screen=0 ) const

返回与给定窗口 ID 图形 API 上下文相匹配的窗口宽度(单位为像素)。虽然参数的名字叫 screen,但返回的是窗口的大小。另见 screen_get_height

注意:只有 RenderingServer.get_rendering_device 返回的主 RenderingDevice 有宽度。如果对局部 RenderingDevice 调用,则会输出错误并返回 INVALID_ID


void set_resource_name ( RID id, String name )

将 ID 为 id 的资源名称设置为 name。用于使用 RenderDoc 等第三方工具进行调试。

可以为以下类型的资源命名:纹理、采样器、顶点缓冲、索引缓冲、uniform 缓冲、纹理缓冲、存储缓冲、uniform 集缓冲、着色器、渲染管线、计算管线。无法为帧缓冲命名。尝试为不兼容的资源类型命名会输出错误。

注意:引擎以详细模式运行时(OS.is_stdout_verbose = true),或者使用 dev_mode=yes SCons 选项编译引擎构建时,才会设置资源的名称。图形驱动也必须支持 Vulkan 扩展 VK_EXT_DEBUG_UTILS_EXTENSION_NAME 具名资源才能正常工作。


PackedByteArray shader_compile_binary_from_spirv ( RDShaderSPIRV spirv_data, String name="" )

spirv_data 编译二进制着色器,并将编译得到的二进制数据以 PackedByteArray 的形式返回。编译后的着色器与所使用的 GPU 型号和驱动版本对应;无法在不同的 GPU 型号甚至不同的驱动版本上正常工作。另见 shader_compile_spirv_from_source

name 是可选的人类可读名称,会给予编译后的着色器,方便组织。


RDShaderSPIRV shader_compile_spirv_from_source ( RDShaderSource shader_source, bool allow_cache=true )

shader_source 中的着色器源代码编译为 RDShaderSPIRV 形式的 SPIR-V。这种中间语言的着色器可以在不同 GPU 型号和驱动版本之间移植,但无法直接在 GPU 上运行,需要先使用 shader_compile_binary_from_spirv 编译为二进制着色器。

如果 allow_cachetrue,则会使用 Godot 生成的着色器缓存。如果着色器已经在缓存中,这样就可能避免冗长的着色器编译步骤。allow_cachefalse,则会忽略 Godot 的着色器缓存,始终重新编译着色器。


RID shader_create_from_bytecode ( PackedByteArray binary_data, RID placeholder_rid=RID() )

根据二进制的已编译着色器创建新的着色器实例。可以通过返回的 RID 进行访问。

RID 使用结束后,应该使用 RenderingDevice 的 free_rid 方法进行释放。另见 shader_compile_binary_from_spirvshader_create_from_spirv


RID shader_create_from_spirv ( RDShaderSPIRV spirv_data, String name="" )

根据 SPIR-V 中间代码创建新的着色器实例。可以通过返回的 RID 进行访问。

RID 使用结束后,应该使用 RenderingDevice 的 free_rid 方法进行释放。另见 shader_compile_spirv_from_sourceshader_create_from_bytecode


RID shader_create_placeholder ( )

通过分配 RID 来创建占位符 RID,而不对其进行初始化以供在 shader_create_from_bytecode 中使用。这允许你为着色器创建 RID 并传递它,但将着色器的编译推迟到以后的时间。


int shader_get_vertex_input_attribute_mask ( RID shader )

返回内部顶点输入掩码。在内部,顶点输入掩码是一个无符号整数,由输入变量(在 GLSL 中通过 in 关键字指定)的位置(在 GLSL 中通过 layout(location = ...) 指定)组成。


RID storage_buffer_create ( int size_bytes, PackedByteArray data=PackedByteArray(), BitField<StorageBufferUsage> usage=0 )

创建带有指定数据 data 用法为 usage存储缓冲。可以通过返回的 RID 进行访问。

RID 使用结束后,应该使用 RenderingServer 的 free_rid 方法进行释放。


void submit ( )

推送帧设置与绘图命令缓冲,然后将局部设备标记为当前正在处理(这样就能够调用 sync)。

注意:仅在局部 RenderingDevice 上可用。


void sync ( )

让 CPU 与 GPU 进行强制同步,部分场合可能需要进行这样的操作。请只在需要时调用,因为 CPU 与 GPU 的同步存在性能开销。

注意:仅在局部 RenderingDevice 上可用。

注意:只能在 submit 后调用 sync


RID texture_buffer_create ( int size_bytes, DataFormat format, PackedByteArray data=PackedByteArray() )

新建纹理缓冲。可以通过返回的 RID 进行访问。

RID 使用结束后,应该使用 RenderingServer 的 free_rid 方法进行释放。


Error texture_clear ( RID texture, Color color, int base_mipmap, int mipmap_count, int base_layer, int layer_count, BitField<BarrierMask> post_barrier=32767 )

将指定的 texture 清屏,将所有像素替换为指定的颜色 colorbase_mipmapmipmap_count 决定该清屏操作影响纹理的哪些 mipmap,而 base_layerlayer_count 决定该清屏操作影响 3D 纹理(或纹理数组)的哪几层。如果是 2D 纹理(本来就只有一层),则 base_layer 必须为 0layer_count 必须为 1

注意:如果使用 texture 的绘图列表是创建的帧缓冲的一部分,则该纹理不能被清屏。确保绘图列表释放后(并且使用它的颜色和深度纹理没有被设为 FINAL_ACTION_CONTINUE)才能对该纹理做清屏操作。


Error texture_copy ( RID from_texture, RID to_texture, Vector3 from_pos, Vector3 to_pos, Vector3 size, int src_mipmap, int dst_mipmap, int src_layer, int dst_layer, BitField<BarrierMask> post_barrier=32767 )

from_texture 复制到 to_texture,使用指定的 from_posto_possize 坐标。对于二维纹理,from_posto_possize 的 Z 轴必须为 0。来源和目标的 mipmap/图层也必须指定,对于没有 mipmap 或单层纹理的情况,这些参数应为 0。如果纹理复制成功,则返回 @GlobalScope.OK,否则返回 @GlobalScope.ERR_INVALID_PARAMETER

注意:如果使用 from_texture 纹理的绘图列表是创建的帧缓冲的一部分,则无法复制。请确保绘图列表已经完成(并且使用它的颜色/深度纹理没有设置为 FINAL_ACTION_CONTINUE),然后再复制纹理。

注意:from_texture 纹理需要获取 TEXTURE_USAGE_CAN_COPY_FROM_BIT

注意:如果使用 to_texture 纹理的绘图列表是创建的帧缓冲的一部分,则无法复制。请确保绘图列表已经完成(并且使用它的颜色/深度纹理没有设置为 FINAL_ACTION_CONTINUE),然后再复制纹理。

注意:to_texture 纹理需要获取 TEXTURE_USAGE_CAN_COPY_TO_BIT

注意:from_textureto_texture 的类型必须相同(颜色或深度)。


RID texture_create ( RDTextureFormat format, RDTextureView view, PackedByteArray[] data=[] )

新建纹理。可以通过返回的 RID 进行访问。

RID 使用结束后,应该使用 RenderingServer 的 free_rid 方法进行释放。

注意:请勿与 RenderingServer.texture_2d_create 混淆,后者创建的是 Godot 专属的 Texture2D 资源,不是图形 API 自己的纹理类型。


RID texture_create_from_extension ( TextureType type, DataFormat format, TextureSamples samples, BitField<TextureUsageBits> usage_flags, int image, int width, int height, int depth, int layers )

使用给定的 typeformatsamplesusage_flagswidthheightdepth、和 layers 返回已有 imageVkImage)的 RID。这可被用于允许 Godot 渲染到外部图像上。


RID texture_create_shared ( RDTextureView view, RID with_texture )

使用指定的 viewwith_texture 中的纹理信息创建共享纹理。


RID texture_create_shared_from_slice ( RDTextureView view, RID with_texture, int layer, int mipmap, int mipmaps=1, TextureSliceType slice_type=0 )

使用指定的 viewwith_texturelayermipmap 中的纹理信息创建共享纹理。可以使用 mipmaps 参数控制从原始纹理中包含的 mipmap 数量。仅适用于 3D 纹理、纹理数组、立方体贴图等多层纹理。单层纹理请使用 texture_create_shared

对于 2D 纹理(仅有一个图层),layer 必须为 0

注意:图层切片仅支持 2D 纹理数组,不支持 3D 纹理或立方体贴图。


PackedByteArray texture_get_data ( RID texture, int layer )

将纹理 texture 中指定层 layer 的纹理数据以原始二进制数据的形式返回。2D 纹理(只有一层)的 layer 必须为 0

注意:如果使用 texture 纹理的绘图列表是创建的帧缓冲的一部分,则无法获取。请确保绘图列表已经完成(并且使用它的颜色/深度纹理没有设置为 FINAL_ACTION_CONTINUE),然后获取纹理。否则会输出错误并返回空的 PackedByteArray

注意:texture 纹理需要获取 TEXTURE_USAGE_CAN_COPY_FROM_BIT。否则会输出错误并返回空的 PackedByteArray


RDTextureFormat texture_get_format ( RID texture )

返回用于创建该纹理的数据格式。


int texture_get_native_handle ( RID texture )

返回该纹理对象的内部图形句柄。主要用于 GDExtension 与第三方 API 通讯。

注意:这个函数返回的是 uint64_t,内部映射到 GLuint(OpenGL)或 VkImage(Vulkan)。


bool texture_is_format_supported_for_usage ( DataFormat format, BitField<TextureUsageBits> usage_flags ) const

如果指定的格式 format 支持给定的用途标志 usage_flags,则返回 true,否则返回 false


bool texture_is_shared ( RID texture )

如果 texture 是共享纹理,则返回 true,否则返回 false。见 RDTextureView


bool texture_is_valid ( RID texture )

如果 texture 有效,则返回 true,否则返回 false


Error texture_resolve_multisample ( RID from_texture, RID to_texture, BitField<BarrierMask> post_barrier=32767 )

启用多重采样抗锯齿,将 from_texture 纹理溶解至 to_texture。启用后才能够正常渲染 MSAA 帧缓冲。成功时返回 @GlobalScope.OK,否则返回 @GlobalScope.ERR_INVALID_PARAMETER

注意:from_textureto_texture 的尺寸、格式、类型(颜色或深度)都必须相同。

注意:如果使用 from_texture 纹理的绘图列表是创建的帧缓冲的一部分,则无法复制。请确保绘图列表已经完成(并且使用它的颜色/深度纹理没有设置为 FINAL_ACTION_CONTINUE),然后再复制纹理。

注意:from_texture 纹理需要获取 TEXTURE_USAGE_CAN_COPY_FROM_BIT

注意:from_texture 纹理必须为多重采样,并且必须为 2D 纹理(或者是 3D/立方体贴图纹理的切片)。

注意:如果使用 to_texture 纹理的绘图列表是创建的帧缓冲的一部分,则无法复制。请确保绘图列表已经完成(并且使用它的颜色/深度纹理没有设置为 FINAL_ACTION_CONTINUE),然后再溶解纹理。

注意:to_texture 纹理需要获取 TEXTURE_USAGE_CAN_COPY_TO_BIT

注意:from_texture 纹理必须不能是多重采样,并且必须为 2D 纹理(或者是 3D/立方体贴图纹理的切片)。


Error texture_update ( RID texture, int layer, PackedByteArray data, BitField<BarrierMask> post_barrier=32767 )

使用新的数据更新纹理数据,会原地替换之前的数据。更新后的纹理数据必须和原有尺寸、格式一致。2D 纹理(只有一层)的 layer 必须为 0。如果更新成功则返回 @GlobalScope.OK,否则返回 @GlobalScope.ERR_INVALID_PARAMETER

注意:精致在创建绘图列表或计算列表时更新纹理。

注意:如果使用 texture 纹理的绘图列表是创建的帧缓冲的一部分,则无法更新。请确保绘图列表已经完成(并且使用它的颜色/深度纹理没有设置为 FINAL_ACTION_CONTINUE),然后再更新纹理。

注意:texture 纹理需要获取 TEXTURE_USAGE_CAN_UPDATE_BIT


RID uniform_buffer_create ( int size_bytes, PackedByteArray data=PackedByteArray() )

新建 uniform 缓冲。可以通过返回的 RID 进行访问。

RID 使用结束后,应该使用 RenderingDevice 的 free_rid 方法进行释放。


RID uniform_set_create ( RDUniform[] uniforms, RID shader, int shader_set )

新建 uniform 集。可以通过返回的 RID 进行访问。

RID 使用结束后,应该使用 RenderingDevice 的 free_rid 方法进行释放。


bool uniform_set_is_valid ( RID uniform_set )

检查 uniform_set 是否有效,即是否有归属。


RID vertex_array_create ( int vertex_count, int vertex_format, RID[] src_buffers, PackedInt64Array offsets=PackedInt64Array() )

根据给定的缓冲区创建顶点数组。还可以为各个缓冲区定义偏移量 offsets(单位为字节)。


RID vertex_buffer_create ( int size_bytes, PackedByteArray data=PackedByteArray(), bool use_as_storage=false )

可以通过返回的 RID 进行访问。

RID 使用结束后,应该使用 RenderingServer 的 free_rid 方法进行释放。


int vertex_format_create ( RDVertexAttribute[] vertex_descriptions )

新建顶点描述为 vertex_descriptions 的顶点格式。返回与新建顶点格式对应的唯一格式 ID。