Difference between revisions of "On rez"
(Clarify scheduling of on_rez event while script is already processing an event.) |
Omei Qunhua (talk | contribs) m (Added a comment) |
||
| Line 3: | Line 3: | ||
|p1_type=integer|p1_name=start_param|p1_desc=parameter supplied to [[llRezObject]] or [[llRezAtRoot]] | |p1_type=integer|p1_name=start_param|p1_desc=parameter supplied to [[llRezObject]] or [[llRezAtRoot]] | ||
|event_desc=Triggered when an object is rezzed (by script or by user). Also triggered in attachments when a user logs in, or when the object is [[attach]]ed from inventory. | |event_desc=Triggered when an object is rezzed (by script or by user). Also triggered in attachments when a user logs in, or when the object is [[attach]]ed from inventory. | ||
|event_footnote='''start_param''' is always zero when an object is not rezzed by [[llRezObject]] or [[llRezAtRoot]]. <br/>'''start_param''' is available at any subsequent time by calling [[llGetStartParameter]] (unless it has been overridden by [[llRemoteLoadScriptPin]]). | |event_footnote='''start_param''' is always zero when an object is not rezzed by [[llRezObject]] or [[llRezAtRoot]]. | ||
<br/>When an object is rezzed by [[llRezObject]] or [[llRezAtRoot]], then '''start_param''' will be the value given as the last parameter of the rezzing command. | |||
<br/>'''start_param''' is available at any subsequent time by calling [[llGetStartParameter]] (unless it has been overridden by [[llRemoteLoadScriptPin]]). | |||
|constants | |constants | ||
|spec | |spec | ||
Revision as of 10:02, 19 December 2012
| LSL Portal | Functions | Events | Types | Operators | Constants | Flow Control | Script Library | Categorized Library | Tutorials |
Description
Event: on_rez( integer start_param ){ ; }| 27 | Event ID |
Triggered when an object is rezzed (by script or by user). Also triggered in attachments when a user logs in, or when the object is attached from inventory.
| • integer | start_param | – | parameter supplied to llRezObject or llRezAtRoot |
start_param is always zero when an object is not rezzed by llRezObject or llRezAtRoot.
When an object is rezzed by llRezObject or llRezAtRoot, then start_param will be the value given as the last parameter of the rezzing command.
start_param is available at any subsequent time by calling llGetStartParameter (unless it has been overridden by llRemoteLoadScriptPin).
Caveats
- If an object is rezzed by another object then the object_rez event in the parent object does not trigger at the same time as the on_rez event in the child object.
Examples
<lsl>default {
on_rez(integer start_param)
{
// Restarts the script every time the object is rezzed
llResetScript();
}
}</lsl>
Notes
state_entry & on_rez
state_entry will be triggered prior to on_rez if state_entry has not been run prior.
on_rez & attach
on_rez will be triggered prior to attach when attaching from inventory or during login.
on_rez & slow events
If the script was already processing an event at rez time, on_rez does not not trigger until the current event handler is completed. (same with attach)
See Also
Events
| • | object_rez | – | triggered when this object rezzes an object from inventory | |
| • | state_entry | – | triggered during script startup, reset and state change |
Functions
| • | llGetStartParameter | |||
| • | llRezObject | |||
| • | llRezAtRoot |
Deep Notes
Signature |
|---|
event void on_rez( integer start_param ); |