llVolumeDetect

From Second Life Wiki
Revision as of 05:38, 17 October 2009 by Harleen Gretzky (talk | contribs)
Jump to navigation Jump to search

Summary

Function: llVolumeDetect( integer detect );

If detect is TRUE, VolumeDetect is enabled, physical object and avatars can pass through the object. This works much like Phantom, but unlike Phantom, VolumeDetect objects trigger collision_start and collision_end events when interpenetrating. Collision events will trigger in any script in the object.

• integer detect TRUE enables, FALSE disables

Caveats

  • llDetectedLinkNumber will return 0 in collision_start and collision_end events of VolumeDetect objects (SVC-2996).
  • VolumeDetect objects will fall through the ground, whereas Phantom objects will not.
  • VolumeDetect cannot be enabled on attachments[1].
  • Only detects physical objects and avatars.
  • Can only be applied to the root prim (which will make the entire object VolumeDetect).
  • When moving via llSetPos() by a loop of stages, collision events will not trigger.
  • Attachments will not register collision events when the avatar collides with a VolumeDetect object.
  • land_collision_start, land_collision_end and land_collision events are not generated anymore after setting VolumeDetect to TRUE.
All Issues ~ Search JIRA for related Bugs

Examples

<lsl>default {

   state_entry()
   {
       llVolumeDetect(TRUE); // Starts llVolumeDetect
   }
   collision_start(integer total_number)
   {
       llSay(0, "Detected!"); // Tells you when something penetrates the prim
   }
}</lsl>

See Also

Events

•  collision_start
•  collision
•  collision_end

Functions

•  llPassCollisions

Deep Notes

All Issues

~ Search JIRA for related Issues
   llDetectedLinkNumber returns 0 with llVolumeDetect(TRUE)

Footnotes

  1. ^ Attachments aren't included in the avatar bounding box, so it's moot

Signature

function void llVolumeDetect( integer detect );