La structure de l'objet Effect varie selon son type. Chaque section ci-dessous détaille les paramètres propres à un type d'effet spécifique.
Type d'effet : Text (texte en bannière)
Exemple de timeline :Sous-titres et modèles de sous-titres.
|
Nom |
Type |
Obligatoire |
Description |
|
X |
Float |
Non |
Distance horizontale entre le coin supérieur gauche du texte en bannière et celui de la vidéo de sortie. Cette valeur s'exprime en pourcentage ou en pixels. Une valeur comprise dans l'intervalle [0, 0.9999] correspond à un pourcentage de la largeur de la vidéo. Un entier supérieur ou égal à 2 représente une valeur absolue en pixels. La valeur par défaut est 0. Ces coordonnées sont mises à l'échelle en fonction des dimensions du média source et de la vidéo de sortie. |
|
Y |
Float |
Non |
Distance verticale entre le coin supérieur gauche du texte en bannière et celui de la vidéo de sortie. Cette valeur s'exprime en pourcentage ou en pixels. Une valeur comprise dans l'intervalle [0, 0.9999] correspond à un pourcentage de la hauteur de la vidéo. Un entier supérieur ou égal à 2 représente une valeur absolue en pixels. La valeur par défaut est 0. Ces coordonnées sont mises à l'échelle en fonction des dimensions du média source et de la vidéo de sortie. |
|
TimelineIn |
Float |
Non |
Instant d'apparition du texte en bannière sur la timeline, exprimé en secondes avec une précision de quatre décimales. En l'absence de cette valeur, le système utilise la propriété |
|
TimelineOut |
Float |
Non |
Instant de disparition du texte en bannière sur la timeline, exprimé en secondes avec une précision de quatre décimales. Si ce paramètre n'est pas défini, la valeur |
|
Content |
String |
Oui |
Contenu textuel de la bannière. |
|
Font |
String |
Non |
Police de caractères utilisée pour le texte. Polices prises en charge :Liste des polices. Valeur par défaut : SimSun. |
|
FontSize |
Int |
Oui |
Taille de la police du texte en bannière. Cette taille est ajustée proportionnellement aux dimensions du média source et de la vidéo de sortie. La valeur par défaut est 0 et le maximum autorisé est 5000. Remarque :
|
|
SizeRequestType |
String |
Non |
Méthode de calcul de la taille réelle de rendu du texte à partir de la taille de police spécifiée. La valeur par défaut est
|
|
FixedFontSize |
Int |
Oui |
Taille de police fixe pour le texte en bannière. Contrairement à Remarque :
|
|
FixedX |
Float |
Non |
Position horizontale du coin supérieur gauche du texte par rapport au coin supérieur gauche de la vidéo de sortie. Accepte un pourcentage ou une valeur en pixels. L'intervalle [0, 0.9999] indique un ratio de la largeur vidéo, tandis qu'un entier ≥ 2 définit une position absolue en pixels. Valeur par défaut : 0. Aucune mise à l'échelle n'est appliquée selon la taille du média source. |
|
FixedY |
Float |
Non |
Décalage vertical du texte depuis le coin supérieur gauche de la vidéo de sortie. Exprimé en pourcentage ou en pixels. Une valeur entre 0 et 0.9999 est interprétée comme une fraction de la hauteur vidéo ; un entier ≥ 2 correspond à des pixels absolus. Par défaut à 0, cette coordonnée reste indépendante des dimensions du média d'origine. |
|
FontColor |
String |
Non |
Couleur du texte en bannière, spécifiée par un code hexadécimal précédé d'un dièse (#). Exemple : |
|
FontColorOpacity |
String |
Non |
Niveau d'opacité du texte. Plage autorisée : [0, 1], où 1 signifie totalement opaque et 0 complètement transparent. Valeur par défaut : 1. |
|
FontFace |
FontFace |
Non |
Style typographique appliqué au texte de la bannière. |
|
Spacing |
Integer |
Non |
Espacement inter-caractères du texte, mesuré en pixels. Valeur initiale : 0. |
|
LineSpacing |
Integer |
Non |
Interligne du texte en bannière, exprimé en pixels. Réglage par défaut : 0. |
|
Angle |
Float |
Non |
Angle de rotation antihoraire appliqué au texte. Unité : degrés. Valeur par défaut : 0. |
|
BorderStyle |
Int |
Non |
Format de bordure et d'ombre portée du texte. Options disponibles : 1 (bordure + ombre), 3 (encadré de fond opaque). Valeur par défaut : 1. |
|
Outline |
Int |
Non |
Épaisseur du contour entourant le texte, en pixels. Valeur par défaut : 0. |
|
OutlineColour |
String |
Non |
Teinte du contour du texte, définie par un code couleur hexadécimal préfixé par #. Exemple : |
|
Shadow |
Int |
Non |
Profondeur de l'ombre projetée par le texte, exprimée en pixels. Valeur par défaut : 0. |
|
BackColour |
String |
Non |
Couleur de l'ombre du texte. Utilisez un code hexadécimal commençant par #. Exemple : |
|
Alignment |
String |
Non |
Point d'ancrage du texte dans la vidéo. Valeur par défaut :
Pour un positionnement précis selon le mode d'alignement choisi, configurez ce paramètre ainsi :
|
|
AdaptMode |
String |
Non |
Détermine le comportement d'adaptation lorsque le texte dépasse la largeur de la vidéo ou la valeur
|
|
TextWidth |
String |
Non |
Largeur de la zone de texte, utilisée uniquement si |
|
FontUrl |
String |
Non |
Chemin vers un fichier de police stocké dans votre bucket OSS pour le rendu des sous-titres. Formats acceptés : TTF, OTF et WOFF. Exemple : |
|
EffectColorStyle |
String |
Non |
Style WordArt appliqué au texte en bannière.Exemples d'effets WordArt. |
|
SubtitleEffects |
Non |
Effets multicouches applicables au texte en bannière. Permet d'ajouter plusieurs contours, ombres superposées, un flou gaussien ou un arrière-plan de sous-titre. Le flou gaussien fonctionne uniquement avec le type shadow. Remarque :
|
|
|
AaiMotionInEffect |
String |
Non |
Animation d'entrée du texte en bannière. Réservé aux sous-titres de type bannière.Exemples d'effets de sous-titres. |
|
AaiMotionIn |
Float |
Non |
Durée de l'animation d'entrée, en secondes (précision de 4 décimales). Par défaut : 0,5 s. Si le texte dure moins de 0,5 s, cette durée équivaut à la durée totale moins celle de l'animation de sortie. |
|
AaiMotionOutEffect |
String |
Non |
Animation de sortie du texte en bannière. Applicable uniquement aux sous-titres de type bannière.Exemples d'effets de sous-titres. |
|
AaiMotionOut |
Float |
Non |
Temps consacré à l'animation de sortie pour les textes en bannière, exprimé en secondes avec quatre décimales. À défaut, le système applique 0,5 s. Pour un texte plus court que 0,5 s, cette valeur couvre l'intégralité de sa durée d'affichage. |
|
AaiMotionLoopEffect |
String |
Non |
Effet d'animation en boucle pour le texte en bannière. Compatible uniquement avec ce type de sous-titre et incompatible avec les animations d'entrée ou de sortie.Exemples d'effets de sous-titres. |
|
Ratio |
Float |
Non |
Vitesse de lecture de l'effet en boucle pour les textes en bannière. Précision : 4 décimales. Défaut : 1. Une valeur supérieure accélère l'animation, tandis qu'une valeur inférieure la ralentit. |
|
TextureURL |
String |
Non |
URL d'une texture appliquée au sous-titre (type bannière uniquement). Formats supportés : PNG, JPG, JPEG, BMP. Seuls les fichiers hébergés sur OSS sont actuellement acceptés. Exemple : |
|
BubbleStyleId |
String |
Non |
Identifiant du style de bulle pour le texte en bannière. Réservé aux sous-titres de type bannière.Exemples de sous-titres en bulle. |
|
BubbleWidth |
Float |
Non |
Largeur de l'arrière-plan en bulle par rapport à la vidéo de sortie. Paramètre valide uniquement pour les sous-titres en bulle. Une valeur > 1 indique des pixels absolus ; ≤ 1 correspond à une proportion relative. |
|
BubbleHeight |
Float |
Non |
Hauteur de l'arrière-plan en bulle relativement à la vidéo de sortie. S'applique exclusivement aux sous-titres en bulle. Valeur > 1 = pixels absolus ; ≤ 1 = ratio relatif. |
Type d'effet : DeWatermark (masquage)
|
Nom |
Type |
Obligatoire |
Description |
|
X |
Float |
Non |
Distance horizontale entre le coin supérieur gauche de la zone floutée et celui de la vidéo de sortie. Accepte un pourcentage ou une valeur en pixels. L'intervalle [0, 0.9999] correspond à un ratio de la largeur vidéo ; un entier ≥ 2 définit une position absolue en pixels. Valeur par défaut : 0. |
|
Y |
Float |
Non |
Décalage vertical depuis le coin supérieur gauche de la vidéo jusqu'à la zone floutée. Peut être exprimé en pourcentage ou en pixels. Les valeurs de 0 à 0.9999 représentent une fraction de la hauteur vidéo ; un entier ≥ 2 correspond à des pixels absolus. Par défaut : 0. |
|
Width |
Float |
Oui |
Largeur de la zone masquée dans la vidéo finale. Saisissez un pourcentage ou une mesure en pixels. La plage [0, 0.9999] indique une proportion de la largeur vidéo, tandis qu'un entier ≥ 2 spécifie une dimension absolue. |
|
Height |
Float |
Oui |
Hauteur de la région floutée dans la vidéo de sortie. Format accepté : pourcentage ou pixels. Une valeur entre 0 et 0.9999 est un ratio de la hauteur vidéo ; ≥ 2 équivaut à une taille fixe en pixels. |
Type d'effet : Crop
Exemple de timeline :Recadrage vidéo.
|
Nom |
Type |
Obligatoire |
Description |
|
X |
Float |
Non |
Position horizontale du coin supérieur gauche de la zone conservée après recadrage, par rapport au coin supérieur gauche de la vidéo de sortie. Valeur en pourcentage ou en pixels. L'intervalle [0, 0.9999] représente une fraction de la largeur vidéo ; un entier ≥ 2 correspond à une coordonnée absolue. Défaut : 0. |
|
Y |
Float |
Non |
Ordonnée du coin supérieur gauche de la portion visible après découpe, mesurée depuis le coin supérieur gauche de la vidéo. Exprimable en pourcentage ou en pixels. La plage [0, 0.9999] correspond à un ratio de hauteur ; ≥ 2 indique une valeur absolue. Valeur par défaut : 0. |
|
Width |
Float |
Oui |
Dimension horizontale de la zone retenue dans la vidéo finale. Renseignez un pourcentage ou une valeur en pixels. Les nombres de 0 à 0.9999 sont interprétés comme une proportion de la largeur vidéo ; un entier ≥ 2 définit une largeur fixe. |
|
Height |
Float |
Oui |
Hauteur de la région conservée suite au recadrage. Accepte un ratio (0 à 0.9999 de la hauteur vidéo) ou une mesure absolue en pixels (entier ≥ 2). |
Type d'effet : Scale (mise à l'échelle)
Si le format du média diffère de celui de la vidéo cible et qu'aucun effet de mise à l'échelle n'est appliqué, le système adapte automatiquement le média à la largeur ou à la hauteur, le centre, puis comble les bandes restantes avec du noir.
Exemple de timeline :Configuration de la mise à l'échelle.
|
Nom |
Type |
Obligatoire |
Description |
|
Width |
Float |
Oui |
Largeur de la zone affichée après redimensionnement. Fournissez un pourcentage ou une valeur en pixels. La plage [0, 0.9999] correspond à une fraction de la largeur vidéo ; tout entier ≥ 1 représente une dimension absolue. |
|
Height |
Float |
Oui |
Hauteur résultante dans la vidéo de sortie après application de l'effet. Exprimable en pourcentage (0 à 0.9999 de la hauteur vidéo) ou en pixels absolus (entier ≥ 1). |
Type d'effet : Pad (remplissage)
En l'absence d'effet de remplissage explicite, un média dont le ratio ne correspond pas à la vidéo de sortie sera automatiquement ajusté à la largeur ou à la hauteur, centré, et les espaces vides seront remplis par des bandes noires.
Exemple de timeline :Conversion paysage vers portrait avec remplissage flouté.
|
Nom |
Type |
Obligatoire |
Description |
|
Left |
Float |
Non |
Marge gauche entre le média et le bord gauche de la vidéo de sortie. Accepte un pourcentage ou des pixels. Intervalle [0, 0.9999] = ratio de largeur vidéo ; entier ≥ 1 = valeur absolue. |
|
Right |
Float |
Non |
Espace réservé à droite du média jusqu'au bord droit de la vidéo. Format : pourcentage ou pixels. De 0 à 0.9999, il s'agit d'une proportion de la largeur ; ≥ 1 correspond à une marge fixe. |
|
Top |
Float |
Non |
Écart vertical entre le haut du média et le bord supérieur de la vidéo. Renseignez un ratio (0–0.9999 de la hauteur vidéo) ou une distance en pixels (≥ 1). |
|
Bottom |
Float |
Non |
Padding inférieur séparant le bas du média du bord inférieur de la vidéo. Valeur admise : pourcentage de la hauteur vidéo (0–0.9999) ou pixels absolus (≥ 1). |
|
Color |
String |
Non |
Teinte de remplissage des marges. Code hexadécimal préfixé par #. Exemple : |
Type d'effet : Background (paramètres d'arrière-plan)
Les options d'arrière-plan permettent d'appliquer un flou ou une couleur unie pour combler les zones vides lorsque les dimensions du média et de la vidéo diffèrent.
Compatible avec les effets Crop, Scale, VFX et Transition.
Exemple de timeline :Conversion paysage/portrait avec couleur d'arrière-plan personnalisée.
|
Nom |
Type |
Obligatoire |
Description |
|
SubType |
String |
Oui |
Variante de l'effet d'arrière-plan. Options :
|
|
Radius |
Float |
Non |
Rayon du flou appliqué. Paramètre actif uniquement lorsque |
|
Color |
String |
Non |
Code couleur RGB hexadécimal de l'arrière-plan. Utilisé seulement si |
Type d'effet : Transition
Cet effet de transition repose sur le chevauchement de deux clips, ce qui réduit la durée totale de la vidéo finale. Pour conserver la durée originale, privilégiez l'effet DLTransition décrit ci-après.
Une transition s'insère entre deux clips consécutifs et se configure uniquement sur le premier. Elle superpose la fin du clip 1 avec le début du clip 2, diminuant ainsi la longueur globale de la vidéo d'une durée équivalente à celle de la transition.
Prenons l'exemple d'une piste vidéo contenant Clip1 (10 s) et Clip2 (8 s). L'ajout d'une transition de 4 s ramène la durée totale de la piste à 14 s au lieu de 18 s.
Le tableau suivant présente les propriétés génériques des transitions. Pour consulter les effets spécifiques :Exemples d'effets de transition.
Exemple de timeline :Exemple de configuration de transition dans une timeline.
|
Nom |
Type |
Obligatoire |
Description |
|
SubType |
String |
Oui |
Sous-type de transition. Indiquez un ou plusieurs sous-types séparés par des virgules ; le système en sélectionnera un aléatoirement. Vous pouvez aussi utiliser |
|
Duration |
Float |
Non |
Longueur temporelle de la transition, en secondes, avec une précision de quatre décimales. Valeur par défaut : 1 s. |
Type d'effet : DLTransition (transition à durée verrouillée)
Contrairement à l'effet Transition classique, le Duration Lock Transition (DLTransition) préserve intégralement la durée de la vidéo finale en comblant la période de transition avec des images fixes.
Les paramètres de DLTransition sont identiques à ceux de Transition.
|
Nom |
Type |
Obligatoire |
Description |
|
SubType |
String |
Oui |
Variante de transition souhaitée. Listez un ou plusieurs sous-types séparés par des virgules pour une sélection aléatoire, ou utilisez |
|
Duration |
Float |
Non |
Temps alloué à la transition, exprimé en secondes (4 décimales). Par défaut : 1 s. |
Type d'effet : VFX
Exemple de timeline :VFX.
|
Nom |
Type |
Obligatoire |
Description |
|
SubType |
String |
Oui |
Sous-type de l'effet. Spécifiez un ou plusieurs sous-types d'effet, séparés par des virgules (,). Un sous-type est sélectionné aléatoirement dans la liste. Vous pouvez également spécifier |
|
X |
Float |
Non |
Ce champ n'est valide que lorsque Remarque : La valeur peut être exprimée en pourcentage ou en pixels. Une valeur comprise dans l'intervalle [0, 0,9999] correspond à un pourcentage de la largeur de la vidéo de sortie. Une valeur entière supérieure ou égale à 2 représente une valeur absolue en pixels. |
|
Y |
Float |
Non |
Ce champ n'est valide que lorsque Il indique la distance verticale entre la zone d'effet et le coin supérieur gauche de la vidéo de sortie. Remarque : La valeur peut être exprimée en pourcentage ou en pixels. Une valeur comprise dans l'intervalle [0, 0,9999] correspond à un pourcentage de la hauteur de la vidéo de sortie. Une valeur entière supérieure ou égale à 2 représente une valeur absolue en pixels. |
|
Width |
Float |
Non |
Ce champ n'est valide que lorsque |
|
Height |
Float |
Non |
Ce champ n'est valide que lorsque |
|
ExtParams |
String |
Non |
Paramètres étendus de l'effet. Ce champ s'applique uniquement aux scénarios de masquage, lorsque |
Exemples de masquage et effets obtenus :Effets de masquage.
Pour les paramètres de masque suivants, vous devez spécifier des valeurs décimales au format à virgule flottante, telles que 0,5 ou 2,0.
Paramètres des effets de masque circulaire
SubType=mask_circle
Description des paramètres ExtParams
|
Paramètre |
Type |
Plage de valeurs |
Valeur par défaut |
Description |
|
x |
float |
[0.0, material width] |
0.5 |
Coordonnée X du centre du masque par rapport au coin supérieur gauche du média source. Une valeur comprise dans l'intervalle [0.0, 1.0] représente une coordonnée relative à la largeur du média. Une valeur supérieure à 1.0 correspond à une valeur absolue en pixels. |
|
y |
float |
[0.0, material height] |
0.5 |
Coordonnée Y du centre du masque par rapport au coin supérieur gauche du média source. Une valeur comprise dans l'intervalle [0.0, 1.0] représente une coordonnée relative à la hauteur du média. Une valeur supérieure à 1.0 correspond à une valeur absolue en pixels. |
|
width |
float |
[0.0, material width] |
0.8 |
Largeur du masque elliptique par rapport à celle du média source. Une valeur comprise dans l'intervalle [0.0, 1.0] représente une largeur relative. Une valeur supérieure à 1.0 correspond à une valeur absolue en pixels. |
|
height |
float |
[0.0, material height] |
0.8 |
Hauteur du masque elliptique par rapport à celle du média source. Une valeur comprise dans l'intervalle [0.0, 1.0] représente une hauteur relative. Une valeur supérieure à 1.0 correspond à une valeur absolue en pixels. |
|
antialias |
float |
[0.0, 1.0] |
0.1 |
Paramètre d'anticrénelage du masque elliptique. Plus cette valeur est élevée, plus le flou appliqué aux contours est important. |
|
angle |
float |
[-9999.0, 9999.0] |
0.0 |
Angle de rotation. |
Paramètres des effets de masque rectangulaire
SubType=mask_rec
Description des paramètres ExtParams
|
Paramètre |
Type |
Plage de valeurs |
Valeur par défaut |
Description |
|
x |
float |
[0.0, material width] |
0.5 |
Coordonnée X du centre du masque rectangulaire dans le média vidéo, par rapport au coin supérieur gauche du média. Une valeur comprise dans l'intervalle [0.0, 1.0] représente une coordonnée relative à la largeur du média. Une valeur supérieure à 1.0 correspond à une valeur absolue en pixels. |
|
y |
float |
[0.0, material height] |
0.5 |
Coordonnée Y du centre du masque rectangulaire dans le média vidéo, par rapport au coin supérieur gauche du média. Une valeur comprise dans l'intervalle [0.0, 1.0] représente une coordonnée relative à la hauteur du média. Une valeur supérieure à 1.0 correspond à une valeur absolue en pixels. |
|
width |
float |
[0.0, material width] |
0.8 |
Largeur du masque rectangulaire. Une valeur comprise dans l'intervalle [0.0, 1.0] représente une largeur relative à celle du média. Une valeur supérieure à 1.0 correspond à une valeur absolue en pixels. |
|
height |
float |
[0.0, material height] |
0.8 |
Hauteur du masque rectangulaire. Une valeur comprise dans l'intervalle [0.0, 1.0] représente une hauteur relative à celle du média. Une valeur supérieure à 1.0 correspond à une valeur absolue en pixels. |
|
antialias |
float |
[0.0, 1.0] |
0.1 |
Paramètre d'anticrénelage du masque rectangulaire. Plus cette valeur est élevée, plus le flou appliqué aux contours est important. |
|
radius |
float |
[0.0, the larger of the material's width or height] |
0.1 |
Rayon des coins du masque rectangulaire. Une valeur comprise dans l'intervalle [0.0, 1.0] représente un rayon relatif à la plus grande dimension (largeur ou hauteur) du média. Une valeur supérieure à 1.0 correspond à une valeur absolue en pixels. |
|
angle |
float |
[-9999.0, 9999.0] |
0.0 |
Angle de rotation. |
Paramètres des effets de masque linéaire
SubType=mask_linear
Description des paramètres ExtParams
|
Paramètre |
Type |
Plage de valeurs |
Valeur par défaut |
Description |
|
x |
float |
[0.0, material width] |
0.5 |
Coordonnée X du point de référence central du masque linéaire, par rapport au coin supérieur gauche du média. Une valeur comprise dans l'intervalle [0.0, 1.0] représente une coordonnée relative à la largeur du média. Une valeur supérieure à 1.0 correspond à une valeur absolue en pixels. |
|
y |
float |
[0.0, material height] |
0.5 |
Coordonnée Y du point de référence central du masque linéaire dans le média vidéo, par rapport au coin supérieur gauche de la vidéo. Une valeur comprise dans l'intervalle [0.0, 1.0] représente une coordonnée relative à la largeur du média. Une valeur supérieure à 1.0 correspond à une valeur absolue en pixels. |
|
antialias |
float |
[0.0, 1.0] |
0.1 |
Paramètre d'anticrénelage du masque linéaire. Plus cette valeur est élevée, plus le flou appliqué aux contours est important. |
|
angle |
float |
[-9999.0, 9999.0] |
0.0 |
Angle de rotation. |
Paramètres des effets de masque miroir
SubType=mask_minor
Description des paramètres ExtParams
|
Paramètre |
Type |
Plage de valeurs |
Valeur par défaut |
Description |
|
x |
float |
[0.0, material width] |
0.5 |
Coordonnée X du point de référence central du masque miroir, par rapport au coin supérieur gauche du média. Une valeur comprise dans l'intervalle [0.0, 1.0] représente une coordonnée relative à la largeur du média. Une valeur supérieure à 1.0 correspond à une valeur absolue en pixels. |
|
y |
float |
[0.0, material height] |
0.5 |
Coordonnée Y du point de référence central du masque miroir, par rapport au coin supérieur gauche du média. Une valeur comprise dans l'intervalle [0.0, 1.0] représente une coordonnée relative à la hauteur du média. Une valeur supérieure à 1.0 correspond à une valeur absolue en pixels. |
|
antialias |
float |
[0.0, 1.0] |
0.1 |
Paramètre d'anticrénelage du masque miroir. Plus cette valeur est élevée, plus le flou appliqué aux contours est important. |
|
angle |
float |
[-9999.0, 9999.0] |
0.0 |
Angle de rotation. |
Type d'effet : Filter
Exemple de timeline :Filter.
|
Nom |
Type |
Obligatoire |
Description |
|
SubType |
String |
Oui |
Sous-type du filtre. Spécifiez un ou plusieurs sous-types de filtre, séparés par des virgules (,). Un sous-type est sélectionné aléatoirement dans la liste. Vous pouvez également spécifier |
|
TimelineIn |
Float |
Non |
Moment où le filtre est appliqué sur la timeline. Unité : secondes. La valeur est précise jusqu'à quatre décimales. Si ce paramètre n'est pas spécifié, la valeur |
|
TimelineOut |
Float |
Non |
Moment où le filtre est retiré de la timeline. Unité : secondes. La valeur est précise jusqu'à quatre décimales. Si ce paramètre n'est pas spécifié, la valeur |
|
ExtParams |
String |
Non |
Paramètres étendus du filtre. Ce champ n'est valide que lorsque |
Paramètres ExtParams du filtre colorimétrique
Exemple de timeline :Utiliser des filtres colorimétriques.
Description des paramètres ExtParams
|
Paramètre |
Type |
Plage de valeurs |
Description |
Valeur par défaut |
|
brightness |
int |
[-255,255] |
Luminosité |
0 |
|
contrast |
int |
[-100,100] |
Contraste |
0 |
|
saturation |
int |
[-100,100] |
Saturation |
0 |
|
kelvin_temperature |
int |
[1000,40000] |
Température de couleur. Ce paramètre fonctionne conjointement avec le paramètre temperature_ratio. |
6000 |
|
temperature_ratio |
int |
[0,100] |
Ratio de température. |
0 |
|
tint |
int |
[-100,100] |
Teinte |
0 |
|
dark_corner_ratio |
int |
[0,100] |
Ratio de vignettage. |
0 |
Type d'effet : Volume (ajustement du volume)
Exemples de timeline :Couper le son d'une vidéo entière et Ajuster le volume vidéo et audio.
|
Nom |
Type |
Obligatoire |
Description |
|
Gain |
Float |
Non |
Gain du volume. Plage : [0, 10]. 0 = muet, 1 = volume original, inférieur à 1 = plus faible, supérieur à 1 = plus fort. Valeur par défaut : 1. Des valeurs excessivement élevées peuvent provoquer une distorsion. |
Type d'effet : AFade (fondu audio)
Exemple de timeline :Configurer le fondu entrant et sortant pour les clips audio uniquement et l'audio des vidéos.
|
Nom |
Type |
Obligatoire |
Description |
|
SubType |
String |
Oui |
Sous-type du fondu audio. Valeurs valides :
|
|
Duration |
Float |
Non |
Durée du fondu. Un fondu entrant s'applique au début du clip, tandis qu'un fondu sortant s'applique à la fin. La valeur par défaut est 0, ce qui désactive l'effet. |
|
Curve |
String |
Non |
Courbe de volume pour le fondu audio. La valeur par défaut est Valeurs valides :
|
Type d'effet : AI_ASR (reconnaissance vocale)
Cet effet génère des sous-titres à partir de l'audio. Vous pouvez placer cet effet dans l'objet Effects d'une piste vidéo ou audio. Les paramètres sont identiques à ceux décrits dans la section Type d'effet : Text (texte superposé). Par défaut, les sous-titres sont centrés en bas de la vidéo. Cette fonctionnalité est disponible uniquement dans les régions Chine (Pékin), Chine (Shanghai) et Chine (Hangzhou).
|
Nom |
Type |
Obligatoire |
Description |
|
X |
Float |
Non |
Distance horizontale entre le coin supérieur gauche du texte superposé et le coin supérieur gauche de la vidéo de sortie. La valeur peut être exprimée en pourcentage ou en pixels. Une valeur comprise dans l'intervalle [0, 0,9999] correspond à un pourcentage de la largeur de la vidéo de sortie. Une valeur entière supérieure ou égale à 2 représente une valeur absolue en pixels. |
|
Y |
Float |
Non |
Distance verticale entre le coin supérieur gauche du texte superposé et le coin supérieur gauche de la vidéo de sortie. La valeur peut être exprimée en pourcentage ou en pixels. Une valeur comprise dans l'intervalle [0, 0,9999] correspond à un pourcentage de la hauteur de la vidéo de sortie. Une valeur entière supérieure ou égale à 2 représente une valeur absolue en pixels. |
|
Font |
String |
Non |
Police du texte superposé. Polices prises en charge :Liste des polices. Valeur par défaut : SimSun. |
|
FontSize |
Int |
Oui |
Taille de police du texte superposé. |
|
FontColor |
String |
Non |
Couleur du texte superposé. La valeur est un code couleur hexadécimal commençant par un dièse (#). Exemple : |
|
FontColorOpacity |
String |
Non |
Opacité du texte superposé. Plage : [0, 1]. 1 = opaque, 0 = totalement transparent. Valeur par défaut : 1. |
|
FontFace |
FontFace |
Non |
Style de police du texte superposé. |
|
NeedHighlighting |
Boolean |
Non |
Indique si le surlignage automatique des sous-titres ASR doit être activé. |
|
HighlightingStyle |
Non |
Style appliqué aux sous-titres surlignés. |
Type d'effet : Rotate (rotation du média)
Cet effet fait pivoter un média selon un angle spécifié. Seuls les angles de 90, 180 et 270 degrés sont pris en charge. Il s'applique aux médias situés sur des pistes vidéo ou image.
Exemple de timeline :Rotation du média.
|
Nom |
Type |
Obligatoire |
Description |
|
Degree |
Integer |
Oui |
Angle de rotation horaire du média. Seuls les angles de 90, 180 et 270 degrés sont pris en charge. |
Type d'effet : AI_Matting (incrustation sur fond vert)
Cet effet extrait un sujet d'un arrière-plan vert ou bleu pour le superposer à une autre vidéo ou image d'arrière-plan. Cette fonctionnalité est disponible uniquement dans les régions Chine (Pékin), Chine (Shanghai) et Chine (Hangzhou).
|
Nom |
Type |
Obligatoire |
Description |
|
Color |
String |
Oui |
Couleur d'arrière-plan à supprimer. Seules les valeurs |
|
Auto |
Integer |
Oui |
Indique si la couleur d'arrière-plan doit être détectée automatiquement. Valeurs valides :
|
|
Thres |
Float |
Non |
Seuil de détection de la couleur d'arrière-plan. Une valeur plus élevée rend la détection moins stricte. La valeur doit se situer dans l'intervalle [0, 10]. |
Type d'effet : AI_RealMatting (incrustation en environnement réel)
Cet effet extrait une personne d'une scène réelle dans une vidéo pour la superposer à une autre vidéo ou image d'arrière-plan. Cette fonctionnalité est disponible uniquement dans les régions Chine (Pékin), Chine (Shanghai) et Chine (Hangzhou).
|
Nom |
Type |
Obligatoire |
Description |
|
Thres |
Float |
Non |
Seuil de détection de la couleur d'arrière-plan. Une valeur plus élevée rend la détection moins stricte. La valeur doit se situer dans l'intervalle [0, 10]. La valeur par défaut est 2. |
Type d'effet : AI_Delogo (suppression intelligente de logo)
Cet effet reconnaît et supprime intelligemment les logos présents dans les vidéos. Cette fonctionnalité est disponible uniquement dans les régions Chine (Pékin) et Chine (Shanghai).
Type d'effet : Clip (clip aléatoire)
Cet effet prélève aléatoirement un segment du média source pour l'ajouter à la timeline.
|
Nom |
Type |
Obligatoire |
Description |
|
SubType |
String |
Oui |
Type de découpage. Seul le découpage aléatoire est pris en charge : |
|
ClipDuration |
Float |
Oui |
Durée du segment découpé. |
Type d'effet : Flip
Vous pouvez retourner les vidéos ou images d'une piste vidéo horizontalement ou verticalement.
Exemple de timeline :Retournement horizontal et vertical.
|
Nom |
Type |
Obligatoire |
Description |
|
Direction |
String |
Oui |
|
Type d'effet : KenBurns (effet Ken Burns)
Cet effet applique un effet Ken Burns à une vidéo ou une image située sur une piste vidéo.
Limites :
Cet effet s'applique aux images et aux vidéos. Il est compatible avec les effets visuels, les filtres et les transitions.
Puisque cet effet permet de définir la largeur et la hauteur du cadre de sortie via les paramètres
WindowWetWindowH, il est incompatible avec les effetsCrop,Scale,PadouBackground.
|
Nom |
Type |
Obligatoire |
Description |
Exemple |
|
|
Duration |
Float |
Non |
Durée de l'effet. La valeur par défaut correspond à la durée du clip. La valeur maximale est de 10. Unité : secondes (s). |
5 |
|
|
WindowW |
Float |
Non |
Largeur du clip. Par défaut, cette valeur est égale à la largeur de la vidéo de sortie. Unité : pixels. Une valeur comprise dans l'intervalle |
1 |
|
|
WindowH |
Float |
Non |
Hauteur du clip. Par défaut, cette valeur correspond à la hauteur de la vidéo de sortie. Unité : pixels. Si la valeur de WindowH se situe dans l'intervalle (0,1], il s'agit d'une valeur relative. > Une valeur de 1 indique une valeur absolue. |
1 |
|
|
Start |
String |
Non |
Position de la zone d'effet avant l'application de l'effet Ken Burns. Cette position est définie par les coordonnées x et y du coin supérieur gauche ainsi que par la largeur et la hauteur de la zone d'effet. Ces paramètres sont facultatifs. Les valeurs doivent être séparées par des virgules (,). "StartX, StartY, StartW, StartH" Limites : 0 < StartX + StartW <=1 0 < StartY + StartH <=1 |
"0,0,0.9,0.9" |
|
|
StartX |
Float |
Non |
Coordonnée x du coin supérieur gauche de la zone d'effet avant l'application de l'effet Ken Burns. Unité : pixels. Si la valeur du paramètre StartX se situe dans l'intervalle [0,1), il s'agit d'une valeur relative. Une valeur supérieure ou égale à 1 indique une valeur absolue. |
0 |
|
|
StartY |
Float |
Non |
Coordonnée y du coin supérieur gauche de la zone d'effet avant l'application de l'effet Ken Burns. Unité : pixels. Si la valeur du paramètre StartY se situe dans l'intervalle [0,1), il s'agit d'une valeur relative. La valeur absolue doit être supérieure ou égale à 1. |
0 |
|
|
StartW |
Float |
Non |
Largeur de la zone d'effet avant l'application de l'effet Ken Burns. Unité : pixels. Si la valeur du paramètre StartW se situe dans l'intervalle (0,1], il s'agit d'une valeur relative. > Une valeur de 1 indique une valeur absolue. |
0.9 |
|
|
StartH |
Float |
Non |
Hauteur de la zone d'effet avant l'application de l'effet Ken Burns. Unité : pixels. Si la valeur du paramètre StartH se situe dans l'intervalle (0,1], il s'agit d'une valeur relative. > Une valeur supérieure à 1 indique une valeur absolue. |
0.9 |
|
|
End |
String |
Non |
Position de la zone d'effet après l'application de l'effet Ken Burns. Cette position est définie par les coordonnées x et y du coin supérieur gauche ainsi que par la largeur et la hauteur de la zone d'effet. Ces paramètres sont facultatifs. Les valeurs doivent être séparées par des virgules (,). "EndX, EndY, EndW, EndH" Limites : 0 < EndX + EndW <=1 0 < EndY + EndH <=1 |
"0,0,1,1" |
|
|
EndX |
Float |
Non |
Coordonnée x du coin supérieur gauche de la zone d'effet après l'application de l'effet Ken Burns. Unité : pixels. Si la valeur du paramètre StartX se situe dans l'intervalle [0,1), il s'agit d'une valeur relative. La valeur absolue doit être supérieure ou égale à 1. |
0 |
|
|
EndY |
Float |
Non |
Coordonnée y du coin supérieur gauche de la zone d'effet après l'application de l'effet Ken Burns. Unité : pixels. Si la valeur du paramètre StartY se situe dans l'intervalle [0,1), il s'agit d'une valeur relative. La valeur absolue doit être supérieure ou égale à 1. |
0 |
|
|
EndW |
Float |
Non |
Largeur de la zone d'effet après l'application de l'effet Ken Burns. Unité : pixels. Si la valeur du paramètre StartW se situe dans l'intervalle (0,1], il s'agit d'une valeur relative. > Une valeur de 1 indique une valeur absolue. |
1 |
|
|
EndH |
Float |
Non |
Hauteur de la zone d'effet après l'application de l'effet Ken Burns. Unité : pixels. Si la valeur du paramètre StartH se situe dans l'intervalle (0,1], il s'agit d'une valeur relative. > Une valeur supérieure à 1 spécifie une valeur absolue. |
1 |
|
Type d'effet : ADenoise (réduction du bruit audio)
Vous pouvez appliquer cet effet aux vidéos contenant de l'audio sur une piste vidéo, ou aux clips audio sur une piste audio.
|
Nom |
Type |
Obligatoire |
Description |
|
Mode |
Integer |
Non |
|
Type d'effet : Zoom
Cet effet ajoute un zoom au clip correspondant.
Cet effet est pris en charge uniquement pour les clips d'une VideoTrack.
|
Nom |
Type |
Obligatoire |
Description |
|
StartRate |
Float |
Non |
|
|
EndRate |
Float |
Non |
|
|
Duration |
Float |
Non |
|
Type d'effet : Harmonization (harmonisation de l'arrière-plan)
Cet effet applique une harmonisation de l'arrière-plan au clip correspondant et est principalement destiné aux clips vidéo d'humains numériques. Lorsqu'il est appliqué à un clip d'humain numérique, l'éclairage, la luminosité et la température des couleurs du clip sont ajustés pour correspondre à l'image d'arrière-plan. Cela réduit les incohérences visuelles entre le clip d'humain numérique et l'arrière-plan.
Cet effet est pris en charge uniquement pour les clips d'une
VideoTrack.Vous ne pouvez ajouter qu'un seul effet d'harmonisation par requête de montage vidéo.
Aucun autre paramètre d'entrée n'est requis pour cet effet.
Type d'effet : ALoudNorm (normalisation du volume)
L'effet ALoudNorm s'applique à un seul fichier audio ou vidéo. Si vous disposez de plusieurs fichiers audio ou vidéo et souhaitez qu'ils partagent le même niveau sonore, vous devez configurer ALoudNorm séparément sur chaque fichier.
Cet effet s'applique uniquement aux clips audio et vidéo. Si ALoudNorm est utilisé conjointement avec ADenoise ou Volume, les effets sont appliqués dans l'ordre suivant : ADenoise > Volume > ALoudNorm.
Exemple de timeline :Normalisation du volume.
|
Nom |
Type |
Obligatoire |
Description |
|
Loudness |
Float |
Non |
Niveau sonore cible qui détermine le volume et respecte la norme EBU R128. Plage de valeurs : [-70.0, -5.0]. Valeur par défaut : -24.0. |
|
TruePeak |
Float |
Non |
Niveau de crête réel qui limite le niveau de crête maximal du signal audio. Plage de valeurs : [-9.0, +0.0]. Valeur par défaut : -2.0. |
Type d'effet : AEqualize (égalisation du volume)
Il s'agit d'un effet global qui s'applique à la piste d'effets. Il applique une égalisation uniforme du volume au mixage audio final.
Cet effet est global et ne peut pas être appliqué à un seul clip.
Exemple de timeline :Égalisation du volume.
|
Nom |
Type |
Obligatoire |
Description |
|
Peak |
Float |
Non |
Niveau de crête cible de l'audio. La valeur par défaut est 0.95. Ne dépassez pas cette valeur. La valeur doit se situer dans l'intervalle ouvert (0, 1). |
|
Gain |
Float |
Non |
Coefficient de gain maximal. La valeur doit se situer dans la plage [1.0, 100.0]. La valeur par défaut est 10.0. Le normalisateur audio dynamique détermine le facteur de gain maximal possible (local) pour chaque trame d'entrée afin d'éviter tout écrêtage ou distorsion. |
Type d'effet : FreezeFrame (arrêt sur image)
Cet effet s'applique aux contenus vidéo sur une piste vidéo et crée un arrêt sur image à partir de la dernière trame de la vidéo.
Cet effet s'applique uniquement aux contenus vidéo sur une piste vidéo. Il ne fonctionne ni sur les images fixes d'une piste vidéo, ni sur les contenus d'une piste audio.
Cet effet est incompatible avec l'effet Type d'effet : Transition.
Exemple de timeline :Arrêt sur image vidéo.
|
Nom |
Type |
Obligatoire |
Description |
|
Duration |
Float |
Non |
Durée de l'arrêt sur image. La valeur par défaut est 0. Unité : secondes (s). |