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 |
- 返回 mipmap 级别的最大 (零) 维度。
- TextureCubeArray 在着色器模型 4.1 或更高版本中可用。
- 着色器模型 4.1 在 Direct3D 10.1 或更高版本中可用。