Class RayPointerDriverAbstract

A PointerDriver which gets pointer events from raycasts in a 3D engine's world. This is an abstract class and must be implemented.

Hierarchy (view full)

Constructors

Properties

hints: Map<number, PointerHint> = ...

The hints for each pointer. The keys are pointer IDs, while the values are that pointer's hint.

See PointerDriver#getPointerHint

sources: Set<RayPointerSource> = ...

The sources which this is assigned to

states: Map<Root, PointerDriverState> = ...

The current state for each registered and enabled root. Contains whether each root is pressing, hovering, and which pointer is bound to it

Methods

  • Cast a ray in the world and get which root was intersected and where.

    Parameters

    • origin: [number, number, number]

      The world position where the ray is starting

    • direction: [number, number, number]

      A normalised vector representing the ray's direction. Not a euler rotation nor a quaternion

    Returns [null | Root, number, number]

    Returns a 3-tuple containing, in this order, the intersected root or null if none intersected, the normalised x axis of the intersection and the normalised y axis of the intersection. If no root was intersected, use bogus values for x and y

  • Receive a ray from a RayPointerSource.

    Parameters

    • pointer: number

      The source's pointer ID, given when setting the source's sink

    • pressing: null | number

      Is the pointer pressed? If null, then the last pressing state will be used. A bitmask where each set bit represents a different button being pressed

    • origin: [number, number, number]

      The world position where the ray is starting

    • direction: [number, number, number]

      A normalised vector representing the ray's direction. Not a euler rotation nor a quaternion

    • shift: boolean

      Is shift being pressed?

    • ctrl: boolean

      Is control being pressed?

    • alt: boolean

      Is alt being pressed?

    Returns void

  • Dispatch a pointer event to a given root. The type of PointerEvent is decided automatically based on the root's state and whether its pressing or not.

    If null, the last pressing state is used, meaning that the pressing state has not changed. Useful if getting pointer movement in an event based environment where you only know when a pointer press occurs, but not if the pointer is pressed or not

    Parameters

    • root: Root
    • pointer: number

      The registered pointer ID

    • xNorm: number

      The normalised (non-integer range from 0 to 1) X coordinate of the pointer event. 0 is the left edge of the root, while 1 is the right edge of the root.

    • yNorm: number

      The normalised (non-integer range from 0 to 1) Y coordinate of the pointer event. 0 is the top edge of the root, while 1 is the bottom edge of the root.

    • pressing: null | number

      Is the pointer pressed? If null, then the last pressing state will be used. A bitmask where each set bit represents a different button being pressed

    • shift: boolean

      Is shift being pressed?

    • ctrl: boolean

      Is control being pressed?

    • alt: boolean

      Is alt being pressed?

    Returns boolean

    Returns true if the pointer event was captured.

  • Unregister a pointer.

    If a root has this pointer bound to it, the pointer is unbound from the root, a LeaveRootEvent event is dispatched to the root and the hovering and pressing state of the root is set to false.

    Parameters

    • pointer: number

    Returns void

  • Dispatch a mouse wheel event in a given 2D direction. Event will only be dispatched if the root was being hovered.

    Parameters

    • root: Root
    • pointer: number

      The registered pointer ID

    • xNorm: number

      The normalised (non-integer range from 0 to 1) X coordinate of the pointer event. 0 is the left edge of the root, while 1 is the right edge of the root.

    • yNorm: number

      The normalised (non-integer range from 0 to 1) Y coordinate of the pointer event. 0 is the top edge of the root, while 1 is the bottom edge of the root.

    • deltaX: number

      How much was scrolled horizontally, in pixels

    • deltaY: number

      How much was scrolled vertically, in pixels

    • deltaZ: number

      How much was scrolled in the Z axis, in pixels. Rarely used

    • deltaMode: PointerWheelMode

      How the delta values should be interpreted

    • shift: boolean

      Is shift being pressed?

    • ctrl: boolean

      Is control being pressed?

    • alt: boolean

      Is alt being pressed?

    Returns boolean

    Returns true if the pointer event was captured.