OSSL Standards

From OpenSimulator

(Difference between revisions)
Jump to: navigation, search
(Naming)
m (Robot: Cosmetic changes)
 
(3 intermediate revisions by 3 users not shown)
Line 1: Line 1:
 
__NOTOC__
 
__NOTOC__
{{Template:Quicklinks}}
+
{{Quicklinks}}
 
<br />
 
<br />
  
Line 9: Line 9:
 
Base Syntax: osCategoryFunction()
 
Base Syntax: osCategoryFunction()
  
=Naming=
+
= Naming =
 
Function and parameter names should use US English spelling. <!-- Why? What's the rationale behind this? Please explain. -->
 
Function and parameter names should use US English spelling. <!-- Why? What's the rationale behind this? Please explain. -->
  
Line 18: Line 18:
 
osRegionAnnouncement - Better<br />
 
osRegionAnnouncement - Better<br />
  
==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 35: Line 35:
 
etc.
 
etc.
  
==Category Examples==
+
== Category Examples ==
  
 
* Region - region admin and region-wide scoped functions.
 
* Region - region admin and region-wide scoped functions.
Line 54: Line 54:
 
= See Also =
 
= See Also =
 
* [[LSL Status|LSL/OSSL Status Page]]
 
* [[LSL Status|LSL/OSSL Status Page]]
* LSL
 
** [[LSL Status/Types|LSL Types Status Page]]
 
** [[LSL Status/Events|LSL Events Status Page]]
 
** [[LSL Status/Functions|LSL Functions Status Page]]
 
** [[LSL_Status/functions/summary | LSL Functions Status Summary]]
 
** [[LSL_Known_Issues| LSL Known Issues]]
 
** [[Kan-Ed_Tests| Kan-Ed Tests]]
 
 
* OSSL
 
* OSSL
** [[OSSL Status/Types |OSSL Types Status Page]]
+
** [[OSSL Status/Types|OSSL Types Status Page]]
** [[OSSL Status/Events |OSSL Events Status Page]]
+
** [[OSSL Status/Events|OSSL Events Status Page]]
** [[OSSL_Proposals | OSSL Proposed Functions]]
+
** [[OSSL Proposals|OSSL Proposed Functions]]
** [[OSSL_Implemented | OSSL Implemented Functions]]
+
** [[OSSL Implemented|OSSL Implemented Functions]]
** [[OSSL_Standards | OSSL Standards]]
+
** [[OSSL Standards]]
* [[Technical_Reference|Technical Reference Page]]
+
  
 
[[Category:Development]]
 
[[Category:Development]]
 +
[[Category:OSSL]]

Latest revision as of 20:41, 3 March 2012


POLICY PROPOSAL: This document is a proposal for naming standards and is not yet active.


Base Syntax: osCategoryFunction()

[edit] Naming

Function and parameter names should use US English spelling.

Function should be clearly named & indicative of purpose, eg:

osSendAnnounce - Mediocre
osRegionAnnounce - Good
osRegionAnnouncement - Better

[edit] 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.

[edit] 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()

etc.

[edit] See Also

Personal tools
General
About This Wiki