Classe CDrawImage

[O recurso associado a esta página, DirectShow, é um recurso herdado. Ele foi substituído por MediaPlayer, IMFMediaEngine e Captura de Áudio/Vídeo na Media Foundation. Esses recursos foram otimizados para Windows 10 e Windows 11. A Microsoft recomenda fortemente que o novo código use MediaPlayer, IMFMediaEngine e Captura de Áudio/Vídeo no Media Foundation em vez de DirectShow, quando possível. A Microsoft sugere que o código existente que usa as APIs herdadas seja reescrito para usar as novas APIs, se possível.]

A CDrawImage classe é uma classe auxiliar que gerencia o desenho de um filtro de renderizador de vídeo. Todas as operações de desenho são executadas usando GDI. Essa classe não fornece suporte para renderização com DirectDraw. A CDrawImage classe requer que o filtro proprietário também use a classe CBaseWindow , que gerencia a janela de vídeo. O CDrawImage construtor usa um ponteiro para o objeto CBaseWindow .

O diagrama a seguir mostra a maneira preferida de usar essa classe em um filtro de renderizador de vídeo personalizado.

Para usar essa classe, faça o seguinte:

• Quando os pinos se conectarem, chame os métodos CDrawImage::NotifyMediaType e CDrawImage::NotifyAllocator .
• Sempre que o tipo de mídia for alterado, chame NotifyMediaType novamente.
• Antes de qualquer renderização ocorrer, chame CDrawImage::SetDrawContext.
• Chame CDrawImage::SetSourceRect se o retângulo de origem for alterado e CDrawImage::SetTargetRect se o retângulo de destino for alterado.
• Gerencie a paleta para imagens palettizadas, conforme descrito na seção em paletas a seguir.

Alocadores

O filtro mostrado no diagrama anterior usa uma classe de alocador personalizada, CImageAllocator. Esse alocador cria DIBs na memória compartilhada, usando a função GDI CreateDIBSection . Os exemplos criados pelo alocador são objetos CImageSample .

Se o filtro possuir o alocador para a conexão, os exemplos de mídia terão a garantia de serem objetos CImageSample . Nesse caso, o objeto CDrawImage pode otimizar o desenho usando BitBlt ou StretchBlt. Caso contrário, ele deverá usar as funções SetDIBitsToDevice ou StretchDIBits mais lentas. A opção mais rápida é implementada pelo método CDrawImage::FastRender , a opção mais lenta pelo método CDrawImage::SlowRender . (Apesar do nome, você provavelmente não verá um grande impacto no desempenho no SlowRender, especialmente em hardware mais recente.)

Paletas

Se o método FastRender for usado para desenhar e a imagem for palettizada, o filtro precisará gerenciar a paleta, da seguinte maneira:

• A classe CImageSample contém um número de versão de paleta, armazenado na estrutura DIBDATA . O valor é inicializado quando o alocador cria o exemplo.
• A classe CDrawImage também contém um número de versão de paleta, que é inicializado na criação.
• Sempre que o tipo de mídia for alterado para um novo formato palettizado, chame CDrawImage::IncrementPaletteVersion. Esse método incrementa o número de versão da paleta do objeto CDrawImage . Se o filtro usar a classe CImagePalette para gerenciar as informações da paleta, você poderá simplesmente chamar CImagePalette::P reparePalette sempre que o tipo de mídia for alterado. O método PreparePalette incrementa a versão da paleta somente quando necessário.
• O método FastRender compara a versão da paleta CDrawImage com a versão da paleta do exemplo. Se o número de versão do exemplo ficar atrás do número de versão CDrawImage , o método FastRenderchamará CDrawImage::UpdateColorrTable. O método UpdateColorrTable define a tabela de cores no contexto do dispositivo, usando a função GDI SetDIBColorTable . Além disso, a versão da paleta no exemplo é atualizada para o número de versão atual.
• Se o pino se reconectar, o filtro deverá chamar CDrawImage::ResetPaletteVersion para redefinir a versão da paleta. Na reconexão de pino, o alocador aloca novamente todos os exemplos.

Requisitos