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

Artículo
06/12/2023

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