Template:LSL Function: Difference between revisions
Jump to navigation
Jump to search
No edit summary |
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