Difference between revisions of "LlRezAtRoot"

From Second Life Wiki
Jump to navigation Jump to search
Line 14: Line 14:
|caveats=
|caveats=
*Silently fails to rez '''inventory''' if '''pos''' is more than 10 meters away.
*Silently fails to rez '''inventory''' if '''pos''' is more than 10 meters away.
*Function silently fails if a script owned by you calls this function on group owned land while you are offline or in another sim.
|examples=<pre class="lsl">//Rez an object on touch
|examples=<pre class="lsl">//Rez an object on touch
string object = "Object";//Object in inventory
string object = "Object";//Object in inventory

Revision as of 13:07, 29 November 2007

Summary

Function: llRezAtRoot( string inventory, vector position, vector velocity, rotation rot, integer param );

Instantiate inventory object rotated to rot with its root at position, moving at velocity, using param as the start parameter

• string inventory an object in the inventory of the prim this script is in
• vector position initial position (in region coordinates)
• vector velocity initial velocity
• rotation rot initial rotation
• integer param on_rez event parameter and value returned by llGetStartParameter in the rezzed object.

Causes a hard delay based on the mass of the object rezzed.
To rez an object so its center is at pos (instead of the root) use llRezObject instead.

Caveats

  • This function causes the script to sleep for 0.1 seconds.
  • If inventory is missing from the prim's inventory or it is not an object then an error is shouted on DEBUG_CHANNEL.
  • Silently fails to rez inventory if pos is more than 10 meters away.
  • Function silently fails if a script owned by you calls this function on group owned land while you are offline or in another sim.
All Issues ~ Search JIRA for related Bugs

Examples

//Rez an object on touch
string object = "Object";//Object in inventory
integer start_param = 10;
rotation rot;

default
{
    state_entry()
    {
        rot = llEuler2Rot(< 0, 90, 90> * DEG_TO_RAD);
    }
    touch_start(integer a)
    {
        vector vec = llGetPos() + < 0.0, 0.0, 5.0>; // 5 meter above this
        vector speed = llGetVel();
        llRezAtRoot(object, vec, speed, rot, start_param);
    }
}

See Also

Events

•  object_rez triggered when this object rezzes an object from inventory

Functions

•  llRezObject
•  llGetStartParameter
•  llGodLikeRezObject

Deep Notes

Search JIRA for related Issues

Signature

function void llRezAtRoot( string inventory, vector position, vector velocity, rotation rot, integer param );