Pixi’VNClass: FederatedPointerEvent
Defined in: node_modules/pixi.js/lib/events/FederatedPointerEvent.d.ts:48
A specialized event class for pointer interactions in PixiJS applications. Extends FederatedMouseEvent to provide advanced pointer-specific features while maintaining compatibility with the DOM PointerEvent interface.
Key features:
- Supports multi-touch interactions
- Provides pressure sensitivity
- Handles stylus input
- Tracks pointer dimensions
- Supports tilt detection
Example
// Basic pointer event handling
sprite.on('pointerdown', (event: FederatedPointerEvent) => {
// Access pointer information
console.log('Pointer ID:', event.pointerId);
console.log('Pointer Type:', event.pointerType);
console.log('Is Primary:', event.isPrimary);
// Get pressure and tilt data
console.log('Pressure:', event.pressure);
console.log('Tilt:', event.tiltX, event.tiltY);
// Access contact geometry
console.log('Size:', event.width, event.height);
});
// Handle stylus-specific features
sprite.on('pointermove', (event: FederatedPointerEvent) => {
if (event.pointerType === 'pen') {
// Handle stylus tilt
const tiltAngle = Math.atan2(event.tiltY, event.tiltX);
console.log('Tilt angle:', tiltAngle);
// Use barrel button pressure
console.log('Tangential pressure:', event.tangentialPressure);
}
});
See
- FederatedMouseEvent For base mouse event functionality
- https://developer.mozilla.org/en-US/docs/Web/API/PointerEvent DOM PointerEvent Interface
- EventSystem For the event management system
Standard
Extends
Implements
PointerEvent
Constructors
Constructor
> new FederatedPointerEvent(manager): FederatedPointerEvent
Defined in: node_modules/pixi.js/lib/events/FederatedEvent.d.ts:181
Parameters
manager
The event boundary which manages this event. Propagation can only occur within the boundary's jurisdiction.
Returns
FederatedPointerEvent
Inherited from
FederatedMouseEvent.constructor
Properties
altitudeAngle
> altitudeAngle: number
Defined in: node_modules/pixi.js/lib/events/FederatedPointerEvent.d.ts:66
The angle in radians of a pointer or stylus measuring the vertical angle between the device's surface to the pointer or stylus. A stylus at 0 degrees would be directly parallel whereas at π/2 degrees it would be perpendicular.
See
https://developer.mozilla.org/docs/Web/API/PointerEvent/altitudeAngle)
Implementation of
PointerEvent.altitudeAngle
altKey
> altKey: boolean
Defined in: node_modules/pixi.js/lib/events/FederatedMouseEvent.d.ts:48
Whether the "alt" key was pressed when this mouse event occurred.
Implementation of
PointerEvent.altKey
Inherited from
AT_TARGET
> readonly AT_TARGET: 2 = 2
Defined in: node_modules/pixi.js/lib/events/FederatedEvent.d.ts:291
The event propagation phase AT_TARGET that indicates that the event is at the target.
Default
2
Advanced
Implementation of
PointerEvent.AT_TARGET
Inherited from
azimuthAngle
> azimuthAngle: number
Defined in: node_modules/pixi.js/lib/events/FederatedPointerEvent.d.ts:73
The angle in radians of a pointer or stylus measuring an arc from the X axis of the device to the pointer or stylus projected onto the screen's plane. A stylus at 0 degrees would be pointing to the "0 o'clock" whereas at π/2 degrees it would be pointing at "6 o'clock".
See
https://developer.mozilla.org/docs/Web/API/PointerEvent/azimuthAngle)
Implementation of
PointerEvent.azimuthAngle
bubbles
> bubbles: boolean
Defined in: node_modules/pixi.js/lib/events/FederatedEvent.d.ts:107
Flags whether this event bubbles. This will take effect only if it is set before propagation.
Implementation of
PointerEvent.bubbles
Inherited from
BUBBLING_PHASE
> readonly BUBBLING_PHASE: 3 = 3
Defined in: node_modules/pixi.js/lib/events/FederatedEvent.d.ts:297
The event propagation phase BUBBLING_PHASE that indicates that the event is in the bubbling phase.
Default
3
Advanced
Implementation of
PointerEvent.BUBBLING_PHASE
Inherited from
FederatedMouseEvent.BUBBLING_PHASE
button
> button: number
Defined in: node_modules/pixi.js/lib/events/FederatedMouseEvent.d.ts:50
The specific button that was pressed in this mouse event.
Implementation of
PointerEvent.button
Inherited from
buttons
> buttons: number
Defined in: node_modules/pixi.js/lib/events/FederatedMouseEvent.d.ts:52
The button depressed when this event occurred.
Implementation of
PointerEvent.buttons
Inherited from
cancelable
> readonly cancelable: false = false
Defined in: node_modules/pixi.js/lib/events/FederatedEvent.d.ts:114
Flags whether this event can be canceled using FederatedEvent.preventDefault. This is always false (for now).
Implementation of
PointerEvent.cancelable
Inherited from
FederatedMouseEvent.cancelable
~~cancelBubble~~
> cancelBubble: boolean
Defined in: node_modules/pixi.js/lib/events/FederatedEvent.d.ts:109
Deprecated
since 7.0.0
Implementation of
PointerEvent.cancelBubble
Inherited from
FederatedMouseEvent.cancelBubble
CAPTURING_PHASE
> readonly CAPTURING_PHASE: 1 = 1
Defined in: node_modules/pixi.js/lib/events/FederatedEvent.d.ts:285
The event propagation phase CAPTURING_PHASE that indicates that the event is in the capturing phase.
Default
1
Advanced
Implementation of
PointerEvent.CAPTURING_PHASE
Inherited from
FederatedMouseEvent.CAPTURING_PHASE
client
> client: Point
Defined in: node_modules/pixi.js/lib/events/FederatedMouseEvent.d.ts:62
The coordinates of the mouse event relative to the canvas.
Inherited from
ctrlKey
> ctrlKey: boolean
Defined in: node_modules/pixi.js/lib/events/FederatedMouseEvent.d.ts:54
Whether the "control" key was pressed when this mouse event occurred.
Implementation of
PointerEvent.ctrlKey
Inherited from
currentTarget
> currentTarget: Container
Defined in: node_modules/pixi.js/lib/events/FederatedEvent.d.ts:123
The listeners of the event target that are being notified.
Implementation of
PointerEvent.currentTarget
Inherited from
FederatedMouseEvent.currentTarget
defaultPrevented
> defaultPrevented: boolean
Defined in: node_modules/pixi.js/lib/events/FederatedEvent.d.ts:125
Flags whether the default response of the user agent was prevent through this event.
Implementation of
PointerEvent.defaultPrevented
Inherited from
FederatedMouseEvent.defaultPrevented
detail
> detail: number
Defined in: node_modules/pixi.js/lib/events/FederatedPointerEvent.d.ts:118
This is the number of clicks that occurs in 200ms/click of each other.
Implementation of
PointerEvent.detail
Overrides
eventPhase
> eventPhase: number
Defined in: node_modules/pixi.js/lib/events/FederatedEvent.d.ts:130
The propagation phase.
Default
Implementation of
PointerEvent.eventPhase
Inherited from
FederatedMouseEvent.eventPhase
global
> global: Point
Defined in: node_modules/pixi.js/lib/events/FederatedMouseEvent.d.ts:92
The pointer coordinates in world space.
Inherited from
height
> height: number
Defined in: node_modules/pixi.js/lib/events/FederatedPointerEvent.d.ts:79
The height of the pointer's contact along the y-axis, measured in CSS pixels. radiusY of TouchEvents will be represented by this value.
See
https://developer.mozilla.org/en-US/docs/Web/API/PointerEvent/height
Implementation of
PointerEvent.height
isPrimary
> isPrimary: boolean
Defined in: node_modules/pixi.js/lib/events/FederatedPointerEvent.d.ts:84
Indicates whether or not the pointer device that created the event is the primary pointer.
See
https://developer.mozilla.org/en-US/docs/Web/API/PointerEvent/isPrimary
Implementation of
PointerEvent.isPrimary
isTrusted
> isTrusted: boolean
Defined in: node_modules/pixi.js/lib/events/FederatedEvent.d.ts:132
Flags whether this is a user-trusted event
Implementation of
PointerEvent.isTrusted
Inherited from
layer
> layer: Point
Defined in: node_modules/pixi.js/lib/events/FederatedEvent.d.ts:166
The coordinates of the event relative to the nearest DOM layer. This is a non-standard property.
Inherited from
manager
> readonly manager: EventBoundary
Defined in: node_modules/pixi.js/lib/events/FederatedEvent.d.ts:154
The EventBoundary that manages this event. Null for root events.
Inherited from
metaKey
> metaKey: boolean
Defined in: node_modules/pixi.js/lib/events/FederatedMouseEvent.d.ts:56
Whether the "meta" key was pressed when this mouse event occurred.
Implementation of
PointerEvent.metaKey
Inherited from
movement
> movement: Point
Defined in: node_modules/pixi.js/lib/events/FederatedMouseEvent.d.ts:80
The movement in this pointer relative to the last mousemove event.
Inherited from
nativeEvent
> nativeEvent: MouseEvent | PointerEvent | PixiTouch
Defined in: node_modules/pixi.js/lib/events/FederatedEvent.d.ts:144
The native event that caused the foremost original event.
Inherited from
FederatedMouseEvent.nativeEvent
NONE
> readonly NONE: 0 = 0
Defined in: node_modules/pixi.js/lib/events/FederatedEvent.d.ts:279
The event propagation phase NONE that indicates that the event is not in any phase.
Default
0
Advanced
Implementation of
PointerEvent.NONE
Inherited from
offset
> offset: Point
Defined in: node_modules/pixi.js/lib/events/FederatedMouseEvent.d.ts:86
The offset of the pointer coordinates w.r.t. target Container in world space. This is not supported at the moment.
Inherited from
originalEvent
> originalEvent: FederatedEvent<MouseEvent | PointerEvent | PixiTouch>
Defined in: node_modules/pixi.js/lib/events/FederatedEvent.d.ts:146
The original event that caused this event, if any.
Inherited from
FederatedMouseEvent.originalEvent
page
> page: Point
Defined in: node_modules/pixi.js/lib/events/FederatedEvent.d.ts:172
The coordinates of the event relative to the DOM document. This is a non-standard property.
Inherited from
path
> path: Container<ContainerChild>[]
Defined in: node_modules/pixi.js/lib/events/FederatedEvent.d.ts:152
The composed path of the event's propagation. The target is at the end.
Inherited from
pointerId
> pointerId: number
Defined in: node_modules/pixi.js/lib/events/FederatedPointerEvent.d.ts:53
The unique identifier of the pointer.
See
https://developer.mozilla.org/en-US/docs/Web/API/PointerEvent/pointerId
Implementation of
PointerEvent.pointerId
pointerType
> pointerType: string
Defined in: node_modules/pixi.js/lib/events/FederatedPointerEvent.d.ts:89
The type of pointer that triggered the event.
See
https://developer.mozilla.org/en-US/docs/Web/API/PointerEvent/pointerType
Implementation of
PointerEvent.pointerType
pressure
> pressure: number
Defined in: node_modules/pixi.js/lib/events/FederatedPointerEvent.d.ts:96
Pressure applied by the pointing device during the event. s A Touch's force property will be represented by this value.
See
https://developer.mozilla.org/en-US/docs/Web/API/PointerEvent/pressure
Implementation of
PointerEvent.pressure
propagationImmediatelyStopped
> propagationImmediatelyStopped: boolean
Defined in: node_modules/pixi.js/lib/events/FederatedEvent.d.ts:150
Flags whether propagation was immediately stopped.
Inherited from
FederatedMouseEvent.propagationImmediatelyStopped
propagationStopped
> propagationStopped: boolean
Defined in: node_modules/pixi.js/lib/events/FederatedEvent.d.ts:148
Flags whether propagation was stopped.
Inherited from
FederatedMouseEvent.propagationStopped
relatedTarget
> relatedTarget: EventTarget
Defined in: node_modules/pixi.js/lib/events/FederatedMouseEvent.d.ts:58
This is currently not implemented in the Federated Events API.
Implementation of
PointerEvent.relatedTarget
Inherited from
FederatedMouseEvent.relatedTarget
~~returnValue~~
> returnValue: boolean
Defined in: node_modules/pixi.js/lib/events/FederatedEvent.d.ts:134
Deprecated
since 7.0.0
Implementation of
PointerEvent.returnValue
Inherited from
FederatedMouseEvent.returnValue
screen
> screen: Point
Defined in: node_modules/pixi.js/lib/events/FederatedMouseEvent.d.ts:101
The pointer coordinates in the renderer's screen. This has slightly different semantics than native PointerEvent screenX/screenY.
Inherited from
shiftKey
> shiftKey: boolean
Defined in: node_modules/pixi.js/lib/events/FederatedMouseEvent.d.ts:60
Whether the "shift" key was pressed when this mouse event occurred.
Implementation of
PointerEvent.shiftKey
Inherited from
~~srcElement~~
> srcElement: EventTarget
Defined in: node_modules/pixi.js/lib/events/FederatedEvent.d.ts:136
Deprecated
since 7.0.0
Implementation of
PointerEvent.srcElement
Inherited from
FederatedMouseEvent.srcElement
tangentialPressure
> tangentialPressure: number
Defined in: node_modules/pixi.js/lib/events/FederatedPointerEvent.d.ts:101
Barrel pressure on a stylus pointer.
See
https://w3c.github.io/pointerevents/#pointerevent-interface
Implementation of
PointerEvent.tangentialPressure
target
> target: Container
Defined in: node_modules/pixi.js/lib/events/FederatedEvent.d.ts:138
The event target that this will be dispatched to.
Implementation of
PointerEvent.target
Inherited from
tiltX
> tiltX: number
Defined in: node_modules/pixi.js/lib/events/FederatedPointerEvent.d.ts:106
The angle, in degrees, between the pointer device and the screen.
See
https://developer.mozilla.org/en-US/docs/Web/API/PointerEvent/tiltX
Implementation of
PointerEvent.tiltX
tiltY
> tiltY: number
Defined in: node_modules/pixi.js/lib/events/FederatedPointerEvent.d.ts:111
The angle, in degrees, between the pointer device and the screen.
See
https://developer.mozilla.org/en-US/docs/Web/API/PointerEvent/tiltY
Implementation of
PointerEvent.tiltY
timeStamp
> timeStamp: number
Defined in: node_modules/pixi.js/lib/events/FederatedEvent.d.ts:140
The timestamp of when the event was created.
Implementation of
PointerEvent.timeStamp
Inherited from
twist
> twist: number
Defined in: node_modules/pixi.js/lib/events/FederatedPointerEvent.d.ts:116
Twist of a stylus pointer.
See
https://w3c.github.io/pointerevents/#pointerevent-interface
Implementation of
PointerEvent.twist
type
> type: string
Defined in: node_modules/pixi.js/lib/events/FederatedEvent.d.ts:142
The type of event, e.g. "mouseup".
Implementation of
PointerEvent.type
Inherited from
view
> view: Window
Defined in: node_modules/pixi.js/lib/events/FederatedEvent.d.ts:158
The global Window object.
Implementation of
PointerEvent.view
Inherited from
width
> width: number
Defined in: node_modules/pixi.js/lib/events/FederatedPointerEvent.d.ts:59
The width of the pointer's contact along the x-axis, measured in CSS pixels. radiusX of TouchEvents will be represented by this value.
See
https://developer.mozilla.org/en-US/docs/Web/API/PointerEvent/width
Implementation of
PointerEvent.width
Accessors
clientX
Get Signature
> get clientX(): number
Defined in: node_modules/pixi.js/lib/events/FederatedMouseEvent.d.ts:64
Returns
number
Implementation of
PointerEvent.clientX
Inherited from
clientY
Get Signature
> get clientY(): number
Defined in: node_modules/pixi.js/lib/events/FederatedMouseEvent.d.ts:66
Returns
number
Implementation of
PointerEvent.clientY
Inherited from
data
Get Signature
> get data(): this
Defined in: node_modules/pixi.js/lib/events/FederatedEvent.d.ts:186
Fallback for the deprecated InteractionEvent.data.
Deprecated
since 7.0.0
Returns
this
Inherited from
globalX
Get Signature
> get globalX(): number
Defined in: node_modules/pixi.js/lib/events/FederatedMouseEvent.d.ts:94
Returns
number
Inherited from
globalY
Get Signature
> get globalY(): number
Defined in: node_modules/pixi.js/lib/events/FederatedMouseEvent.d.ts:96
Returns
number
Inherited from
layerX
Get Signature
> get layerX(): number
Defined in: node_modules/pixi.js/lib/events/FederatedEvent.d.ts:168
Returns
number
Implementation of
PointerEvent.layerX
Inherited from
layerY
Get Signature
> get layerY(): number
Defined in: node_modules/pixi.js/lib/events/FederatedEvent.d.ts:170
Returns
number
Implementation of
PointerEvent.layerY
Inherited from
movementX
Get Signature
> get movementX(): number
Defined in: node_modules/pixi.js/lib/events/FederatedMouseEvent.d.ts:82
Returns
number
Implementation of
PointerEvent.movementX
Inherited from
movementY
Get Signature
> get movementY(): number
Defined in: node_modules/pixi.js/lib/events/FederatedMouseEvent.d.ts:84
Returns
number
Implementation of
PointerEvent.movementY
Inherited from
offsetX
Get Signature
> get offsetX(): number
Defined in: node_modules/pixi.js/lib/events/FederatedMouseEvent.d.ts:88
Returns
number
Implementation of
PointerEvent.offsetX
Inherited from
offsetY
Get Signature
> get offsetY(): number
Defined in: node_modules/pixi.js/lib/events/FederatedMouseEvent.d.ts:90
Returns
number
Implementation of
PointerEvent.offsetY
Inherited from
pageX
Get Signature
> get pageX(): number
Defined in: node_modules/pixi.js/lib/events/FederatedEvent.d.ts:174
Returns
number
Implementation of
PointerEvent.pageX
Inherited from
pageY
Get Signature
> get pageY(): number
Defined in: node_modules/pixi.js/lib/events/FederatedEvent.d.ts:176
Returns
number
Implementation of
PointerEvent.pageY
Inherited from
screenX
Get Signature
> get screenX(): number
Defined in: node_modules/pixi.js/lib/events/FederatedMouseEvent.d.ts:106
The pointer coordinates in the renderer's screen. Alias for screen.x.
Returns
number
Implementation of
PointerEvent.screenX
Inherited from
screenY
Get Signature
> get screenY(): number
Defined in: node_modules/pixi.js/lib/events/FederatedMouseEvent.d.ts:111
The pointer coordinates in the renderer's screen. Alias for screen.y.
Returns
number
Implementation of
PointerEvent.screenY
Inherited from
x
Get Signature
> get x(): number
Defined in: node_modules/pixi.js/lib/events/FederatedMouseEvent.d.ts:71
Alias for this.clientX.
Returns
number
Implementation of
PointerEvent.x
Inherited from
y
Get Signature
> get y(): number
Defined in: node_modules/pixi.js/lib/events/FederatedMouseEvent.d.ts:76
Alias for this.clientY.
Returns
number
Implementation of
PointerEvent.y
Inherited from
Methods
composedPath()
> composedPath(): Container<ContainerChild>[]
Defined in: node_modules/pixi.js/lib/events/FederatedEvent.d.ts:191
The propagation path for this event. Alias for EventBoundary.propagationPath.
Returns
Advanced
Implementation of
PointerEvent.composedPath
Inherited from
FederatedMouseEvent.composedPath
getLocalPosition()
> getLocalPosition<P>(container, point?, globalPos?): P
Defined in: node_modules/pixi.js/lib/events/FederatedMouseEvent.d.ts:140
Converts global coordinates into container-local coordinates.
This method transforms coordinates from world space to a container's local space, useful for precise positioning and hit testing.
Type Parameters
P
Parameters
container
The Container to get local coordinates for
point?
P
Optional Point object to store the result. If not provided, a new Point will be created
globalPos?
Optional custom global coordinates. If not provided, the event's global position is used
Returns
P
The local coordinates as a Point object
Example
// Basic usage - get local coordinates relative to a container
sprite.on('pointermove', (event: FederatedMouseEvent) => {
// Get position relative to the sprite
const localPos = event.getLocalPosition(sprite);
console.log('Local position:', localPos.x, localPos.y);
});
// Using custom global coordinates
const customGlobal = new Point(100, 100);
sprite.on('pointermove', (event: FederatedMouseEvent) => {
// Transform custom coordinates
const localPos = event.getLocalPosition(sprite, undefined, customGlobal);
console.log('Custom local position:', localPos.x, localPos.y);
});
See
- Container.worldTransform For the transformation matrix
- Point For the point class used to store coordinates
Inherited from
FederatedMouseEvent.getLocalPosition
getModifierState()
> getModifierState(key): boolean
Defined in: node_modules/pixi.js/lib/events/FederatedMouseEvent.d.ts:145
Whether the modifier key was pressed when this event natively occurred.
Parameters
key
string
The modifier key.
Returns
boolean
Implementation of
PointerEvent.getModifierState
Inherited from
FederatedMouseEvent.getModifierState
preventDefault()
> preventDefault(): void
Defined in: node_modules/pixi.js/lib/events/FederatedEvent.d.ts:229
Prevent default behavior of both PixiJS and the user agent.
Returns
void
Example
sprite.on('click', (event) => {
// Prevent both browser's default click behavior
// and PixiJS's default handling
event.preventDefault();
// Custom handling
customClickHandler();
});
Remarks
- Only works if the native event is cancelable
- Does not stop event propagation
Implementation of
PointerEvent.preventDefault
Inherited from
FederatedMouseEvent.preventDefault
stopImmediatePropagation()
> stopImmediatePropagation(): void
Defined in: node_modules/pixi.js/lib/events/FederatedEvent.d.ts:249
Stop this event from propagating to any additional listeners, including those on the current target and any following targets in the propagation path.
Returns
void
Example
container.on('pointerdown', (event) => {
// Stop all further event handling
event.stopImmediatePropagation();
// These handlers won't be called:
// - Other pointerdown listeners on this container
// - Any pointerdown listeners on parent containers
});
Remarks
- Immediately stops all event propagation
- Prevents other listeners on same target from being called
- More aggressive than stopPropagation()
Implementation of
PointerEvent.stopImmediatePropagation
Inherited from
FederatedMouseEvent.stopImmediatePropagation
stopPropagation()
> stopPropagation(): void
Defined in: node_modules/pixi.js/lib/events/FederatedEvent.d.ts:273
Stop this event from propagating to the next target in the propagation path. The rest of the listeners on the current target will still be notified.
Returns
void
Example
child.on('pointermove', (event) => {
// Handle event on child
updateChild();
// Prevent parent handlers from being called
event.stopPropagation();
});
// This won't be called if child handles the event
parent.on('pointermove', (event) => {
updateParent();
});
Remarks
- Stops event bubbling to parent containers
- Does not prevent other listeners on same target
- Less aggressive than stopImmediatePropagation()
Implementation of
PointerEvent.stopPropagation