Camera: pointInsideFrustum

pointInsideFrustum(point)
  • Tests whether or not a point is inside the camera's view frustum.

Type:
  • Boolean
     
  • 1 = True = point is inside the view frustum
     
  • 0 = False = point isn't inside the view frustum

point:

  • Type:  float list  [ x, y, z]
  • x: position on the world x-axis
  • y: position on the world y-axis
  • z: position on the world z-axis
Note:
  • Frustum definition:  A camera frustum is a truncated pyramid.  It is the part that is left when the top of the  pyramid is cut off and removed.  
Sample Code

################## find out if the point is inside the view frustum
  
# import bge
import bge

# get current scene
scene = bge.logic.getCurrentScene()

# get a list of the cameras
camList = scene.cameras

# get camera
# my camera is named security_cam
cam = camList["security_cam"]

# point inside view frustum?
pointInside = cam.pointInsideFrustum( [0.0, 0.0, 0.0])