Class Pointer

Provides a snapshot containing information about a pointer. A Pointer object is immutable — it will not be updated when the pointer's information changes.

Properties

canvasPos device down id isPrimary pressure screenPos timeStamp

Methods

snappedToGrid withCanvasPosition withScreenPosition withTimestamp ofCanvasPoint ofEvent ofScreenPoint

Properties

Readonly canvasPos

canvasPos: Vec3

Position of the pointer relative to the top left corner of the drawing surface.

Readonly device

device: PointerDevice

Readonly down

down: boolean

Readonly id

id: number

Unique ID for the pointer

Readonly isPrimary

isPrimary: boolean

Readonly pressure

pressure: null | number

Readonly screenPos

screenPos: Vec3

The (x, y) position of the pointer relative to the top-left corner of the visible canvas.

Readonly timeStamp

timeStamp: number

Numeric timestamp (milliseconds, as from performance.now()).

Methods

snappedToGrid

  • snappedToGrid(viewport): Pointer

  • Snaps this pointer to the nearest grid point (rounds the coordinates of this pointer based on the current zoom). Returns a new Pointer and does not modify this.

    Parameters

    Returns Pointer

withCanvasPosition

  • withCanvasPosition(canvasPos, viewport): Pointer

  • Returns a copy of this pointer with a new position. The screen position is determined by the given canvasPos.

    Parameters

    Returns Pointer

withScreenPosition

withTimestamp

  • withTimestamp(timeStamp): Pointer

  • Returns a copy of this pointer with a changed timestamp.

    Parameters

    • timeStamp: number

    Returns Pointer

Static ofCanvasPoint

  • ofCanvasPoint(canvasPos, isDown, viewport, id?, device?, isPrimary?, pressure?, timeStamp?): Pointer

  • Create a new Pointer from a point on the canvas. Intended for unit tests.

    Parameters

    • canvasPos: Vec3
    • isDown: boolean
    • viewport: Viewport
    • id: number = 0
    • device: PointerDevice = PointerDevice.Pen
    • isPrimary: boolean = true
    • pressure: null | number = null
    • timeStamp: null | number = null

    Returns Pointer

Static ofEvent

  • ofEvent(evt, isDown, viewport, relativeTo?): Pointer

  • Creates a Pointer from a DOM event. If relativeTo is given, (0, 0) in screen coordinates is considered the top left of relativeTo.

    Parameters

    • evt: PointerEvent
    • isDown: boolean
    • viewport: Viewport
    • Optional relativeTo: HTMLElement

    Returns Pointer

Static ofScreenPoint

  • ofScreenPoint(screenPos, isDown, viewport, id?, device?, isPrimary?, pressure?, timeStamp?): Pointer

  • Create a new Pointer from a point on the screen. Intended for unit tests.

    Parameters

    • screenPos: Vec3
    • isDown: boolean
    • viewport: Viewport
    • id: number = 0
    • device: PointerDevice = PointerDevice.Pen
    • isPrimary: boolean = true
    • pressure: null | number = null
    • timeStamp: null | number = null

    Returns Pointer

Settings

Member Visibility

Theme

On This Page

Generated using TypeDoc

OpenSource licenses