Condividi tramite

Metodo IWICPlanarBitmapSourceTransform::CopyPixels (wincodec.h)

  • Articolo

Copia i pixel nei piani di destinazione. Configurata dai parametri di input forniti.

Se viene specificata una conversione dstTransform, scale o format, cbStride è lo stride trasformato e si basa sul formato pixel di destinazione del parametro pDstPlanes , non sul formato pixel dell'origine originale.

Sintassi

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

Parametri

[in] prcSource

Tipo: const WICRect*

Rettangolo di origine di pixel da copiare.

uiWidth

Tipo: UINT

Larghezza per ridimensionare la bitmap di origine. Questo parametro deve essere uguale a un valore ottenibile tramite IWICPlanarBitmapSourceTransform:: DoesSupportTransform.

uiHeight

Tipo: UINT

Altezza per ridimensionare la bitmap di origine. Questo parametro deve essere uguale a un valore ottenibile tramite IWICPlanarBitmapSourceTransform:: DoesSupportTransform.

dstTransform

Tipo: WICBitmapTransformOptions

Rotazione o capovolgimento desiderato da eseguire prima della copia in pixel. Una rotazione può essere combinata con un capovolgimento orizzontale o un capovolgimento verticale, vedere WICBitmapTransformOptions.

[in] dstPlanarOptions

Tipo: const WICPlanarOptions

Consente di specificare opzioni di configurazione aggiuntive per la trasformazione. Per altri dettagli, vedere WICPlanarOptions .

Decodificatore JPEG WIC: WICPlanarOptionsPreserveSubsampling può essere specificato per mantenere i rapporti di sottocampionamento durante il ridimensionamento inferiore. Per impostazione predefinita, il decodificatore JPEG tenta di mantenere la qualità ridimensionando solo il piano Y in alcuni casi, modificando l'immagine in sottocampionamento 4:4:4.

pDstPlanes

Tipo: WICBitmapPlane

Specifica il formato pixel e il buffer di output per ogni piano componente. Il numero di piani e il formato pixel di ogni piano devono corrispondere ai valori ottenuti tramite IWICPlanarBitmapSourceTransform::D oesSupportTransform.

cPlanes

Tipo: UINT

Numero di piani componente specificati dal parametro pDstPlanes .

Valore restituito

Tipo: HRESULT

Se la scala, la rotazione/rotazione specificate e la configurazione del formato planare non sono supportate, questo metodo ha esito negativo con WINCODEC_ERR_INVALIDPARAMETER. È possibile verificare se una trasformazione è supportata chiamando IWICPlanarBitmapSourceTransform::D oesSupportTransform.

Commenti

Decodificatore JPEG WIC: a seconda del sottocampionamento cromatico configurato dell'immagine, il rettangolo di origine presenta le restrizioni seguenti:

Sottocampionamento cromatico Coordinata X Coordinata Y Larghezza cromatica Altezza cromatica
4:2:0 Multiplo di 2 Multiplo di 2 lumaWidth / 2 Arrotondato fino all'intero più vicino. lumaHeight / 2 Arrotondato fino all'intero più vicino.
4:2:2 Multiplo di 2 Qualsiasi lumaWidth / 2 Arrotondato fino all'intero più vicino. lumaHeight
4:4:4 Qualsiasi Qualsiasi llumaWidth llumaHeight
4:4:0 Qualsiasi Multiplo di 2 lumaWidth llumaHeight / 2 Arrotondato fino all'intero più vicino.
 

Il parametro pDstPlanes supporta i formati pixel seguenti.

Conteggio piani Piano 1 Piano 2 Piano 3
3 GUID_WICPixelFormat8bppY GUID_WICPixelFormat8bppCb GUID_WICPixelFormat8bppCr
2 GUID_WICPixelFormat8bppY GUID_WICPixelFormat16bppCbCr N/D

Requisiti

Requisito Valore
Client minimo supportato Windows 8.1 [app desktop | App UWP]
Server minimo supportato Windows Server 2012 R2 [app desktop | App UWP]
Piattaforma di destinazione Windows
Intestazione wincodec.h
Libreria Windowscodecs.lib
DLL Windowscodecs.dll

Vedi anche

IWICPlanarBitmapSourceTransform