GetDimensions (DirectX HLSL 纹理对象)

  • 项目

获取纹理大小信息。 语法块显示方法声明中可能的所有参数。 “备注”部分中的表显示为每个纹理对象类型实现的参数。

void Object.GetDimensions ( UINT MipLevel， typeX Width， typeX Height， typeX Elements， typeX Depth， typeX NumberOfLevels， typeX NumberOfSamples ) ;

typeX 表示有两种可能的类型： uint 或 float。

参数

项 说明
对象
 除 Buffer 对象之外的任何纹理对象类型。
MipLevel
 [in]一个从零开始的索引，用于标识 mipmap 级别。 如果未使用此参数，则假定第一个 mip 级别。
宽度
 [out]纹理宽度，以纹素为单位。
高度
 [out]纹理高度（以纹素为单位）。
元素
 [out]数组中的元素数。
深度
 [out]纹理深度（以纹素为单位）。
NumberOfLevels
 [out]mipmap 级别的数目。
NumberOfSamples
 [out]样本数。

返回值

无

重载方法

下表列出了 方法的所有不同版本;版本因输入参数数而异。 请注意，对于每个采用整数参数的方法，都有一个采用浮点参数的重载方法。

Texture-Object类型 输入参数
Texture1D UINT MipLevel、UINT Width、UINT NumberOfLevels
Texture1D UINT 宽度
Texture1D UINT MipLevel、float Width、float NumberOfLevels
Texture1D float Width
Texture1DArray UINT MipLevel、UINT 宽度、UINT 元素、UINT NumberOfLevels
Texture1DArray UINT 宽度、UINT 元素
Texture1DArray UINT MipLevel， float Width， float Elements， float NumberOfLevels
Texture1DArray float Width，float Elements
Texture2D UINT MipLevel、UINT 宽度、UINT 高度、UINT NumberOfLevels
Texture2D UINT 宽度、UINT 高度
Texture2D UINT MipLevel、float Width、float Height、float NumberOfLevels
Texture2D float Width、float Height
Texture2DArray UINT MipLevel、UINT 宽度、UINT 高度、UINT 元素、UINT NumberOfLevels
Texture2DArray UINT 宽度、UINT 高度、UINT 元素
Texture2DArray UINT MipLevel， float Width， float Height， float Elements， float NumberOfLevels
Texture2DArray float Width、float Height、float Elements
Texture3D UINT MipLevel、UINT 宽度、UINT 高度、UINT 深度、UINT NumberOfLevels
Texture3D UINT 宽度、UINT 高度、UINT 深度
Texture3D UINT MipLevel、float Width、float Height、float Depth、float NumberOfLevels
Texture3D float Width、float Height、float Depth
TextureCube UINT MipLevel、UINT 宽度、UINT 高度、UINT NumberOfLevels
TextureCube UINT 宽度、UINT 高度
TextureCube UINT MipLevel、float Width、float Height、UINT NumberOfLevels
TextureCube float Width、float Height
TextureCubeArray UINT MipLevel、UINT 宽度、UINT 高度、UINT 元素、UINT NumberOfLevels
TextureCubeArray UINT 宽度、UINT 高度、UINT 元素
TextureCubeArray UINT MipLevel， float Width， float Height， float Elements， float NumberOfLevels
TextureCubeArray float Width、float Height、float Elements
Texture2DMS UINT 宽度、UINT 高度、UINT 示例
Texture2DMS float Width、float Height、float Samples
Texture2DMSArray UINT 宽度、UINT 高度、UINT 元素、UINT 示例
Texture2DMSArray float Width、float Height、float Elements、float Samples

最小着色器模型

以下着色器模型中支持此函数。

vs_4_0 vs_4_1 ps_4_0 ps_4_1 gs_4_0 gs_4_1
x x x x x x
  1. 返回 mipmap 级别的最大 (零) 维度。
  2. TextureCubeArray 在着色器模型 4.1 或更高版本中可用。
  3. 着色器模型 4.1 在 Direct3D 10.1 或更高版本中可用。

Texture-Object