Difference between revisions of "Template:Function"

From the Fallout3 GECK Wiki
Jump to navigation Jump to search
imported>Qazaaq
m (add a linebreak before the if then)
imported>Pintocat
 
(64 intermediate revisions by 12 users not shown)
Line 1: Line 1:
<noinclude>
<noinclude>
__NOTOC__
{{Incomplete}}
{{Incomplete}}


This is a WIP, feedback is appreciated. To retain readability a lot of HTML comments are used, they shouldn't impact the working of the template, but could add to the confusion a bit. Example in the [[Sandbox#Function_Template_Test|Sandbox]].</noinclude><includeonly><!--
This is a WIP, feedback is appreciated. To retain readability a lot of HTML comments are used, they shouldn't impact the working of the template, but could add to the confusion a bit. Example in the [[Sandbox#Function_Template_Test|Sandbox]].
 
{{Template:Community_Wiki}}
 
<nowiki>{{Function</nowiki>
  ''CSWikiPage''        = name of corresponding page on the [http://cs.elderscrolls.com/constwiki/index.php/Category:Functions TES CS Wiki]
  origin            = whether the function came from the GECK itself or was added by a script extender.
                      valid values: GECK1 (GECK 1.1), GECK1.5 (GECK 1.5), FOSE1 (FOSE v1),
                      VEGAS1 (GECK 1.1 New Vegas), NVSE (NVSE), NX (NX plugin), LU (Lutana Plugin), PN (Project Nevada), MCM (MCM), UDF (UDF), JIP (JIP)
  summary          = description of the function
  ''name''              = the name of the function. The page name is the default value.
  ''alias''            = An abbreviated version of the function name that can be
                      used instead of the long name.
  ''returnVal ''        = what the function returns.
  ''returnType''        = the type of the returned value.
  ''referenceType''    = if appropriate, the type of reference that the function may be called
                      on with the dot syntax
  ''arguments''        = List of arguments specified using the [[Template:FunctionArgument]] template,
                      or any other wiki syntax.
  ''example''          = optionally, the function used as part of a script to serve as an example
  ''CategoryList''      = the list of categories to which the page belongs
<nowiki>}}</nowiki>
 
=Example=
 
<pre>{{Function
|CSWikiPage = Test
|origin = GECK1
|summary = Used to test actor and activator references to assure that they are testable.
|name = Test
|alias = tst
|returnVal = 0, 1
|returnType = void
|referenceType = [Actor, Activator]
|arguments =
  {{FunctionArgument
  |Name = Count
  |Type = int
  |Value = 1, 2, 3
  }}{{FunctionArgument
  |Name = Target
  |Type = ref
  |Optional = y
  }}
|example = Player.Test 3
ShackDoor.Test 1 Molerat01
}}</pre>
 
=Result=
 
{{Function
|CSWikiPage = Test
|origin = GECK1
|summary = Used to test actor and activator references to assure that they are testable.
|name = Test
|alias = tst
|returnVal = 0, 1
|returnType = void
|referenceType = [Actor, Activator]
|arguments =
  {{FunctionArgument
  |Name = Count
  |Type = int
  |Value = 1, 2, 3
  }}{{FunctionArgument
  |Name = Target
  |Type = ref
  |Optional = y
  }}
|example = Player.Test 3
ShackDoor.Test 1 Molerat01
}}
 
</noinclude><includeonly>__NOEDITSECTION__<!--
 
Back to: link-->{{Bc|Category:Functions}}<!--


link to the CS Wiki page
link to the CS Wiki page
-->{{ #if: {{{CSWikiPage|}}} | Link to TES4 Construction Set Wiki: [http://cs.elderscrolls.com/constwiki/index.php/{{{CSWikiPage}}} {{{CSWikiPage}}}].|}}<!--
-->{{ #if: {{{CSWikiPage|}}} | Link to TES4 Construction Set Wiki: [http://cs.elderscrolls.com/index.php?title={{{CSWikiPage}}} {{{CSWikiPage}}}].|<!-- no CSwiki page -->}}<!--


line about the origin of the function (GECK1, FOSE0001)
line about the origin of the function (GECK1, FOSE1)
-->
-->
{{ #switch: {{{origin}}}
{{ #switch: {{{origin}}}
| GECK1    = A command included in the original GECK.
| GECK1    = A function included in the GECK version 1.1.0.36.
| FOSE0001 = A command for the [[Fallout Script Extender]].
| GECK1.5 = A function included in the GECK version 1.5.0.19.
| VEGAS1 = A function included in the GECK Version 1.1.0.262 for '''Fallout: New Vegas'''.
| FOSE1 = A function added by the [[Fallout Script Extender]].
| NVSE = A function added by the [[New Vegas Script Extender]].
| NX = A function added by the [[NX]] NVSE plugin.
| PN = A function added by the [[PN|Project Nevada]] NVSE plugin.
| LU = A function added by the [[Lutana]] NVSE plugin.
| MCM = A function added the [[MCM]] NVSE plugin.
| JIP = A function added by the [[Functions_(JIP)|JIP NVSE Plugin]].
| UDF = An example [[User Defined Function|UDF]] script.
| #default = {{Error|missing function origin info}}
| #default = {{Error|missing function origin info}}
}}<!--
}}<!--
Line 22: Line 106:
<!-- syntax starts here: -->
<!-- syntax starts here: -->
== Syntax ==
== Syntax ==
<!-- help link -->
<div style="font-size:10px;margin-top:-3em;margin-left:6.3em;">[[Function syntax|[help]]]</div>


<!-- return value:
<!-- return value:
--> {{ #ifeq: {{{returnVal|missing}}} | missing | '''missing return value!''' | ({{{returnVal}}}|}}<!--
--> {{ #ifeq: {{{returnType|void}}} | void |<!-- no Return Value -->|({{ #if: {{{returnVal|}}} | {{{returnVal}}}<nowiki>:</nowiki> |}}<!--


return type (short, float, base object, ref, something else?):
return type (short, float, base object, ref, something else?):
-->{{ #if: {{{returnType|}}} |:{{{returnType}}}|}}<!--
-->{{ #ifeq: {{{returnType|missing}}} | missing | '''missing return type!''' | {{{returnType}}})&nbsp; }} }}<!--
 
closing parenthesis:
-->{{ #if: {{{returnVal|}}} |)&nbsp;|}}<!--


optional reference type (actor, activator, door, etc.):
optional reference type (actor, activator, door, etc.):
-->{{ #if: {{{referenceType|}}} |''{{{referenceType}}}.''|}}<!--
-->{{ #if: {{{referenceType|}}} |''{{{referenceType}}}.''|<!-- no Reference Type -->}}<!--


the actual function:
the actual function:
-->{{{name}}}<!--
-->{{{name|{{PAGENAME}}}}}<!--
 
arguments
-->{{ #if: {{{arguments|}}} | {{{arguments}}} |<!-- no Arguments -->}}<!--
 
<!-- FOR ALIAS: return value:
-->{{ #if: {{{alias|}}} | &nbsp;
Or:
{{ #ifeq: {{{returnType|void}}} | void |<!-- no Return Value -->|({{ #if: {{{returnVal|}}} | {{{returnVal}}}<nowiki>:</nowiki> |}}<!--
 
return type (short, float, base object, ref, something else?):
-->{{ #ifeq: {{{returnType|missing}}} | missing | '''missing return type!''' | {{{returnType}}})&nbsp; }} }}<!--
 
optional reference type (actor, activator, door, etc.):
-->{{ #if: {{{referenceType|}}} |''{{{referenceType}}}.''|<!-- no Reference Type -->}}<!--


required arguments + types:
alias:
-->{{ #if: {{{arg0|}}} | &nbsp;{{{arg0}}}:{{{arg0Type}}}&nbsp; |}}<!--
-->{{{alias}}}<!--
-->{{ #if: {{{arg1|}}} | &nbsp;{{{arg1}}}:{{{arg1Type}}}&nbsp; |}}<!--
-->{{ #if: {{{arg2|}}} | &nbsp;{{{arg2}}}:{{{arg2Type}}}&nbsp; |}}<!--
-->{{ #if: {{{arg3|}}} | &nbsp;{{{arg3}}}:{{{arg3Type}}}&nbsp; |}}<!--
-->{{ #if: {{{arg4|}}} | &nbsp;{{{arg4}}}:{{{arg4Type}}}&nbsp; |}}<!--
-->{{ #if: {{{arg5|}}} | &nbsp;{{{arg5}}}:{{{arg5Type}}}&nbsp; |}}<!--
-->{{ #if: {{{arg6|}}} | &nbsp;{{{arg6}}}:{{{arg6Type}}}&nbsp; |}}<!--
-->{{ #if: {{{arg7|}}} | &nbsp;{{{arg7}}}:{{{arg7Type}}}&nbsp; |}}<!--
-->{{ #if: {{{arg8|}}} | &nbsp;{{{arg8}}}:{{{arg8Type}}}&nbsp; |}}<!--
-->{{ #if: {{{arg9|}}} | &nbsp;{{{arg9}}}:{{{arg9Type}}}&nbsp; |}}<!--


optional arguments + types:
arguments
-->{{ #if: {{{optarg0|}}} | &nbsp;''{{{optarg0}}}:{{{optarg0Type}}}''&nbsp; |}}<!--
-->{{ #if: {{{arguments|}}} | {{{arguments}}} |<!-- no Arguments -->}}|<!-- no Alias -->}}<!--
-->{{ #if: {{{optarg1|}}} | &nbsp;''{{{optarg1}}}:{{{optarg1Type}}}''&nbsp; |}}<!--
-->{{ #if: {{{optarg2|}}} | &nbsp;''{{{optarg2}}}:{{{optarg2Type}}}''&nbsp; |}}<!--
-->{{ #if: {{{optarg3|}}} | &nbsp;''{{{optarg3}}}:{{{optarg3Type}}}''&nbsp; |}}<!--
-->{{ #if: {{{optarg4|}}} | &nbsp;''{{{optarg4}}}:{{{optarg4Type}}}''&nbsp; |}}<!--
-->{{ #if: {{{optarg5|}}} | &nbsp;''{{{optarg5}}}:{{{optarg5Type}}}''&nbsp; |}}<!--
-->{{ #if: {{{optarg6|}}} | &nbsp;''{{{optarg6}}}:{{{optarg6Type}}}''&nbsp; |}}<!--
-->{{ #if: {{{optarg7|}}} | &nbsp;''{{{optarg7}}}:{{{optarg7Type}}}''&nbsp; |}}<!--
-->{{ #if: {{{optarg8|}}} | &nbsp;''{{{optarg8}}}:{{{optarg8Type}}}''&nbsp; |}}<!--
-->{{ #if: {{{optarg9|}}} | &nbsp;''{{{optarg9}}}:{{{optarg9Type}}}''&nbsp; |}}<!--


example: -->
example: -->
{{ #if: {{{example|}}} | == Example == &nbsp;{{{example}}} |}}<!--
{{ #if: {{{example|}}} | == Example ==
{{{example}}} |<!-- no Example -->}}<!--


categorization code (needs something clever): -->{{{CategoryList|}}}</includeonly>
categorization code (needs something clever): -->{{{CategoryList|}}}</includeonly>

Latest revision as of 13:25, 7 May 2017


This article is incomplete. You can help by filling in any blank descriptions.
Further information might be found in a section of the discussion page. Please remove this message when no longer necessary.

This is a WIP, feedback is appreciated. To retain readability a lot of HTML comments are used, they shouldn't impact the working of the template, but could add to the confusion a bit. Example in the Sandbox.


Please Note: The official wiki is no longer being maintained by the community

The modding community for Fallout 3 and Fallout New Vegas has created its own wiki due to onerous and painful captcha requirements for every edit.

The active wiki contributors have moved to the new wiki -- for the most current information, visit:

http://geckwiki.com

{{Function
 CSWikiPage        = name of corresponding page on the TES CS Wiki
 origin            = whether the function came from the GECK itself or was added by a script extender.
                     valid values: GECK1 (GECK 1.1), GECK1.5 (GECK 1.5), FOSE1 (FOSE v1),
                     VEGAS1 (GECK 1.1 New Vegas), NVSE (NVSE), NX (NX plugin), LU (Lutana Plugin), PN (Project Nevada), MCM (MCM), UDF (UDF), JIP (JIP)
 summary           = description of the function
 name              = the name of the function. The page name is the default value.
 alias             = An abbreviated version of the function name that can be
                     used instead of the long name.
 returnVal         = what the function returns.
 returnType        = the type of the returned value.
 referenceType     = if appropriate, the type of reference that the function may be called
                     on with the dot syntax
 arguments         = List of arguments specified using the Template:FunctionArgument template,
                     or any other wiki syntax.
 example           = optionally, the function used as part of a script to serve as an example
 CategoryList      = the list of categories to which the page belongs
}}

Example

{{Function
 |CSWikiPage = Test
 |origin = GECK1
 |summary = Used to test actor and activator references to assure that they are testable.
 |name = Test
 |alias = tst
 |returnVal = 0, 1
 |returnType = void
 |referenceType = [Actor, Activator]
 |arguments = 
  {{FunctionArgument
   |Name = Count
   |Type = int
   |Value = 1, 2, 3
  }}{{FunctionArgument
   |Name = Target
   |Type = ref
   |Optional = y
  }}
 |example = Player.Test 3
 ShackDoor.Test 1 Molerat01
}}

Result

Link to TES4 Construction Set Wiki: Test.

A function included in the GECK version 1.1.0.36.

Description

Used to test actor and activator references to assure that they are testable.

Syntax

[help]
[Actor, Activator].Test Count:int{1, 2, 3} Target:ref 

Or: 

[Actor, Activator].tst Count:int{1, 2, 3} Target:ref

Example

Player.Test 3
ShackDoor.Test 1 Molerat01


Retrieved from "https://geck.uesp.net/w/index.php?title=Template:Function&oldid=190"