Metode IWICPlanarBitmapSourceTransform::CopyPixels (wincodec.h)

  • Artikel

Menyalin piksel ke dalam bidang tujuan. Dikonfigurasi oleh parameter input yang disediakan.

Jika konversi dstTransform, skala, atau format ditentukan, cbStride adalah langkah yang diubah dan didasarkan pada format piksel tujuan parameter pDstPlanes , bukan format piksel sumber asli.

Sintaks

HRESULT CopyPixels(
  [in] const WICRect             *prcSource,
       UINT                      uiWidth,
       UINT                      uiHeight,
       WICBitmapTransformOptions dstTransform,
  [in] WICPlanarOptions          dstPlanarOptions,
       const WICBitmapPlane      *pDstPlanes,
       UINT                      cPlanes
);

Parameter

[in] prcSource

Jenis: const WICRect*

Persegi panjang sumber piksel yang akan disalin.

uiWidth

Jenis: UINT

Lebar untuk menskalakan bitmap sumber. Parameter ini harus sama dengan nilai yang dapat diperoleh melalui IWICPlanarBitmapSourceTransform:: DoesSupportTransform.

uiHeight

Jenis: UINT

Tinggi untuk menskalakan bitmap sumber. Parameter ini harus sama dengan nilai yang dapat diperoleh melalui IWICPlanarBitmapSourceTransform:: DoesSupportTransform.

dstTransform

Jenis: WICBitmapTransformOptions

Rotasi atau balik yang diinginkan untuk dilakukan sebelum salinan piksel. Rotasi dapat dikombinasikan dengan flip horizontal atau vertikal balik, lihat WICBitmapTransformOptions.

[in] dstPlanarOptions

Jenis: const 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 menurunkan skala. Secara default, dekoder JPEG mencoba mempertahankan kualitas dengan menurunkan skala hanya bidang Y dalam beberapa kasus, mengubah gambar menjadi subsampling chroma 4:4:4.

pDstPlanes

Jenis: WICBitmapPlane

Menentukan format piksel dan buffer output untuk setiap bidang komponen. Jumlah bidang dan format piksel setiap bidang harus cocok dengan nilai yang dapat diperoleh melalui IWICPlanarBitmapSourceTransform::D oesSupportTransform.

cPlanes

Jenis: UINT

Jumlah bidang komponen yang ditentukan oleh parameter pDstPlanes .

Mengembalikan nilai

Jenis: HRESULT

Jika konfigurasi skala, balik/putar, dan format planar yang ditentukan tidak didukung metode ini gagal dengan WINCODEC_ERR_INVALIDPARAMETER. Anda dapat memeriksa apakah transformasi didukung dengan memanggil IWICPlanarBitmapSourceTransform::D oesSupportTransform.

Keterangan

WIC JPEG Decoder: Tergantung pada subsampling chroma gambar yang dikonfigurasi, persegi panjang sumber memiliki batasan berikut:

Chroma Subsampling Koordinat X Koordinat Y Lebar Klorma Tinggi Kroma
4:2:0 Kelipatan 2 Kelipatan 2 lumaWidth / 2 Dibulatkan ke atas ke bilangan bulat terdekat. lumaHeight / 2 Dibulatkan ke atas ke bilangan bulat terdekat.
4:2:2 Kelipatan 2 Apa pun lumaWidth / 2 Dibulatkan ke atas ke bilangan bulat terdekat. lumaHeight
4:4:4 Apa pun Apa pun llumaWidth llumaHeight
4:4:0 Apa pun Kelipatan 2 lumaWidth llumaHeight / 2 Dibulatkan ke bilangan bulat terdekat.
 

Parameter pDstPlanes mendukung format piksel berikut.

Jumlah Bidang Bidang 1 Bidang 2 Bidang 3
3 GUID_WICPixelFormat8bppY GUID_WICPixelFormat8bppCb GUID_WICPixelFormat8bppCr
2 GUID_WICPixelFormat8bppY GUID_WICPixelFormat16bppCbCr T/A

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