SC_multipleRayCastGroup
SYNTAX
return integer=SC_multipleRayCastGroup ( GroupNum, oldx, oldy, oldz, x, y, z, excludeObj )
-groupNum: the group you want to check for collision use 0 for all groups
-oldx...z: the start and end points of the ray to check.
-excludeObj: a single object to exclude from the collision check
returns: the number of collisions that occured along the ray.
-similar to 'SC_rayCastGroup' but will record all
collisions along the ray and return the amount.
-These collision points can be accessed, for example, by
calling getStaticCollisionX(2) will get the x co-ordinate
of the second collision point. see 'multiple intersect demo' for usage example.
-all the collision points are ordered by distance, so (1) is the closest point.
-if the number of collisions is greater than the maximum, say 50, then only 50
collision points will be returned and it is unknown which points will be returned,
in which case collision(1) may not be the definate closest point.
-the maximum number of returned collisions is set to 50 by default but can be
changed using 'setMaximumCollisions' up to a maximum of 500.
-objects assigned to group 0 do not have a group and will be ignored in group collisions.
RELATED INFO
Collision Commands Menu
Index