State entry

From Second Life Wiki
Revision as of 12:36, 5 October 2012 by Kireji Haiku (talk | contribs) (added state_exit() to make it more clear)
Jump to navigation Jump to search

Description

Event: state_entry( ){ ; }

Triggered on any state transition and startup


Specification

Triggered

  1. Script save or adding to object
  2. State change
    • A state_exit is triggered in the old state and the state_entry is triggered in the new state. All other events in the queue are lost as a result of the state change.
  3. On script reset, either by client or llResetScript/llResetOtherScript
  4. When the object is rezzed without a saved script status
    • If it was a copy taken from inworld
    • If the event had not been triggered due to no-script land.

Not Triggered

  1. When the object is rezzed with saved script status
    • Use on_rez event in this situation

Caveats


Examples

<lsl> default {

   state_entry()
   {
       // PUBLIC_CHANNEL has the integer value 0
       llSay(PUBLIC_CHANNEL,
           "You either just saved the script after editing it"
           + "\nand/or the script (re)entered the default state.");
       // white and opaque text
       llSetText("Click to change states", <1.0, 1.0, 1.0>, (float)TRUE);
   }
   touch_start(integer num_detected)
   {
       state other;
   }
   state_exit()
   {
       llSay(PUBLIC_CHANNEL, "The script leaves the default state.");
   }

}

state other {

   state_entry()
   {
       llSay(PUBLIC_CHANNEL, "The script entered the other state.");
       state default;
   }
   state_exit()
   {
       llSay(PUBLIC_CHANNEL, "The script leaves the other state.");
   }

} </lsl>

See Also

Events

•  on_rez Triggered when the object is rezzed
•  state_exit Triggered when the state is exited at state change

Functions

•  llResetScript Resets the script
•  llResetOtherScript Resets another script in the prim
•  llGetStartParameter The on_rez parameter (or llRemoteLoadScriptPin parameter)

Deep Notes

Issues

All Issues

~ Search JIRA for related Issues
   changing to same state triggers state_entry in mono compiled script

Signature

event void state_entry(  );