Difference between revisions of "PRIM TEXT"

From Second Life Wiki
Jump to navigation Jump to search
m
m (just changed pre-release warning into LSL_Generic one..)
Line 24: Line 24:
}}</onlyinclude>{{#if:
}}</onlyinclude>{{#if:


}}{{LSL Constant
}}
{{LSL_Generic/pre-release|constant|server-release=1.38.0}}
{{LSL Constant
|name=PRIM_TEXT
|name=PRIM_TEXT
|type=integer
|type=integer
|value=26
|value=26
|desc={{KBcaution|This function is not yet released and will be available with Server 1.38.}}
|desc=Used to get or set the object's [[:Category:LSL Floating Text|floating text]].
Used to get or set the object's [[:Category:LSL 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 00:44, 11 April 2010

Emblem-important-red.png Pre-release Documentation Warning!

This constant is not available yet. This documentation was written prior to its final release so it may not match the final implementation.It is slated for release in Server 1.38.0.

Description

Constant: integer PRIM_TEXT = 26;

The integer constant PRIM_TEXT has the value 26

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

Related Articles

Functions

•  llSetPrimitiveParams
•  llSetLinkPrimitiveParams
•  llSetLinkPrimitiveParamsFast
•  llGetPrimitiveParams
•  llGetLinkPrimitiveParams
•  llSetText

Articles

•  Limits SL limits and constrictions
•  Color in LSL
•  Translucent Color

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;