Metodo IWICPlanarBitmapSourceTransform::CopyPixels (wincodec.h)

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:

Il parametro pDstPlanes supporta i formati pixel seguenti.

Requisiti

Vedi anche

IWICPlanarBitmapSourceTransform