GetTargetsInCylinder

From HEWIKI
Jump to: navigation, search

Contents

Get Targets In Cylinder

GetTargetsInCylinder(playerSensitive as Boolean, npcSensitive as Boolean, cylBase as Vector3, cylRadius as Float, cylDirection as Vector3, cylDistance as Float) as List of NodeRef

Arguments

<playerSensitive> 
Indicates whether players are included in the list of returned nodes
<npcSensitive> 
Indicates whether non-playing characters are included in the list of returned nodes.
<cylBase> 
the center of the base of the cylinder
<cylRadius> 
the radius of the cylinder, in worldspace units
<cylDirection> 
a vector describing the direction the cylinder "goes" (see VectorDirections)
<cylDistance> 
the height of the cylinder, if the direction were "up"

Description

This function can be called in a script to learn what player nodes are around a given area.

The functions return a list of type noderef, which will include all visible player or character nodes within the defined area.

Other types of assets (waypoints, landscape, etc.) are not targeted in the search.

NPC's can be returned if npcSensitive is set to true.

For more information see: Area Awareness

Example

// The following would print a list of all pc's (and no npc's) within a cylinder defined below
pc as boolean = TRUE
npc as boolean = FALSE
targets as list of noderef
cylBase as vector3 = (0, 0, 0)
cylRadius as float = 30.0
cylDirection as vector3 = (3, 0, 0)
cylDistance as float = 10.0
 
targets = GetTargetsInCylinder(pc, npc, cylBase, cylRadius, cylDirection, cylDistance)
foreach target in targets
  println(target.name+" is in the cone")
.
Personal tools
Namespaces
Variants
Actions
Navigation
Toolbox