énumération AM_ASPECT_RATIO_MODE (mpconfig.h)

Article
03/04/2024

[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

Partager via