Função ICImageCompress (vfw.h)

A função ICImageCompress compacta uma imagem para um determinado tamanho. Essa função não requer funções de inicialização.

Sintaxe

HANDLE VFWAPI ICImageCompress(
  HIC          hic,
  UINT         uiFlags,
  LPBITMAPINFO lpbiIn,
  LPVOID       lpBits,
  LPBITMAPINFO lpbiOut,
  LONG         lQuality,
  LONG         *plSize
);

Parâmetros

hic

Manipule para um compressor aberto com a função ICOpen . Especifique NULL para que o VCM selecione um compressor apropriado para o formato de compactação. Um aplicativo pode fazer com que o usuário selecione o compressor usando a função ICCompressorChoose , que abre o compressor selecionado e retorna um identificador do compressor nesse parâmetro.

uiFlags

Reservados; deve ser zero.

lpbiIn

Ponteiro para a estrutura BITMAPINFO que contém o formato de dados de entrada.

lpBits

Ponteiro para bits de dados de entrada a serem compactados. Os bits de dados excluem informações de cabeçalho e formato.

lpbiOut

Ponteiro para a estrutura BITMAPINFO que contém o formato de saída compactado. Especifique NULL para que o compressor use um formato apropriado.

lQuality

Valor de qualidade usado pelo compressor. Os valores variam de 0 a 10.000.

plSize

Tamanho máximo desejado para a imagem compactada. O compressor pode não ser capaz de compactar os dados para caber dentro desse tamanho. Quando a função retorna, esse parâmetro aponta para o tamanho da imagem compactada. Os tamanhos de imagem são especificados em bytes.

Retornar valor

Retorna um identificador para um DIB compactado. Os dados da imagem seguem o cabeçalho de formato.

Comentários

Para obter as informações de formato da estrutura BITMAPINFOHEADER , use a função GlobalLock para bloquear os dados. Use a função GlobalFree para liberar o DIB quando terminar.

Requisitos

Requisito	Valor
Cliente mínimo com suporte	Windows 2000 Professional [somente aplicativos da área de trabalho]
Servidor mínimo com suporte	Windows 2000 Server [somente aplicativos da área de trabalho]
Plataforma de Destino	Windows
Cabeçalho	vfw.h
Biblioteca	Vfw32.lib
DLL	Msvfw32.dll

Confira também

Funções de compactação de vídeo

Gerenciador de Compactação de Vídeo