フレームレート設定

フレームレート

API バージョン:V1、V2

親:outputs

デフォルト:元の (入力) フレームレート

互換性のあるジョブタイプ:すべて

例:25

説明:

使用する出力フレームレートを 10 進数で表します (例:15、24.98)。

この設定を使用しないことをお勧めします。ビデオのフレームレートを強制的に変更すると、ビデオの品質が低下します。フレームレートが特定のレベルを超えないようにする場合は、 max_frame_rate代わりは。

60 を超えるフレームレートは、HD (1920x1080) より大きい解像度では許可されません。

{
  "input": "s3://zencodertesting/test.mov",
  "outputs": [
    {
      "frame_rate": 25
    }
  ]
}

関連項目： max_frame_rateと間引

max_frame_rate

API バージョン:V1、V2

親:outputs

互換性のあるジョブタイプ:すべて

例:30

説明:

出力フレームレートを特定の数値に制限します。フレームレートがこの数を超える場合（たとえば、入力フレームレートが高すぎる）場合、max_frame_rateフレームレートは設定に下げられます。

例:29.97 max_frame_rateに設定し、入力のフレームレートが 59.94 の場合、出力ファイルのフレームレートは 29.97 になります。

次の 2 つの理由から、厳密な frame_rate を設定するのではなく、この設定を使用することをお勧めします。

まず、frame_rate を変更すると、吃音やぎくしゃく動きによって視覚的な品質が低下することがあります。

次に、フレームレートを固定数に設定すると、入力のフレームレートを超えて出力ビデオのフレームレートが増加し、ファイルサイズが不必要に増加（または品質が低下する）場合があります。

{
  "input": "s3://zencodertesting/test.mov",
  "outputs": [
    {
      "max_frame_rate": 30
    }
  ]
}

関連項目：フレームレートと間引

min_frame_rate

API バージョン:V1、V2

親:outputs

互換性のあるジョブタイプ:すべて

例:30

説明:

最小出力フレームレートを特定の数値に制限します。それ以外の場合、フレームレートがこの数値より小さくなる場合（入力フレームレートが低すぎるなど）、min_frame_rateフレームレートが設定まで増加します。

min_frame_rateその値 未満である必要があります max_frame_rate値。

例:30.0 min_frame_rateに設定し、入力のフレームレートが 29.97 の場合、出力ファイルのフレームレートは 30.0 になります。

次の 2 つの理由から、厳密な frame_rate を設定するのではなく、この設定を使用することをお勧めします。

まず、frame_rate を変更すると、吃音やぎくしゃく動きによって視覚的な品質が低下することがあります。

次に、フレームレートを固定数に設定すると、入力のフレームレートを超えて出力ビデオのフレームレートが増加し、ファイルサイズが不必要に増加（または品質が低下する）場合があります。

{
  "input": "s3://zencodertesting/test.mov",
  "outputs": [
    {
      "min_frame_rate": 30
    }
  ]
}

関連項目：フレームレートと間引

間引

API バージョン:V1、V2

親:outputs

有効な値:正の整数

互換性のあるジョブタイプ:すべて

例:2

説明:

入力フレームレートを指定した数値で割ります。これは、フレームレートを半分にカットしたいが、入力フレームレートがわからない場合に便利です。入力フレームレートが20の場合、decimateを2に設定すると、出力フレームレートは10になります。間引きされたフレームレートが特定の値を超えないようにする場合は、max_frame_rate を設定できます。

出力ビデオには、decimate入力フレームレートを値で割った値に等しい frame_rate が設定されます。したがって、入力が 24 fps で decimate を 4 に設定すると、出力は 6 fps (24/4) になります。

{
  "input": "s3://zencodertesting/test.mov",
  "outputs": [
    {
      "decimate": 2
    }
  ]
}

参照:frame_rateと max_frame_rate

keyframe_interval

API バージョン:V1、V2

親:outputs

デフォルト:250

有効な値:正の整数

互換性のあるジョブタイプ:すべて

例:100

説明:

各キーフレーム間の最大フレーム数を設定します。デフォルトでは、キーフレームは少なくとも 250 フレームごとに作成されます。異なるキーフレーム間隔を指定すると、動画にキーフレームを作成できるようになります。キーフレーム間隔は正の整数で指定する必要があります。たとえば、値が 100 の場合、100 フレームごとにキーフレームが作成されます。

キーフレームの数が多いほど、出力ファイルのサイズが大きくなりますが、ほとんどのプレーヤーでより正確なスクラブが可能になります。

これは最大キーフレーム間隔であることに注意してください。シーンのトランジションなどによっては、高品質のエンコーディングを実現するために、より多くのキーフレームが使用されることがあります。

H.264ビデオの場合、キーフレームは IDR フレームです。

keyframe_interval はキーフレームレートよりも優先されます。

{
  "input": "s3://zencodertesting/test.mov",
  "outputs": [
    {
      "keyframe_interval": 100
    }
  ]
}

参照:keyframe_rate

keyframe_rate

API バージョン:V1、V2

親:outputs

デフォルト:キーフレーム間隔は 250

互換性のあるジョブタイプ:すべて

例:1.5

説明:

1 秒あたりのキーフレーム数を設定します。したがって、値を 0.5 に設定すると、2 秒ごとに 1 つのキーフレームが作成されます。値を 3 にすると、1 秒あたり 3 つのキーフレームが作成されます。

デフォルトでは、キーフレームのコントロールは 250 でkeyframe_interval、デフォルト値は 250 です。ビデオのフレームレートに応じて、8 ～ 11 秒ごとにキーフレームが作成されます。

キーフレームの数が多いほど、出力ファイルのサイズが大きくなりますが、ほとんどのプレーヤーでより正確なスクラブが可能になります。

keyframe_interval keyframe_rate よりも優先されます。

{
  "input": "s3://zencodertesting/test.mov",
  "outputs": [
    {
      "keyframe_rate": 1.5
    }
  ]
}

参照:fixed_keyframe_interval、 forced_keyframe_interval、およびforced_keyframe_rate

fixed_keyframe_interval

API バージョン:V1、V2

親:outputs

デフォルト:偽

有効な値:真または偽

互換性のあるジョブタイプ:すべて

例:真

説明:

デフォルトでは、2 keyframe_intervalつのキーフレーム間の最大フレーム数だけが保証されます。エンコーダは、keyframe_interval で要求される前にキーフレームを配置することを決定する場合があります。たとえば、シーンの変更にキーフレームを配置することで、より優れた圧縮を実現できます。このオプションを true に設定すると、この変動を防ぐことができます。

このオプションはH.264、HEVCまたは VP6 を使用する場合にのみ適用されます。video_codec。

{
  "input": "s3://zencodertesting/test.mov",
  "outputs": [
    {
      "fixed_keyframe_interval": true
    }
  ]
}

参照:keyframe_interval、 forced_keyframe_interval、およびforced_keyframe_rate

force_keyframe_interval

API バージョン:V1、V2

親:outputs

有効な値:正の整数

互換性のあるジョブタイプ:すべて

例:10

説明:

指定されたフレーム間隔（N フレームごと）にキーフレームを強制的に作成しますが、エンコーダがシーンカットなどの他の場所にキーフレームを配置できるようにします。fixed_keyframe_intervalこれとは対照的に、指定された間隔にキーフレームのみを配置します。

このオプションは、H.264またはを使用する場合にのみ適用されます。HEVCvideo_codec。

{
  "input": "s3://zencodertesting/test.mov",
  "outputs": [
    {
      "forced_keyframe_interval": 10
    }
  ]
}

参照:keyframe_interval , fixed_keyframe_interval、 forced_keyframe_rate

force_keyframe_rate

API バージョン:V1、V2

親:outputs

有効な値:0.001から100

互換性のあるジョブタイプ:すべて

例:0.1

説明:

フレームレートを考慮して、1 秒あたりのキーフレーム数を指定して、強制キーフレーム間隔を設定します。

forced_keyframe_intervalが指定されている場合、このオプションは無視されます。

このオプションは、H.264またはを使用する場合にのみ適用されます。HEVCvideo_codec。

{
  "input": "s3://zencodertesting/test.mov",
  "outputs": [
    {
      "forced_keyframe_rate": "0.1"
    }
  ]
}

参照:keyframe_intervalとfixed_keyframe_interval

generate_frame_index

API バージョン:V2

親:outputs

デフォルト:偽

有効な値:真または偽

互換性のあるジョブタイプ:すべて

例:真

説明:

フレーム #、フレームサイズ (バイト)、最後のキーフレーム # の 3 つの整数値を持つタブ区切りファイルを生成します。各行には、幅42列のスペースが埋め込まれています。

このオプションは、出力にビデオストリームが含まれていない限り使用できません。

デフォルトのインデックスファイル名 'frame_index.tab' はで上書きできますframe_index_filename。

{
  "input": "s3://zencodertesting/test.mov",
  "outputs": [
    {
      "generate_frame_index": true,
      "frame_index_filename": "my_frame_index.txt"
    }
  ]
}

以下も参照してください。frame_index_filename

frame_index_filename

API バージョン:V2

親:outputs

互換性のあるジョブタイプ:すべて

例: my_frame_index.txt

説明:

指定しない限り、フレームインデックスの生成に使用されるファイル名は 'frame_index.tab' になります。

このオプションでは、それが true generate_frame_indexであることが必要です。

{
  "input": "s3://zencodertesting/test.mov",
  "outputs": [
    {
      "generate_frame_index": true,
      "frame_index_filename": "my_frame_index.txt"
    }
  ]
}

以下も参照してください。generate_frame_index