Difference between revisions of "Template:Function"
Jump to navigation
Jump to search
Lou Montana (talk | contribs) (Template creation) |
Lou Montana (talk | contribs) (Add default Return Value) |
||
| (16 intermediate revisions by the same user not shown) | |||
| Line 2: | Line 2: | ||
-->__NOTOC__<!-- | -->__NOTOC__<!-- | ||
-->__NOEDITSECTION__<!-- | -->__NOEDITSECTION__<!-- | ||
| − | -->{{DISPLAYTITLE:{{#ifeq: {{uc:{{FULLPAGENAME}}}} | TEMPLATE:FUNCTION | {{FULLPAGENAMEE}} | {{PAGENAMEE | + | -->{{DISPLAYTITLE:{{#ifeq: {{uc:{{FULLPAGENAME}}}} | TEMPLATE:FUNCTION | {{FULLPAGENAMEE}} | {{PAGENAMEE}} }}}}<!-- |
| − | |||
--><div class="function"> | --><div class="function"> | ||
| − | [[:Category:Functions|← back to Functions]] | + | {| class="topinformation" |
| + | | [[:Category:Functions|← back to Functions]] | ||
| + | | {{#if:{{{v|}}}|Introduced in {{vn}} [[:Category:Introduced in v{{{v}}}|v'''{{{v}}}''']]}}{{#if:{{{author|}}}|<br>by {{{author}}}}} | ||
| + | | | ||
| + | {| class="argeff" | ||
| + | | Argument(s): || {{#switch:{{{a|}}}|l|loc|local= '''{{Color|blue|local}}'''|g|glob|global= '''{{Color|darkorange|global}}'''|n/a}} | ||
| + | |- | ||
| + | | Effect(s): || {{#switch:{{{e|}}}|l|loc|local= '''{{Color|blue|local}}'''|g|glob|global= '''{{Color|red|global}}'''|'''''{{Color|grey|unknown}}'''''}} | ||
| + | {{#ifeq:{{{n|}}}|server| | ||
| + | {{!}}- | ||
| + | {{!}} Execution: {{!}}{{!}} '''{{Color|green|Server only}}''' | ||
| + | }} | ||
| + | |} | ||
| + | |} | ||
{{#if:{{{v|}}}{{{d|}}}| | {{#if:{{{v|}}}{{{d|}}}| | ||
<h2 id="Description">Description</h2> | <h2 id="Description">Description</h2> | ||
| − | + | {{#if:{{{d|}}}|{{{d}}}}} | |
| − | {{#if:{{{d|}}}| | ||
}} | }} | ||
{{#if:{{{s|}}}| | {{#if:{{{s|}}}| | ||
<h2 id="Syntax">Syntax</h2> | <h2 id="Syntax">Syntax</h2> | ||
| + | <dl> | ||
<dt>Syntax</dt> | <dt>Syntax</dt> | ||
<dd>{{{s}}}</dd> | <dd>{{{s}}}</dd> | ||
{{#if:{{{p1n|}}}| | {{#if:{{{p1n|}}}| | ||
<dt>Parameters</dt> | <dt>Parameters</dt> | ||
| − | + | {{Function/parameter|{{{p1n|}}}|{{{p1t|}}}|{{{p1d|}}}|{{{p1v|}}}}}<!-- | |
| − | -->{{ | + | -->{{Function/parameter|{{{p2n|}}}|{{{p2t|}}}|{{{p2d|}}}|{{{p2v|}}}}}<!-- |
| − | -->{{ | + | -->{{Function/parameter|{{{p3n|}}}|{{{p3t|}}}|{{{p3d|}}}|{{{p3v|}}}}}<!-- |
| − | -->{{ | + | -->{{Function/parameter|{{{p4n|}}}|{{{p4t|}}}|{{{p4d|}}}|{{{p4v|}}}}}<!-- |
| − | -->{{ | + | -->{{Function/parameter|{{{p5n|}}}|{{{p5t|}}}|{{{p5d|}}}|{{{p5v|}}}}}<!-- |
| − | -->{{ | + | -->{{Function/parameter|{{{p6n|}}}|{{{p6t|}}}|{{{p6d|}}}|{{{p6v|}}}}}<!-- |
| − | -->{{ | + | -->{{Function/parameter|{{{p7n|}}}|{{{p7t|}}}|{{{p7d|}}}|{{{p7v|}}}}}<!-- |
| − | -->{{ | + | -->{{Function/parameter|{{{p8n|}}}|{{{p8t|}}}|{{{p8d|}}}|{{{p8v|}}}}}<!-- |
| − | -->{{ | + | -->{{Function/parameter|{{{p9n|}}}|{{{p9t|}}}|{{{p9d|}}}|{{{p9v|}}}}}<!-- |
| + | -->{{Function/parameter|{{{p10n|}}}|{{{p10t|}}}|{{{p10d|}}}|{{{p10v|}}}}} | ||
}} | }} | ||
| + | <dt>Return value</dt> | ||
| + | <dd>{{DataType|{{{r1t|}}}}}{{#if:{{{r1d|}}}|<nowiki> - </nowiki>{{{r1d}}}}}</dd> | ||
| + | </dl> | ||
}} | }} | ||
| − | |||
| − | |||
| − | |||
| − | |||
{{#if:{{{x1|}}}| | {{#if:{{{x1|}}}| | ||
<h2 id="Examples">Examples</h2> | <h2 id="Examples">Examples</h2> | ||
| − | <dt>Example 1 | + | <dl> |
| − | {{#if:{{{x2|}}}|<dt>Example 2 | + | <dt>Example 1</dt><dd>{{{x1}}}</dt> |
| − | {{#if:{{{x3|}}}|<dt>Example 3 | + | {{#if:{{{x2|}}}|<dt>Example 2</dt><dd>{{{x2}}}</dd>}} |
| − | {{#if:{{{x4|}}}|<dt>Example 4 | + | {{#if:{{{x3|}}}|<dt>Example 3</dt><dd>{{{x3}}}</dd>}} |
| − | {{#if:{{{x5|}}}|<dt>Example 5 | + | {{#if:{{{x4|}}}|<dt>Example 4</dt><dd>{{{x4}}}</dd>}} |
| − | {{#if:{{{x6|}}}|<dt>Example 6 | + | {{#if:{{{x5|}}}|<dt>Example 5</dt><dd>{{{x5}}}</dd>}} |
| − | {{#if:{{{x7|}}}|<dt>Example 7 | + | {{#if:{{{x6|}}}|<dt>Example 6</dt><dd>{{{x6}}}</dd>}} |
| − | {{#if:{{{x8|}}}|<dt>Example 8 | + | {{#if:{{{x7|}}}|<dt>Example 7</dt><dd>{{{x7}}}</dd>}} |
| − | {{#if:{{{x9|}}}|<dt>Example 9 | + | {{#if:{{{x8|}}}|<dt>Example 8</dt><dd>{{{x8}}}</dd>}} |
| − | {{#if:{{{x10|}}}|<dt>Example 10 | + | {{#if:{{{x9|}}}|<dt>Example 9</dt><dd>{{{x9}}}</dd>}} |
| + | {{#if:{{{x10|}}}|<dt>Example 10</dt><dd>{{{x10}}}</dd>}} | ||
| + | </dl> | ||
| + | }} | ||
| + | {{#ifeq: {{uc:{{FULLPAGENAME}}}} | TEMPLATE:FUNCTION | | | ||
| + | {{DEFAULTSORT:{{#replace:{{uc:{{PAGENAMEE}}}}|VN_FNC_|}}}} | ||
| + | [[Category:Functions]] | ||
| + | {{#if:{{{v|}}}|[[Category:Introduced in v{{{v}}}]]}}<!-- | ||
| + | -->{{#if:{{{g1|}}}|[[Category:Function Group: {{{g1}}}]]}}<!-- | ||
| + | -->{{#if:{{{g2|}}}|[[Category:Function Group: {{{g2}}}]]}}<!-- | ||
| + | -->{{#if:{{{g3|}}}|[[Category:Function Group: {{{g3}}}]]}}<!-- | ||
| + | -->{{#if:{{{g4|}}}|[[Category:Function Group: {{{g4}}}]]}}<!-- | ||
| + | -->{{#if:{{{g5|}}}|[[Category:Function Group: {{{g5}}}]]}} | ||
}} | }} | ||
| − | </div> | + | </div></includeonly><noinclude><!-- |
| + | |||
| − | [[Category:Functions]] | + | DOCUMENTATION STARTS HERE |
| − | + | ||
| + | |||
| + | --> | ||
| + | Shows a [[:Category:Functions|Function]] page, adds it to the [[:Category:Functions]] page and the [[:Category:Introduced in]]. | ||
== Usage == | == Usage == | ||
| Line 56: | Line 84: | ||
! Argument !! Name !! Description | ! Argument !! Name !! Description | ||
|- | |- | ||
| − | | v || Version || {{vn}}'s version | + | | author || Author || function's author(s) |
| + | |- | ||
| + | | v || Version || {{vn}}'s version.<br>'''Note:''' '''not''' {{arma3}} version! | ||
| + | |- | ||
| + | | a || Arguments locality || l, loc or local for local arguments, g, glob or global for global arguments | ||
| + | |- | ||
| + | | e || Effect(s) locality || same as ''a'' for effect(s) locality | ||
| + | |- | ||
| + | | n || Network || <q>server</q> if this function is server-side only - anything else will be discarded | ||
| + | |- | ||
| + | | g1..g5 || Group || Function's group (weapon, vehicle, module, etc) | ||
|- | |- | ||
| d || Description || Function summary, e.g <q>Sets provided unit's direction.</q> | | d || Description || Function summary, e.g <q>Sets provided unit's direction.</q> | ||
|- | |- | ||
| − | | s || Syntax || e.g <code | + | | s || Syntax || e.g <q><code>[unit, 45] call [[<nowiki/>VN_fnc_setDir]];</code></q> |
|- | |- | ||
! colspan="3" | Parameters - p1..10 | ! colspan="3" | Parameters - p1..10 | ||
| Line 66: | Line 104: | ||
| p1n || Parameter 1 '''n'''ame (identifier) || e.g unit, dir, etc. | | p1n || Parameter 1 '''n'''ame (identifier) || e.g unit, dir, etc. | ||
|- | |- | ||
| − | | p1t || Parameter 1 '''t'''ype || | + | | p1t || Parameter 1 '''t'''ype || {{DataType|string}}, {{DataType|number}}, etc.<br>'''Note:''' no need to use wiki formatting (like <code>[[<nowiki/>String]]</code>) - simply type s, str or string - see [[Template:DataType]] for possible values. |
|- | |- | ||
| p1d || Parameter 1 '''d'''escription || e.g <q>Sets unit's direction.</q> | | p1d || Parameter 1 '''d'''escription || e.g <q>Sets unit's direction.</q> | ||
|- | |- | ||
| − | | p1v || Parameter 1 default '''v'''alue || e.g 10 | + | | p1v || Parameter 1 default '''v'''alue || e.g <q>10</q> |
|- | |- | ||
! colspan="3" | Return value - r1..5 | ! colspan="3" | Return value - r1..5 | ||
|- | |- | ||
| − | | r1t || Returned value '''t'''ype || e.g | + | | r1t || Returned value '''t'''ype || e.g {{DataType|number}} - same note as ''p1t'' |
|- | |- | ||
| r1d || Returned value '''d'''escription || e.g <q>Angle set</q> | | r1d || Returned value '''d'''escription || e.g <q>Angle set</q> | ||
| Line 80: | Line 118: | ||
! colspan="3" | Examples - x1..10 | ! colspan="3" | Examples - x1..10 | ||
|- | |- | ||
| − | | x1 || Example 1 || e.g <code | + | | x1 || Example 1 || e.g <q><code>[player, 45] call [[<nowiki/>VN_fnc_setDir]]</code></q>.<br>'''Note:''' be sure to use the HTML <tt><code></code></tt> tags around code. |
|} | |} | ||
| Line 89: | Line 127: | ||
<pre> | <pre> | ||
{{Function | {{Function | ||
| + | |||
| + | |author= author | ||
|v= 1.00 | |v= 1.00 | ||
| − | | | + | |a= argumentsLocality |
| − | |s= [] | + | |e= effectsLocality |
| + | |||
| + | |n= serverOnly | ||
| + | |||
| + | |g1= group | ||
| + | |||
| + | |d= description | ||
| + | |||
| + | |s= [] call [[FUNCTION]] | ||
|p1n= identifier | |p1n= identifier | ||
| Line 117: | Line 165: | ||
<pre> | <pre> | ||
{{Function | {{Function | ||
| + | |||
| + | |author= John Doe | ||
|v= 1.00 | |v= 1.00 | ||
| + | |||
| + | |a= loc | ||
| + | |||
| + | |e= global | ||
| + | |||
| + | |n= server | ||
| + | |||
| + | |g1= Command Group | ||
|d= Sets provided unit's direction. | |d= Sets provided unit's direction. | ||
| − | |s= [unit, direction] | + | |s= [unit, direction] call [[VN_fnc_setDir]] |
|p1n= unit | |p1n= unit | ||
| Line 142: | Line 200: | ||
|} | |} | ||
| − | [[Category:Templates]] | + | == Result == |
| − | </noinclude> | + | |
| + | ''Result is in a grey border to separate it from this page.'' | ||
| + | |||
| + | <div style="border: 0.25em solid lightgrey; margin: 0 4em; padding: 2em"> | ||
| + | {{Function | ||
| + | |||
| + | |author= John Doe | ||
| + | |||
| + | |v= 1.00 | ||
| + | |||
| + | |a= loc | ||
| + | |||
| + | |e= global | ||
| + | |||
| + | |n= server | ||
| + | |||
| + | |g1= Command Group | ||
| + | |||
| + | |d= Sets provided unit's direction. | ||
| + | |||
| + | |s= [unit, direction] call '''VN_fnc_setDir''' | ||
| + | |||
| + | |p1n= unit | ||
| + | |p1t= object | ||
| + | |p1d= the unit to sets direction | ||
| + | |p1v= objNull | ||
| + | |||
| + | |p2n= direction | ||
| + | |p2t= number | ||
| + | |p2d= the direction value | ||
| + | |p2v= 0 | ||
| + | |||
| + | |r1t= number | ||
| + | |r1d= set direction | ||
| + | |||
| + | |x1= <code>[player, 45] call '''VN_fnc_setDir''';</code> | ||
| + | }}</div> | ||
| + | |||
| + | |||
| + | [[Category:Templates]]</noinclude> | ||
Latest revision as of 22:51, 25 February 2021
Shows a Function page, adds it to the Category:Functions page and the Category:Introduced in.
Usage
{{Function|arg1=value}}
| Argument | Name | Description |
|---|---|---|
| author | Author | function's author(s) |
| v | Version | S.O.G. Prairie Fire's version. Note: not Arma 3 version! |
| a | Arguments locality | l, loc or local for local arguments, g, glob or global for global arguments |
| e | Effect(s) locality | same as a for effect(s) locality |
| n | Network | serverif this function is server-side only - anything else will be discarded |
| g1..g5 | Group | Function's group (weapon, vehicle, module, etc) |
| d | Description | Function summary, e.g Sets provided unit's direction. |
| s | Syntax | e.g <code>[unit, 45] call [[VN_fnc_setDir]];</code> |
| Parameters - p1..10 | ||
| p1n | Parameter 1 name (identifier) | e.g unit, dir, etc. |
| p1t | Parameter 1 type | String, Number, etc. Note: no need to use wiki formatting (like [[String]]) - simply type s, str or string - see Template:DataType for possible values.
|
| p1d | Parameter 1 description | e.g Sets unit's direction. |
| p1v | Parameter 1 default value | e.g 10 |
| Return value - r1..5 | ||
| r1t | Returned value type | e.g Number - same note as p1t |
| r1d | Returned value description | e.g Angle set |
| Examples - x1..10 | ||
| x1 | Example 1 | e.g <code>[player, 45] call [[VN_fnc_setDir]]</code>. Note: be sure to use the HTML <code></code> tags around code. |
Template{{Function
|author= author
|v= 1.00
|a= argumentsLocality
|e= effectsLocality
|n= serverOnly
|g1= group
|d= description
|s= [] call [[FUNCTION]]
|p1n= identifier
|p1t= type
|p1d= description
|p1v= defaultValue
|p2n= identifier
|p2t= type
|p2d= description
|p2v= defaultValue
|r1t= type
|r1d= description
|x1= example1
}}
|
Example{{Function
|author= John Doe
|v= 1.00
|a= loc
|e= global
|n= server
|g1= Command Group
|d= Sets provided unit's direction.
|s= [unit, direction] call [[VN_fnc_setDir]]
|p1n= unit
|p1t= object
|p1d= the unit to sets direction
|p1v= objNull
|p2n= direction
|p2t= number
|p2d= the direction value
|p2v= 0
|r1t= number
|r1d= set direction
|x1= <code>[player, 45] call [[VN_fnc_setDir]];</code>
}}
|
Result
Result is in a grey border to separate it from this page.
| ← back to Functions | Introduced in S.O.G. Prairie Fire v1.00 by John Doe |
|
Description
Sets provided unit's direction.
Syntax
- Syntax
- [unit, direction] call VN_fnc_setDir
- Parameters
- unit: Object - (Optional, default
objNull) the unit to sets direction - direction: Number - (Optional, default
0) the direction value - Return value
- Number - set direction
Examples
- Example 1
[player, 45] call VN_fnc_setDir;