Interface IWICBitmapScaler (wincodec.h)

Representa uma versão redimensionada do bitmap de entrada usando um algoritmo de nova amostragem ou filtragem.

Herança

A interface IWICBitmapScaler herda de IWICBitmapSource. IWICBitmapScaler também tem estes tipos de membros:

Métodos

A interface IWICBitmapScaler tem esses métodos.

IWICBitmapScaler::Initialize Inicializa o dimensionador de bitmap com os parâmetros fornecidos.

Comentários

As imagens podem ser dimensionadas para tamanhos maiores; no entanto, mesmo com algoritmos de dimensionamento sofisticados, há apenas muitas informações na imagem e os artefatos tendem a piorar quanto mais você escala verticalmente.

O dimensionador reaplicará o algoritmo de resampling sempre que CopyPixels for chamado. Se a imagem dimensionada for animada, a imagem dimensionada deverá ser criada uma vez e armazenada em cache em um novo bitmap, após o qual o IWICBitmapScaler poderá ser lançado. Dessa forma, o algoritmo de dimensionamento - que pode ser computacionalmente caro em relação ao desenho - é executado apenas uma vez e o resultado exibido muitas vezes.

O dimensionador é otimizado para usar a quantidade mínima de memória necessária para dimensionar a imagem corretamente. O dimensionador pode ser usado para produzir partes da imagem incrementalmente (agrupamento) chamando CopyPixels com retângulos diferentes que representam as faixas de saída da imagem. A reamostragem normalmente requer retângulos sobrepostos da imagem de origem e, portanto, pode precisar solicitar os mesmos pixels do bitmap de origem várias vezes. A solicitação de linhas de verificação fora de ordem de alguns decodificadores de imagem pode ter uma penalidade de desempenho significativa. Por esse motivo, o dimensionador é otimizado para lidar com faixas horizontais consecutivas de linhas de verificação (largura do retângulo igual à largura do bitmap). Nesse caso, o acumulador do retângulo adjacente verticalmente anterior é reutilizada para evitar solicitações de linha de verificação duplicadas da origem. Isso implica que a saída em faixa do dimensionador poderá ter melhor desempenho se as bandas forem solicitadas sequencialmente. É claro que, se o dimensionador for simplesmente usado para produzir uma única saída de retângulo, essa preocupação será eliminada porque o dimensionador solicitará internamente as linhas de verificação na ordem correta.

Requisitos

Requisito	Valor
Cliente mínimo com suporte	Windows XP com SP2, Windows Vista [aplicativos da área de trabalho | Aplicativos UWP]
Servidor mínimo com suporte	Windows Server 2008 [aplicativos da área de trabalho | Aplicativos UWP]
Plataforma de Destino	Windows
Cabeçalho	wincodec.h