ホーム › Media.DirectShow › AM_ASPECT_RATIO_MODE

AM_ASPECT_RATIO_MODE

列挙型

基底型i4

メンバー 4

名前	10進	16進	説明
AM_ARMODE_STRETCHED	0	0x0	アスペクト比の補正を行いません。
AM_ARMODE_LETTER_BOX	1	0x1	ビデオをレターボックス形式で表示します。余白の領域を背景色で塗りつぶすため、ビデオが歪みません。
AM_ARMODE_CROP	2	0x2	正しいアスペクト比になるようにビデオを切り抜きます。
AM_ARMODE_STRETCHED_AS_PRIMARY	3	0x3	プライマリストリームに現在設定されているモードをそのまま使用します。この値はセカンダリストリームに対してのみ有効です。

公式ドキュメント

[このページに関連する機能である DirectShow はレガシー機能です。この機能は MediaPlayer、IMFMediaEngine、および Audio/Video Capture in Media Foundation に置き換えられました。これらの機能は Windows 10 および Windows 11 向けに最適化されています。Microsoft は、新しいコードでは可能な限り DirectShow ではなく MediaPlayer、IMFMediaEngine、Audio/Video Capture in Media Foundation を使用することを強く推奨します。また、レガシー API を使用している既存のコードについても、可能であれば新しい API を使用するように書き換えることを推奨します。]

表示ウィンドウ内のビデオ画像のアスペクト比を指定します。

解説(Remarks)

AM_ARMODE_STRETCHED メンバーを指定すると、表示ウィンドウのサイズが変更されたときにビデオストリームがウィンドウ全体の領域を占めるようになり、ビデオが引き伸ばされる場合があります。AM_ARMODE_LETTER_BOX メンバーは、アスペクト比を一定に保ち、ウィンドウの余白部分を背景色で塗りつぶすことで、ビデオの引き伸ばしや歪みを防ぎます。AM_ARMODE_CROP メンバーも、必要に応じて画像を切り抜くことで引き伸ばしを防ぎます。

出典・ライセンス: 上記「公式ドキュメント」の内容は Microsoft の Win32 API ドキュメント(MicrosoftDocs/sdk-api)を日本語に翻訳・改変したものです。© Microsoft Corporation. CC BY 4.0 で提供。
Microsoft 公式リファレンス: 英語 (en-us) · 日本語 (ja-jp) · 原文ソース (GitHub)

各言語での定義

列挙メンバーの定義。HSP タブは #define global(値は16進)。

typedef enum AM_ASPECT_RATIO_MODE : int {
    AM_ARMODE_STRETCHED = 0,
    AM_ARMODE_LETTER_BOX = 1,
    AM_ARMODE_CROP = 2,
    AM_ARMODE_STRETCHED_AS_PRIMARY = 3
} AM_ASPECT_RATIO_MODE;

public enum AM_ASPECT_RATIO_MODE : int
{
    AM_ARMODE_STRETCHED = 0,
    AM_ARMODE_LETTER_BOX = 1,
    AM_ARMODE_CROP = 2,
    AM_ARMODE_STRETCHED_AS_PRIMARY = 3,
}

Public Enum AM_ASPECT_RATIO_MODE As Integer
    AM_ARMODE_STRETCHED = 0
    AM_ARMODE_LETTER_BOX = 1
    AM_ARMODE_CROP = 2
    AM_ARMODE_STRETCHED_AS_PRIMARY = 3
End Enum

import enum

class AM_ASPECT_RATIO_MODE(enum.IntEnum):
    AM_ARMODE_STRETCHED = 0
    AM_ARMODE_LETTER_BOX = 1
    AM_ARMODE_CROP = 2
    AM_ARMODE_STRETCHED_AS_PRIMARY = 3

// AM_ASPECT_RATIO_MODE
pub const AM_ARMODE_STRETCHED: i32 = 0;
pub const AM_ARMODE_LETTER_BOX: i32 = 1;
pub const AM_ARMODE_CROP: i32 = 2;
pub const AM_ARMODE_STRETCHED_AS_PRIMARY: i32 = 3;

// AM_ASPECT_RATIO_MODE
const (
	AM_ARMODE_STRETCHED int32 = 0
	AM_ARMODE_LETTER_BOX int32 = 1
	AM_ARMODE_CROP int32 = 2
	AM_ARMODE_STRETCHED_AS_PRIMARY int32 = 3
)

const
  AM_ARMODE_STRETCHED = 0;
  AM_ARMODE_LETTER_BOX = 1;
  AM_ARMODE_CROP = 2;
  AM_ARMODE_STRETCHED_AS_PRIMARY = 3;

// AM_ASPECT_RATIO_MODE
pub const AM_ARMODE_STRETCHED: i32 = 0;
pub const AM_ARMODE_LETTER_BOX: i32 = 1;
pub const AM_ARMODE_CROP: i32 = 2;
pub const AM_ARMODE_STRETCHED_AS_PRIMARY: i32 = 3;

const
  AM_ARMODE_STRETCHED* = 0
  AM_ARMODE_LETTER_BOX* = 1
  AM_ARMODE_CROP* = 2
  AM_ARMODE_STRETCHED_AS_PRIMARY* = 3

enum AM_ASPECT_RATIO_MODE : int {
    AM_ARMODE_STRETCHED = 0,
    AM_ARMODE_LETTER_BOX = 1,
    AM_ARMODE_CROP = 2,
    AM_ARMODE_STRETCHED_AS_PRIMARY = 3,
}

#define global AM_ARMODE_STRETCHED            0x0
#define global AM_ARMODE_LETTER_BOX           0x1
#define global AM_ARMODE_CROP                 0x2
#define global AM_ARMODE_STRETCHED_AS_PRIMARY 0x3