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

ReadonlycanvasPos

canvasPos: Vec3

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

Readonlydevice

device: PointerDevice

Readonlydown

down: boolean

Readonlyid

id: number

Unique ID for the pointer

ReadonlyisPrimary

isPrimary: boolean

Readonlypressure

pressure: null | number

ReadonlyscreenPos

screenPos: Vec3

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

ReadonlytimeStamp

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

StaticofCanvasPoint

  • 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

StaticofEvent

  • 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
    • OptionalrelativeTo: HTMLElement

    Returns Pointer

StaticofScreenPoint

  • 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

On This Page

Properties
Methods
OpenSource licenses