Class PlaceableObject`Interface`

An Abstract Base Class which defines a Placeable Object which represents a Document placed on the Canvas

Abstract

Param: document

The Document instance which is represented by this object

Hierarchy (view full)

any
- PlaceableObject

Index

Properties

scene document controlIcon mouseInteractionManager #original #lastQuadtreeBounds #drawing #drawn embeddedName RENDER_FLAGS

Accessors

_original isOwner interactionState bounds center id objectId sourceId isPreview hasPreview layer sheet controlled hover hasActiveHUD

Properties

scene

scene: Scene

Retain a reference to the Scene within which this Placeable Object resides

document

document: Document

A reference to the Scene embedded Document instance which this object represents

controlIcon

controlIcon: ControlIcon

A control icon for interacting with the object

mouseInteractionManager

mouseInteractionManager: MouseInteractionManager

A mouse interaction manager instance which handles mouse workflows related to this object.

`Private` #original

#original: PlaceableObject

The object that this object is a preview of if this object is a preview.

`Private` #lastQuadtreeBounds

#lastQuadtreeBounds: Rectangle

The bounds that the placeable was added to the quadtree with.

`Private` #drawing

#drawing: Promise<PlaceableObject> = ...

An internal reference to a Promise in-progress to draw the Placeable Object.

`Private` #drawn

#drawn: boolean = false

Has this Placeable Object been drawn and is there no drawing in progress?

`Static` embeddedName

embeddedName: string

Identify the official Document name for this PlaceableObject class

`Static` RENDER_FLAGS

RENDER_FLAGS: {
    redraw: {
        propagate: string[];
    };
    refresh: {
        propagate: string[];
        alias: boolean;
    };
    refreshState: {};
} = ...

The flags declared here are required for all PlaceableObject subclasses to also support.

Type declaration

redraw: {
propagate: string[];
}
- propagate: string[]
refresh: {
propagate: string[];
alias: boolean;
}
- propagate: string[]
- alias: boolean
refreshState: {}

Accessors

_original

get _original(): PlaceableObject
The object that this object is a preview of if this object is a preview.

Returns PlaceableObject

isOwner

get isOwner(): boolean
A convenient reference for whether the current User has full control over the document.

Returns boolean

interactionState

get interactionState(): {
    NONE: number;
    HOVER: number;
    CLICKED: number;
    GRABBED: number;
    DRAG: number;
    DROP: number;
}
The mouse interaction state of this placeable.

Returns {
    NONE: number;
    HOVER: number;
    CLICKED: number;
    GRABBED: number;
    DRAG: number;
    DROP: number;
}
- NONE: number
- HOVER: number
- CLICKED: number
- GRABBED: number
- DRAG: number
- DROP: number

bounds

get bounds(): Rectangle
The bounding box for this PlaceableObject. This is required if the layer uses a Quadtree, otherwise it is optional

Returns Rectangle

center

get center(): Point
The central coordinate pair of the placeable object based on it's own width and height

Returns Point

id

get id(): string
The id of the corresponding Document which this PlaceableObject represents.

Returns string

objectId

get objectId(): string
A unique identifier which is used to uniquely identify elements on the canvas related to this object.

Returns string

sourceId

get sourceId(): string
The named identified for the source object associated with this PlaceableObject. This differs from the objectId because the sourceId is the same for preview objects as for the original.

Returns string

isPreview

get isPreview(): boolean
Is this placeable object a temporary preview?

Returns boolean

hasPreview

get hasPreview(): boolean
Does there exist a temporary preview of this placeable object?

Returns boolean

layer

get layer(): PlaceablesLayer
Provide a reference to the CanvasLayer which contains this PlaceableObject.

Returns PlaceablesLayer

sheet

get sheet(): FormApplication
A Form Application which is used to configure the properties of this Placeable Object or the Document it represents.

Returns FormApplication

controlled

get controlled(): boolean
An indicator for whether the object is currently controlled

Returns boolean

hover

get hover(): boolean
An indicator for whether the object is currently a hover target

Returns boolean

hasActiveHUD

get hasActiveHUD(): boolean
Is the HUD display active for this Placeable?

Returns boolean

Methods

getSnappedPosition

getSnappedPosition(position?): Point
Get the snapped position for a given position or the current position.
Parameters
- Optional position: Point
  The position to be used instead of the current position
Returns Point
The snapped position

applyRenderFlags

applyRenderFlags(): void
Returns void

clear

clear(): PlaceableObject
Clear the display of the existing object.

Returns PlaceableObject
The cleared object

destroy

destroy(options): any
Parameters
- options: any
Returns any
Inherit Doc

draw

draw(options?): Promise<PlaceableObject>
Draw the placeable object into its parent container
Parameters
- Optional options: object = {}
  Options which may modify the draw and refresh workflow
Returns Promise<PlaceableObject>
The drawn object

_partialDraw

_partialDraw(fn): Promise<PlaceableObject>
Internal
Execute a partial draw.
Parameters
- fn: (() => Promise<void>)
  The draw function
  - - (): Promise<void>
    - Returns Promise<void>
Returns Promise<PlaceableObject>
The drawn object

refresh

refresh(options?): PlaceableObject
Refresh all incremental render flags for the PlaceableObject. This method is no longer used by the core software but provided for backwards compatibility.
Parameters
- Optional options: object = {}
  Options which may modify the refresh workflow
Returns PlaceableObject
The refreshed object

_updateQuadtree

_updateQuadtree(): void
Internal
Update the quadtree.

Returns void

control

control(options?): boolean
Assume control over a PlaceableObject, flagging it as controlled and enabling downstream behaviors
Parameters
- options: {
  releaseOthers: boolean;
  } = {}
  Additional options which modify the control request
  - releaseOthers: boolean
    Release any other controlled objects first
Returns boolean
A flag denoting whether control was successful

release

release(options?): boolean
Release control over a PlaceableObject, removing it from the controlled set
Parameters
- options: object = {}
  Options which modify the releasing workflow
Returns boolean
A Boolean flag confirming the object was released.

clone

clone(): PlaceableObject
Clone the placeable object, returning a new object with identical attributes. The returned object is non-interactive, and has no assigned ID. If you plan to use it permanently you should call the create method.

Returns PlaceableObject
A new object with identical data

rotate

rotate(angle, snap): Promise<PlaceableObject>
Rotate the PlaceableObject to a certain angle of facing
Parameters
- angle: number
  The desired angle of rotation
- snap: number
  Snap the angle of rotation to a certain target degree increment
Returns Promise<PlaceableObject>
The rotated object

_updateRotation

_updateRotation(options?): number
Internal
Determine a new angle of rotation for a PlaceableObject either from an explicit angle or from a delta offset.
Parameters
- options: {
      angle: number;
      delta: number;
      snap: number;
  } = {}
  An object which defines the rotation update parameters
  - angle: number
    An explicit angle, either this or delta must be provided
  - delta: number
    A relative angle delta, either this or the angle must be provided
  - snap: number
    A precision (in degrees) to which the resulting angle should snap. Default is 0.
Returns number
The new rotation angle for the object

_getShiftedPosition

_getShiftedPosition(dx, dy): Point
Internal
Obtain a shifted position for the Placeable Object
Parameters
- dx: -1 | 0 | 1
  The number of grid units to shift along the X-axis
- dy: -1 | 0 | 1
  The number of grid units to shift along the Y-axis
Returns Point
The shifted target coordinates

activateListeners

activateListeners(): void
Activate interactivity for the Placeable Object

Returns void

can

can(user, action): boolean
Test whether a user can perform a certain interaction regarding a Placeable Object
Parameters
- user: User
  The User performing the action
- action: string
  The named action being attempted
Returns boolean
Does the User have rights to perform the action?

_prepareDragLeftDropUpdates

_prepareDragLeftDropUpdates(event): object[]
Perform the database updates that should occur as the result of a drag-left-drop operation.
Parameters
- event: FederatedEvent
  The triggering canvas interaction event
Returns object[]
An array of database updates to perform for documents in this collection

`Protected` _applyRenderFlags

_applyRenderFlags(flags): void
Protected
Apply render flags before a render occurs.
Parameters
- flags: Record<string, boolean>
  The render flags which must be applied
Returns void

`Protected` _destroy

_destroy(options?): void
Protected
The inner _destroy method which may optionally be defined by each PlaceableObject subclass.
Parameters
- Optional options: object
  Options passed to the initial destroy call
Returns void

`Protected` _draw

_draw(options): Promise<void>
Protected
The inner _draw method which must be defined by each PlaceableObject subclass.
Parameters
- options: object
  Options which may modify the draw workflow
Returns Promise<void>
Abstract

`Protected` _overlapsSelection

_overlapsSelection(rectangle): any
Protected Internal
Is this PlaceableObject within the selection rectangle?
Parameters
- rectangle: Rectangle
  The selection rectangle
Returns any

`Protected` _getTargetAlpha

_getTargetAlpha(): number
Protected
Get the target opacity that should be used for a Placeable Object depending on its preview state.

Returns number

`Protected` _onCreate

_onCreate(data, options, userId): void
Protected
Register pending canvas operations which should occur after a new PlaceableObject of this type is created
Parameters
- data: object
- options: object
- userId: string
Returns void

`Protected` _onUpdate

_onUpdate(changed, options, userId): void
Protected
Define additional steps taken when an existing placeable object of this type is updated with new data
Parameters
- changed: object
- options: object
- userId: string
Returns void

`Protected` _onDelete

_onDelete(options, userId): void
Protected
Define additional steps taken when an existing placeable object of this type is deleted
Parameters
- options: object
- userId: string
Returns void

`Protected` _onControl

_onControl(options): void
Protected
Additional events which trigger once control of the object is established
Parameters
- options: Object
  Optional parameters which apply for specific implementations
Returns void

`Protected` _onRelease

_onRelease(options): void
Protected
Additional events which trigger once control of the object is released
Parameters
- options: object
  Options which modify the releasing workflow
Returns void

`Protected` _createInteractionManager

_createInteractionManager(): MouseInteractionManager
Protected
Create a standard MouseInteractionManager for the PlaceableObject

Returns MouseInteractionManager

`Protected` _canHUD

_canHUD(user, event): boolean
Protected
Can the User access the HUD for this Placeable Object?
Parameters
- user: User
  The User performing the action.
- event: object
  The event object.
Returns boolean
The returned status.

`Protected` _canConfigure

_canConfigure(user, event): boolean
Protected
Does the User have permission to configure the Placeable Object?
Parameters
- user: User
  The User performing the action.
- event: object
  The event object.
Returns boolean
The returned status.

`Protected` _canControl

_canControl(user, event): boolean
Protected
Does the User have permission to control the Placeable Object?
Parameters
- user: User
  The User performing the action.
- event: object
  The event object.
Returns boolean
The returned status.

`Protected` _canView

_canView(user, event): boolean
Protected
Does the User have permission to view details of the Placeable Object?
Parameters
- user: User
  The User performing the action.
- event: object
  The event object.
Returns boolean
The returned status.

`Protected` _canCreate

_canCreate(user, event): boolean
Protected
Does the User have permission to create the underlying Document?
Parameters
- user: User
  The User performing the action.
- event: object
  The event object.
Returns boolean
The returned status.

`Protected` _canDrag

_canDrag(user, event): boolean
Protected
Does the User have permission to drag this Placeable Object?
Parameters
- user: User
  The User performing the action.
- event: object
  The event object.
Returns boolean
The returned status.

`Protected` _canDragLeftStart

_canDragLeftStart(user, event): boolean
Protected
Does the User have permission to left-click drag this Placeable Object?
Parameters
- user: User
  The User performing the action.
- event: object
  The event object.
Returns boolean
The returned status.

`Protected` _canHover

_canHover(user, event): boolean
Protected
Does the User have permission to hover on this Placeable Object?
Parameters
- user: User
  The User performing the action.
- event: object
  The event object.
Returns boolean
The returned status.

`Protected` _canUpdate

_canUpdate(user, event): boolean
Protected
Does the User have permission to update the underlying Document?
Parameters
- user: User
  The User performing the action.
- event: object
  The event object.
Returns boolean
The returned status.

`Protected` _canDelete

_canDelete(user, event): boolean
Protected
Does the User have permission to delete the underlying Document?
Parameters
- user: User
  The User performing the action.
- event: object
  The event object.
Returns boolean
The returned status.

`Protected` _onHoverIn

_onHoverIn(event, options?): void
Protected
Actions that should be taken for this Placeable Object when a mouseover event occurs. Hover events on PlaceableObject instances allow event propagation by default.
Parameters
- event: FederatedEvent
  The triggering canvas interaction event
- options: {
  hoverOutOthers: boolean;
  } = {}
  Options which customize event handling
  - hoverOutOthers: boolean
    Trigger hover-out behavior on sibling objects
Returns void
See
MouseInteractionManager##handlePointerOver

`Protected` _onHoverOut

_onHoverOut(event): void
Protected
Actions that should be taken for this Placeable Object when a mouseout event occurs
Parameters
- event: FederatedEvent
  The triggering canvas interaction event
Returns void
See
MouseInteractionManager##handlePointerOut

`Protected` _propagateLeftClick

_propagateLeftClick(event): boolean
Protected
Should the placeable propagate left click downstream?
Parameters
- event: FederatedEvent
Returns boolean

`Protected` _onClickLeft

_onClickLeft(event): void
Protected
Callback actions which occur on a single left-click event to assume control of the object
Parameters
- event: FederatedEvent
  The triggering canvas interaction event
Returns void
See
MouseInteractionManager##handleClickLeft

`Protected` _onUnclickLeft

_onUnclickLeft(event): void
Protected
Callback actions which occur on a single left-unclick event to assume control of the object
Parameters
- event: FederatedEvent
  The triggering canvas interaction event
Returns void

`Protected` _onClickLeft2

_onClickLeft2(event): void
Protected
Callback actions which occur on a double left-click event to activate
Parameters
- event: FederatedEvent
  The triggering canvas interaction event
Returns void
See
MouseInteractionManager##handleClickLeft2

`Protected` _propagateRightClick

_propagateRightClick(event): boolean
Protected
Should the placeable propagate right click downstream?
Parameters
- event: FederatedEvent
Returns boolean

`Protected` _onClickRight

_onClickRight(event): void
Protected
Callback actions which occur on a single right-click event to configure properties of the object
Parameters
- event: FederatedEvent
  The triggering canvas interaction event
Returns void
See
MouseInteractionManager##handleClickRight

`Protected` _onUnclickRight

_onUnclickRight(event): void
Protected
Callback actions which occur on a single right-unclick event
Parameters
- event: FederatedEvent
  The triggering canvas interaction event
Returns void

`Protected` _onClickRight2

_onClickRight2(event): void
Protected
Callback actions which occur on a double right-click event to configure properties of the object
Parameters
- event: FederatedEvent
  The triggering canvas interaction event
Returns void
See
MouseInteractionManager##handleClickRight2

`Protected` _onDragLeftStart

_onDragLeftStart(event): void
Protected
Callback actions which occur when a mouse-drag action is first begun.
Parameters
- event: FederatedEvent
  The triggering canvas interaction event
Returns void
See
MouseInteractionManager##handleDragStart

`Protected` _onDragStart

_onDragStart(): void
Protected
Begin a drag operation from the perspective of the preview clone. Modify the appearance of both the clone (this) and the original (_original) object.

Returns void

`Protected` _onDragEnd

_onDragEnd(): void
Protected
Conclude a drag operation from the perspective of the preview clone. Modify the appearance of both the clone (this) and the original (_original) object.

Returns void

`Protected` _onDragLeftMove

_onDragLeftMove(event): void
Protected
Callback actions which occur on a mouse-move operation.
Parameters
- event: FederatedEvent
  The triggering canvas interaction event
Returns void
See
MouseInteractionManager##handleDragMove

`Protected` _onDragLeftDrop

_onDragLeftDrop(event): boolean
Protected
Callback actions which occur on a mouse-move operation.
Parameters
- event: FederatedEvent
  The triggering canvas interaction event
Returns boolean
See
MouseInteractionManager##handleDragDrop

`Protected` _onDragLeftCancel

_onDragLeftCancel(event): void
Protected
Callback actions which occur on a mouse-move operation.
Parameters
- event: FederatedEvent
  The triggering mouse click event
Returns void
See
MouseInteractionManager##handleDragCancel

`Protected` _onDragRightStart

_onDragRightStart(event): any
Protected
Callback actions which occur on a right mouse-drag operation.
Parameters
- event: FederatedEvent
  The triggering mouse click event
Returns any
See
MouseInteractionManager##handleDragStart

`Protected` _onDragRightMove

_onDragRightMove(event): any
Protected
Callback actions which occur on a right mouse-drag operation.
Parameters
- event: FederatedEvent
  The triggering canvas interaction event
Returns any
See
MouseInteractionManager##handleDragMove

`Protected` _onDragRightDrop

_onDragRightDrop(event): Promise<any>
Protected
Callback actions which occur on a right mouse-drag operation.
Parameters
- event: FederatedEvent
  The triggering canvas interaction event
Returns Promise<any>
See
MouseInteractionManager##handleDragDrop

`Protected` _onDragRightCancel

_onDragRightCancel(event): any
Protected
Callback actions which occur on a right mouse-drag operation.
Parameters
- event: FederatedEvent
  The triggering mouse click event
Returns any
See
MouseInteractionManager##handleDragCancel

`Protected` _onLongPress

_onLongPress(event, origin): any
Protected
Callback action which occurs on a long press.
Parameters
- event: FederatedEvent
  The triggering canvas interaction event
- origin: Point
  The local canvas coordinates of the mousepress.
Returns any
See
MouseInteractionManager##handleLongPress

`Private` #commitDragLeftDropUpdates

#commitDragLeftDropUpdates(updates): Promise<void>
Perform database updates using the result of a drag-left-drop operation.
Parameters
- updates: object[]
  The database updates for documents in this collection
Returns Promise<void>

Class PlaceableObjectInterface

Abstract

Param: document

Hierarchy (view full)

Index

Properties

Accessors

Methods

Properties

scene

document

controlIcon

mouseInteractionManager

Private #original

Private #lastQuadtreeBounds

Private #drawing

Private #drawn

Static embeddedName

Static RENDER_FLAGS

Type declaration

redraw: { propagate: string[]; }

propagate: string[]

refresh: { propagate: string[]; alias: boolean; }

propagate: string[]

alias: boolean

refreshState: {}

Accessors

_original

Returns PlaceableObject

isOwner

Returns boolean

interactionState

Returns { NONE: number; HOVER: number; CLICKED: number; GRABBED: number; DRAG: number; DROP: number; }

NONE: number

HOVER: number

CLICKED: number

GRABBED: number

DRAG: number

DROP: number

bounds

Returns Rectangle

center

Returns Point

id

Returns string

objectId

Returns string

sourceId

Returns string

isPreview

Returns boolean

hasPreview

Returns boolean

layer

Returns PlaceablesLayer

sheet

Returns FormApplication

controlled

Returns boolean

hover

Returns boolean

hasActiveHUD

Returns boolean

Methods

getSnappedPosition

Parameters

Returns Point

applyRenderFlags

Returns void

clear

Returns PlaceableObject

destroy

Parameters

Returns any

Inherit Doc

draw

Parameters

Returns Promise<PlaceableObject>

_partialDraw

Parameters

Class PlaceableObject`Interface`

`Private` #original

`Private` #lastQuadtreeBounds

`Private` #drawing

`Private` #drawn

`Static` embeddedName

`Static` RENDER_FLAGS

redraw: {
propagate: string[];
}

refresh: {
propagate: string[];
alias: boolean;
}

Returns {
NONE: number;
HOVER: number;
CLICKED: number;
GRABBED: number;
DRAG: number;
DROP: number;
}

`Protected` _applyRenderFlags

`Protected` _destroy

`Protected` _draw

`Protected` _overlapsSelection

`Protected` _getTargetAlpha

`Protected` _onCreate

`Protected` _onUpdate

`Protected` _onDelete

`Protected` _onControl

`Protected` _onRelease

`Protected` _createInteractionManager

`Protected` _canHUD