Share via

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

  • Artikel

Sampel tekstur, menggunakan gradien untuk memengaruhi cara lokasi sampel dihitung, dengan nilai opsional untuk menjepit nilai tingkat detail (LOD) sampel. Mengembalikan status tentang operasi.

Sintaks

DXGI_FORMAT SampleGrad(
  in  SamplerState S,
  in  float        Location,
  in  float        DDX,
  in  float        DDY,
  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

 

DDX [in]

Jenis: float

Tingkat perubahan geometri permukaan ke arah x. Jenis argumen tergantung pada jenis objek tekstur.

Jenis Texture-Object Jenis Parameter
Texture1D, Texture1DArray float
Texture2D, Texture2DArray float2
Texture3D, TextureCube, TextureCubeArray float3
Texture2DMS, Texture2DMSArray tidak didukung

 

DDY [in]

Jenis: float

Tingkat perubahan geometri permukaan ke arah y. Jenis argumen tergantung pada jenis objek tekstur.

Jenis Texture-Object Jenis Parameter
Texture1D, Texture1DArray float
Texture2D, Texture2DArray float2
Texture3D, TextureCube, TextureCubeArray float3
Texture2DMS, Texture2DMSArray tidak didukung

 

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 SampleGrad

Texture2DArray