Grammar - Revision history

Raffriff42: chaining - correction

2017-11-16T14:28:29Z

chaining - correction

← Older revision		Revision as of 16:28, 16 November 2017
Line 48:		Line 48:
	{{BoldColor\|black\|120\|►}} Incidentally, Avisynth '''ignores case''': ''avisource'' or ''aViSouRCe'' is just as good as ''AVISource''.		{{BoldColor\|black\|120\|►}} Incidentally, Avisynth '''ignores case''': ''avisource'' or ''aViSouRCe'' is just as good as ''AVISource''.

	{{BoldColor\|black\|120\|►}} As a special case, [[Operators~~#For_Booleans~~\|~~boolean operations~~]] may be ''chained'':		{{BoldColor\|black\|120\|►}} As a special case, [[Operators\|comparisons ]] may be ''chained'':
	:<code>(3 <= x <= 5)</code> can be used where normally something like		:<code>(3 <= x <= 5)</code> can be used where normally something like
	:<code>(3 <= x && x <= 5)</code> would be required.<sup>[http://forum.doom9.org/showthread.php?p=1783132#post1783132 (doom9)]</sup>		:<code>(3 <= x && x <= 5)</code> would be required.<sup>[http://forum.doom9.org/showthread.php?p=1783132#post1783132 (doom9)]</sup>

Raffriff42: GScript - rephrase

2017-11-15T22:07:05Z

GScript - rephrase

← Older revision		Revision as of 00:07, 16 November 2017
Line 17:		Line 17:
	{{BoldColor\|black\|120\|►}} Two higher-level constructs also exist - the '''function declaration''' (dicussed below) and the '''[[Control_structures#The_try..catch_statement\|try..catch statement]]'''.		{{BoldColor\|black\|120\|►}} Two higher-level constructs also exist - the '''function declaration''' (dicussed below) and the '''[[Control_structures#The_try..catch_statement\|try..catch statement]]'''.

	{{BoldColor\|black\|120\|►}} ~~{{AvsPluscon}} supports (via~~ [[GScript]]) '''~~{ statement blocks }~~''', '''for''' and '''while''' loops.		{{BoldColor\|black\|120\|►}} [[GScript]], a [[External_filters#Support_filters\|support plugin]], extends the language to include '''if–else''', '''for''' and '''while''' loops; {{AvsPluscon}} has [[GScript#Avisynth.2B\|native support of GScript]].

Raffriff42: 'Statements', 'Expression' formatting; 'Functions' part rewrite; mention AVS+ Gscript; mention chaining of boolean expressions

2017-11-15T05:21:58Z

'Statements', 'Expression' formatting; 'Functions' part rewrite; mention AVS+ Gscript; mention chaining of boolean expressions

Show changes

Raffriff42: one more touch-up -- operators; max-width

2016-03-11T14:47:46Z

one more touch-up -- operators; max-width

← Older revision		Revision as of 16:47, 11 March 2016
Line 1:		Line 1:
			<div style="max-width:62em" >
	==== Statements, Expressions, Types and Operators ====		==== Statements, Expressions, Types and Operators ====
	All basic AviSynth scripting '''statements''' have one of these ''forms'':		All basic AviSynth scripting '''statements''' have one of these ''forms'':
Line 33:		Line 34:
	::{{FuncArg\|''expression''}} <b>.</b> {{FuncArg\|function_name}} '''(''' {{FuncArg\|argument_list}} ''')''' is equivalent to		::{{FuncArg\|''expression''}} <b>.</b> {{FuncArg\|function_name}} '''(''' {{FuncArg\|argument_list}} ''')''' is equivalent to
	::{{FuncArg\|function_name}} '''(''' {{FuncArg\|''expression''}} ''',''' {{FuncArg\|argument_list}} ''')'''		::{{FuncArg\|function_name}} '''(''' {{FuncArg\|''expression''}} ''',''' {{FuncArg\|argument_list}} ''')'''
	*The fifth form has an {{FuncArg\|operator}}; AviSynth operators are discussed [[Operators\|here]]; in addition to the normal math operators you would expect, there are several ''special'' operators; for example,		*The fifth form has an {{FuncArg\|operator}}; AviSynth operators are discussed [[Operators\|'''here''']]; in addition to the normal math operators you would expect, there are several ''special'' operators; for example,
	:*'''strings''' can be ''concatenated'' (joined together) with '+', and ''compared'' with relational operators.		:*'''strings''' can be ''concatenated'' (joined together) with '+', and ''compared'' with relational operators like '>='.
	:*'''video clips''' can be ''spliced'' (joined together) with '+':		:*'''video clips''' can be ''spliced'' (joined together) with '+':
	::''a'' '''+''' ''b'' is equivalent to [[Splice\|UnalignedSplice]](''a'', ''b'')		::''a'' '''+''' ''b'' is equivalent to [[Splice\|UnalignedSplice]](''a'', ''b'')
Line 174:		Line 175:
	Trim(0,9) '''[''' select some frames '''] \'''		Trim(0,9) '''[''' select some frames '''] \'''
	+ Trim(20,29)		+ Trim(20,29)
			</div>
	</div>		</div>

Admin: /* Statements, Expressions, Types and Operators */

2016-01-31T19:15:07Z

Statements, Expressions, Types and Operators

← Older revision		Revision as of 21:15, 31 January 2016
Line 13:		Line 13:
	As a shorthand, if '''return''' is not present in the final executable statement of a script (or script block), it is ''implied'' – the statement is treated as if '''return''' was present.		As a shorthand, if '''return''' is not present in the final executable statement of a script (or script block), it is ''implied'' – the statement is treated as if '''return''' was present.

	Most of the time the '''result''' of an expression will be a video clip; however an expression's result can be any ~~'''[[Script_variables\|Avisynth Type]]'''~~ (clip, int, float, bool, string) ~~– these are sometimes called~~ ''utility functions''~~. A guide to the built-in utility functions can be found~~ [[Internal_functions\|~~here~~]].		Most of the time the '''result''' of an expression will be a video clip; however an expression's result can be any type supported by AviSynth (clip, int, float, bool, string) and this is how ''utility functions'' such as [[Internal_functions\|Internal script functions]] operate.

	If the return value of the script is a ''clip'', which is the normal case, it can be "played" as a video by a [[Frameserver\|frameserving]] client.		If the return value of the script is a ''clip'', which is the normal case, it can be "played" as a video by a [[Frameserver\|frameserving]] client.
Line 47:		Line 47:

	Incidentally, Avisynth '''ignores case''': ''avisource'' or ''aViSouRCe'' is just as good as ''AVISource''.		Incidentally, Avisynth '''ignores case''': ''avisource'' or ''aViSouRCe'' is just as good as ''AVISource''.


	==== Functions, Filters and Arguments ====		==== Functions, Filters and Arguments ====

Raffriff42: value of an expression, forms 5 and 6; more ternary

2016-01-25T20:50:10Z

value of an expression, forms 5 and 6; more ternary

← Older revision		Revision as of 22:50, 25 January 2016
Line 24:		Line 24:
	# {{FuncArg\|function_name}} '''(''' {{FuncArg\|argument_list}} ''')'''		# {{FuncArg\|function_name}} '''(''' {{FuncArg\|argument_list}} ''')'''
	# {{FuncArg\|expression}} <b>.</b> {{FuncArg\|function_name}} '''(''' {{FuncArg\|argument_list}} ''')'''		# {{FuncArg\|expression}} <b>.</b> {{FuncArg\|function_name}} '''(''' {{FuncArg\|argument_list}} ''')'''
	# {{FuncArg\|~~expression~~}} '''operator''' {{FuncArg\|~~expression~~}}		# {{FuncArg\|expression1}} '''operator''' {{FuncArg\|expression2}}
	# {{FuncArg\|~~boolean_expression~~}} <b>?</b> {{FuncArg\|~~expression~~}} <b>:</b> {{FuncArg\|~~expression~~}}		# {{FuncArg\|expression1}} <b>?</b> {{FuncArg\|expression2}} <b>:</b> {{FuncArg\|expression3}}

	*In the first form, the value of the expression is the value of the (numeric, string or boolean) {{FuncArg\|constant}}—a ''literal value'' such as '42'.		*In the first form, the value of the expression is the value of the (numeric, string or boolean) {{FuncArg\|constant}}—a ''literal value'' such as '42'.
Line 33:		Line 33:
	::{{FuncArg\|''expression''}} <b>.</b> {{FuncArg\|function_name}} '''(''' {{FuncArg\|argument_list}} ''')''' is equivalent to		::{{FuncArg\|''expression''}} <b>.</b> {{FuncArg\|function_name}} '''(''' {{FuncArg\|argument_list}} ''')''' is equivalent to
	::{{FuncArg\|function_name}} '''(''' {{FuncArg\|''expression''}} ''',''' {{FuncArg\|argument_list}} ''')'''		::{{FuncArg\|function_name}} '''(''' {{FuncArg\|''expression''}} ''',''' {{FuncArg\|argument_list}} ''')'''
	*The fifth form has an {{FuncArg\|operator}}; AviSynth operators are discussed [[Operators\|here]]; for example,		*The fifth form has an {{FuncArg\|operator}}; AviSynth operators are discussed [[Operators\|here]]; in addition to the normal math operators you would expect, there are several ''special'' operators; for example,
	:*'''strings''' can be ''concatenated'' (joined together) with '+', and ''compared'' with relational operators.		:*'''strings''' can be ''concatenated'' (joined together) with '+', and ''compared'' with relational operators.
	:*'''video clips''' can be ''spliced'' (joined together) with '+':		:*'''video clips''' can be ''spliced'' (joined together) with '+':
	::''a'' '''+''' ''b'' is equivalent to [[Splice\|UnalignedSplice]](''a'', ''b'')		::''a'' '''+''' ''b'' is equivalent to [[Splice\|UnalignedSplice]](''a'', ''b'')
	::''a'' '''++''' ''b'' is equivalent to [[Splice\|AlignedSplice]](''a'', ''b'').		::''a'' '''++''' ''b'' is equivalent to [[Splice\|AlignedSplice]](''a'', ''b'').
	*The sixth form supports conditional execution with the {{FuncArg\|a~~?b:c~~}} [[~~Ternary_operator~~\|''~~ternary operator~~'']].		:The value of the expression will depend on the specific operator; for example,
			:* the value of ''string'' '''+''' ''string'' is the concatenated string
			:* the value of ''string'' '''==''' ''string'' is a ''boolean'' (true/false) value (it is a ''boolean expression'')
			*The sixth form supports conditional execution with the [[Ternary_operator\|''ternary operator'']];
			:*If the value of {{FuncArg\|expression1}} evaluates to ''true'', the value of the whole expression is the value of {{FuncArg\|expression2}}; otherwise it is the value of {{FuncArg\|expression3}}
			:*If {{FuncArg\|expression1}} is true and {{FuncArg\|expression2}} is a {{FuncArg\|function}}, that function will be ''executed''. This is the main method of [[Control_structures\|code branching]] in AviSynth.
			::For more on ternary operators, see [http://www.cplusplus.com/articles/1AUq5Di1/ ''The Conditional (or Ternary) Operator''] (cplusplus.com)

	Avisynth '''ignores case''': ''avisource'' or ''aViSouRCe'' is just as good as ''AVISource''.		Incidentally, Avisynth '''ignores case''': ''avisource'' or ''aViSouRCe'' is just as good as ''AVISource''.

Raffriff42: 'ternary' - add link

2016-01-24T19:08:18Z

'ternary' - add link

← Older revision		Revision as of 21:08, 24 January 2016
Line 38:		Line 38:
	::''a'' '''+''' ''b'' is equivalent to [[Splice\|UnalignedSplice]](''a'', ''b'')		::''a'' '''+''' ''b'' is equivalent to [[Splice\|UnalignedSplice]](''a'', ''b'')
	::''a'' '''++''' ''b'' is equivalent to [[Splice\|AlignedSplice]](''a'', ''b'').		::''a'' '''++''' ''b'' is equivalent to [[Splice\|AlignedSplice]](''a'', ''b'').
	*The sixth form supports conditional execution with the {{FuncArg\|? :}} ''ternary operator''.		*The sixth form supports conditional execution with the {{FuncArg\|a?b:c}} [[Ternary_operator\|''ternary operator'']].

	Avisynth '''ignores case''': ''avisource'' or ''aViSouRCe'' is just as good as ''AVISource''.		Avisynth '''ignores case''': ''avisource'' or ''aViSouRCe'' is just as good as ''AVISource''.

Raffriff42: constant - correction

2016-01-24T19:00:52Z

constant - correction

← Older revision		Revision as of 21:00, 24 January 2016
Line 20:		Line 20:
	An '''Expression''' can have one of these forms:		An '''Expression''' can have one of these forms:

	# {{FuncArg\|~~constant_name~~}}		# {{FuncArg\|constant}}
	# {{FuncArg\|variable_name}} or {{FuncArg\|clip_property_name}}		# {{FuncArg\|variable_name}} or {{FuncArg\|clip_property_name}}
	# {{FuncArg\|function_name}} '''(''' {{FuncArg\|argument_list}} ''')'''		# {{FuncArg\|function_name}} '''(''' {{FuncArg\|argument_list}} ''')'''
Line 27:		Line 27:
	# {{FuncArg\|boolean_expression}} <b>?</b> {{FuncArg\|expression}} <b>:</b> {{FuncArg\|expression}}		# {{FuncArg\|boolean_expression}} <b>?</b> {{FuncArg\|expression}} <b>:</b> {{FuncArg\|expression}}

	*In the first form, the value of the expression is the value of the (numeric, string or boolean) {{FuncArg\|constant}}~~. <br>(syntactically, a ''constant'' is indistinguishable from~~ a ''~~variable''; by convention, you set the~~ value ~~of a~~ ''~~constant~~'' ~~once and once only)~~		*In the first form, the value of the expression is the value of the (numeric, string or boolean) {{FuncArg\|constant}}—a ''literal value'' such as '42'.
	*In the second form, the value equals the value of the specified [[Script_variables\|{{FuncArg\|variable}}]] or [[Clip_properties\|{{FuncArg\|clip property}}]] (possibly [[Internal_functions/Defined#Defined\|undefined]]).		*In the second form, the value equals the value of the specified [[Script_variables\|{{FuncArg\|variable}}]] or [[Clip_properties\|{{FuncArg\|clip property}}]] (possibly [[Internal_functions/Defined#Defined\|undefined]]).
	*In the third form, the value is the return value of a {{FuncArg\|function}} (see below).		*In the third form, the value is the return value of a {{FuncArg\|function}} (see below).

Raffriff42: typo

2016-01-24T18:27:19Z

typo

← Older revision		Revision as of 20:27, 24 January 2016
Line 61:		Line 61:
	The list can be '''empty'''. If so, you can omit the '''parentheses''':		The list can be '''empty'''. If so, you can omit the '''parentheses''':
	<div {{BoxWidthIndent\|48\|1}} >		<div {{BoxWidthIndent\|48\|1}} >
	AviSource("my.avi").~~AssumeFieldBased~~.AssumeTFF.SeparateFields		AviSource("my.avi").AssumeFrameBased.AssumeTFF.SeparateFields
	</div>		</div>
	versus		versus
	<div {{BoxWidthIndent\|48\|1}} >		<div {{BoxWidthIndent\|48\|1}} >
	AviSource("my.avi").~~AssumeFieldBased~~().AssumeTFF().SeparateFields()		AviSource("my.avi").AssumeFrameBased().AssumeTFF().SeparateFields()
	</div>		</div>

Raffriff42: one more touch-up

2016-01-24T18:21:31Z

one more touch-up

Show changes

← Older revision		Revision as of 22:50, 25 January 2016
Line 24:		Line 24:
	# {{FuncArg\|function_name}} '''(''' {{FuncArg\|argument_list}} ''')'''		# {{FuncArg\|function_name}} '''(''' {{FuncArg\|argument_list}} ''')'''
	# {{FuncArg\|expression}} <b>.</b> {{FuncArg\|function_name}} '''(''' {{FuncArg\|argument_list}} ''')'''		# {{FuncArg\|expression}} <b>.</b> {{FuncArg\|function_name}} '''(''' {{FuncArg\|argument_list}} ''')'''
	# {{FuncArg\|~~expression~~}} '''operator''' {{FuncArg\|~~expression~~}}		# {{FuncArg\|expression1}} '''operator''' {{FuncArg\|expression2}}
	# {{FuncArg\|~~boolean_expression~~}} <b>?</b> {{FuncArg\|~~expression~~}} <b>:</b> {{FuncArg\|~~expression~~}}		# {{FuncArg\|expression1}} <b>?</b> {{FuncArg\|expression2}} <b>:</b> {{FuncArg\|expression3}}

	*In the first form, the value of the expression is the value of the (numeric, string or boolean) {{FuncArg\|constant}}—a ''literal value'' such as '42'.		*In the first form, the value of the expression is the value of the (numeric, string or boolean) {{FuncArg\|constant}}—a ''literal value'' such as '42'.
Line 33:		Line 33:
	::{{FuncArg\|''expression''}} <b>.</b> {{FuncArg\|function_name}} '''(''' {{FuncArg\|argument_list}} ''')''' is equivalent to		::{{FuncArg\|''expression''}} <b>.</b> {{FuncArg\|function_name}} '''(''' {{FuncArg\|argument_list}} ''')''' is equivalent to
	::{{FuncArg\|function_name}} '''(''' {{FuncArg\|''expression''}} ''',''' {{FuncArg\|argument_list}} ''')'''		::{{FuncArg\|function_name}} '''(''' {{FuncArg\|''expression''}} ''',''' {{FuncArg\|argument_list}} ''')'''
	*The fifth form has an {{FuncArg\|operator}}; AviSynth operators are discussed [[Operators\|here]]; for example,		*The fifth form has an {{FuncArg\|operator}}; AviSynth operators are discussed [[Operators\|here]]; in addition to the normal math operators you would expect, there are several ''special'' operators; for example,
	:*'''strings''' can be ''concatenated'' (joined together) with '+', and ''compared'' with relational operators.		:*'''strings''' can be ''concatenated'' (joined together) with '+', and ''compared'' with relational operators.
	:*'''video clips''' can be ''spliced'' (joined together) with '+':		:*'''video clips''' can be ''spliced'' (joined together) with '+':
	::''a'' '''+''' ''b'' is equivalent to [[Splice\|UnalignedSplice]](''a'', ''b'')		::''a'' '''+''' ''b'' is equivalent to [[Splice\|UnalignedSplice]](''a'', ''b'')
	::''a'' '''++''' ''b'' is equivalent to [[Splice\|AlignedSplice]](''a'', ''b'').		::''a'' '''++''' ''b'' is equivalent to [[Splice\|AlignedSplice]](''a'', ''b'').
	*The sixth form supports conditional execution with the {{FuncArg\|a~~?b:c~~}} [[~~Ternary_operator~~\|''~~ternary operator~~'']].		:The value of the expression will depend on the specific operator; for example,
			:* the value of ''string'' '''+''' ''string'' is the concatenated string
			:* the value of ''string'' '''==''' ''string'' is a ''boolean'' (true/false) value (it is a ''boolean expression'')
			*The sixth form supports conditional execution with the [[Ternary_operator\|''ternary operator'']];
			:*If the value of {{FuncArg\|expression1}} evaluates to ''true'', the value of the whole expression is the value of {{FuncArg\|expression2}}; otherwise it is the value of {{FuncArg\|expression3}}
			:*If {{FuncArg\|expression1}} is true and {{FuncArg\|expression2}} is a {{FuncArg\|function}}, that function will be ''executed''. This is the main method of [[Control_structures\|code branching]] in AviSynth.
			::For more on ternary operators, see [http://www.cplusplus.com/articles/1AUq5Di1/ ''The Conditional (or Ternary) Operator''] (cplusplus.com)

	Avisynth '''ignores case''': ''avisource'' or ''aViSouRCe'' is just as good as ''AVISource''.		Incidentally, Avisynth '''ignores case''': ''avisource'' or ''aViSouRCe'' is just as good as ''AVISource''.

← Older revision		Revision as of 21:00, 24 January 2016
Line 20:		Line 20:
	An '''Expression''' can have one of these forms:		An '''Expression''' can have one of these forms:

	# {{FuncArg\|~~constant_name~~}}		# {{FuncArg\|constant}}
	# {{FuncArg\|variable_name}} or {{FuncArg\|clip_property_name}}		# {{FuncArg\|variable_name}} or {{FuncArg\|clip_property_name}}
	# {{FuncArg\|function_name}} '''(''' {{FuncArg\|argument_list}} ''')'''		# {{FuncArg\|function_name}} '''(''' {{FuncArg\|argument_list}} ''')'''
Line 27:		Line 27:
	# {{FuncArg\|boolean_expression}} <b>?</b> {{FuncArg\|expression}} <b>:</b> {{FuncArg\|expression}}		# {{FuncArg\|boolean_expression}} <b>?</b> {{FuncArg\|expression}} <b>:</b> {{FuncArg\|expression}}

	*In the first form, the value of the expression is the value of the (numeric, string or boolean) {{FuncArg\|constant}}~~. <br>(syntactically, a ''constant'' is indistinguishable from~~ a ''~~variable''; by convention, you set the~~ value ~~of a~~ ''~~constant~~'' ~~once and once only)~~		*In the first form, the value of the expression is the value of the (numeric, string or boolean) {{FuncArg\|constant}}—a ''literal value'' such as '42'.
	*In the second form, the value equals the value of the specified [[Script_variables\|{{FuncArg\|variable}}]] or [[Clip_properties\|{{FuncArg\|clip property}}]] (possibly [[Internal_functions/Defined#Defined\|undefined]]).		*In the second form, the value equals the value of the specified [[Script_variables\|{{FuncArg\|variable}}]] or [[Clip_properties\|{{FuncArg\|clip property}}]] (possibly [[Internal_functions/Defined#Defined\|undefined]]).
	*In the third form, the value is the return value of a {{FuncArg\|function}} (see below).		*In the third form, the value is the return value of a {{FuncArg\|function}} (see below).