Class Frustum

constructor

• new Frustum(): Frustum

  Create a new Frustum instance.

  Returns Frustum

  Example

  const frustum = new pc.Frustum();
  Copy

planes

add

• add(other: Frustum): Frustum

  Expands this frustum to also contain another frustum. The other frustum's 8 corner points are computed, and each of this frustum's planes is pushed outwards just far enough to contain them all. The result is a conservative convex volume that contains both frustums. This is useful for multi-view rendering such as stereo XR, where culling should keep objects visible in any view.

  Note: keeping each plane's orientation makes this correct for arbitrary frusta, including the asymmetric per-eye projections of XR headsets, where matching planes of the two eyes have different normals and a per-plane "outermost" selection would wrongly cut into the combined volume at a distance.

  Parameters

  • other: Frustum

    The other frustum to add.

  Returns Frustum

  Self for chaining.

clone

• clone(): Frustum

  Returns a clone of the specified frustum.

  Returns Frustum

  A duplicate frustum.

  Example

  const frustum = new pc.Frustum();
  const clone = frustum.clone();
  Copy

containsPoint

• containsPoint(point: Vec3): boolean

  Tests whether a point is inside the frustum. Note that points lying in a frustum plane are considered to be outside the frustum.

  Parameters

  • point: Vec3

    The point to test.

  Returns boolean

  True if the point is inside the frustum, false otherwise.

containsSphere

• containsSphere(sphere: BoundingSphere): number

  Tests whether a bounding sphere intersects the frustum. If the sphere is outside the frustum, zero is returned. If the sphere intersects the frustum, 1 is returned. If the sphere is completely inside the frustum, 2 is returned. Note that a sphere touching a frustum plane from the outside is considered to be outside the frustum.

  Parameters

  • sphere: BoundingSphere

    The sphere to test.

  Returns number

  0 if the bounding sphere is outside the frustum, 1 if it intersects the frustum and 2 if it is contained by the frustum.

copy

• copy(src: Frustum): Frustum

  Copies the contents of a source frustum to a destination frustum.

  Parameters

  • src: Frustum

    A source frustum to copy to the destination frustum.

  Returns Frustum

  Self for chaining.

  Example

  const src = entity.camera.frustum;
  const dst = new pc.Frustum();
  dst.copy(src);
  Copy

setFromMat4

• setFromMat4(matrix: Mat4): void

  Updates the frustum shape based on the supplied 4x4 matrix.

  Parameters

  • matrix: Mat4

    The matrix describing the shape of the frustum.

  Returns void

  Example

  // Create a perspective projection matrix
  const projection = new pc.Mat4();
  projection.setPerspective(45, 16 / 9, 1, 1000);
  
  // Create a frustum shape that is represented by the matrix
  const frustum = new pc.Frustum();
  frustum.setFromMat4(projection);
  Copy