Syntaxe avisynth - Revision history

Admin: Undo revision 3131 by MarcelProut (talk) - spam

2014-03-02T22:16:12Z

Undo revision 3131 by MarcelProut (talk) - spam

MarcelProut at 16:58, 2 March 2014

2014-03-02T16:58:58Z

Admin: 6 revisions

2013-07-18T19:48:25Z

6 revisions

Wilbert at 19:50, 17 July 2013

2013-07-17T19:50:09Z

Admin: 1 revision

2013-05-09T21:33:34Z

1 revision

Manusse at 20:01, 1 July 2008

2008-07-01T20:01:23Z

New page

La syntaxe d'une ligne de commande d'un script AviSynth peut se présenter sous l'une de ces trois formes :

# ''nom_de_la_variable'' = ''expression''
# ''expression''
# '''return''' ''expression''

Dans le premier cas, ''expression'' est exécuté et le résultat de l'expression est assigné à ''nom_de_la_variable''. Dans le second cas ''expression'' est exécuté et le résultat est assigné à la variable spéciale '''last'''. En fin dans le troisième cas, ''expression'' est évalué et le résultat de ''expression'' est la valeur du bloc courant (que le bloc en question soit une fonction ou le script en lui même) qui sera retournée. Dans le cas ou la valeur retournée est celle du script, la valeur retournée sera typiquement le clip vidéo envoyé à l'application qui ouvre le script AviSynth.

La plupart du temps, le résultat d'une expression sera un clip vidéo; Cependant AviSynth supporte plusieurs types de valeurs (clip, entiers / int, flottant / float, booléen / bool et chaîne de caractère / string ) qui peuvent être traitées par les [[Internal_functions|fonctions internes]] d'AviSynth.

Une ''expression'' peut se présenter sous l'une de ces formes :

# ''constante_numérique'' ou ''constante_string''
# ''nom_de_variable'' ou ''propriété_du_clip''
# ''Fonction''(''argument'')
# ''expression''.''Fonction''(''argument'')
# ''expression1'' '''opérateur''' ''expression2''
# ''expression_booléenne'' ? ''expression1'' : ''expression2''

Dans le premier cas, la valeur d'''expression'' prend la valeur de la constante.
Dans le second cas, ''expression'' prend la valeur correspondante à une [[Clip_properties|propriété du clip]] ou d'une variable (dont la valeur doit avoir été préalablement définie).
Dans le troisième cas, ''expression'' prend la valeur retournée par la fonction (voir ci-dessous).
Le quatrième cas est une alternative à la forme ''fonction''(''expression'',''argument'').

Les deux derniers cas montrent la syntaxe employée pour effectuer une opération arithmétique ou logique (via des [[opérateurs]] dérivés du langage C) :
Le premier permet de manipuler int, float, variable générique (val) ou booléen (voir [[Script variables]]).
Le second permet de mettre en place des actions conditionnelles.

A noter que le caractère '+' peut être aussi utilisé pour concaténer des chaînes de caractères ou pour assembler des vidéos : '''a + b''' est équivalent à [[Splice|UnalignedSplice]](''a'', ''b'') tandis que '''a ++ b''' est équivalent à [[Splice|AlignedSplice]](''a'', ''b'').

La majeure partie des fonctions utilisées dans AviSynth sont des filtres vidéo. Cependant une fonction peut retourner tout type de variable (ce qui peut être utile dans le cas de scripting de fonction complexe - voir [[User_defined_script_functions|script functions]]). Il faut cependant noter que la dernière fonction d'un script doit retourner un ''clip'' comme variable finale.

Une fonction peut avoir jusqu'à 60 arguments (vous en aurez assez ?), et la valeur retournée peut être de n'importe quel type supporté par AviSynth (clip, int, float, bool, string).

Pour connaître la syntaxe d'appel des différentes fonctions intégrées à AviSynth, reportez vous à la page détaillant les[[Filtres_internes| filtres internes]]. Pour les fonctions opérant sur des variables autres que ''clip'' voyez la page des [Internal_functions|fonctions internes]].

Les ''Arguments'' sont les paramètres appliqués à la fonction; chaque argument est séparé par une virgule. Un argument doit être de type ''string'', ''int'',, ''float'', ''bool'' ou ''clip''. Cependant une fonction peut très bien ne pas avoir d'argument déclaré. Si une fonction attend un ''clip'' comme premier argument mais que celui-ci n'est spécifié, la fonction utilisera la variable spéciale ''last''.

Les filtres AviSynth peuvent avoir des arguments nommés ou non. Les arguments nommés rendent en général les filtres plus faciles à paramétrer. En effet on peut spécifier les arguments dans l'ordre que l'on souhaite, et ce sans avoir à spécifier chacun des paramètres de la fonction (si un argument n'est pas spécifié, le filtre choisira la valeur par défaut).
Par exemple, vous pouvez écrire '''[[Subtitle]]("Hello, World!", text_color=$00FF00, x=100, y=200)''' au lieu de '''[[Subtitle]]("Hello, World!", 100, 200, 0, 999999, "Arial", 24, $00FF00)'''. La [[Colors|couleur]] peut être spécifiée en hexadécimal comme ci-dessus ou en décimal. Dans les deux cas vous devez donner la couleur en format RVB même si votre clip est en YUV.

Il est aussi possible d'appeler une fonction sans utiliser de parenthèse : '''NomDuFiltre''' ''argument1'', ''argument2'' afin d'assurer une compatibilité avec vieux script créés pour de vieilles versions d'AviSynth. Je ne vous conseille pas d'utiliser cette syntaxe à moins que vous ayez une bonne raison de le faire.

Voyons maintenant les marqueurs de commentaires : Avisynth ignore tout ce qui se trouve derrière le caractère # et ce jusqu'à la fin de la ligne. On se sert donc de ce caractère pour commenter les scripts.

<pre># commentaires blah blah</pre>

La version v2.58 introduit de nouveaux types de commentaires : les commentaires en bloc et les commentaires en bloc "emboîtables". Voici comment les utiliser:

# commentaire en bloc :
/*
commentaire 1
commentaire 2
*/

# commentaire en bloc emboité:
[* [* un exemple concret viendra plus tard :) *] *]

Avisynth ignore également tout texte qui se trouve après la commande <nowiki>__END__</nowiki> (avec un double underscore)) .
Cela peut être utiliser pour tronquer la fin d'un script.

Avisynth ne prend pas en compte la casse des caractères : "aViSouRCe" est traité de la même façon qu' "AVISource" par AviSynth.

Il est également possible d'enchaîner les déclarations sur une seule ligne (voir cas numéro 4 ci-dessus) :

[[AviSource]]("c:\video.avi").[[Trim]](0, 499)
-or-
[[AudioDub]](AviSource("c:\video.avi"), [[AviSource|WavSource]]("c:\audio.wav"))

Avisynth per met également d'écrire une déclaration sur plusieurs lignes en utilisant un backslash ("\") soit à la fin de la première ligne de déclaration soit au début de la ligne suivante de déclaration.

Un exemple (les deux syntaxes sont valides :

Subtitle("Hello, World!", 100, 200, 0, \
999999, "Arial", 24, $00FF00)

-ou-

Subtitle("Hello, World!", 100, 200, 0,
\ 999999, "Arial", 24, $00FF00)

Faites attention lorsque vous utilisez les commentaires en même temps que les déclarations sur plusieurs lignes... Cela peut conduire à des bugs difficiles à déceler :

Voici un exemple du genre de bug que l'on peut rencontrer :

[[ColorBars]]
[[ShowFrameNumber]]
Trim(0,9) # sélectionne un certain nbre de frames \
+Trim(20,29)

L'exemple ci-dessus ne renvoie pas les frames [0..9,20..29] car le caractère "\" est masqué par le marqueur de commentaire "#"

[[Category:AviSynth_Syntax]]

Reuf Toc at 17:29, 16 February 2008

2008-02-16T17:29:58Z

Reuf Toc at 17:24, 16 February 2008

2008-02-16T17:24:28Z

Reuf Toc at 17:23, 16 February 2008

2008-02-16T17:23:18Z

Reuf Toc at 17:21, 16 February 2008

2008-02-16T17:21:45Z

@@ Line 18: / Line 18: @@
 # ''expression_booléenne'' ? ''expression1'' : ''expression2''
-Dans le premier cas, la valeur d'''expression'' prend la valeur de la constante.  Dans le second cas, ''expression'' prend la valeur correspondante à une [[Clip_properties|propriété du clip]] ou d'une variable (dont la valeur doit avoir été préalablement définie).  Dans le troisième cas, ''expression'' prend la valeur retournée par la fonction (voir ci-dessous).  Le quatrième cas est une alternative à la forme ''fonction''(''expression'',''argument'').
+Dans le premier cas, la valeur d'''expression'' prend la valeur de la constante.
-Les deux derniers cas montrent la syntaxe employée pour effectuer une opération arithmétique ou logique (via des [[operators|opérateurs]] dérivés du langage C). Le premier permet de manipuler int, float, variable générique (val - voir [[Script variables]]) ou booléen. Le second permet de mettre en place des actions conditionnelles. Les chaînes de caractères peuvent être concaténées avec '+'. L'opérateur '+' peut être aussi utilisé pour assembler des vidéos : '''a + b''' est équivalent à  [[Splice|UnalignedSplice]](''a'', ''b'') tandis que '''a ++ b''' est équivalent à  [[Splice|AlignedSplice]](''a'', ''b'').
+Les deux derniers cas montrent la syntaxe employée pour effectuer une opération arithmétique ou logique (via des [[operators|opérateurs]] dérivés du langage C) :
 La majeure partie des fonctions utilisées dans AviSynth sont des filtres vidéo. Cependant une fonction peut retourner tout type de variable (ce qui peut être utile dans le cas de scripting de fonction complexe - voir [[User_defined_script_functions|script functions]]). Il faut cependant noter que la dernière fonction d'un script doit retourner un ''clip'' comme variable finale.
-Une fonction peut avoir jusqu'à 60 arguments (vous en aurez assez?), et la valeur retournée  peut être de n'importe quel type supporté par AviSynth (clip, int, float, bool, string). Functions can take up to sixty arguments (hope that's enough), and the return value can be of any type supported by the scripting language (clip, int, float, bool, string). Functions always produce a new value and never modify an existing one. What that means is that all arguments to a function are passed "by value" and not "by reference"; in order to alter a variable's value in AviSynth script language you must assign to it a new value.
+Une fonction peut avoir jusqu'à 60 arguments (vous en aurez assez ?), et la valeur retournée  peut être de n'importe quel type supporté par AviSynth (clip, int, float, bool, string).
-''Args'' is a list of function arguments separated by commas. The list can be empty. Each argument must be a text string, an integer, a floating-point number, a boolean value or a video clip (that is, an ''expression''). If the filter function expects a video clip as its first argument, and that argument is not supplied, then the clip in the special last variable will be used.
+Pour connaître la syntaxe d'appel des différentes fonctions intégrées à AviSynth, reportez vous à la page détaillant les[[Filtres_internes| filtres internes]]. Pour les fonctions opérant sur des variables autres que ''clip'' voyez la page des [Internal_functions|fonctions internes]].
-AviSynth filters can take named arguments. The named arguments can be specified in any order, and the filter will choose default values for any that you leave off. This makes certain filters much easier to use. For example, you can now write '''[[Subtitle]]("Hello, World!", text_color=$00FF00, x=100, y=200)''' instead of '''[[Subtitle]]("Hello, World!", 100, 200, 0, 999999, "Arial", 24, $00FF00)'''. [[Colors]] can be specified in hexadecimal as in the example above or in decimal. In both cases it should be specified as RGB value, even if the clip itself is YUV.
+Les ''Arguments'' sont les paramètres appliqués à la fonction; chaque argument est séparé par une virgule. Un argument doit être de type ''string'', ''int'',, ''float'', ''bool'' ou ''clip''. Cependant une fonction peut très bien ne pas avoir d'argument déclaré. Si une fonction attend un ''clip'' comme premier argument mais que celui-ci n'est spécifié, la fonction utilisera la variable spéciale ''last''.
-You can also make function calls without parentheses, e.g. '''FilterName''' ''arg1'', ''arg2''. The primary reason for this is to retain compatibility with old scripts. However, it's sometimes convenient to leave off the parentheses when there's no possibility of confusion.
+Les filtres AviSynth peuvent avoir des arguments nommés ou non. Les arguments nommés rendent en général les filtres plus faciles à paramétrer. En effet on peut spécifier les arguments dans l'ordre que l'on souhaite, et ce sans avoir à spécifier chacun des paramètres de la fonction (si un argument n'est pas spécifié, le filtre choisira la valeur par défaut).
-Avisynth ignores anything from a # character to the end of that line. This can be used to add '''comments''' to a script.
+Il est aussi possible d'appeler une fonction sans utiliser de parenthèse : '''NomDuFiltre''' ''argument1'', ''argument2'' afin d'assurer une compatibilité avec vieux script créés pour de vieilles versions d'AviSynth. Je ne vous conseille pas d'utiliser cette syntaxe à moins que vous ayez une bonne raison de l'utiliser.
-<pre># comment</pre>
-In v2.58 it is possible to add '''block''' and '''nested block''' comments in the following way:
+Voyons maintenant les marqueurs de commentaires : Avisynth ignore tout ce qui se trouve derrière le caractère # et ce jusqu'à la fin de la ligne. On se sert donc de ce caractère pour commenter les scripts.
- # block comment:
+<pre># commentaires blah blah</pre>
   /*
-  comment 1
+  commentaire 1
-  comment 2
+  commentaire 2
   */
-  # nested block comments:
+  # commentaire en bloc emboité:
-  [* [* a meaningful example will follow later :) *] *]
+  [* [* un exemple concret viendra plus tard :) *] *]
-Avisynth '''ignores case''': aViSouRCe is just as good as AVISource.
+Avisynth ne prend pas en compte la casse des caractères : "aViSouRCe" est traité de la même façon qu' "AVISource" par AviSynth.
-Multiple Avisynth statements on a single line can only be achieved in the context of OOP notation or embedding filters as parameters of another function such as:
+Il est également possible d'enchaîner les déclarations sur une seule ligne (voir cas numéro 4 ci-dessus) :
   [[AviSource]]("c:\video.avi").[[Trim]](0, 499)
@@ Line 64: / Line 70: @@
   [[AudioDub]](AviSource("c:\video.avi"), [[AviSource|WavSource]]("c:\audio.wav"))
-Avisynth statements can be split across multiple lines by placing a backslash ("\") either as the last non-space character of the line being extended, or as the first non-space character on the next line.
+Avisynth per met également d'écrire une déclaration sur plusieurs lignes en utilisant un backslash ("\") soit à la fin de la première ligne de déclaration soit au début de la ligne suivante de déclaration.
-Line splitting examples (both valid and equal):
+Un exemple (les deux syntaxes sont valides :
   Subtitle("Hello, World!", 100, 200, 0, \
 , "Arial", 24, $00FF00)
--or-
+-ou-
   Subtitle("Hello, World!", 100, 200, 0,
       \ 999999, "Arial", 24, $00FF00)
-When splitting accross multiple lines you may ''place comments only at the end of the last line''. Mixing comments with backslashes at an intermediate line of the line-split will either produce an error message or result at hard to trace bugs.
+Faites attention lorsque vous utilisez les commentaires en même temps que les déclarations sur plusieurs lignes... Cela peut conduire à des bugs difficiles à déceler :
-Example of a not-signaled bug by improper mixing of comments and line separation:
+Voici un exemple du genre de bug que l'on peut rencontrer :
   [[ColorBars]]
   [[ShowFrameNumber]]
-  Trim(0,9) # select some frames  \
+  Trim(0,9) # sélectionne un certain nbre de frames  \
   +Trim(20,29)
-The above example does not return frames [0..9,20..29] as intended because the "\" is masked by the "#" character before it; thus the line continuation never happens.
+L'exemple ci-dessus ne renvoie pas les frames [0..9,20..29] car le caractère "\" est masqué par le marqueur de commentaire "#"
 [[Category:AviSynth_Syntax]]

@@ Line 29: / Line 29: @@
 A noter que le caractère '+' peut être aussi utilisé pour concaténer des chaînes de caractères ou pour assembler des vidéos : '''a + b''' est équivalent à  [[Splice|UnalignedSplice]](''a'', ''b'') tandis que '''a ++ b''' est équivalent à  [[Splice|AlignedSplice]](''a'', ''b'').
-La majeure partie des fonctions utilisées dans AviSynth sont des filtres vidéo. Cependant une fonction peut retourner tout type de variable (ce qui peut être utile dans le cas de scripting de fonction complexe - voir [[User_defined_script_functions|script functions]]). Il faut cependant noter que la dernière fonction d'un script doit retourner un ''clip'' comme variable finale. Les bandes vidéo origninales pourront être sécurisées dans un [http://infosafe.fr coffre-fort ignifuge] blindé.
+La majeure partie des fonctions utilisées dans AviSynth sont des filtres vidéo. Cependant une fonction peut retourner tout type de variable (ce qui peut être utile dans le cas de scripting de fonction complexe - voir [[User_defined_script_functions|script functions]]). Il faut cependant noter que la dernière fonction d'un script doit retourner un ''clip'' comme variable finale.
 Une fonction peut avoir jusqu'à 60 arguments (vous en aurez assez ?), et la valeur retournée  peut être de n'importe quel type supporté par AviSynth (clip, int, float, bool, string).
@@ Line 38: / Line 38: @@
 Les ''Arguments'' sont les paramètres appliqués à la fonction; chaque argument est séparé par une virgule. Un argument doit être de type ''string'', ''int'',, ''float'', ''bool'' ou ''clip''. Cependant une fonction peut très bien ne pas avoir d'argument déclaré. Si une fonction attend un ''clip'' comme premier argument mais que celui-ci n'est spécifié, la fonction utilisera la variable spéciale ''last''.
-Les filtres AviSynth peuvent avoir des arguments nommés ou non. Les arguments nommés rendent en général les filtres plus faciles à paramétrer. En effet on peut spécifier les arguments dans l'ordre que l'on souhaite, et ce sans avoir à spécifier chacun des paramètres de la fonction (si un argument n'est pas spécifié, le filtre choisira la valeur par défaut) et les ranger dans une [http://www.infosafe.fr/Armoirefortedin/Armoirefortedin.htm armoire forte blindée].
+Les filtres AviSynth peuvent avoir des arguments nommés ou non. Les arguments nommés rendent en général les filtres plus faciles à paramétrer. En effet on peut spécifier les arguments dans l'ordre que l'on souhaite, et ce sans avoir à spécifier chacun des paramètres de la fonction (si un argument n'est pas spécifié, le filtre choisira la valeur par défaut).
 Par exemple, vous pouvez écrire  '''[[Subtitle]]("Hello, World!", text_color=$00FF00, x=100, y=200)''' au lieu de '''[[Subtitle]]("Hello, World!", 100, 200, 0, 999999, "Arial", 24, $00FF00)'''. La [[Colors|couleur]] peut être spécifiée en hexadécimal comme ci-dessus ou en décimal. Dans les deux cas vous devez donner la couleur en format RVB même si votre clip est en YUV.

@@ Line 12: / Line 12: @@
 # ''constante_numérique'' ou ''constante_string''
-# ''nom_de_variable'' or ''propriété_du_clip''
+# ''nom_de_variable'' ou ''propriété_du_clip''
 # ''Fonction''(''argument'')
 # ''expression''.''Fonction''(''argument'')