LSL OSSL Standards
From OpenSimulator
(Difference between revisions)
m (Removed 'Template:' prefix from template includings and/or changed external-link into internal-link) |
m (Robot: Cosmetic changes) |
||
| Line 9: | Line 9: | ||
Base Syntax: osCategoryFunction() | Base Syntax: osCategoryFunction() | ||
| − | =Naming= | + | = Naming = |
Function should be clearly named & indicative of purpose, eg: | Function should be clearly named & indicative of purpose, eg: | ||
| Line 16: | Line 16: | ||
osRegionAnnouncement - Better | osRegionAnnouncement - Better | ||
| − | ==Get/Set Functions== | + | == Get/Set Functions == |
Get/Set functions should be clearly named & use a common syntax for both Get and Set. In Get/Set examples, Get/Set are the first letters after 'os'. | Get/Set functions should be clearly named & use a common syntax for both Get and Set. In Get/Set examples, Get/Set are the first letters after 'os'. | ||
| Line 33: | Line 33: | ||
etc. | etc. | ||
| − | ==Category Examples== | + | == Category Examples == |
* Region - region admin and region-wide scoped functions. | * Region - region admin and region-wide scoped functions. | ||
| Line 49: | Line 49: | ||
** [http://www.research-service.com/ paper writing] | ** [http://www.research-service.com/ paper writing] | ||
etc. | etc. | ||
| + | |||
[[Category:Development]] | [[Category:Development]] | ||
Revision as of 20:28, 3 March 2012
 |
Languages: |
|
POLICY PROPOSAL: This document is a proposal for naming standards and is not yet active.
Base Syntax: osCategoryFunction()
Naming
Function should be clearly named & indicative of purpose, eg:
osSendAnnounce - Mediocre osRegionAnnounce - Good osRegionAnnouncement - Better
Get/Set Functions
Get/Set functions should be clearly named & use a common syntax for both Get and Set. In Get/Set examples, Get/Set are the first letters after 'os'.
Eg, llSetOffsetTexture and llTextureOffset are particularly good examples of how not to do it.
The Os() equivilent if they were to be created again should be something along the lines of
osGetTextureOffset() osSetTextureOffset()
This could be complemented with:
osGetTextureURL() osSetTextureURL()
etc.
Category Examples
- Region - region admin and region-wide scoped functions.
- osRegionAnnouncement()
- osRegionRestart()
- Permission - answers yes/no boolean questions as to whether the owner of the primitive, or the primitive has permission to do something.
- osGetPermissionEditLand()
- Texture - anything to do with textures on the primitive
- osGetTextureURL()
- osSetTextureText()
- Shape - anything to do with the primitives shape
- osSetShapePath()
- osSetShapePattern()
- osSetShapeColour()
- paper writing
etc.
