Compartir a través de


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

Muestra una textura, utilizando un degradado para influir en la forma en que se calcula la ubicación de ejemplo, con un valor opcional para fijar los valores de nivel de detalle (LOD) de muestra. Devuelve el estado sobre 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 efectos 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

Un 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. Use un desplazamiento solo en un miplevel entero; de lo contrario, puede obtener resultados que no se traducen bien en 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 fijar los valores de LOD de ejemplo. Por ejemplo, si pasa 2.0f para el valor de abrazadera, asegúrese de que ninguna muestra individual tenga acceso a un nivel mip inferior a 2.0f.

Estado [out]

Tipo: uint

Estado de la operación. No se puede acceder al estado directamente; 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 no asignado, 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

Texture3D