Metode IWICBitmapSourceTransform::CopyPixels (wincodec.h)

Artikel
08/27/2023

Menyalin data piksel menggunakan parameter input yang disediakan.

Sintaks

HRESULT CopyPixels(
  [in]  const WICRect             *prc,
  [in]  UINT                      uiWidth,
  [in]  UINT                      uiHeight,
  [in]  WICPixelFormatGUID        *pguidDstFormat,
  [in]  WICBitmapTransformOptions dstTransform,
  [in]  UINT                      nStride,
  [in]  UINT                      cbBufferSize,
  [out] BYTE                      *pbBuffer
);

Parameter

[in] prc

Jenis: const WICRect*

Persegi panjang piksel yang akan disalin.

[in] uiWidth

Jenis: UINT

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

[in] uiHeight

Jenis: UINT

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

[in] pguidDstFormat

Jenis: WICPixelFormatGUID*

GUID format piksel yang diinginkan di mana piksel harus dikembalikan.

GUID ini harus berupa format yang diperoleh melalui panggilan GetClosestPixelFormat .

[in] dstTransform

Jenis: WICBitmapTransformOptions

Rotasi atau balik yang diinginkan untuk dilakukan sebelum salinan piksel.

Transformasi harus merupakan operasi yang didukung oleh panggilan DoesSupportTransform .

Jika dstTransform ditentukan, nStride adalah langkah yang diubah dan didasarkan pada format piksel pguidDstFormat , bukan format piksel sumber asli.

[in] nStride

Jenis: UINT

Langkah buffer tujuan.

[in] cbBufferSize

Jenis: UINT

Ukuran buffer tujuan.

[out] pbBuffer

Jenis: BYTE*

Buffer output.

Nilai kembali

Jenis: HRESULT

Jika metode ini berhasil, metode akan mengembalikan S_OK. Jika tidak, kode kesalahan HRESULT akan dikembalikan.

Keterangan

Keterangan Pengembang Codec

Jika NULL diteruskan untuk rrc, seluruh gambar akan disalin.

Untuk detail implementasi pengembang codec untuk metode ini, lihat Menerapkan IWICBitmapSourceTransform.

Ketika beberapa operasi transformasi diminta, hasilnya tergantung pada urutan operasi dilakukan. Untuk memastikan prediksi dan konsistensi di seluruh CODEC, penting bahwa semua CODEC melakukan operasi ini dalam urutan yang sama. Urutan yang disarankan dari operasi ini adalah:

Skala
Tanaman
Balik/Putar

Konversi format piksel dapat dilakukan kapan saja, karena tidak berpengaruh pada transformasi lain.

Parameter pertama, rangkaian digunakan untuk menentukan wilayah yang diminati untuk mengklip gambar. Berdasarkan konvensi, penskalaan dilakukan sebelum kliping, jadi, jika gambar akan diskalakan serta diklip, wilayah yang diinginkan harus ditentukan setelah gambar diskalakan.

Jika dstTransform ditentukan, langkahnya adalah langkah yang diubah, dan didasarkan pada pixelFormat yang ditentukan dalam panggilan CopyPixels , bukan format piksel bingkai asli.

Persyaratan

Persyaratan	Nilai
Klien minimum yang didukung	Windows XP dengan SP2, Windows Vista [aplikasi desktop \| Aplikasi UWP]
Server minimum yang didukung	Windows Server 2008 [aplikasi desktop \| Aplikasi UWP]
Target Platform	Windows
Header	wincodec.h
Pustaka	Windowscodecs.lib