Image クラス

入力ビデオからサムネイルを生成するための基本的なプロパティについて説明します。

このクラスを直接使用するのではなく、サブクラスを使用する必要がある可能性があります。 既知のサブクラス: JpgImage、PngImage

Azure に送信するには、必要なすべてのパラメーターを設定する必要があります。

継承

azure.mgmt.media.models._models_py3.Video

Image

コンストラクター

Image(*, start: str, label: str | None = None, key_frame_interval: timedelta | None = None, stretch_mode: str | _models.StretchMode | None = None, sync_mode: str | _models.VideoSyncMode | None = None, step: str | None = None, range: str | None = None, **kwargs)

キーワードのみのパラメーター

名前	説明
label	str コーデックの省略可能なラベル。 ラベルを使用して、多重化の動作を制御できます。
key_frame_interval	timedelta 2 つのキー フレーム間の距離。 値は、ISO 8601 形式で指定された [0.5, 20] 秒の範囲で 0 以外にする必要があります。 既定値は 2 秒 (PT2S) です。 VideoSyncMode.Passthrough が設定されている場合、KeyFrameInterval 値が入力ソース設定に従う場合、この設定は無視されることに注意してください。
stretch_mode	str または StretchMode サイズ変更モード - 入力ビデオを目的の出力解像度に合わせてサイズ変更する方法。 既定値は AutoSize です。 既知の値は、"None"、"AutoSize"、および "AutoFit" です。
sync_mode	str または VideoSyncMode ビデオ同期モード。 既知の値は、"Auto"、"Passthrough"、"Cfr"、"Vfr" です。
start	str サムネイルの生成を開始する場所からの入力ビデオ内の位置。 この値は、ISO 8601 形式 (たとえば、PT05S の場合は 5 秒で開始する)、フレーム数 (たとえば、10 の場合は 10 番目のフレームで開始する)、またはストリーム期間に対する相対値 (たとえば、10% の場合はストリーム期間の 10% で開始する) とすることができます。 また、マクロ {Best} もサポートされています。これにより、ビデオの最初の数秒から最適なサムネイルを選択するようにエンコーダーに指示が送られ、ステップと範囲の他の設定に関係なく、1 つのサムネイルのみが生成されることになります。 既定値はマクロ {Best} です。 必須。
step	str サムネイルが生成される間隔。 この値は、ISO 8601 形式 (たとえば、5 秒ごとに 1 つのイメージの PT05S)、フレーム数 (30 フレームごとに 1 つのイメージの場合は 30)、またはストリーム期間に対する相対値 (たとえば、ストリーム期間の 10% ごとに 10% のイメージ) にすることができます。 注: ステップ値は、最初に生成されたサムネイルに影響します。これは、変換プリセットの開始時刻に指定されたサムネイルとは異なることがあります。 これは、最初の出力として開始時刻からステップ位置までの間で最適なサムネイルを選択しようとするエンコーダーが原因です。 既定値は 10% であるため、ストリームの期間が長い場合は、最初に生成されたサムネイルが起動時に指定されたものから遠く離れている可能性があることを意味します。 最初のサムネイルが開始時刻に近づくと予想される場合は[ステップ] に適切な値を選択し、開始時にサムネイルが 1 つだけ必要な場合は Range 値を 1 に設定します。
range	str サムネイルの生成を停止する入力ビデオの変換プリセット開始時刻に対する相対位置。 値は ISO 8601 形式 (たとえば、開始時刻から 5 分 30 秒で停止する PT5M30S)、またはフレーム数 (たとえば、300 は、開始時刻のフレームから 300 番目のフレームで停止する場合) です。この値が 1 の場合は、開始時に 1 つのサムネイルのみを生成することを意味します。または、ストリームの継続時間に対する相対値 (たとえば、開始時刻からのストリーム期間の半分で停止する場合は 50%) を意味します。 既定値は 100% です。これは、ストリームの末尾で停止することを意味します。

変数

名前	説明
odata_type	str 派生型の識別子。 必須。
label	str コーデックの省略可能なラベル。 ラベルを使用して、多重化の動作を制御できます。
key_frame_interval	timedelta 2 つのキー フレーム間の距離。 値は、ISO 8601 形式で指定された [0.5, 20] 秒の範囲で 0 以外にする必要があります。 既定値は 2 秒 (PT2S) です。 VideoSyncMode.Passthrough が設定されている場合、KeyFrameInterval 値が入力ソース設定に従う場合、この設定は無視されることに注意してください。
stretch_mode	str または StretchMode サイズ変更モード - 入力ビデオを目的の出力解像度に合わせてサイズ変更する方法。 既定値は AutoSize です。 既知の値は、"None"、"AutoSize"、および "AutoFit" です。
sync_mode	str または VideoSyncMode ビデオ同期モード。 既知の値は、"Auto"、"Passthrough"、"Cfr"、"Vfr" です。
start	str サムネイルの生成を開始する場所からの入力ビデオ内の位置。 この値は、ISO 8601 形式 (たとえば、PT05S の場合は 5 秒で開始する)、フレーム数 (たとえば、10 の場合は 10 番目のフレームで開始する)、またはストリーム期間に対する相対値 (たとえば、10% の場合はストリーム期間の 10% で開始する) とすることができます。 また、マクロ {Best} もサポートされています。これにより、ビデオの最初の数秒から最適なサムネイルを選択するようにエンコーダーに指示が送られ、ステップと範囲の他の設定に関係なく、1 つのサムネイルのみが生成されることになります。 既定値はマクロ {Best} です。 必須。
step	str サムネイルが生成される間隔。 この値は、ISO 8601 形式 (たとえば、5 秒ごとに 1 つのイメージの PT05S)、フレーム数 (30 フレームごとに 1 つのイメージの場合は 30)、またはストリーム期間に対する相対値 (たとえば、ストリーム期間の 10% ごとに 10% のイメージ) にすることができます。 注: ステップ値は、最初に生成されたサムネイルに影響します。これは、変換プリセットの開始時刻に指定されたサムネイルとは異なることがあります。 これは、最初の出力として開始時刻からステップ位置までの間で最適なサムネイルを選択しようとするエンコーダーが原因です。 既定値は 10% であるため、ストリームの期間が長い場合は、最初に生成されたサムネイルが起動時に指定されたものから遠く離れている可能性があることを意味します。 最初のサムネイルが開始時刻に近づくと予想される場合は[ステップ] に適切な値を選択し、開始時にサムネイルが 1 つだけ必要な場合は Range 値を 1 に設定します。
range	str サムネイルの生成を停止する入力ビデオの変換プリセット開始時刻に対する相対位置。 値は ISO 8601 形式 (たとえば、開始時刻から 5 分 30 秒で停止する PT5M30S)、またはフレーム数 (たとえば、300 は、開始時刻のフレームから 300 番目のフレームで停止する場合) です。この値が 1 の場合は、開始時に 1 つのサムネイルのみを生成することを意味します。または、ストリームの継続時間に対する相対値 (たとえば、開始時刻からのストリーム期間の半分で停止する場合は 50%) を意味します。 既定値は 100% です。これは、ストリームの末尾で停止することを意味します。