Überblick
Sie können die Auflösung Ihres Ausgabevideos mit einer oder mehreren Auflösungseinstellungen steuern.
1. Beginnen Sie mit der Einstellung entweder Größe , Breite , oder Höhe . width
und height
Vorrang vor size
. Wenn Sie keine dieser Einstellungen vornehmen, bleibt die ursprüngliche Videoauflösung erhalten.
2. Bestimmen Sie dann, ob Sie die Größe von Videos erhöhen möchten, wenn die Eingabe kleiner als Ihre Zielausgabe ist (gehoben). Standardmäßig werden Videos nicht hochskaliert. Oft kann Ihr Videoplayer Videos für Sie problemlos hochskalieren, sodass Sie das Video zum Zeitpunkt der Codierung nicht hochskalieren müssen (was nur die Dateigröße erhöht).
3. Wählen Sie schließlich einen Ansatz für das Seitenverhältnis. Wenn Ihr Eingangsvideo ein anderes Seitenverhältnis als die von Ihnen gewählte Auflösung hat, können Sie entweder das ursprüngliche Seitenverhältnis beibehalten. Dehnen Sie das Video, um es an das Zielseitenverhältnis anzupassen. Beschneiden Sie die Eingabe so, dass sie dem Zielseitenverhältnis entspricht. oder füllen Sie das Video mit schwarzen Balken auf, um es an das Zielseitenverhältnis anzupassen.
Größe
size:String
API-Versionen: V2
Elternteil: Ausgänge
Gültige Werte: WxH, wobei W und H die Breite bzw. Höhe sind. Beide Dimensionen sollten eine durch 4 teilbare ganze Zahl sein.
Kompatible Auftragstypen: VOD
Beispiel: 480 x 320
Beschreibung:
Die Auflösung der Ausgabedatei, ausgedrückt als BxH, beträgt 640 × 480 oder 1280 × 720. Beachten Sie, dass Breite und Höhe Vorrang vor der Größe haben.
Der Seitenmodus bleibt standardmäßig erhalten. Wenn das Eingangsvideo also 16: 9 ist und eine 4: 3-Ausgangsauflösung angefordert wird, behält die Ausgabe das Seitenverhältnis 16: 9 bei. Dies führt dazu, dass die Ausgabeabmessungen nicht mit der angeforderten Größe übereinstimmen. Benutzen Aspektmodus um dies zu kontrollieren.
{
"input": "s3://zencodertesting/test.mov",
"outputs": [
{
"size": "480x320"
}
]
}
Siehe auch: Breite , Höhe , und Aspekt_Modus
Breite
width:Integer
API-Versionen: V2
Elternteil: Ausgänge
Gültige Werte: Ganzzahlen teilbar durch 4.
Kompatible Auftragstypen: VOD
Beispiel: 480
Beschreibung:
Videobildbreite. Wenn keine Breite angegeben ist, verwenden wir die ursprüngliche Breite oder skalieren auf Größe oder Höhe Rahmen.
Beachten Sie, dass Breite und Höhe Vorrang vor Größe.
{
"input": "s3://zencodertesting/test.mov",
"outputs": [
{
"width": "480"
}
]
}
Höhe
height:Integer
API-Versionen: V2
Elternteil: Ausgänge
Gültige Werte: Ganzzahlen teilbar durch 4.
Kompatible Auftragstypen: VOD
Beispiel: 640
Beschreibung:
Videobildhöhe. Wenn keine Höhe angegeben ist, verwenden wir die ursprüngliche Höhe oder skalieren auf Größe oder Breite Rahmen.
Beachten Sie, dass Breite und Höhe haben Vorrang vor Größe.
{
"input": "s3://zencodertesting/test.mov",
"outputs": [
{
"height": "640"
}
]
}
gehoben
upscale:Boolean
API-Versionen: V2
Elternteil: Ausgänge
Standard: falsch
Gültige Werte: richtig oder falsch
Kompatible Auftragstypen: VOD
Beispiel: wahr
Beschreibung:
Standardmäßig erhöht Zencoder die nicht Größe eines (oder „gehobenen“) Eingangsvideos, das dem entspricht Breite und Höhe Sie geben in einer API-Anfrage an. Im Allgemeinen erhöht das Hochskalieren eines Videos nur die Größe, aber nicht wirklich die Qualität. Ihr Wiedergabegerät (Flash, HTML5-Video, iPhone usw.) kann die Größe eines Videos erhöhen, anstatt dies vom Encoder ausführen zu lassen.
Wenn Sie Zencoder jedoch zwingen möchten, die Größe eines Eingangsvideos zu erhöhen, setzen Sie "upscale" auf "true". Wenn Sie dies tun, wird ein Eingangsvideo, das kleiner als die Ausgangsauflösung ist, entsprechend der Auflösung erweitert. Wenn Ihre Ausgabespezifikation beispielsweise 480 × 360 ist und jemand ein Video mit 320 × 240 sendet, wird das Video auf 480 × 360 vergrößert, wenn Sie diese Option auf true setzen, und bleibt ansonsten bei 320 × 240.
{
"input": "s3://zencodertesting/test.mov",
"outputs": [
{
"upscale": true
}
]
}
aspect_mode
aspect_mode:String
API-Versionen: V2
Elternteil: Ausgänge
Standard: erhalten
Gültige Werte: konservieren, dehnen, beschneiden oder polstern
Kompatible Auftragstypen: VOD
Beispiel: Ernte
Beschreibung:
Wenn das Seitenverhältnis der Eingabe nicht mit dem angeforderten Seitenverhältnis der Ausgabe übereinstimmt, wie sollte die Ausgabeauflösung sein? "Aspect_mode" steuert diese Entscheidung. Beachten Sie, dass sowohl die Breite als auch die Höhe geändert werden können.
Angenommen, eine Eingabedatei ist 1280 × 720 (Breitbild 16: 9), die Zielausgabe jedoch 640 × 480 (Standard 4: 3). Es gibt vier grundlegende Ansätze für dieses Problem, und Zencoder unterstützt sie alle.
- erhalten:: Standardmäßig behält Zencoder das Seitenverhältnis der Originaldatei bei. Wenn Sie also Breitbildinhalte senden und nach einer Standardauflösung fragen, passt die Ausgabedatei das Breitbild-Seitenverhältnis und passt in die Ausgabegröße. Vermutlich fügt der Spieler dann schwarze Balken hinzu, um den Rahmen auszufüllen. In unserem Beispiel ist die Ausgabedatei 640 × 360 (Breitbild 16 × 9, das in das 640 × 480-Ziel passt).
- strecken:: Wenn der Seitenmodus "Strecken" ist, entspricht das Ausgabevideo genau der gewünschten Breite und Höhe, auch wenn es das Bild verzerrt. In unserem Beispiel beträgt die Ausgabe also 640 × 480, sieht jedoch vertikal gestreckt aus. Hinweis: Dies ist nicht dasselbe wie die oben beschriebene Option "Hochskalieren", mit der festgelegt wird, ob ein kleineres Video auf eine größere Bildgröße vergrößert wird oder nicht.
- zuschneiden: Diese Option weist Zencoder an, das Video entsprechend der Ausgabegröße zu vergrößern, indem Pixel von oben / unten oder links / rechts zugeschnitten werden. Wenn die Eingabe also Breitbild 1280 × 720 ist und das Ausgabeziel Standard 640 × 480 ist, werden ungefähr 160 Pixel links und rechts von der Eingabedatei zugeschnitten (Erstellen eines 4: 3-Films) und dann die Größe geändert bis zu 640 × 480. Wenn Sie alt genug sind, um sich an Nicht-Breitbild-VHS zu erinnern (wie wir), ist dies die alte Option zum Schwenken und Scannen.
- Pad: Die Pad-Option weist Zencoder an, das Video mit einem Briefkasten zu versehen, der genau der Größe des Ausgabebilds entspricht. Verwenden Sie diese Option, wenn Ihr Zielspieler nicht weiß, wie er ein Video auffüllt. Andernfalls verschwenden Sie nur Bits, indem Sie schwarze Balken in die eigentliche Datei aufnehmen. Nach unserem Beispiel würde diese Option 1280 × 720 (16: 9) Inhalt verwenden und in 640 × 480 (4: 3) konvertieren, indem ein 640 × 360-Film erstellt und dann oben und unten schwarze Balken mit 60 Pixel platziert werden der Film. Der Film wäre also 640 × 480, mit schwarzen Balken oben und unten.
Beachten Sie, dass aspect_mode erfordert, dass beide a Breite und ein Höhe bereitgestellt werden (oder Größe); Andernfalls berechnen wir die andere Dimension proportional, wenn nur eine Dimension angegeben ist.
Hinweis: der VP6 Video-Codec unterstützt nicht den "pad" Aspekt_Modus. Wenn Sie mit VP6-Video nach "Pad" fragen, verwenden wir den Standardmodus "Beibehalten".
{
"input": "s3://zencodertesting/test.mov",
"outputs": [
{
"aspect_mode": "crop"
}
]
}
sample_aspect_ratio
sample_aspect_ratio:String
API-Versionen: V2
Elternteil: Ausgänge
Kompatible Auftragstypen: VOD
Beispiel: 8: 9
Beschreibung:
Das Sample-Seitenverhältnis (Pixel), das für das Ausgabevideo verwendet werden soll. Die Optionen für Größe, Breite, Höhe und Seitenmodus beziehen sich alle auf die codierten Pixelabmessungen, nicht auf die Anzeigeabmessungen.
Legt das Seitenverhältnis fest, das für Stichprobe/Pixel des Ausgabevideos verwendet werden soll, angegeben als "8:9 „," 32:27 „oder ein anderes Verhältnis zweier positiver Ganzzahlen zwischen 1 und 65535.
Wenn Sie einen (gültigen) Wert für diese Einstellung angeben, wird der Standard-Aspektmodus von "Erhalten" in "Strecken" geändert. Dies bedeutet, dass Sie standardmäßig auch eine Breite / Höhe für die codierte Ausgabe angeben müssen.
Hinweis: Es kann nützlich sein, die Option "Hochskalieren" in Verbindung mit dieser Option für vorhersagbare Ausgabeauflösungen zu verwenden.
Diese Option gilt nur bei Verwendung der Codecs H.264 und HEVC.
{
"input": "s3://zencodertesting/test.mov",
"outputs": [
{
"sample_aspect_ratio": "8:9"
}
]
}
Siehe auch: Aspekt_Modus , Breite , Höhe , und Größe
force_interlace_headers
force_interlace_headers:Boolean
API-Versionen: V2
Elternteil: Ausgänge
Kompatible Auftragstypen: VOD
Standard: falsch
Beschreibung:
Einige Decoder fragen nach Interlaced-Inhalten, spielen aber progressive Inhalte einwandfrei ab. Diese Einstellung fügt den Metadaten des progressiven Inhalts "Interlaced" -Header hinzu, damit es so aussieht, als wäre es tatsächlich Interlaced.
Hinweis: Einige Tools zur Medieninspektion werden dadurch nicht ausgetrickst und melden diesen Inhalt trotz der Header-Informationen als progressiv.)
Diese Option gilt nur bei Verwendung des H.264-Codecs.
{
"input": "s3://zencodertesting/test.mov",
"outputs": [
{
"force_interlace_headers": true
}
]
}
Siehe auch: Aspekt_Modus , Breite , Höhe , und Größe