Lens Scripting API
    Preparing search index...

    Class ColliderComponent

    Used to define the physical boundaries of an object, allowing it to interact with other objects in Physics, Cloth or Hair simulation.

    Provides a way for SceneObjects to detect and respond to collisions. Useful for detecting when objects overlap or contact each other, which can then be used to trigger events or effects within the Lens experience.

    Lens Scripting Version 152

    // Add a callback for onCollisionEnter on this collider

    // @input Physics.ColliderComponent collider

    script.collider.onCollisionEnter.add(function(eventArgs) {
        var collision = eventArgs.collision;
        print("CollisionEnter(" + collision.id + "): contacts=" + collision.contactCount + " ---> " + collision.collider.getSceneObject().name);
    });

    Hierarchy (View Summary)

    Index

    Properties

    angularVelocity asset debugDrawEnabled enabled filter fitVisual forceCompound intangible isBeingDestroyed isEnabledInHierarchy matter onCollisionEnter onCollisionExit onCollisionStay onOverlapEnter onOverlapExit onOverlapStay overlapFilter rotateSmoothFactor sceneObject shape smooth translateSmoothFactor uniqueIdentifier velocity worldSettings

    Methods

    clearMotion destroy getSceneObject getTransform getTypeName isOfType isSame

    Properties

    angularVelocity: vec3

    Angular velocity, expressed as an axis of rotation scaled by angular speed (radians/s).

    Lens Scripting Version 164

    (0, 0, 0)
    asset: LevelsetColliderAsset

    Expects a LevelsetColliderAsset. Contains distance field data which describes a collider's shape. A selection of default Levelset assets can be found in Resource->Add->Hairstyle Colliders

    Use ColliderComponent#shape to set the shape to a LevelsetShape

    Lens Scripting Version 152

    debugDrawEnabled: boolean

    Toggle collider wire rendering for visualizing collider geometry shape and where it is placed.

    Lens Scripting Version 152

    false
    enabled: boolean

    If disabled, the Component will stop enacting its behavior.

    true
    filter: Physics.Filter

    Collision filter to use for this collider.

    Lens Scripting Version 183

    null
    fitVisual: boolean

    If enabled, the collider shape extends to fit the visual mesh, if any. Only applicable for Box and Sphere shapes.

    Lens Scripting Version 164

    true
    forceCompound: boolean

    Nested collider/body components may be merged into compound shapes. By default, this occurs only for dynamic bodies and not for static colliders. If forceCompound is set, this occurs for static colliders as well.

    Lens Scripting Version 169

    false
    intangible: boolean

    If enabled, the collider doesn't interact with the world but may still be detected with ray casts and intersection events.

    Lens Scripting Version 164

    false
    isBeingDestroyed: boolean

    Returns true if this Component is currently being destroyed. Becomes true as soon as destruction begins via Component#destroy or destruction of its owning SceneObject, before any OnDestroyEvent callbacks fire.

    Lens Scripting Version 364

    if (!script.isBeingDestroyed) {
        // Component is still fully alive
    }
    isEnabledInHierarchy: boolean

    Returns true if this Component, its SceneObject, and all of that SceneObjects parents are enabled.

    matter: Matter

    The matter used by the collider to define its physical substance, such as friction and bounciness.

    Lens Scripting Version 169

    null
    onCollisionEnter: event1<CollisionEnterEventArgs, void>

    Signals when objects initially collide.

    Lens Scripting Version 152

    onCollisionExit: event1<CollisionExitEventArgs, void>

    Signals when objects stop colliding.

    Lens Scripting Version 152

    onCollisionStay: event1<CollisionStayEventArgs, void>

    Signals every frame while objects continue to collide.

    Lens Scripting Version 152

    onOverlapEnter: event1<OverlapEnterEventArgs, void>

    Signals when colliders first overlap.

    Lens Scripting Version 152

    onOverlapExit: event1<OverlapExitEventArgs, void>

    Signals when colliders stop overlapping.

    Lens Scripting Version 152

    onOverlapStay: event1<OverlapStayEventArgs, void>

    Signals every frame while colliders continue to overlap.

    Lens Scripting Version 152

    overlapFilter: Physics.Filter

    Collision filter used for overlap events.

    Lens Scripting Version 164

    null
    rotateSmoothFactor: number

    Smoothing spring factor, for rotation.

    Lens Scripting Version 169

    30
    sceneObject: SceneObject

    The SceneObject this component is on.

    shape: Shape

    The Shape object used for collision.

    Lens Scripting Version 157

    null
    smooth: boolean

    Smooth transform changes using a dampened spring. Useful to reduce motion noise. This only applies to the simulation and changes from outside the simulation. The SceneObject's transform is not affected. It has no effect for dynamic bodies.

    Lens Scripting Version 169

    false
    translateSmoothFactor: number

    Smoothing spring factor, for translation. This controls the restitution strength of the spring, so low values are smoother but lag more.

    Lens Scripting Version 169

    30
    uniqueIdentifier: string

    Lens Scripting Version 176

    velocity: vec3

    Linear velocity (cm/s).

    Lens Scripting Version 164

    (0, 0, 0)
    worldSettings: WorldSettingsAsset

    The WorldSettingsAsset used by the collider to define the physics simulation settings.

    Lens Scripting Version 169

    null

    Methods

    • Clears all velocities and forces on a collider.

      Returns void

      Lens Scripting Version 164

    • Destroys the component.

      Returns void

    • Returns the name of this object's type.

      Returns string

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

      Parameters

      • type: string

      Returns boolean

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

      Parameters

      Returns boolean

    Settings

    Member Visibility

    On This Page

    Properties
    Methods