enumeração AM_ASPECT_RATIO_MODE (mpconfig.h)

[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.]

Especifica a taxa de proporção de uma imagem de vídeo em uma janela de exibição.

Syntax

typedef enum _AM_ASPECT_RATIO_MODE {
  AM_ARMODE_STRETCHED,
  AM_ARMODE_LETTER_BOX,
  AM_ARMODE_CROP,
  AM_ARMODE_STRETCHED_AS_PRIMARY
} AM_ASPECT_RATIO_MODE;

Constantes

AM_ARMODE_STRETCHED Nenhuma correção de taxa de proporção.
AM_ARMODE_LETTER_BOX Coloque o vídeo no formato de caixa de correio. Pinte a cor da tela de fundo na região em excesso para que o vídeo não seja distorcido.
AM_ARMODE_CROP Corte o vídeo para a taxa de proporção correta.
AM_ARMODE_STRETCHED_AS_PRIMARY Use qualquer modo definido no momento para o fluxo primário. Esse valor é válido apenas para fluxos secundários.

Comentários

O membro AM_ARMODE_STRETCHED faz com que um fluxo de vídeo ocupe toda a região da janela de exibição quando a janela é redimensionada, possivelmente estendendo o vídeo. O membro AM_ARMODE_LETTER_BOX elimina o alongamento de vídeo e distorções mantendo a taxa de proporção consistente e pintando as áreas em excesso da janela uma cor de plano de fundo. O membro AM_ARMODE_CROP também impede o alongamento, cortando a imagem, se necessário.

Requisitos

Requisito	Valor
Cabeçalho	mpconfig.h

Confira também

Tipos Enumerados do DirectShow

IMixerPinConfig::GetAspectRatioMode

IMixerPinConfig::SetAspectRatioMode