Wasserzeicheneinstellungen

Einleitung

Wasserzeichen sind Bilder, die einem Video hinzugefügt werden, oft um die Herkunft oder den Eigentümer anzugeben. Wenn Sie ein Wasserzeichen angeben, wird das Bild in diese Ausgabe eingebettet. Wie bei der Videoeingabe wird die Position des Wasserzeichens über ein angegeben, auf url das Zencoder zugreifen kann.

Mit Zencoder können Sie die Position und Größe des Wasserzeichens über die folgenden Einstellungen festlegen:

Position/Größe Einstellungen
Rahmen	Beschreibung
`x`	Die horizontale Position des Wasserzeichens, ausgedrückt als Anzahl von Pixeln, als Prozentsatz der Videobreite oder als `centered`. Wenn `x` es sich um eine positive Zahl oder einen positiven Prozentsatz handelt, wird sie vom linken Rand des Videos bis zum linken Bildrand gemessen. Wenn `x` der Wert negativ ist, wird er vom rechten Rand des Videos bis zum rechten Bildrand gemessen. Standard: -10
`y`	Die vertikale Position des Wasserzeichens, ausgedrückt als Anzahl von Pixeln, als Prozentsatz der Videobreite oder als `centered`. Wenn `y` es sich um eine positive Zahl oder einen positiven Prozentsatz handelt, wird sie vom oberen Rand des Videos bis zum oberen Bildrand gemessen. Wenn `y` der Wert negativ ist, wird er vom unteren Rand des Videos bis zum unteren Bildrand gemessen. Standard: -10
`width`	Die Breite des Wasserzeichens, ausgedrückt in einer Anzahl von Pixeln oder in Prozent der Videobreite. Standard: tatsächliche Breite des Bildes.
`height`	Die Höhe des Wasserzeichens, ausgedrückt als Anzahl von Pixeln oder als Prozentsatz der Videohöhe. Standard: tatsächliche Höhe des Bildes.

Hinweise

Alle oben genannten Einstellungen können als Zeichenketten oder Zahlen eingegeben werden, wenn sie Pixelwerte haben.
Wenn Sie width oder verwenden, wird height das Bild gestreckt oder zusammengedrückt, wodurch die Bildqualität beeinträchtigt wird.
Wenn Sie die Bildgröße ändern müssen, geben Sie entweder das width oder an height, aber nicht beides. In diesem Fall wird die andere Dimension unter Beibehaltung des Seitenverhältnisses entsprechend skaliert.
Das Wasserzeichen muss so dimensioniert und positioniert werden, dass es vollständig in die Frame-Größe der Ausgabe passt, der es zugewiesen ist. Wenn dies nicht der Fall ist, gibt Zencoder einen Fehler zurück.
Es gibt auch eine origin, mit der Sie alle Messungen in Bezug auf die Videobildgröße und nicht auf die Inhaltsgröße durchführen können, wenn die beiden unterschiedlich sind - aber das ist selten.

Das folgende Diagramm zeigt, wie die y Einstellungen x und funktionieren.

Probe

Das nachstehende Beispiel wurde mit den folgenden Einstellungen mit einem Wasserzeichen versehen:

{
  "input": "https://support.brightcove.com/test-assets/videos/oystercatcher.mp4",
  "outputs": [
    {
      "watermarks": {
        "url": "https://support.brightcove.com/test-assets/images/watermark.png",
        "x": "centered",
        "y": "centered"
      }
    }
  ]
}

Wasserzeichen

watermarks:Array or Hash

API-Versionen: V2

Elternteil: Ausgänge ODER dynamic_profile_options

Gültige Werte: Ein Array oder ein Hash von Wasserzeicheneinstellungen

Kompatible Auftragstypen: VOD

Beschreibung:

Mit unserer Wasserzeichen-API können Sie einem Ausgabevideo ein oder mehrere Wasserzeichen hinzufügen. Zencoder unterstützt bis zu 4 Wasserzeichendateien pro Ausgabe im JPEG-, BMP- oder PNG-Format.

  {
    "input": "s3: //zencodertesting/test.mov",
    "Ausgänge": [
      {
        "Wasserzeichen": [
          {
            "url": "s3: //bucket/watermark_file.png",
            "x": 20,
            "y": "-10%",
            "Breite": 32,
            "Höhe": 24
          }
        ]
      }
    ]
  }}

url

url:String

API-Versionen: V2

Elternteil: Ausgänge /. Wasserzeichen

Gültige Werte: Eine gültige URL zu einer Bilddatei.

Kompatible Auftragstypen: VOD

Beispiel:

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

Beschreibung:

Die URL einer Remote-Image-Datei, die als Wasserzeichen verwendet werden soll. Verwenden Sie die Eingang URL-Syntax. Unterstützt S3, GCS, Cloud-Dateien, HTTP / S, FTP und SFTP mit oder ohne Authentifizierung.

Zencoder unterstützt Wasserzeichendateien im JPEG-, BMP- oder PNG-Format.

Verwenden Sie für transparente Wasserzeichen PNGs mit Alpha- oder Indextransparenz.

Unterstützte PNG-Formate

8-Bit-RGB
8-Bit-RGB + Alpha
8-Bit-Graustufen
8-Bit indiziert
8-Bit indiziert + Transparenz
16-Bit-RGB
16-Bit-Graustufen

Nicht unterstützte PNG-Formate

8-Bit-Graustufen + Alpha
16-Bit-Graustufen + Alpha
16-Bit-RGB + Alpha

  {
    "input": "s3: //zencodertesting/test.mov",
    "Ausgänge": [
      {
        "Wasserzeichen": {
          "url": "https://s3.amazonaws.com/bucket/img.png"
        }
      }
    ]
  }}

x

x:String or Number

API-Versionen: V2

Elternteil: Ausgänge /. Wasserzeichen

Standard: -10

Kompatible Auftragstypen: VOD

Beispiel:

-0
320
zentriert

Beschreibung:

Wo soll das Wasserzeichen im Video auf der x-Achse (links / rechts) platziert werden? Kann eine Anzahl von Pixeln (z. B. 100 oder -20), ein Prozent der Videobreite (z. B. 25% oder -5%) oder "zentriert" sein, um das Wasserzeichen an der Mitte des Videos auszurichten. Verwenden Sie eine positive Zahl, um relativ zur linken Seite des Videos zu platzieren, und eine negative Zahl, um relativ zur rechten Seite des Videos zu platzieren. Verwenden Sie "-0" (als Zeichenfolge), um auf der rechten Seite zu sperren.

Standardmäßig basiert die Position auf dem sichtbaren Inhaltsbereich ohne Auffüllung. Benutzen Ursprung um die Wasserzeichenposition basierend auf der vollen Ausgabe einzustellen.

  {
    "input": "s3: //zencodertesting/test.mov",
    "Ausgänge": [
      {
        "Wasserzeichen": {
          "x": 320
        }
      }
    ]
  }}

Siehe auch: y und Ursprung

ja

y:String or Number

API-Versionen: V2

Elternteil: Ausgänge /. Wasserzeichen

Standard: -10

Kompatible Auftragstypen: VOD

Beispiel:

-0
320
zentriert

Beschreibung:

Wo soll das Wasserzeichen im Video auf der y-Achse (oben / unten) platziert werden? Kann eine Anzahl von Pixeln (z. B. 100 oder -20), ein Prozent der Videobreite (z. B. 25% oder -5%) oder "zentriert" sein, um das Wasserzeichen an der Mitte des Videos auszurichten. Verwenden Sie eine positive Zahl, um relativ zur Oberseite des Videos zu platzieren, und eine negative Zahl, um relativ zur Unterseite des Videos zu platzieren. Verwenden Sie "-0" (als Zeichenfolge), um nach unten zu sperren.

Standardmäßig basiert die Position auf dem sichtbaren Inhaltsbereich ohne Auffüllung. Benutzen Ursprung um die Wasserzeichenposition basierend auf der vollen Ausgabe einzustellen.

  {
    "input": "s3: //zencodertesting/test.mov",
    "Ausgänge": [
      {
        "Wasserzeichen": {
          "y": 320
        }
      }
    ]
  }}

Siehe auch: x und Ursprung

Breite

width:Number or String

API-Versionen: V2

Elternteil: Ausgänge /. Wasserzeichen

Standard: Skalieren auf Höhe oder Originalbildbreite.

Gültige Werte: Eine positive Zahl oder ein Prozentsatz

Kompatible Auftragstypen: VOD

Beschreibung:

Die Breite des Wasserzeichens, ausgedrückt als Anzahl von Pixeln (z. B. 64) oder als Prozentsatz der Videobreite (z. B. 10%). Wenn Höhe Wird bereitgestellt, aber nicht die Breite, wird das Wasserzeichenbild proportional skaliert.

  {
    "input": "s3: //zencodertesting/test.mov",
    "Ausgänge": [
      {
        "Wasserzeichen": {
          "Breite": 100
        }
      }
    ]
  }}

Siehe auch: Höhe

Höhe

height:Number or String

API-Versionen: V2

Elternteil: Ausgänge /. Wasserzeichen

Standard: Skalieren auf Breite oder Originalbildhöhe.

Gültige Werte: Eine positive Zahl oder ein Prozentsatz

Kompatible Auftragstypen: VOD

Beschreibung:

Die Höhe des Wasserzeichens, ausgedrückt als Anzahl von Pixeln (z. B. 64) oder als Prozentsatz der Videohöhe (z. B. 10%). Wenn Breite Wird dies bereitgestellt, jedoch nicht die Höhe, wird das Wasserzeichenbild proportional skaliert.

  {
    "input": "s3: //zencodertesting/test.mov",
    "Ausgänge": [
      {
        "Wasserzeichen": {
          "Höhe": 100
        }
      }
    ]
  }}

Siehe auch: Breite

Herkunft

origin:String

API-Versionen: V2

Elternteil: Ausgänge /. Wasserzeichen

Standard: Inhalt

Gültige Werte: Inhalt oder Rahmen

Kompatible Auftragstypen: VOD

Beispiel: Rahmen

Beschreibung:

Der Teil des Videos, auf dem die Position des Wasserzeichens basiert. Dies betrifft nur Jobs, bei denen aspect_mode 'pad' ist.

'frame' basiert die Platzierung auf der vollen Auflösung der Ausgabe, einschließlich etwaiger Auffüllungen.
'Inhalt' basiert die Platzierung auf dem sichtbaren Inhaltsbereich, ohne Auffüllen.

  {
    "input": "s3: //zencodertesting/test.mov",
    "Ausgänge": [
      {
        "Wasserzeichen": {
          "Herkunft": "Inhalt"
        }
      }
    ]
  }}

Siehe auch: x , ja , und Aspekt_Modus

Opazität

opacity:Float

API-Versionen: V2

Elternteil: Ausgänge /. Wasserzeichen

Standard: 1,0

Gültige Werte: 0,0 bis 1,0

Kompatible Auftragstypen: VOD

Beispiel: 0.5

Beschreibung:

Machen Sie das Wasserzeichen transparent, indem Sie einen Deckkraftwert zwischen 0,0 (transparent) und 1,0 (undurchsichtig) einstellen.

  {
    "input": "s3: //zencodertesting/test.mov",
    "Ausgänge": [
      {
        "Wasserzeichen": {
          "Opazität": 0.5
        }
      }
    ]
  }}

Siehe auch: URL