SampleLevel::SampleLevel(S,float,float,int,uint) function untuk Texture2DArray

Artikel
06/13/2023

Sampel tekstur pada tingkat mipmap yang ditentukan dan mengembalikan status tentang operasi.

Sintaks

DXGI_FORMAT SampleLevel(
  in  SamplerState S,
  in  float        Location,
  in  float        LOD,
  in  int          Offset,
  out uint         Status
);

Parameter

S [in]

Jenis: SamplerState

Status Sampler. Ini adalah objek yang dideklarasikan dalam file efek yang berisi penetapan status.

Lokasi [in]

Jenis: float

Koordinat tekstur. Jenis argumen tergantung pada jenis objek tekstur.

Jenis Texture-Object	Jenis Parameter
Texture1D	float
Texture1DArray, Texture2D	float2
Texture2DArray, Texture3D, TextureCube	float3
TextureCubeArray	float4

LOD [in]

Jenis: float

[in] Angka yang menentukan tingkat mipmap. Jika nilainya ≤ 0, mipmap level 0 (peta terbesar) digunakan. Nilai pecahan (jika disediakan) digunakan untuk menginterpolasi antara dua tingkat mipmap.

Offset [in]

Jenis: int

Offset koordinat tekstur opsional, yang dapat digunakan untuk jenis objek tekstur apa pun; offset diterapkan ke lokasi sebelum pengambilan sampel. Gunakan offset hanya pada miplevel bilangan bulat; jika tidak, Anda mungkin mendapatkan hasil yang tidak diterjemahkan dengan baik ke perangkat keras. Jenis argumen tergantung pada jenis objek tekstur. Untuk informasi selengkapnya, lihat Menerapkan Offset Bilangan Bulat.

Jenis Texture-Object	Jenis Parameter
Texture1D, Texture1DArray	int
Texture2D, Texture2DArray	int2
Texture3D	int3
TextureCube, TextureCubeArray	tidak didukung

Status [keluar]

Jenis: uint

Status operasi. Anda tidak dapat mengakses status secara langsung; sebagai gantinya, teruskan status ke fungsi intrinsik CheckAccessFullyMapped . CheckAccessFullyMapped mengembalikan TRUE jika semua nilai dari petak peta Sampel, Pengumpulan, atau Pemuatan yang diakses yang sesuai diakses dalam sumber daya petak peta. Jika ada nilai yang diambil dari petak peta yang tidak dipetakan, CheckAccessFullyMapped mengembalikan FALSE.

Nilai kembali

Jenis: DXGI_FORMAT

Format tekstur, yang merupakan salah satu nilai yang di ketik yang tercantum dalam DXGI_FORMAT.

Lihat juga

Metode SampleLevel
Texture2DArray