Difference between revisions of "Template:Function"

From Savage Game Design Wiki
Jump to navigation Jump to search
m (Fix won't work; {{#replace}} does not work yet)
(Add default Return Value)
 
(10 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}} }}}}<!--
-->{{DEFAULTSORT:{{#replace:{{uc:{{PAGENAMEE}}}}|VN_FNC_|}}}}}}<!--
 
-->{{#ifeq: {{uc:{{FULLPAGENAME}}}} | TEMPLATE:FUNCTION | | [[Category:Functions]]{{#if:{{{v|}}}|[[Category:Introduced in v{{{v}}}]]}}}}<!--
 
 
--><div class="function">
 
--><div class="function">
{|
+
{| class="topinformation"
| style="min-width: 20em" | [[:Category:Functions|← back to Functions]]
+
| [[:Category:Functions|← back to Functions]]
| style="width: 50%" | {{#if:{{{v|}}}|Introduced in {{vn}} v'''{{{v}}}'''}}
+
| {{#if:{{{v|}}}|Introduced in {{vn}} [[:Category:Introduced in v{{{v}}}|v'''{{{v}}}''']]}}{{#if:{{{author|}}}|<br>by {{{author}}}}}
| style="width: 33%" | <div style="display: inline-block; text-align: right">
+
|  
Argument(s): {{#switch:{{{a|}}}|l|loc|local= '''{{Color|blue|local}}'''|g|glob|global= '''{{Color|darkorange|global}}'''|n/a}}<br>
+
  {| class="argeff"
Effect(s):  {{#switch:{{{e|}}}|l|loc|local= '''{{Color|blue|local}}'''|g|glob|global= '''{{Color|darkorange|global}}'''|'''''{{Color|grey|unknown}}'''''}}</div>
+
| 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 style="border-left: .5em solid #380; border-bottom: .1em solid #380; padding-left: .5em" id="Description">Description</h2>
+
<h2 id="Description">Description</h2>
 
{{#if:{{{d|}}}|{{{d}}}}}
 
{{#if:{{{d|}}}|{{{d}}}}}
 
}}
 
}}
 
{{#if:{{{s|}}}|
 
{{#if:{{{s|}}}|
<h2 style="border-left: .5em solid #380; border-bottom: .1em solid #380; padding-left: .5em" id="Syntax">Syntax</h2>
+
<h2 id="Syntax">Syntax</h2>
 
<dl>
 
<dl>
<dt style="float: left">Syntax</dt>
+
<dt>Syntax</dt>
<dd style="padding-left: 10em">{{{s}}}</dd>
+
<dd>{{{s}}}</dd>
 
{{#if:{{{p1n|}}}|
 
{{#if:{{{p1n|}}}|
<dt style="float: left">Parameters</dt>
+
<dt>Parameters</dt>
<dd style="padding-left: 10em">{{{p1n}}}{{#if:{{{p1t|}}}|<nowiki/>: {{DataType|{{{p1t}}}}}}}{{#if:{{{p1d|}}}{{{p1v|}}}|<nowiki/> - {{#if:{{{p1v|}}}|<nowiki/> (Optional, default <code>{{{p1v}}}</code>)}}{{#if:{{{p1d|}}}|<nowiki/> {{{p1d}}}}}}}</dd><!--
+
{{Function/parameter|{{{p1n|}}}|{{{p1t|}}}|{{{p1d|}}}|{{{p1v|}}}}}<!--
-->{{#if:{{{p2n|}}}|<dd style="padding-left: 10em">{{{p2n}}}{{#if:{{{p2t|}}}|<nowiki/>: {{DataType|{{{p2t}}}}}}}{{#if:{{{p2d|}}}{{{p2v|}}}|<nowiki/> - {{#if:{{{p2v|}}}|<nowiki/> (Optional, default <code>{{{p2v}}}</code>)}}{{#if:{{{p2d|}}}|<nowiki/> {{{p2d}}}}}}}</dd>}}<!--
+
-->{{Function/parameter|{{{p2n|}}}|{{{p2t|}}}|{{{p2d|}}}|{{{p2v|}}}}}<!--
-->{{#if:{{{p3n|}}}|<dd style="padding-left: 10em">{{{p3n}}}{{#if:{{{p3t|}}}|<nowiki/>: {{DataType|{{{p3t}}}}}}}{{#if:{{{p3d|}}}{{{p3v|}}}|<nowiki/> - {{#if:{{{p3v|}}}|<nowiki/> (Optional, default <code>{{{p3v}}}</code>)}}{{#if:{{{p3d|}}}|<nowiki/> {{{p3d}}}}}}}</dd>}}<!--
+
-->{{Function/parameter|{{{p3n|}}}|{{{p3t|}}}|{{{p3d|}}}|{{{p3v|}}}}}<!--
-->{{#if:{{{p4n|}}}|<dd style="padding-left: 10em">{{{p4n}}}{{#if:{{{p4t|}}}|<nowiki/>: {{DataType|{{{p4t}}}}}}}{{#if:{{{p4d|}}}{{{p4v|}}}|<nowiki/> - {{#if:{{{p4v|}}}|<nowiki/> (Optional, default <code>{{{p4v}}}</code>)}}{{#if:{{{p4d|}}}|<nowiki/> {{{p4d}}}}}}}</dd>}}<!--
+
-->{{Function/parameter|{{{p4n|}}}|{{{p4t|}}}|{{{p4d|}}}|{{{p4v|}}}}}<!--
-->{{#if:{{{p5n|}}}|<dd style="padding-left: 10em">{{{p5n}}}{{#if:{{{p5t|}}}|<nowiki/>: {{DataType|{{{p5t}}}}}}}{{#if:{{{p5d|}}}{{{p5v|}}}|<nowiki/> - {{#if:{{{p5v|}}}|<nowiki/> (Optional, default <code>{{{p5v}}}</code>)}}{{#if:{{{p5d|}}}|<nowiki/> {{{p5d}}}}}}}</dd>}}<!--
+
-->{{Function/parameter|{{{p5n|}}}|{{{p5t|}}}|{{{p5d|}}}|{{{p5v|}}}}}<!--
-->{{#if:{{{p6n|}}}|<dd style="padding-left: 10em">{{{p6n}}}{{#if:{{{p6t|}}}|<nowiki/>: {{DataType|{{{p6t}}}}}}}{{#if:{{{p6d|}}}{{{p6v|}}}|<nowiki/> - {{#if:{{{p6v|}}}|<nowiki/> (Optional, default <code>{{{p6v}}}</code>)}}{{#if:{{{p6d|}}}|<nowiki/> {{{p6d}}}}}}}</dd>}}<!--
+
-->{{Function/parameter|{{{p6n|}}}|{{{p6t|}}}|{{{p6d|}}}|{{{p6v|}}}}}<!--
-->{{#if:{{{p7n|}}}|<dd style="padding-left: 10em">{{{p7n}}}{{#if:{{{p7t|}}}|<nowiki/>: {{DataType|{{{p7t}}}}}}}{{#if:{{{p7d|}}}{{{p7v|}}}|<nowiki/> - {{#if:{{{p7v|}}}|<nowiki/> (Optional, default <code>{{{p7v}}}</code>)}}{{#if:{{{p7d|}}}|<nowiki/> {{{p7d}}}}}}}</dd>}}<!--
+
-->{{Function/parameter|{{{p7n|}}}|{{{p7t|}}}|{{{p7d|}}}|{{{p7v|}}}}}<!--
-->{{#if:{{{p8n|}}}|<dd style="padding-left: 10em">{{{p8n}}}{{#if:{{{p8t|}}}|<nowiki/>: {{DataType|{{{p8t}}}}}}}{{#if:{{{p8d|}}}{{{p8v|}}}|<nowiki/> - {{#if:{{{p8v|}}}|<nowiki/> (Optional, default <code>{{{p8v}}}</code>)}}{{#if:{{{p8d|}}}|<nowiki/> {{{p8d}}}}}}}</dd>}}<!--
+
-->{{Function/parameter|{{{p8n|}}}|{{{p8t|}}}|{{{p8d|}}}|{{{p8v|}}}}}<!--
-->{{#if:{{{p9n|}}}|<dd style="padding-left: 10em">{{{p9n}}}{{#if:{{{p9t|}}}|<nowiki/>: {{DataType|{{{p9t}}}}}}}{{#if:{{{p9d|}}}{{{p9v|}}}|<nowiki/> - {{#if:{{{p9v|}}}|<nowiki/> (Optional, default <code>{{{p9v}}}</code>)}}{{#if:{{{p9d|}}}|<nowiki/> {{{p9d}}}}}}}</dd>}}<!--
+
-->{{Function/parameter|{{{p9n|}}}|{{{p9t|}}}|{{{p9d|}}}|{{{p9v|}}}}}<!--
-->{{#if:{{{p10n|}}}|<dd style="padding-left: 10em">{{{p10n}}}{{#if:{{{p10t|}}}|<nowiki/>: {{DataType|{{{p10t}}}}}}}{{#if:{{{p10d|}}}{{{p10v|}}}|<nowiki/> - {{#if:{{{p10v|}}}|<nowiki/> (Optional, default <code>{{{p10v}}}</code>)}}{{#if:{{{p10d|}}}|<nowiki/> {{{p10d}}}}}}}</dd>}}
+
-->{{Function/parameter|{{{p10n|}}}|{{{p10t|}}}|{{{p10d|}}}|{{{p10v|}}}}}
 
}}
 
}}
{{#if:{{{r1t|}}}{{{r1d|}}}|<dt style="float: left">Return value:</dt><dd style="padding-left: 10em">{{#if:{{{r1t|}}}|{{DataType|{{{r1t}}}}}{{#if:{{{r1d|}}}|<nowiki> - </nowiki>}}}}{{{r1d|}}}</dd>}}
+
<dt>Return value</dt>
 +
<dd>{{DataType|{{{r1t|}}}}}{{#if:{{{r1d|}}}|<nowiki> - </nowiki>{{{r1d}}}}}</dd>
 
</dl>
 
</dl>
 
}}
 
}}
 
{{#if:{{{x1|}}}|
 
{{#if:{{{x1|}}}|
<h2 style="border-left: .5em solid #380; border-bottom: .1em solid #380; padding-left: .5em" id="Examples">Examples</h2>
+
<h2 id="Examples">Examples</h2>
 
<dl>
 
<dl>
<dt style="float: left">Example 1:</dt><dd style="padding-left: 10em">{{{x1}}}</dt>
+
<dt>Example 1</dt><dd>{{{x1}}}</dt>
{{#if:{{{x2|}}}|<dt style="float: left">Example 2:</dt><dd style="padding-left: 10em">{{{x2}}}</dd>}}
+
{{#if:{{{x2|}}}|<dt>Example 2</dt><dd>{{{x2}}}</dd>}}
{{#if:{{{x3|}}}|<dt style="float: left">Example 3:</dt><dd style="padding-left: 10em">{{{x3}}}</dd>}}
+
{{#if:{{{x3|}}}|<dt>Example 3</dt><dd>{{{x3}}}</dd>}}
{{#if:{{{x4|}}}|<dt style="float: left">Example 4:</dt><dd style="padding-left: 10em">{{{x4}}}</dd>}}
+
{{#if:{{{x4|}}}|<dt>Example 4</dt><dd>{{{x4}}}</dd>}}
{{#if:{{{x5|}}}|<dt style="float: left">Example 5:</dt><dd style="padding-left: 10em">{{{x5}}}</dd>}}
+
{{#if:{{{x5|}}}|<dt>Example 5</dt><dd>{{{x5}}}</dd>}}
{{#if:{{{x6|}}}|<dt style="float: left">Example 6:</dt><dd style="padding-left: 10em">{{{x6}}}</dd>}}
+
{{#if:{{{x6|}}}|<dt>Example 6</dt><dd>{{{x6}}}</dd>}}
{{#if:{{{x7|}}}|<dt style="float: left">Example 7:</dt><dd style="padding-left: 10em">{{{x7}}}</dd>}}
+
{{#if:{{{x7|}}}|<dt>Example 7</dt><dd>{{{x7}}}</dd>}}
{{#if:{{{x8|}}}|<dt style="float: left">Example 8:</dt><dd style="padding-left: 10em">{{{x8}}}</dd>}}
+
{{#if:{{{x8|}}}|<dt>Example 8</dt><dd>{{{x8}}}</dd>}}
{{#if:{{{x9|}}}|<dt style="float: left">Example 9:</dt><dd style="padding-left: 10em">{{{x9}}}</dd>}}
+
{{#if:{{{x9|}}}|<dt>Example 9</dt><dd>{{{x9}}}</dd>}}
{{#if:{{{x10|}}}|<dt style="float: left">Example 10:</dt><dd style="padding-left: 10em">{{{x10}}}</dd>}}
+
{{#if:{{{x10|}}}|<dt>Example 10</dt><dd>{{{x10}}}</dd>}}
 
</dl>
 
</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></includeonly><noinclude><!--
 
</div></includeonly><noinclude><!--
Line 67: Line 83:
 
{| class="wikitable"
 
{| class="wikitable"
 
! Argument !! Name !! Description
 
! Argument !! Name !! Description
 +
|-
 +
| author || Author || function's author(s)
 
|-
 
|-
 
| v || Version || {{vn}}'s version.<br>'''Note:''' '''not''' {{arma3}} version!
 
| v || Version || {{vn}}'s version.<br>'''Note:''' '''not''' {{arma3}} version!
Line 73: Line 91:
 
|-
 
|-
 
| e || Effect(s) locality || same as ''a'' for effect(s) locality
 
| 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>
Line 105: Line 127:
 
<pre>
 
<pre>
 
{{Function
 
{{Function
 +
 +
|author= author
  
 
|v= 1.00
 
|v= 1.00
Line 112: Line 136:
 
|e= effectsLocality
 
|e= effectsLocality
  
|d= DESCRIPTION
+
|n= serverOnly
 +
 
 +
|g1= group
 +
 
 +
|d= description
  
 
|s= [] call [[FUNCTION]]
 
|s= [] call [[FUNCTION]]
Line 137: Line 165:
 
<pre>
 
<pre>
 
{{Function
 
{{Function
 +
 +
|author= John Doe
  
 
|v= 1.00
 
|v= 1.00
Line 143: Line 173:
  
 
|e= global
 
|e= global
 +
 +
|n= server
 +
 +
|g1= Command Group
  
 
|d= Sets provided unit's direction.
 
|d= Sets provided unit's direction.
Line 172: Line 206:
 
<div style="border: 0.25em solid lightgrey; margin: 0 4em; padding: 2em">
 
<div style="border: 0.25em solid lightgrey; margin: 0 4em; padding: 2em">
 
{{Function
 
{{Function
 +
 +
|author= John Doe
  
 
|v= 1.00
 
|v= 1.00
Line 178: Line 214:
  
 
|e= global
 
|e= global
 +
 +
|n= server
 +
 +
|g1= Command Group
  
 
|d= Sets provided unit's direction.
 
|d= Sets provided unit's direction.

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 server 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 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
Argument(s): local
Effect(s): global
Execution: Server only

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;