SampleLevel::SampleLevel (S、float、float、int、uint) 函数(适用于 Texture1DArray)

对指定 mipmap 级别的纹理进行采样,并返回有关操作的状态。

语法

DXGI_FORMAT SampleLevel(
  in  SamplerState S,
  in  float        Location,
  in  float        LOD,
  in  int          Offset,
  out uint         Status
);

参数

S [in]

类型: SamplerState

采样器状态。 这是在包含状态分配的效果文件中声明的对象。

位置 [in]

类型: float

纹理坐标。 参数类型依赖于纹理对象类型。

Texture-Object类型 参数类型
Texture1D FLOAT
Texture1DArray、Texture2D float2
Texture2DArray、Texture3D、TextureCube float3
TextureCubeArray float4

 

LOD [in]

类型: float

[in]一个指定 mipmap 级别的数字。 如果该值≤ 0,则使用 mipmap 级别 0 (最大的地图) 。 如果提供的) 用于在两个 mipmap 级别之间内插,则小数部分值 (。

偏移量 [in]

类型: int

可选纹理坐标偏移量,可用于任何纹理对象类型:偏移量应用于采样前的位置。 仅在整数位处使用偏移量;否则,可能会获得无法很好地转换为硬件的结果。 参数类型依赖于纹理对象类型。 有关详细信息,请参阅 应用整数偏移量。

Texture-Object类型 参数类型
Texture1D、Texture1DArray int
Texture2D、Texture2DArray int2
Texture3D int3
TextureCube、TextureCubeArray 不支持

 

状态 [out]

类型: uint

操作的状态。 无法直接访问状态;而是将状态传递给 CheckAccessFullyMapped 内部函数。 如果相应示例收集加载操作中的所有值访问了平铺资源中的映射磁贴,CheckAccessFullyMapped 将返回 TRUE。 如果从未映射的磁贴中提取任何值, CheckAccessFullyMapped 将返回 FALSE

返回值

类型: DXGI_FORMAT

纹理格式,它是 DXGI_FORMAT中列出的类型化值之一。

另请参阅

SampleLevel 方法