Class BaseRuler

The ruler that is used to measure distances on the Canvas.

Mixes

RenderFlagsMixin

Hierarchy (View Summary)

  • RenderFlagObject<this>

Constructors

constructor

Properties

renderFlags RENDER_FLAG_PRIORITY RENDER_FLAGS

Accessors

active destination hidden origin path user visible canMeasure

Methods

applyRenderFlags destroy draw refresh reset _addDragWaypoint _changeDragElevation _onClickLeft _onClickRight _onDragCancel _onDragStart _onHiddenChange _onMouseMove _onMouseUp _onMouseWheel _onPathChange _refresh _removeDragWaypoint getSnappedPoint

Constructors

constructor

Properties

renderFlags

renderFlags: RenderFlags

Status flags which are applied at render-time to update the PlaceableObject. If an object defines RenderFlags, it should at least include flags for "redraw" and "refresh".

StaticRENDER_FLAG_PRIORITY

RENDER_FLAG_PRIORITY: string = "OBJECTS"

The ticker priority when RenderFlags of this class are handled. Valid values are OBJECTS or PERCEPTION.

StaticRENDER_FLAGS

RENDER_FLAGS: { refresh: {} } = ...

Accessors

active

  • get active(): boolean

    Is this Ruler active? True, if the path of the Ruler is nonempty.

    Returns boolean

destination

  • get destination(): undefined | ElevatedPoint

    The last point of the path, or undefined if the path is empty.

    Returns undefined | ElevatedPoint

hidden

  • get hidden(): boolean

    Is this Ruler hidden? If true, only the User of the Ruler can see it.

    Returns boolean

    Default Value

    false

origin

  • get origin(): undefined | ElevatedPoint

    The first point of the path, or undefined if the path is empty.

    Returns undefined | ElevatedPoint

path

  • get path(): readonly Readonly<ElevatedPoint>[]

    The sequence of points that the Ruler measures.

    Returns readonly Readonly<ElevatedPoint>[]

    Default Value

    []
  • set path(value: readonly Readonly<ElevatedPoint>[]): void

    Set the sequence of points that the Ruler measures.

    Parameters

    Returns void

user

visible

  • get visible(): boolean

    The Ruler is visible if it is active and either not hidden or its User is the current User.

    Returns boolean

StaticcanMeasure

  • get canMeasure(): boolean

    Is the Ruler ready to measure?

    Returns boolean

Methods

applyRenderFlags

  • applyRenderFlags(): void

    Returns void

Abstractdestroy

  • destroy(): void

    Destroy the Ruler.

    Returns void

Abstractdraw

  • draw(): Promise<void>

    Draw the Ruler.

    Returns Promise<void>

refresh

  • refresh(): void

    Refresh the Ruler.

    Returns void

reset

  • reset(): void

    Reset the path and the hidden state of the Ruler.

    Returns void

Protected_addDragWaypoint

  • _addDragWaypoint(point: Point, options?: { snap?: boolean }): void
    Protected

    Add a waypoint.

    Parameters

    • point: Point

      The (unsnapped) waypoint

    • Optionaloptions: { snap?: boolean } = {}

      Additional options

      • Optionalsnap?: boolean

        Snap the added waypoint?

    Returns void

Protected_changeDragElevation

  • _changeDragElevation(delta: number, options?: { precise?: boolean }): void
    Protected

    Change the elevation of the destination.

    Parameters

    • delta: number

      The number vertical steps

    • Optionaloptions: { precise?: boolean } = {}

      Additional options

      • Optionalprecise?: boolean

        Round elevations to multiples of the grid distance divided by CONFIG.Canvas.elevationSnappingPrecision? If false, rounds to multiples of the grid distance.

    Returns void

Protected_onClickLeft

  • _onClickLeft(event: FederatedEvent<UIEvent | PixiTouch>): void
    Protected

    Handle left-click events on the Canvas during Ruler measurement.

    Parameters

    • event: FederatedEvent<UIEvent | PixiTouch>

      The pointer-down event

    Returns void

Protected_onClickRight

  • _onClickRight(event: FederatedEvent<UIEvent | PixiTouch>): void
    Protected

    Handle right-click events on the Canvas during Ruler measurement.

    Parameters

    • event: FederatedEvent<UIEvent | PixiTouch>

      The pointer-down event

    Returns void

Protected_onDragCancel

  • _onDragCancel(event: FederatedEvent<UIEvent | PixiTouch>): boolean | void
    Protected

    Handle the end of the Ruler measurement workflow

    Parameters

    • event: FederatedEvent<UIEvent | PixiTouch>

      The drag cancel event

    Returns boolean | void

    If false, the cancellation of the drag workflow is prevented

Protected_onDragStart

  • _onDragStart(event: FederatedEvent<UIEvent | PixiTouch>): void
    Protected

    Handle the beginning of a new Ruler measurement workflow.

    Parameters

    • event: FederatedEvent<UIEvent | PixiTouch>

      The drag start event

    Returns void

Protected_onHiddenChange

  • _onHiddenChange(): void
    Protected

    Called when the Ruler becomes hidden or unhidden.

    Returns void

Protected_onMouseMove

  • _onMouseMove(event: FederatedEvent<UIEvent | PixiTouch>): void
    Protected

    Continue a Ruler measurement workflow for left-mouse movements on the Canvas.

    Parameters

    • event: FederatedEvent<UIEvent | PixiTouch>

      The mouse move event

    Returns void

Protected_onMouseUp

  • _onMouseUp(event: FederatedEvent<UIEvent | PixiTouch>): void
    Protected

    Conclude a Ruler measurement workflow by releasing the left-mouse button.

    Parameters

    • event: FederatedEvent<UIEvent | PixiTouch>

      The pointer-up event

    Returns void

Protected_onMouseWheel

  • _onMouseWheel(event: WheelEvent): void
    Protected

    Adjust the elevation of Ruler waypoints by scrolling up/down.

    Parameters

    • event: WheelEvent

      The mousewheel event

    Returns void

Protected_onPathChange

  • _onPathChange(): void
    Protected

    Called when the Ruler's path has changed.

    Returns void

Protected Abstract_refresh

  • _refresh(): void
    Protected

    Refresh the Ruler.

    Returns void

Protected_removeDragWaypoint

  • _removeDragWaypoint(): void
    Protected

    Remove the second to last waypoint.

    Returns void

StaticgetSnappedPoint

  • getSnappedPoint(point: Point): Point

    Snaps the given point to the grid.

    Parameters

    • point: Point

      The point that is to be snapped

    Returns Point

    The snapped point

Settings

Member Visibility

On This Page

Constructors
Properties
Accessors
Methods