QMediaFormat Class
マルチメディアファイルやストリームのエンコード形式を記述する。詳細...
| Header: | #include <QMediaFormat> |
| CMake: | find_package(Qt6 REQUIRED COMPONENTS Multimedia)target_link_libraries(mytarget PRIVATE Qt6::Multimedia) |
| qmake: | QT += multimedia |
パブリックタイプ
| enum class | AudioCodec { WMA, AC3, AAC, ALAC, DolbyTrueHD, …, Unspecified } |
| enum | ConversionMode { Encode, Decode } |
| enum | FileFormat { WMA, AAC, Matroska, WMV, MP3, …, UnspecifiedFormat } |
| enum | ResolveFlags { NoFlags, RequiresVideo } |
| enum class | VideoCodec { VP8, MPEG2, MPEG1, WMV, H265, …, Unspecified } |
プロパティ
- audioCodec : AudioCodec
- fileFormat : FileFormat
- videoCodec : VideoCodec
パブリック関数
| QMediaFormat(QMediaFormat::FileFormat format = UnspecifiedFormat) | |
| QMediaFormat(const QMediaFormat &other) | |
| QMediaFormat(QMediaFormat &&other) | |
| ~QMediaFormat() | |
| QMediaFormat::AudioCodec | audioCodec() const |
| QMediaFormat::FileFormat | fileFormat() const |
| bool | isSupported(QMediaFormat::ConversionMode mode) const |
| QMimeType | mimeType() const |
| void | resolveForEncoding(QMediaFormat::ResolveFlags flags) |
| void | setAudioCodec(QMediaFormat::AudioCodec codec) |
| void | setFileFormat(QMediaFormat::FileFormat f) |
| void | setVideoCodec(QMediaFormat::VideoCodec codec) |
| QList<QMediaFormat::AudioCodec> | supportedAudioCodecs(QMediaFormat::ConversionMode m) |
| QList<QMediaFormat::FileFormat> | supportedFileFormats(QMediaFormat::ConversionMode m) |
| QList<QMediaFormat::VideoCodec> | supportedVideoCodecs(QMediaFormat::ConversionMode m) |
| void | swap(QMediaFormat &other) |
| QMediaFormat::VideoCodec | videoCodec() const |
| bool | operator!=(const QMediaFormat &other) const |
| QMediaFormat & | operator=(QMediaFormat &&other) |
| QMediaFormat & | operator=(const QMediaFormat &other) |
| bool | operator==(const QMediaFormat &other) const |
静的パブリックメンバ
| QString | audioCodecDescription(QMediaFormat::AudioCodec codec) |
| QString | audioCodecName(QMediaFormat::AudioCodec codec) |
| QString | fileFormatDescription(QMediaFormat::FileFormat fileFormat) |
| QString | fileFormatName(QMediaFormat::FileFormat fileFormat) |
| QString | videoCodecDescription(QMediaFormat::VideoCodec codec) |
| QString | videoCodecName(QMediaFormat::VideoCodec codec) |
詳細な説明
QMediaFormat は、マルチメディアファイルやストリームのエンコード形式を記述します。
QMediaFormat を使用して、特定のメディア形式をエンコードまたはデコードに使用できるかどうかを確認できます。
メンバ型 ドキュメント
enum class QMediaFormat::AudioCodec
マルチメディアファイルまたはストリームで使用される音声コーデックを記述します。
| 定数 | 値 | 説明 |
|---|---|---|
QMediaFormat::AudioCodec::WMA | 9 | Windows Media オーディオ |
QMediaFormat::AudioCodec::AC3 | 2 | ドルビーデジタル |
QMediaFormat::AudioCodec::AAC | 1 | 高度なオーディオコーディング |
QMediaFormat::AudioCodec::ALAC | 10 | Apple ロスレス・オーディオ・コーデック |
QMediaFormat::AudioCodec::DolbyTrueHD | 5 | ドルビーTrueHD |
QMediaFormat::AudioCodec::EAC3 | 3 | ドルビーデジタルプラス（EAC3） |
QMediaFormat::AudioCodec::MP3 | 0 | MPEG-1オーディオ・レイヤーIIIまたはMPEG-2オーディオ・レイヤーIII |
QMediaFormat::AudioCodec::Wave | 8 | 波形オーディオファイル形式 |
QMediaFormat::AudioCodec::Vorbis | 7 | Ogg Vorbis |
QMediaFormat::AudioCodec::FLAC | 4 | フリーのロスレス・オーディオ・コーデック |
QMediaFormat::AudioCodec::Opus | 6 | Opusオーディオ・フォーマット |
QMediaFormat::AudioCodec::Unspecified | -1 | 未指定のコーデック |
enum QMediaFormat::ConversionMode
多くの場合、システムには非対称な機能があり、エンコード可能なフォーマットやコーデックよりも多くのフォーマットやコーデックをデコードできることが多い。この列挙型は、特定のファイルフォーマットやコーデックがサポートされているかどうかをチェックするときに使用される、要求された変換モードを記述します。
| 定数 | 値 | 説明 |
|---|---|---|
QMediaFormat::Encode | 0 | あるファイルフォーマットやコーデックがエンコード可能かどうかをチェックするために使用されます。 |
QMediaFormat::Decode | 1 | あるファイル形式またはコーデックがデコードできるかどうかをチェックするために使用される。 |
supportedFileFormats 、supportedAudioCodecs 、supportedVideoCodecsも参照 。
enum QMediaFormat::FileFormat
マルチメディアファイルまたはストリームで使用されるコンテナ形式を記述する。
| 定数 | 値 | 説明 |
|---|---|---|
QMediaFormat::WMA | 9 | Windows Media Audio |
QMediaFormat::AAC | 8 | 高度なオーディオ符号化 |
QMediaFormat::Matroska | 2 | マトロスカ (MKV) |
QMediaFormat::WMV | 0 | Windowsメディア・ビデオ |
QMediaFormat::MP3 | 10 | MPEG-1オーディオ・レイヤーIIIまたはMPEG-2オーディオ・レイヤーIII |
QMediaFormat::Wave | 12 | 波形オーディオファイル形式 |
QMediaFormat::Ogg | 4 | Ogg |
QMediaFormat::MPEG4 | 3 | MPEG-4 |
QMediaFormat::AVI | 1 | オーディオビデオインターリーブ |
QMediaFormat::QuickTime | 5 | QuickTime |
QMediaFormat::WebM | 6 | WebM |
QMediaFormat::Mpeg4Audio | 7 | MPEG-4パート3またはMPEG-4オーディオ（正式にはISO/IEC 14496-3） |
QMediaFormat::FLAC | 11 | フリーのロスレス・オーディオ・コーデック |
QMediaFormat::UnspecifiedFormat | -1 | フォーマットは未指定。 |
enum QMediaFormat::ResolveFlags
QMediaRecorder に適したフォーマットを解決するための要件を記述する。
| 定数 | 値 | 説明 |
|---|---|---|
QMediaFormat::NoFlags | 0 | 要件なし |
QMediaFormat::RequiresVideo | 1 | ビデオコーデックが必要 |
resolveForEncoding()も参照 。
enum class QMediaFormat::VideoCodec
マルチメディアファイルまたはストリームで使用されるビデオコーデックを記述します。
| 定数 | 値 | 説明 |
|---|---|---|
QMediaFormat::VideoCodec::VP8 | 5 | VP8 |
QMediaFormat::VideoCodec::MPEG2 | 1 | MPEG-2 |
QMediaFormat::VideoCodec::MPEG1 | 0 | MPEG-1 |
QMediaFormat::VideoCodec::WMV | 9 | ウィンドウズ・メディア・ビデオ |
QMediaFormat::VideoCodec::H265 | 4 | 高効率ビデオコーディング（HEVC） |
QMediaFormat::VideoCodec::H264 | 3 | 高度なビデオコーディング |
QMediaFormat::VideoCodec::MPEG4 | 2 | MPEG-4 |
QMediaFormat::VideoCodec::AV1 | 7 | AOMediaビデオ1 |
QMediaFormat::VideoCodec::MotionJPEG | 10 | モーションJPEG |
QMediaFormat::VideoCodec::VP9 | 6 | VP9 |
QMediaFormat::VideoCodec::Theora | 8 | セオラ |
QMediaFormat::VideoCodec::Unspecified | -1 | ビデオコーデック指定なし |
プロパティの説明
audioCodec : AudioCodec
このプロパティは、メディアの音声コーデックを保持する。
アクセス関数です：
| QMediaFormat::AudioCodec | audioCodec() const |
| void | setAudioCodec(QMediaFormat::AudioCodec codec) |
fileFormat : FileFormat
このプロパティは、メディアのファイル（コンテナ）フォーマットを保持します。
アクセス関数：
| QMediaFormat::FileFormat | fileFormat() const |
| void | setFileFormat(QMediaFormat::FileFormat f) |
videoCodec : VideoCodec
このプロパティは、メディアのビデオコーデックを保持します。
アクセス関数：
| QMediaFormat::VideoCodec | videoCodec() const |
| void | setVideoCodec(QMediaFormat::VideoCodec codec) |
メンバ関数ドキュメント
QMediaFormat::QMediaFormat(QMediaFormat::FileFormat format = UnspecifiedFormat)
format の QMediaFormat オブジェクトを構築します。
[noexcept] QMediaFormat::QMediaFormat(const QMediaFormat &other)
other からコピーして QMediaFormat オブジェクトを構築する。
[noexcept] QMediaFormat::QMediaFormat(QMediaFormat &&other)
other から移動して QMediaFormat オブジェクトを構築する。
[noexcept] QMediaFormat::~QMediaFormat()
QMediaFormat オブジェクトを破棄します。
QMediaFormat::AudioCodec QMediaFormat::audioCodec() const
このフォーマットで使用されている音声コーデックを返します。
注： プロパティ audioCodec のゲッター関数。
setAudioCodec() およびQMediaFormat::AudioCodecも参照 。
[static invokable] QString QMediaFormat::audioCodecDescription(QMediaFormat::AudioCodec codec)
codec の説明を返す。
注： この関数はメタオブジェクトシステムやQMLから呼び出すことができます。Q_INVOKABLE を参照してください。
[static invokable] QString QMediaFormat::audioCodecName(QMediaFormat::AudioCodec codec)
codec に対する文字列ベースの名前を返します。
注意： この関数はメタオブジェクトシステム経由でも QML からでも呼び出すことができます。Q_INVOKABLE を参照してください。
[static invokable] QString QMediaFormat::fileFormatDescription(QMediaFormat::FileFormat fileFormat)
fileFormat の説明を返します。
注： この関数はメタオブジェクトシステム経由でも QML からでも呼び出すことができます。Q_INVOKABLE を参照してください。
[static invokable] QString QMediaFormat::fileFormatName(QMediaFormat::FileFormat fileFormat)
fileFormat の文字列ベースの名前を返します。
注意: この関数はメタオブジェクトシステムやQMLから呼び出すことができます。Q_INVOKABLE を参照してください。
[invokable] bool QMediaFormat::isSupported(QMediaFormat::ConversionMode mode) const
Qt Multimedia がこのフォーマットをエンコードまたはデコードできる場合、mode に応じてtrue を返します。
注意: この関数はメタオブジェクトシステムやQMLから呼び出すことができます。Q_INVOKABLE を参照してください。
QMimeType QMediaFormat::mimeType() const
このメディアフォーマットで使われているファイルフォーマットのMIMEタイプを返します。
void QMediaFormat::resolveForEncoding(QMediaFormat::ResolveFlags flags)
flags に基づき、このフォーマットをQMediaRecorder でサポートされるフォーマットに解決する。
このメソッドは、未指定の設定に対して、可能な限り最良の一致を見つけようとする。レコーダーがサポートしていない設定は、サポートされている最も近い一致に修正される。
解決に際しては、以下の順序で優先順位が与えられます：
- ファイル形式
- ビデオコーデック
- 音声コーデック
void QMediaFormat::setAudioCodec(QMediaFormat::AudioCodec codec)
音声コーデックをcodec に設定する。
注： プロパティaudioCodec に対するセッター関数。
audioCodec() およびQMediaFormat::AudioCodecも参照 。
void QMediaFormat::setVideoCodec(QMediaFormat::VideoCodec codec)
ビデオコーデックをcodec に設定する。
注: プロパティvideoCodec のセッター関数。
videoCodec() およびQMediaFormat::VideoCodecも参照のこと 。
[invokable] QList<QMediaFormat::AudioCodec> QMediaFormat::supportedAudioCodecs(QMediaFormat::ConversionMode m)
選択されたファイル形式とビデオコーデックのオーディオコーデックのリストを返します (m)。
サポートされるすべてのオーディオコーデックを取得するには、デフォルトで構築されたQMediaFormat に対してこのクエリを実行します。
注意： この関数はメタオブジェクトシステムやQMLから呼び出すことができます。Q_INVOKABLE を参照してください。
QMediaFormat::ConversionModeも参照して ください。
[invokable] QList<QMediaFormat::FileFormat> QMediaFormat::supportedFileFormats(QMediaFormat::ConversionMode m)
m で指定されたオーディオ・コーデックおよびビデオ・コーデックに対応する ファイル形式のリストを返します。
サポートされているすべてのファイル形式を取得するには、デフォルトで構築されたQMediaFormat に対してこのクエリを実行してください。
注意: この関数はメタオブジェクトシステムやQMLから呼び出すことができます。Q_INVOKABLE を参照してください。
QMediaFormat::ConversionModeも参照して ください。
[invokable] QList<QMediaFormat::VideoCodec> QMediaFormat::supportedVideoCodecs(QMediaFormat::ConversionMode m)
選択したファイル形式とオーディオコーデック(m)に対応するビデオコーデックのリストを返します。
サポートされているすべてのビデオコーデックを取得するには、デフォルトで構築された MediaFormat に対してこのクエリを実行してください。
注意: この関数は、メタオブジェクトシステムや QML から呼び出すことができます。Q_INVOKABLE を参照。
QMediaFormat::ConversionModeも参照して ください。
[noexcept] void QMediaFormat::swap(QMediaFormat &other)
メディアフォーマットをother と入れ替えます。
QMediaFormat::VideoCodec QMediaFormat::videoCodec() const
このフォーマットで使用されているビデオコーデックを返す。
注： プロパティ videoCodec のゲッター関数。
setVideoCodec() およびQMediaFormat::VideoCodecも参照 。
[static invokable] QString QMediaFormat::videoCodecDescription(QMediaFormat::VideoCodec codec)
codec の説明を返す。
注 ：この関数は、メタオブジェクトシステムおよび QML から呼び出すことができます。Q_INVOKABLE を参照してください。
[static invokable] QString QMediaFormat::videoCodecName(QMediaFormat::VideoCodec codec)
codec に対する文字列ベースの名前を返します。
注意： この関数はメタオブジェクトシステム経由でも QML からでも呼び出すことができます。Q_INVOKABLE を参照してください。
bool QMediaFormat::operator!=(const QMediaFormat &other) const
other が現在のメディアフォーマットと等しくない場合はtrue を返し、そうでない場合はfalse を返します。
[noexcept] QMediaFormat &QMediaFormat::operator=(QMediaFormat &&other)
other をこのQMediaFormat オブジェクトに移動します。
[noexcept] QMediaFormat &QMediaFormat::operator=(const QMediaFormat &other)
other をこのQMediaFormat オブジェクトにコピーします。
bool QMediaFormat::operator==(const QMediaFormat &other) const
other が現在のメディア・フォーマットと等しい場合はtrue を返し、そうでない場合はfalse を返します。
©2024 The Qt Company Ltd. 本文書に含まれる文書の著作権は、それぞれの所有者に帰属します。 本書で提供されるドキュメントは、Free Software Foundation が発行したGNU Free Documentation License version 1.3に基づいてライセンスされています。 Qtおよびそれぞれのロゴは、フィンランドおよびその他の国におけるThe Qt Company Ltd.の 商標です。その他すべての商標は、それぞれの所有者に帰属します。
