Bagikan melalui

SampleCmp::SampleCmp(S,float,float,int,float,uint) function untuk Texture1DArray

  • Artikel

Sampel tekstur, menggunakan nilai perbandingan untuk menolak sampel, dengan nilai opsional untuk menjepit nilai tingkat detail sampel (LOD). Mengembalikan status tentang operasi.

Sintaks

DXGI_FORMAT SampleCmp(
  in  SamplerState S,
  in  float        Location,
  in  float        CompareValue,
  in  int          Offset,
  in  float        Clamp,
  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

 

CompareValue [in]

Jenis: float

Nilai floating-point untuk digunakan sebagai nilai perbandingan.

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

 

Jepit [in]

Jenis: float

Nilai opsional untuk menjepit nilai LOD sampel. Misalnya, jika Anda meneruskan 2,0f untuk nilai klem, Anda memastikan bahwa tidak ada sampel individual yang mengakses tingkat mip kurang dari 2,0f.

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 SampleCmp