透かし設定

透かし

透かし：配列またはハッシュ

APIバージョン：V1、V2

有効な値:透かし設定の配列またはハッシュ

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

説明:

ウォーターマーク API を使用して、出力ビデオに 1 つ以上のウォーターマークを追加できます。Zencoderは、JPEG、BMP、またはPNG形式の出力ごとに最大4つの透かしファイルをサポートします。

  { "input": "s3://zencodertesting/test.mov", "outputs": [ { "watermarks": [ { "url": "s3://bucket/watermark_file.png", "x": "20", "y": "-10%", "width": 32, "height": 24 } ]}]}

url

url：String

APIバージョン：V1、V2

親:出力 / ウォーターマーク

有効な値:画像ファイルへの有効な URL。

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

例:

https://s3.amazonaws.com/bucket/img.png
ftp://user:pass@example.com/path/to/watermark.jpg

説明:

ウォーターマークとして使用するリモートイメージファイルの URL。入力 URL 構文を使用します。認証の有無にかかわらず、S3、GCS、クラウドファイル、HTTP/S、FTP、および SFTP をサポートします。

Zencoder は GIF、JPEG、BMP、または PNG 形式の透かしファイルをサポートしています。

透明な透かしの場合は、アルファまたはインデックス透明度を持つ PNG を使用します。

サポートされている PNG 形式

8ビットRGB
8ビットRGB+アルファ
8 ビットグレースケール
8 ビットインデックス付き
8 ビットインデックス付き+透明度
16ビット RGB
16 ビットグレースケール

サポートされていない PNG 形式

8 ビットグレースケール+アルファ
16 ビットグレースケール+アルファ
16ビットRGB +アルファ

  { "input": "s3://zencodertesting/test.mov", "outputs": [ { "watermarks": { "url": "https://s3.amazonaws.com/bucket/img.png" } }]}

x

x：StringまたはNumber

APIバージョン：V1、V2

親:出力 / ウォーターマーク

デフォルト: -10

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

例:

-0
320
中心に

説明:

ビデオ内のx軸（左/右）に透かしを配置する場所。ピクセル数（例：100 または -20）、ビデオ幅のパーセント（25% または -5% など）、' またはウォーターマークをビデオの中心に揃えるには 'centerd を指定します。ビデオの左側を基準にして配置するには正の数を使用し、ビデオの右側を基準にして配置するには負の数を使用します。右側にロックするには「-0" (文字列として) を使用します。

デフォルトでは、位置は表示されているコンテンツ領域に基づいており、パディングは含まれません。originを使用して、完全な出力に基づいてウォーターマークの位置を設定します。

  { "input": "s3://zencodertesting/test.mov", "outputs": [ { "watermarks": { "x": 320 } }]}

参照:y と原点

y

y：文字列または数値

APIバージョン：V1、V2

親:出力 / ウォーターマーク

デフォルト: -10

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

例:

-0
320
中心に

説明:

ビデオ内のy軸（上/下）に透かしを配置する場所。ピクセル数（例：100 または -20）、ビデオ幅のパーセント（25% または -5% など）、' またはウォーターマークをビデオの中心に揃えるには 'centerd を指定します。ビデオの上側を基準にして配置するには正の数を使用し、ビデオの下側を基準にして配置するには負の数を使用します。底にロックするには、「-0" (文字列として) を使用します。

デフォルトでは、位置は表示されているコンテンツ領域に基づいており、パディングは含まれません。originを使用して、完全な出力に基づいてウォーターマークの位置を設定します。

  { "input": "s3://zencodertesting/test.mov", "outputs": [ { "watermarks": { "y": 320 } }]}

参照:x と原点

幅

幅：数値または文字列

APIバージョン：V1、V2

親:出力 / ウォーターマーク

デフォルト:高さ、または元のイメージの幅に拡大/縮小します。

有効な値:正の数またはパーセンテージ

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

説明:

透かしの幅。ピクセル数（64など）またはビデオ幅のパーセント（10％など）で表されます。高さを指定しても幅を指定しない場合、透かし画像は比例して拡大/縮小されます。

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

参照:高さ

高さ

高さ：数値または文字列

APIバージョン：V1、V2

親:出力 / ウォーターマーク

デフォルト:幅、または元のイメージの高さにスケールします。

有効な値:正の数またはパーセンテージ

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

説明:

透かしの高さ。ピクセル数（64など）またはビデオの高さのパーセント（10％など）で表されます。幅を指定しても高さを指定しない場合、透かし画像は比例して拡大/縮小されます。

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

参照:幅

原点

origin：String

APIバージョン：V1、V2

親:出力 / ウォーターマーク

デフォルト:コンテンツ

有効な値:コンテンツまたはフレーム

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

例:フレーム

説明:

透かしの位置のベースとなるビデオの部分。これは、aspect_modeが「pad」であるジョブにのみ影響します。

'frame' は、パディングを含む出力のフル解像度に基づいて配置されます。
' 'content は、パディングを含まない、可視コンテンツ領域の配置に基づきます。

  { "input": "s3://zencodertesting/test.mov", "outputs": [ { "watermarks": { "origin": "content" } }]}

参照:X、 Y、および aspect_mode

不透明度

不透明度：フロート

APIバージョン：V1、V2

親:出力 / ウォーターマーク

デフォルト:1.0

有効な値:0.0 から 1.0

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

例:0.5

説明:

不透明度の値を0.0（透明）から1.0（不透明）の間に設定して、透かしを透明にします。

  { "input": "s3://zencodertesting/test.mov", "outputs": [ { "watermarks": { "opacity": 0.5 } }]}

参照:url

ページコンテンツ

透かし設定

透かし

url

サポートされている PNG 形式

サポートされていない PNG 形式

x

y

幅

高さ

原点

不透明度