Compartir a través de


Texture3D::Sample(S,float,int,float,uint) (función)

Muestrea una textura con un valor opcional para fijar los valores de nivel de detalle (LOD) de muestra y devuelve el estado de la operación.

Sintaxis

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

Parámetros

S [in]

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

Ubicación [in]

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

 

Desplazamiento [in]

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]

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]

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

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

Consulte también

Métodos de ejemplo

Texture3D