Metode IWICPlanarBitmapSourceTransform::D oesSupportTransform (wincodec.h)

Artikel
08/27/2023

Gunakan metode ini untuk menentukan apakah output planar yang diinginkan didukung dan memungkinkan pemanggil untuk memilih jalur kode yang dioptimalkan jika ada. Jika tidak, penelepon harus kembali ke IWICBitmapSourceTransform atau IWICBitmapSource dan mengambil piksel yang saling terkait.

Transformasi berikut dapat diperiksa:

Tentukan apakah opsi balik/putar yang ditentukan melalui WICBitmapTransformOptions didukung.
Tentukan apakah konfigurasi format piksel planar yang diminta didukung.
Tentukan dimensi terdekat implementasi dapat menskalakan secara asli untuk diberikan dimensi yang diinginkan.

Ketika transformasi didukung, metode ini mengembalikan deskripsi bidang yang dihasilkan dalam parameter pPlaneDescriptions .

Sintaks

HRESULT DoesSupportTransform(
  [in, out] UINT                      *puiWidth,
  [in, out] UINT                      *puiHeight,
            WICBitmapTransformOptions dstTransform,
            WICPlanarOptions          dstPlanarOptions,
  [in]      const WICPixelFormatGUID  *pguidDstFormats,
  [out]     WICBitmapPlaneDescription *pPlaneDescriptions,
            UINT                      cPlanes,
  [out]     BOOL                      *pfIsSupported
);

Parameter

[in, out] puiWidth

Jenis: UINT*

Pada input, lebar yang diinginkan. Pada output, lebar terdekat yang didukung dengan lebar yang diinginkan; ini adalah ukuran yang sama atau lebih besar dari lebar yang diinginkan.

[in, out] puiHeight

Jenis: UINT*

Pada input, tinggi yang diinginkan. Pada output, tinggi terdekat yang didukung dengan tinggi yang diinginkan; ini adalah ukuran yang sama atau lebih besar dari lebar yang diinginkan.

dstTransform

Jenis: WICBitmapTransformOptions

Operasi rotasi atau balik yang diinginkan. Beberapa WICBitmapTransformOptions dapat digabungkan dalam parameter bendera ini, lihat WICBitmapTransformOptions.

dstPlanarOptions

Jenis: WICPlanarOptions

Digunakan untuk menentukan opsi konfigurasi tambahan untuk transformasi. Lihat WICPlanarOptions untuk detail selengkapnya.

WIC JPEG Decoder:

WICPlanarOptionsPreserveSubsampling dapat ditentukan untuk mempertahankan rasio subsampling saat penurunan skala. Secara default, dekoder JPEG mencoba mempertahankan kualitas dengan menurunkan skala hanya bidang Y dalam beberapa kasus, mengubah gambar menjadi subsampling kroma 4:4:4.

[in] pguidDstFormats

Jenis: const WICPixelFormatGUID*

Format piksel yang diminta dari masing-masing bidang.

[out] pPlaneDescriptions

Jenis: WICBitmapPlaneDescription*

Ketika *pfIsSupported == TRUE, array deskripsi bidang berisi ukuran dan format masing-masing bidang.

WIC JPEG Decoder: Bidang Cb dan Cr dapat menjadi ukuran yang berbeda dari nilai yang dikembalikan oleh puiWidth dan puiHeight karena subsampling chroma.

cPlanes

Jenis: UINT

Jumlah bidang komponen yang diminta.

[out] pfIsSupported

Jenis: BOOL*

Atur ke TRUE jika transformasi yang diminta didukung secara asli.

Nilai kembali

Jenis: HRESULT

Periksa nilai pfIsSupported untuk menentukan apakah transformasi didukung melalui IWICPlanarBitmapSourceTransform::CopyPixels. Jika metode ini gagal, parameter output untuk deskripsi lebar, tinggi, dan bidang tidak diinisialisasi. Nilai pengembalian lainnya menunjukkan kegagalan.

Persyaratan

Persyaratan	Nilai
Klien minimum yang didukung	Windows 8.1 [aplikasi desktop \| Aplikasi UWP]
Server minimum yang didukung	Windows Server 2012 R2 [aplikasi desktop \| Aplikasi UWP]
Target Platform	Windows
Header	wincodec.h
Pustaka	Windowscodecs.lib
DLL	Windowscodecs.dll

Lihat juga

IWICPlanarBitmapSourceTransform

IWicPlanarBitmapSourceTransform::CopyPixels

WICBitmapPlaneDescription

WICBitmapTransformOptions