D3D10_SAMPLER_DESC 结构 (d3d10.h)

描述采样器状态。

语法

typedef struct D3D10_SAMPLER_DESC {
  D3D10_FILTER               Filter;
  D3D10_TEXTURE_ADDRESS_MODE AddressU;
  D3D10_TEXTURE_ADDRESS_MODE AddressV;
  D3D10_TEXTURE_ADDRESS_MODE AddressW;
  FLOAT                      MipLODBias;
  UINT                       MaxAnisotropy;
  D3D10_COMPARISON_FUNC      ComparisonFunc;
  FLOAT                      BorderColor[4];
  FLOAT                      MinLOD;
  FLOAT                      MaxLOD;
} D3D10_SAMPLER_DESC;

成员

Filter

类型： D3D10_FILTER

采样纹理时要使用的筛选方法 (看到 D3D10_FILTER) 。

AddressU

类型： D3D10_TEXTURE_ADDRESS_MODE

用于解析超出 0 到 1 范围的 u 纹理坐标的方法 (请参阅 D3D10_TEXTURE_ADDRESS_MODE) 。

AddressV

类型： D3D10_TEXTURE_ADDRESS_MODE

用于解析超出 0 到 1 范围的 v 纹理坐标的方法。

AddressW

类型： D3D10_TEXTURE_ADDRESS_MODE

用于解析超出 0 到 1 范围的 w 纹理坐标的方法。

MipLODBias

类型： FLOAT

与计算的 mipmap 级别的偏移量。 例如，如果 Direct3D 计算纹理应在 mipmap 级别 3 采样，而 MipLODBias 为 2，则将在 mipmap 级别 5 对纹理进行采样。

MaxAnisotropy

类型： UINT

如果在 Filter 中指定了D3D10_FILTER_ANISOTROPIC或D3D10_FILTER_COMPARISON_ANISOTROPIC，则使用的固定值。 有效值介于 1 和 16 之间。

ComparisonFunc

类型： D3D10_COMPARISON_FUNC

一个函数，用于将采样数据与现有采样数据进行比较。 函数选项在 D3D10_COMPARISON_FUNC 中列出。

BorderColor[4]

类型： FLOAT

如果为 AddressU、AddressV 或 AddressW 指定了D3D10_TEXTURE_ADDRESS_BORDER，则使用的边框颜色。 范围必须介于 0.0 和 1.0（含）之间。

MinLOD

类型： FLOAT

要固定访问的 mipmap 范围的下端，其中 0 是最大和最详细的 mipmap 级别，任何高于该级别的级别都不太详细。

MaxLOD

类型： FLOAT

要固定访问的 mipmap 范围的上端，其中 0 是最大和最详细的 mipmap 级别，任何高于该级别的级别都不太详细。 此值必须大于或等于 MinLOD。 如果没有 LOD 的上限，请将此值设置为较大的值，例如D3D10_FLOAT32_MAX。

注解

这些是采样器状态的默认值。

状态	默认值
筛选器	Min_Mag_Mip_Point
AddressU	Clamp
AddressV	Clamp
AddressW	Clamp
MinLOD	0.0f
MaxLOD	3.402823466e+38F (FLT_MAX)
MipMapLODBias	0.0f
MaxAnisotropy	16
ComparisonFunc	从不
BorderColor	float4 (0.0f、0.0f、0.0f、0.0f)
纹理	N/A

要求

要求	值
Header	d3d10.h

另请参阅

核心结构