SampleGrad::SampleGrad(S,float,float,float,int,float,uint) para Texture1DArray

Muestra una textura, utilizando un degradado para influir en la forma en que se calcula la ubicación de la muestra, con un valor opcional para restringir los valores de nivel de detalle de muestra (LOD). Devuelve el estado de la operación.

Sintaxis

DXGI_FORMAT SampleGrad(
  in  SamplerState S,
  in  float        Location,
  in  float        DDX,
  in  float        DDY,
  in  int          Offset,
  in  float        Clamp,
  out uint         Status
);

Parámetros

S [in]

Tipo: SamplerState

Un estado sampler. Se trata de un objeto declarado en un archivo de efecto que contiene asignaciones de estado.

Ubicación [in]

Tipo: float

Las coordenadas de textura. El tipo de argumento depende del tipo de objeto de textura.

tipo de Texture-Object	Tipo de parámetro
Texture1D	FLOAT
Texture1DArray, Texture2D	float2
Texture2DArray, Texture3D, TextureCube	float3
TextureCubeArray	float4

 

DDX [in]

Tipo: float

Velocidad de cambio de la geometría de la superficie en la dirección x. El tipo de argumento depende del tipo de objeto de textura.

tipo de Texture-Object	Tipo de parámetro
Texture1D, Texture1DArray	FLOAT
Texture2D, Texture2DArray	float2
Texture3D, TextureCube, TextureCubeArray	float3
Texture2DMS, Texture2DMSArray	no admitido

 

DDY [in]

Tipo: float

Velocidad de cambio de la geometría de la superficie en la dirección y. El tipo de argumento depende del tipo de objeto de textura.

tipo de Texture-Object	Tipo de parámetro
Texture1D, Texture1DArray	FLOAT
Texture2D, Texture2DArray	float2
Texture3D, TextureCube, TextureCubeArray	float3
Texture2DMS, Texture2DMSArray	no admitido

 

Desplazamiento [in]

Tipo: int

Desplazamiento de coordenadas de textura opcional, que se puede usar para cualquier tipo de objeto de textura; el desplazamiento se aplica a la ubicación antes del muestreo. Utilice un desplazamiento solo en un miplevel entero; De lo contrario, puede obtener resultados que no se traducen bien en el hardware. El tipo de argumento depende del tipo de objeto de textura. Para obtener más información, consulta Aplicar desplazamientos enteros.

tipo de Texture-Object	Tipo de parámetro
Texture1D, Texture1DArray	int
Texture2D, Texture2DArray	int2
Texture3D	int3
TextureCube, TextureCubeArray	no admitido

 

Abrazadera [in]

Tipo: float

Valor opcional al que se van a restringir los valores de LOD de ejemplo. Por ejemplo, si pasa 2.0f para el valor de la abrazadera, asegúrese de que ninguna muestra individual tiene acceso a un nivel mip inferior a 2.0f.

Estado [out]

Tipo: uint

Estado de la operación. No se puede acceder directamente al estado; en su lugar, pase el estado a la función intrínseca CheckAccessFullyMapped . CheckAccessFullyMapped devuelve TRUE si todos los valores de la operación Sample, Gather o Load correspondiente a la que se ha accedido a los iconos asignados en un recurso en mosaico. Si se han tomado valores de un icono sin asignar, CheckAccessFullyMapped devuelve FALSE.

Valor devuelto

Tipo: DXGI_FORMAT

Formato de textura, que es uno de los valores con tipo enumerados en DXGI_FORMAT.

Consulte también

Métodos sampleGrad