énumération AM_ASPECT_RATIO_MODE (mpconfig.h)

[La fonctionnalité associée à cette page, DirectShow, est une fonctionnalité héritée. Il a été remplacé par MediaPlayer, IMFMediaEngine et Audio/Video Capture dans Media Foundation. Ces fonctionnalités ont été optimisées pour Windows 10 et Windows 11. Microsoft recommande vivement au nouveau code d’utiliser MediaPlayer, IMFMediaEngine et La capture audio/vidéo dans Media Foundation au lieu de DirectShow, lorsque cela est possible. Microsoft suggère que le code existant qui utilise les API héritées soit réécrit pour utiliser les nouvelles API si possible.]

Spécifie le rapport d’aspect d’une image vidéo dans une fenêtre d’affichage.

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 Aucune correction du rapport d’aspect.
AM_ARMODE_LETTER_BOX Placez la vidéo au format boîte aux lettres. Peignez la couleur d’arrière-plan dans la région excédentaire afin que la vidéo ne soit pas déformée.
AM_ARMODE_CROP Rognez la vidéo pour obtenir le bon rapport d’aspect.
AM_ARMODE_STRETCHED_AS_PRIMARY Utilisez le mode actuellement défini pour le flux principal. Cette valeur est valide uniquement pour les flux secondaires.

Remarques

Le membre AM_ARMODE_STRETCHED fait qu’un flux vidéo occupe toute la région de la fenêtre d’affichage lorsque la fenêtre est redimensionnée, ce qui peut étendre la vidéo. Le membre AM_ARMODE_LETTER_BOX élimine les étirements vidéo et les distorsions en gardant le rapport d’aspect cohérent et en peignant les zones excédentaires de la fenêtre une couleur d’arrière-plan. Le membre AM_ARMODE_CROP empêche également l’étirement, en rognant l’image si nécessaire.

Configuration requise

Condition requise	Valeur
En-tête	mpconfig.h

Voir aussi

Types énumérés DirectShow

IMixerPinConfig ::GetAspectRatioMode

IMixerPinConfig ::SetAspectRatioMode