Skip to main content

SpecsInteractionModule.BoxOverlapProbe

Class

An OverlapProbe whose volume is an oriented box that tracks the SceneObject's world rotation (uniform scale only).

  • Snapchat: not supported
  • SPECS: fully supported
  • Camera Kit Web: not supported
  • Camera Kit Mobile: not supported
  • SnapchatNot supported — Available on SPECS only
  • SPECSFully supported
  • Camera Kit WebNot supported — Available on SPECS only
  • Camera Kit MobileNot supported — Available on SPECS only

Platform details

  • Snapchat — Not supported — Available on SPECS only.

  • SPECS — Fully supported.

  • Camera Kit Web — Not supported — Available on SPECS only.

  • Camera Kit Mobile — Not supported — Available on SPECS only.

Since Lens Scripting v375

An OverlapProbe whose volume is an oriented box that tracks the SceneObject's world rotation (uniform scale only). enterHalfExtents/exitHalfExtents (cm) give per-axis hysteresis. Create with SpecsInteractionModule#createBoxOverlapProbe.

Index

Extends

Properties

enterHalfExtents

readonly enterHalfExtents: vec3

SPECS

The box probe's enter half-extents, cm.

Since

Lens Scripting Version 375


exitHalfExtents

readonly exitHalfExtents: vec3

SPECS

The box probe's exit half-extents, cm.

Since

Lens Scripting Version 375


onOverlapEnter

readonly onOverlapEnter: event1<OverlapEnterEventArgs, void>

SPECS

Signals at most once per frame with the colliders that entered the probe's enter volume that frame, delivered as the OverlapEnterEventArgs#enteredOverlaps batch. When a frame has both enters and exits, onOverlapEnter fires before OverlapProbe#onOverlapExit. Delivered after Update, prior to LateUpdate.

Since

Lens Scripting Version 375

Inherited from

OverlapProbe.onOverlapEnter


onOverlapExit

readonly onOverlapExit: event1<OverlapExitEventArgs, void>

SPECS

Signals at most once per frame with the colliders that left the probe's exit volume that frame, whose collider was removed while a member, or that were still inside when the probe itself was removed, delivered as the OverlapExitEventArgs#exitedOverlaps batch. Delivered after Update, prior to LateUpdate.

Since

Lens Scripting Version 375

Inherited from

OverlapProbe.onOverlapExit


queryMask

readonly queryMask: LayerSet

SPECS

The layers this probe matches against. A collider joins only when its Interactable's layerMask shares a layer with this set. Only layers 0-63 are supported, so this reads back without any layers above that range the probe was created with.

Since

Lens Scripting Version 375

Inherited from

OverlapProbe.queryMask

Methods

destroy()

destroy(): void

SPECS

Stops the probe and drops it from active tracking. Any colliders still inside fire one final OverlapProbe#onOverlapExit shortly after. No further events follow. Idempotent.

Returns

void

Since

Lens Scripting Version 375

Inherited from

OverlapProbe.destroy


getTypeName()

static getTypeName(): TypeName<BoxOverlapProbe>

SPECS

Returns the fully-qualified JavaScript type name for this class (for example, "Component.Camera"). This is a static accessor (no instance required) and returns the same value as the instance getTypeName().

Returns

TypeName<BoxOverlapProbe>

Since

Lens Scripting Version 375

Overrides

OverlapProbe.getTypeName


getTypeName()

getTypeName(): string

Returns the name of this object's type.

Returns

string

Inherited from

OverlapProbe.getTypeName


isOfType()

isOfType(type): boolean

Returns true if the object matches or derives from the passed in type.

Parameters

ParameterType
typestring

Returns

boolean

Inherited from

OverlapProbe.isOfType


isSame()

isSame(other): boolean

Returns true if this object is the same as other. Useful for checking if two references point to the same thing.

Parameters

ParameterType
otherScriptObject

Returns

boolean

Inherited from

OverlapProbe.isSame


setHalfExtents()

setHalfExtents(enterHalfExtents, exitHalfExtents): void

SPECS

Updates the box probe's enter and exit half-extents (cm). exitHalfExtents should be >= enterHalfExtents per axis; equal values disable hysteresis. Applied at the next overlap evaluation, after Update and before LateUpdate.

Parameters

ParameterType
enterHalfExtentsvec3
exitHalfExtentsvec3

Returns

void

Since

Lens Scripting Version 375