Difference between revisions of "PRIM TEXT"

From Second Life Wiki
Jump to navigation Jump to search
m
Line 15: Line 15:


{{#vardefine:caveats|{{#var:caveats}}
{{#vardefine:caveats|{{#var:caveats}}
* Do not rely on {{#var:text_const}} as a secure storage medium. Floating text has been altered in past server updates, and even "invisible" floating text can be read by anybody who has a client modified to do so.}}
* Do not rely on {{LSLGC|Floating Text}} as a storage medium; it is neither secure nor finalized.
** Floating text has been altered in past server updates, breaking existing content; future changes may occur.
** Even "invisible"{{Footnote|Floating text with an '''{{LSL Param|alpha}}''' set to 1.0 is rendered "invisible"|Floating text with an alpha set to 1.0 is rendered "invisible"}} floating text is transmitted to the client.
*** It can be viewed by anyone with a client that is capable of rendering text that is supposed to be invisible.
*** The network packets that contain the text can be sniffed and the text read.}}


}}</onlyinclude>{{#if:
}}</onlyinclude>{{#if:
Line 24: Line 28:
|value=26
|value=26
|desc={{KBcaution|This function is not yet released and will be available with Server 1.38.}}
|desc={{KBcaution|This function is not yet released and will be available with Server 1.38.}}
Used to get or set the object's [[llSetText|floating text]].
Used to get or set the object's {{LSLGC|Floating Text|floating text}}.
|pa={{LSL Constant/List|i_front=[[llSetPrimitiveParams]]([ {{#var:text_const}},&#32;|i_end=&nbsp;]
|pa={{LSL Constant/List|i_front=[[llSetPrimitiveParams]]([ {{#var:text_const}},&#32;|i_end=&nbsp;]
|text=Syntax for: [[llSetPrimitiveParams]], [[llSetLinkPrimitiveParams]] & [[llSetLinkPrimitiveParamsFast]]
|text=Syntax for: [[llSetPrimitiveParams]], [[llSetLinkPrimitiveParams]] & [[llSetLinkPrimitiveParamsFast]]

Revision as of 15:36, 25 March 2010

Description

Constant: integer PRIM_TEXT = 26;

The integer constant PRIM_TEXT has the value 26

KBcaution.png Important: This function is not yet released and will be available with Server 1.38.

Used to get or set the object's floating text.

llSetPrimitiveParams

llSetPrimitiveParams([ PRIM_TEXT, string text, vector color, float alpha ]
• string text floating text to display
• vector color color in RGB <R, G, B> (<0.0, 0.0, 0.0> = black, <1.0, 1.0, 1.0> = white)
• float alpha from 0.0 (clear) to 1.0 (solid) (0.0 <= alpha <= 1.0)

Syntax for: llSetPrimitiveParams, llSetLinkPrimitiveParams & llSetLinkPrimitiveParamsFast

llGetPrimitiveParams

llGetPrimitiveParams([ PRIM_TEXT ]);

Returns the list [ string text, vector color, float alpha ]

• string text floating text displayed
• vector color color in RGB <R, G, B> (<0.0, 0.0, 0.0> = black, <1.0, 1.0, 1.0> = white)
• float alpha from 0.0 (clear) to 1.0 (solid) (0.0 <= alpha <= 1.0)

Syntax for: llGetPrimitiveParams, llGetLinkPrimitiveParams

Caveats

  • Do not rely on Floating Text as a storage medium; it is neither secure nor finalized.
    • Floating text has been altered in past server updates, breaking existing content; future changes may occur.
    • Even "invisible"[1] floating text is transmitted to the client.
      • It can be viewed by anyone with a client that is capable of rendering text that is supposed to be invisible.
      • The network packets that contain the text can be sniffed and the text read.
All Issues ~ Search JIRA for related Bugs

Deep Notes

Search JIRA for related Issues

Footnotes

  1. ^ Floating text with an alpha set to 1.0 is rendered "invisible"

Signature

integer PRIM_TEXT = 26;