Compartir a través de


Función SampleLevel::SampleLevel(S,float,float,int,uint) para Texture1DArray

Muestra una textura en el nivel de mapa mip especificado y devuelve el estado sobre la operación.

Sintaxis

DXGI_FORMAT SampleLevel(
  in  SamplerState S,
  in  float        Location,
  in  float        LOD,
  in  int          Offset,
  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

 

LOD [in]

Tipo: float

[in] Número que especifica el nivel de mapa mip. Si el valor es ≤ 0, se usa el nivel de mapa mip 0 (mapa más grande). El valor fraccionaria (si se proporciona) se usa para interpolar entre dos niveles de mapa MIP.

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

 

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 SampleLevel