Difference between revisions of "Template:LSL Function"
Jump to navigation
Jump to search
constants
m (~_~ had to be done) |
|||
Line 1: | Line 1: | ||
{{LSL Header}} __NOTOC__ <noinclude> | {{LSL Header}} __NOTOC__ <noinclude> | ||
See [[{{FULLPAGENAME}}/docs]] for additional documentation. | |||
<pre> | <pre> | ||
{{LSL_Function | {{LSL_Function | ||
Line 252: | Line 253: | ||
</div> | </div> | ||
</noinclude><includeonly>{{#vardefine:func_id|{{{func_id|}}}}}{{#vardefine:p1_name|{{{p1_name|}}}}}{{#vardefine:p1_type|{{{p1_type|}}}}}{{#vardefine:p1_desc|{{#var:p_{{#var:p1_name}}_desc}}{{{p1_desc|}}}}}{{#vardefine:p2_name|{{{p2_name|}}}}}{{#vardefine:p2_type|{{{p2_type|}}}}}{{#vardefine:p2_desc|{{#var:p_{{#var:p2_name}}_desc}}{{{p2_desc|}}}}}{{#vardefine:p3_name|{{{p3_name|}}}}}{{#vardefine:p3_type|{{{p3_type|}}}}}{{#vardefine:p3_desc|{{#var:p_{{#var:p3_name}}_desc}}{{{p3_desc|}}}}}{{#vardefine:p4_name|{{{p4_name|}}}}}{{#vardefine:p4_type|{{{p4_type|}}}}}{{#vardefine:p4_desc|{{#var:p_{{#var:p4_name}}_desc}}{{{p4_desc|}}}}}{{#vardefine:p5_name|{{{p5_name|}}}}}{{#vardefine:p5_type|{{{p5_type|}}}}}{{#vardefine:p5_desc|{{#var:p_{{#var:p5_name}}_desc}}{{{p5_desc|}}}}}{{#vardefine:p6_name|{{{p6_name|}}}}}{{#vardefine:p6_type|{{{p6_type|}}}}}{{#vardefine:p6_desc|{{#var:p_{{#var:p6_name}}_desc}}{{{p6_desc|}}}}}{{#vardefine:p7_name|{{{p7_name|}}}}}{{#vardefine:p7_type|{{{p7_type|}}}}}{{#vardefine:p7_desc|{{#var:p_{{#var:p7_name}}_desc}}{{{p7_desc|}}}}}{{#vardefine:p8_name|{{{p8_name|}}}}}{{#vardefine:p8_type|{{{p8_type|}}}}}{{#vardefine:p8_desc|{{#var:p_{{#var:p8_name}}_desc}}{{{p8_desc|}}}}}{{#vardefine:p9_name|{{{p9_name|}}}}}{{#vardefine:p9_type|{{{p9_type|}}}}}{{#vardefine:p9_desc|{{#var:p_{{#var:p9_name}}_desc}}{{{p9_desc|}}}}}{{#vardefine:p10_name|{{{p10_name|}}}}}{{#vardefine:p10_type|{{{p10_type|}}}}}{{#vardefine:p10_desc|{{#var:p_{{#var:p10_name}}_desc}}{{{p10_desc|}}}}}{{#vardefine:p11_name|{{{p11_name|}}}}}{{#vardefine:p11_type|{{{p11_type|}}}}}{{#vardefine:p11_desc|{{#var:p_{{#var:p11_name}}_desc}}{{{p11_desc|}}}}}{{#vardefine:p12_name|{{{p12_name|}}}}}{{#vardefine:p12_type|{{{p12_type|}}}}}{{#vardefine:p12_desc|{{#var:p_{{#var:p12_name}}_desc}}{{{p12_desc|}}}}}{{#vardefine:return_type|{{#var:return_type}}{{{return_type|}}} }}{{#vardefine:return_text|{{#var:return_text}}{{{return_text|}}} }}{{#vardefine:name|{{{func}}}}}{{#vardefine:constants_nb|{{#var:constants_nb}} | </noinclude><includeonly>{{#vardefine:func_id|{{{func_id|}}}}}{{#vardefine:p1_name|{{{p1_name|}}}}}{{#vardefine:p1_type|{{{p1_type|}}}}}{{#vardefine:p1_desc|{{#var:p_{{#var:p1_name}}_desc}}{{{p1_desc|}}}}}{{#vardefine:p2_name|{{{p2_name|}}}}}{{#vardefine:p2_type|{{{p2_type|}}}}}{{#vardefine:p2_desc|{{#var:p_{{#var:p2_name}}_desc}}{{{p2_desc|}}}}}{{#vardefine:p3_name|{{{p3_name|}}}}}{{#vardefine:p3_type|{{{p3_type|}}}}}{{#vardefine:p3_desc|{{#var:p_{{#var:p3_name}}_desc}}{{{p3_desc|}}}}}{{#vardefine:p4_name|{{{p4_name|}}}}}{{#vardefine:p4_type|{{{p4_type|}}}}}{{#vardefine:p4_desc|{{#var:p_{{#var:p4_name}}_desc}}{{{p4_desc|}}}}}{{#vardefine:p5_name|{{{p5_name|}}}}}{{#vardefine:p5_type|{{{p5_type|}}}}}{{#vardefine:p5_desc|{{#var:p_{{#var:p5_name}}_desc}}{{{p5_desc|}}}}}{{#vardefine:p6_name|{{{p6_name|}}}}}{{#vardefine:p6_type|{{{p6_type|}}}}}{{#vardefine:p6_desc|{{#var:p_{{#var:p6_name}}_desc}}{{{p6_desc|}}}}}{{#vardefine:p7_name|{{{p7_name|}}}}}{{#vardefine:p7_type|{{{p7_type|}}}}}{{#vardefine:p7_desc|{{#var:p_{{#var:p7_name}}_desc}}{{{p7_desc|}}}}}{{#vardefine:p8_name|{{{p8_name|}}}}}{{#vardefine:p8_type|{{{p8_type|}}}}}{{#vardefine:p8_desc|{{#var:p_{{#var:p8_name}}_desc}}{{{p8_desc|}}}}}{{#vardefine:p9_name|{{{p9_name|}}}}}{{#vardefine:p9_type|{{{p9_type|}}}}}{{#vardefine:p9_desc|{{#var:p_{{#var:p9_name}}_desc}}{{{p9_desc|}}}}}{{#vardefine:p10_name|{{{p10_name|}}}}}{{#vardefine:p10_type|{{{p10_type|}}}}}{{#vardefine:p10_desc|{{#var:p_{{#var:p10_name}}_desc}}{{{p10_desc|}}}}}{{#vardefine:p11_name|{{{p11_name|}}}}}{{#vardefine:p11_type|{{{p11_type|}}}}}{{#vardefine:p11_desc|{{#var:p_{{#var:p11_name}}_desc}}{{{p11_desc|}}}}}{{#vardefine:p12_name|{{{p12_name|}}}}}{{#vardefine:p12_type|{{{p12_type|}}}}}{{#vardefine:p12_desc|{{#var:p_{{#var:p12_name}}_desc}}{{{p12_desc|}}}}}{{#vardefine:return_type|{{#var:return_type}}{{{return_type|}}} }}{{#vardefine:return_text|{{#var:return_text}}{{{return_text|}}} }}{{#vardefine:name|{{{func}}}}}{{#vardefine:constants_nb|{{#var:constants_nb}} | ||
{{{constants|}}}}}{{#vardefine:spec|{{{spec|}}}}}{{#vardefine:examples|{{#var:examples}}{{{examples|}}}}}{{#vardefine:helpers|{{#var:helpers}}{{{helpers|}}}}}{{#vardefine:also_header|{{#var:also_header}}{{{also_header|}}}}}{{#vardefine:also_tests|{{#var:also_tests}}{{{also_tests|}}}}}{{#vardefine:also_events|{{#var:also_events}}{{{also_events|}}}}}{{#vardefine:also_functions|{{#var:also_functions}}{{{also_functions|}}}}}{{#vardefine:also_articles|{{#var:also_articles}}{{{also_articles|}}}}}{{#vardefine:also_footer|{{#var:also_footer}}{{{also_footer|}}}}}{{#vardefine:notes|{{#var:notes}}{{{notes|}}}}}{{#vardefine:mode|{{#var:mode}}{{{mode|}}}}}{{#vardefine:self|{{#var:self}}{{{self|}}}}}{{#vardefine:type|function}}{{#vardefine:template}}{{#vardefine:caveats|{{#ifexpr:{{{func_sleep|0.0}}}> 0.0|*This function causes the script to sleep for {{{func_sleep|}}} seconds.}}{{#if:{{#var:caveats}}| | {{{constants|}}}}}{{#vardefine:spec|{{#if:{{#var:spec}}|{{#var:spec}}<br/>}}{{{spec|}}}}}{{#vardefine:examples|{{#var:examples}}{{{examples|}}}}}{{#vardefine:helpers|{{#var:helpers}}{{{helpers|}}}}}{{#vardefine:also_header|{{#var:also_header}}{{{also_header|}}}}}{{#vardefine:also_tests|{{#var:also_tests}}{{{also_tests|}}}}}{{#vardefine:also_events|{{#var:also_events}}{{{also_events|}}}}}{{#vardefine:also_functions|{{#var:also_functions}}{{{also_functions|}}}}}{{#vardefine:also_articles|{{#var:also_articles}}{{{also_articles|}}}}}{{#vardefine:also_footer|{{#var:also_footer}}{{{also_footer|}}}}}{{#vardefine:notes|{{#var:notes}}{{{notes|}}}}}{{#vardefine:mode|{{#var:mode}}{{{mode|}}}}}{{#vardefine:self|{{#var:self}}{{{self|}}}}}{{#vardefine:type|function}}{{#vardefine:template}}{{#vardefine:caveats|{{#ifexpr:{{{func_sleep|0.0}}}> 0.0|*This function causes the script to sleep for {{{func_sleep|}}} seconds.}}{{#if:{{#var:caveats}}| | ||
{{#var:caveats}}}} | {{#var:caveats}}}} | ||
{{{caveats|}}}}}{{#vardefine:location|{{#var:location}}{{{location|}}}}}{{#vardefine:sort|{{#if:{{#var:sort}}|{{#var:sort}}|{{#if:{{{sort|}}}|{{{sort}}}|{{#ifeq:{{#sub:{{#var:name}}|0|2}}|ll|{{#sub:{{#var:name}}|2}}|{{#var:name}}}}}}}}}}{{#vardefine:return_end|<nowiki>;</nowiki>}}{{#vardefine:header_footnote|{{#if:{{#var:header_footnote}}|{{#var:header_footnote}}<br/>}}{{{func_footnote|}}}{{{func_footer|}}}}}{{#vardefine:header_desc|{{#if:{{#var:header_desc}}|{{#var:header_desc}}<br/>}}{{#var:header_desc}}{{{func_desc|}}}}}{{#ifeq:{{#var:mode}}|god|{{{{#ifeq:{{#var:mode}}|god|LSL_Generic/god|!}}|}} }}{{#ifeq:{{#var:mode}}|request|{{{{#ifeq:{{#var:mode}}|request|LSL_Generic/request|!}}|}} }}{{#if:{{{deprecated|}}}{{{depreciated|}}}|{{{{#if:{{{deprecated|}}}{{{depreciated|}}}|LSL_Generic/deprecated|!}}|{{{deprecated|}}}{{{depreciated|}}}|}}}}{{#if:{{{inventory|}}}|{{{{#if:{{{inventory|}}}|LSL_Function/inventory|!}}|{{{inventory|}}}|}}}}{{#if:{{{permission|}}}|{{{{#if:{{{permission|}}}|LSL_Function/permission|!}}|{{{permission|}}}|}}}}{{#if:{{{negative_index|}}}|{{{{#if:{{{negative_index|}}}|LSL_Function/negative_index|!}}|{{{negative_index|}}}|}}}}{{#if:{{#var:func_id}}{{#var:mode}}|| | {{{caveats|}}}}}{{#vardefine:location|{{#var:location}}{{{location|}}}}}{{#vardefine:sort|{{#if:{{#var:sort}}|{{#var:sort}}|{{#if:{{{sort|}}}|{{{sort}}}|{{#ifeq:{{#sub:{{#var:name}}|0|2}}|ll|{{#sub:{{#var:name}}|2}}|{{#var:name}}}}}}}}}}{{#vardefine:return_end|<nowiki>;</nowiki>}}{{#vardefine:header_footnote|{{#if:{{#var:header_footnote}}|{{#var:header_footnote}}<br/>}}{{{func_footnote|}}}{{{func_footer|}}}}}{{#vardefine:header_desc|{{#if:{{#var:header_desc}}|{{#var:header_desc}}<br/>}}{{#var:header_desc}}{{{func_desc|}}}}}{{#ifeq:{{#var:mode}}|god|{{{{#ifeq:{{#var:mode}}|god|LSL_Generic/god|!}}|}} }}{{#ifeq:{{#var:mode}}|request|{{{{#ifeq:{{#var:mode}}|request|LSL_Generic/request|!}}|}} }}{{#if:{{{deprecated|}}}{{{depreciated|}}}|{{{{#if:{{{deprecated|}}}{{{depreciated|}}}|LSL_Generic/deprecated|!}}|{{{deprecated|}}}{{{depreciated|}}}|}}}}{{#if:{{{inventory|}}}|{{{{#if:{{{inventory|}}}|LSL_Function/inventory|!}}|{{{inventory|}}}|}}}}{{#if:{{{permission|}}}|{{{{#if:{{{permission|}}}|LSL_Function/permission|!}}|{{{permission|}}}|}}}}{{#if:{{{negative_index|}}}|{{{{#if:{{{negative_index|}}}|LSL_Function/negative_index|!}}|{{{negative_index|}}}|}}}}{{#if:{{#var:func_id}}{{#var:mode}}|| | ||
Line 272: | Line 273: | ||
<td> {{HoverText|{{{func_sleep|}}}|The number of seconds this script will sleep after executing this function.}} | <td> {{HoverText|{{{func_sleep|}}}|The number of seconds this script will sleep after executing this function.}} | ||
<td> [[LSL Delay|Delay]] | <td> [[LSL Delay|Delay]] | ||
</tr><tr> | </tr>{{#if:{{{func_complexity|}}}|<tr> | ||
<td> {{HoverText|{{{func_complexity|}}}|The complexity of the function based on the parameters.}} | |||
<td> [[LSL Complexity|Compl.]] | |||
</tr>}}<tr> | |||
<td> {{HoverText|{{{func_energy|}}}|The quantity of energy consumed by this function.}} | <td> {{HoverText|{{{func_energy|}}}|The quantity of energy consumed by this function.}} | ||
<td> [[Energy|Energy]] | <td> [[Energy|Energy]] | ||
</tr></table>}}{{#vardefine:header_text|{{LSL Generic/Text}}}}{{#vardefine:header_title|Function: {{LSL Generic/Title}}}}{{#ifeq:{{{render|}}}|false||{{{{#ifeq:{{{render|}}}|false|!|LSL Generic}}|}}}}{{#if:{{#var:self}}|| {{#ifeq:{{#var:mode}}|request|| {{LSLC|Functions|{{#var:sort}}}} {{#if:{{#var:examples}}||{{LSLC|Needs Example|{{#var:sort}}}}}}}} {{#if:{{{cat1|}}}|{{LSLC|{{{cat1}}}|{{#var:sort}}}}}} {{#if:{{{cat2|}}}|{{LSLC|{{{cat2}}}|{{#var:sort}}}}}} {{#if:{{{cat3|}}}|{{LSLC|{{{cat3}}}|{{#var:sort}}}}}} {{#if:{{{cat4|}}}|{{LSLC|{{{cat4}}}|{{#var:sort}}}}}} {{#if:{{{cat5|}}}|{{LSLC|{{{cat5}}}|{{#var:sort}}}}}} {{#if:{{{cat6|}}}|{{LSLC|{{{cat6}}}|{{#var:sort}}}}}} {{#if:{{{cat7|}}}|{{LSLC|{{{cat7}}}|{{#var:sort}}}}}} {{#if:{{{cat8|}}}|{{LSLC|{{{cat8}}}|{{#var:sort}}}}}} }}</includeonly> | </tr></table>}}{{#vardefine:header_text|{{LSL Generic/Text}}}}{{#vardefine:header_title|Function: {{LSL Generic/Title}}}}{{#ifeq:{{{render|}}}|false||{{{{#ifeq:{{{render|}}}|false|!|LSL Generic}}|}}}}{{#if:{{#var:self}}|| {{#ifeq:{{#var:mode}}|request|| {{LSLC|Functions|{{#var:sort}}}} {{#if:{{#var:examples}}||{{LSLC|Needs Example|{{#var:sort}}}}}}}} {{#if:{{{cat1|}}}|{{LSLC|{{{cat1}}}|{{#var:sort}}}}}} {{#if:{{{cat2|}}}|{{LSLC|{{{cat2}}}|{{#var:sort}}}}}} {{#if:{{{cat3|}}}|{{LSLC|{{{cat3}}}|{{#var:sort}}}}}} {{#if:{{{cat4|}}}|{{LSLC|{{{cat4}}}|{{#var:sort}}}}}} {{#if:{{{cat5|}}}|{{LSLC|{{{cat5}}}|{{#var:sort}}}}}} {{#if:{{{cat6|}}}|{{LSLC|{{{cat6}}}|{{#var:sort}}}}}} {{#if:{{{cat7|}}}|{{LSLC|{{{cat7}}}|{{#var:sort}}}}}} {{#if:{{{cat8|}}}|{{LSLC|{{{cat8}}}|{{#var:sort}}}}}} }}</includeonly> |
Revision as of 18:13, 6 March 2007
LSL Portal | Functions | Events | Types | Operators | Constants | Flow Control | Script Library | Categorized Library | Tutorials |
See Template:LSL Function/docs for additional documentation.
{{LSL_Function |func |func_id |func_sleep |func_energy |sort |func_desc |func_footnote |return_type |return_text |p1_type|p1_name|p1_desc |p2_type|p2_name|p2_desc |p3_type|p3_name|p3_desc |p4_type|p4_name|p4_desc |p5_type|p5_name|p5_desc |p6_type|p6_name|p6_desc |p7_type|p7_name|p7_desc |p8_type|p8_name|p8_desc |p9_type|p9_name|p9_desc |p10_type|p10_name|p10_desc |p11_type|p11_name|p11_desc |p12_type|p12_name|p12_desc |constants |spec |caveats |examples |helpers |also_header |also_functions |also_tests |also_events |also_articles |also_footer |notes |mode |deprecated |location |inventory |permission |negative_index |cat1 |cat2 |cat3 |cat4 |cat5 |cat6 }}
The LSL_Function template is a intermediate template for LSL_Generic, which handles the formating for both functions and events (LSL_Event is also an intermediate template). The main job of this template is to change the parameter, names & setup the right-side floater. Also makes permission requirements a part of the template.
parameter | desc | example |
---|---|---|
func | Function name | |
func_id | Function ID | 1.0 |
func_sleep | Delay | 0.0 |
func_energy | Energy | 10.0 |
func_desc | Function description text. | Gives the monkey a banana |
func_footnote | Function footnote (appears after the parameters text). | Has the side effect of causing the avatar to run in circles shouting like on fire. |
return_type | return type | integer |
return_text | "Returns a return_type return_text" in most cases return_text can be used instead of func_desc. | that is a monkey |
p1_type | first parameter type | |
p1_name | first parameter name | |
p1_desc | first parameter desc | |
p2_type | second parameter type | |
p2_name | second parameter name | |
p2_desc | second parameter desc | |
... | ||
p12_type | twelfth parameter type | |
p12_name | twelfth parameter name | |
p12_desc | twelfth parameter desc | |
constants | constants area, no box, please use a table for this section. | |
spec | spec box | |
caveats | caveats box | |
examples | examples box | |
helpers | helper functions box | |
also_header | also header | |
also_functions | also functions indent | |
also_events | also events indent | |
also_articles | also articles indent | |
also_tests | also tests indent | |
also_footer | also footer | |
notes | notes box | |
mode | if mode equals 'god' then it is tagged as requiring godmode. if set to 'request' marks the page as a feature request. | |
deprecated | Marks the function as deprecated. Set the value to the replacement functions name or 'none'. If it is not set to none and it is infact set, it will include a link to the replacement function. | |
permission | Set to the PERMISSION_* flag that the function requires. It will amend the appropriate fields to show this requirement (without all the haste of doing it yourself) | PERMISSION_CHANGE_LINKS |
negative_index | 'true', 'false' or nothing. If set to true or false then it amends the appropriate fields so that the function is marked as supporting or not supporting negative indexes. | true |
self | Special field that you only set if you don't want the function to be included in any categories. | |
cat1 | An LSL specific category and sets the proper sort. (example would add the function to the "LSL Stub" category) | Stub |
cat2 | " | |
cat3 | " | |
cat4 | " | |
cat5 | " | |
cat6 | " | |
sort | not required but used to specify the sort order, if excluded the wiki will calculate this value for you. | |
location | optional: location box, used to say which source file it is defined in. | |
inventory | set to the name of the parameter that is an inventory item name. It makes a nice message in caveats about missing inventory items. |
LSL Portal | Functions | Events | Types | Operators | Constants | Flow Control | Script Library | Categorized Library | Tutorials |
Function: void MyFunction( integer i, float f, string s, key k, list l, vector v, rotation r );
Function: void MyFunction( integer i, float f, string s, key k, list l, vector v, rotation r );-1 | Function ID |
100.5 | Delay |
0.0 | Energy |
A fictitious function
Returns a void (aka nadda, nothing).
• integer | i | |||
• float | f | |||
• string | s | |||
• key | k | |||
• list | l | |||
• vector | v | |||
• rotation | r |
func_footnote
Specification
spec
Caveats
- This function causes the script to sleep for 100.5 seconds.
caveats
Examples
examples
Useful Snippets
helpers
Notes
notes
See Also
also_header
Events
- also_events
Functions
- also_functions
Articles
- also_articles
also_footer
Deep Notes
Tests
- also_tests
Source
location
MyFunction