bndr-js - v0.18.0 / PointerEmitter

Class: PointerEmitter

Hierarchy

• Emitter<PointerEvent>

  ↳ PointerEmitter

Constructors

constructor

• new PointerEmitter(target?, options?)

Parameters

Name	Type	Default value
target	PointerEmitterTarget	document
options	Pick<EmitterOptions<PointerEmitter>, "sources">	{}

Overrides

Emitter.constructor

Defined in

src/generator/pointer.ts:85

Generators

pinch

▸ pinch(options?): Emitter<number>

Creates a generator that emits the pinch delta of the pointer.

Parameters

Name	Type
options?	GeneratorOptions

Returns

Emitter<number>

See

https://kenneth.io/post/detecting-multi-touch-trackpad-gestures-in-javascript

Defined in

src/generator/pointer.ts:576

---

scroll

▸ scroll(options?): Emitter<vec2>

Creates a generator that emits the scroll delta of the pointer.

Parameters

Name	Type
options?	GeneratorOptions

Returns

Emitter<vec2>

Defined in

src/generator/pointer.ts:543

Filters

left

• get left(): PointerEmitter

Returns

PointerEmitter

Defined in

src/generator/pointer.ts:468

---

middle

• get middle(): PointerEmitter

Returns

PointerEmitter

Defined in

src/generator/pointer.ts:475

---

mouse

• get mouse(): PointerEmitter

Returns

PointerEmitter

Defined in

src/generator/pointer.ts:521

---

pen

• get pen(): PointerEmitter

Returns

PointerEmitter

Defined in

src/generator/pointer.ts:528

---

primary

• get primary(): PointerEmitter

Returns

PointerEmitter

Defined in

src/generator/pointer.ts:454

---

right

• get right(): PointerEmitter

Returns

PointerEmitter

Defined in

src/generator/pointer.ts:482

---

secondary

• get secondary(): PointerEmitter

Returns

PointerEmitter

Defined in

src/generator/pointer.ts:461

---

touch

• get touch(): PointerEmitter

Returns

PointerEmitter

Defined in

src/generator/pointer.ts:535

---

down

▸ down(options?): Emitter<true>

Creates an emitter that emits true at the moment the pointer is pressed.

Parameters

Name	Type
options?	GeneratorOptions

Returns

Emitter<true>

Overrides

Emitter.down

Defined in

src/generator/pointer.ts:394

---

drag

▸ drag(options?): Emitter<DragData>

Creates a emitter that emits when the pointer is dragged.

Parameters

Name	Type
options?	PointerDragGeneratorOptions

Returns

Emitter<DragData>

Defined in

src/generator/pointer.ts:265

---

gestureTransform

▸ gestureTransform(options): Emitter<GestureTransformData>

Parameters

Name	Type
options	GeneratorOptions

Returns

Emitter<GestureTransformData>

Defined in

src/generator/pointer.ts:340

---

pointerCount

▸ pointerCount(): Emitter<number>

Creates a generator that emits the pointer count.

Returns

Emitter<number>

Defined in

src/generator/pointer.ts:209

---

pointerType

▸ pointerType(type, options?): PointerEmitter

Creates a emitter that emits only when the pointer type is the given type.

Parameters

Name	Type	Description
type	"mouse" | "pen" | "touch"	Pointer type to watch.
options?	GeneratorOptions	-

Returns

PointerEmitter

A new emitter.

Defined in

src/generator/pointer.ts:499

---

position

▸ position(options?): Emitter<vec2>

Creates a generator that emits the position of the pointer.

Parameters

Name	Type
options?	PointerPositionGeneratorOptions

Returns

Emitter<vec2>

Defined in

src/generator/pointer.ts:154

---

pressed

▸ pressed(options?): Emitter<boolean>

Creates a generator that emits true when the pointer is pressed.

Parameters

Name	Type
options?	PointerPressedGeneratorOptions

Returns

Emitter<boolean>

Defined in

src/generator/pointer.ts:130

---

pressure

▸ pressure(): Emitter<number>

Creates a generator that emits the pressure of the pointer.

Returns

Emitter<number>

Defined in

src/generator/pointer.ts:175

---

size

▸ size(): Emitter<vec2>

Creates a generator that emits the size of the pointer.

Returns

Emitter<vec2>

Defined in

src/generator/pointer.ts:200

---

tilt

▸ tilt(): Emitter<vec2>

Returns

Emitter<vec2>

Defined in

src/generator/pointer.ts:191

---

twist

▸ twist(): Emitter<number>

Returns

Emitter<number>

Defined in

src/generator/pointer.ts:183

---

up

▸ up(options?): Emitter<true>

Creates an emitter that emits true at the moment the pointer is released.

Parameters

Name	Type
options?	GeneratorOptions

Returns

Emitter<true>

Overrides

Emitter.up

Defined in

src/generator/pointer.ts:408

---

withPointerCount

▸ withPointerCount(count, options?): Emitter<WithPointerCountData>

Creates a generator that emits the list of pointers when the pointer count is the given count.

Parameters

Name	Type
count	number
options?	GeneratorOptions

Returns

Emitter<WithPointerCountData>

Defined in

src/generator/pointer.ts:230

Common Filters

change

▸ change(equalFn?): Emitter<PointerEvent>

Emits only when the value is changed

Parameters

Name	Type	Default value	Description
equalFn	(a: PointerEvent, b: PointerEvent) => boolean	isEqual	A comparator function. The event will be emitted when the function returns falsy value.

Returns

Emitter<PointerEvent>

Inherited from

Emitter.change

Defined in

src/Emitter.ts:305

---

constant

▸ constant<U>(value): Emitter<U>

Creates an emitter that emits a constant value every time the current emitter is emitted.

Type parameters

Name
U

Parameters

Name	Type
value	U

Returns

Emitter<U>

See

https://lodash.com/docs/4.17.15#throttle

Inherited from

Emitter.constant

Defined in

src/Emitter.ts:393

---

debounce

▸ debounce(wait, options): Emitter<unknown>

Creates debounced version of the current emitter.

Parameters

Name	Type	Description
wait	number	Milliseconds to wait.
options	DebounceSettings

Returns

Emitter<unknown>

A new emitter

Inherited from

Emitter.debounce

Defined in

src/Emitter.ts:435

---

delay

▸ delay(wait): Emitter<unknown>

Creates delayed version of the current emitter.

Parameters

Name	Type	Description
wait	number	Milliseconds to wait.

Returns

Emitter<unknown>

A new emitter

Inherited from

Emitter.delay

Defined in

src/Emitter.ts:460

---

delta

▸ delta<U>(fn): Emitter<U>

Creates an emitter that emits the ‘difference’ between the current value and the previous value.

Type parameters

Name
U

Parameters

Name	Type	Description
fn	(prev: PointerEvent, curt: PointerEvent) => U	A function to calculate the difference

Returns

Emitter<U>

A new emitter

Inherited from

Emitter.delta

Defined in

src/Emitter.ts:679

---

filter

▸ filter(fn): Emitter<PointerEvent>

Filters events with the given predicate function

Parameters

Name	Type	Description
fn	(value: PointerEvent) => any	Return truthy value to pass events

Returns

Emitter<PointerEvent>

A new emitter

Inherited from

Emitter.filter

Defined in

src/Emitter.ts:237

---

filterMap

▸ filterMap<U>(fn, initialValue?): Emitter<U>

Maps the current value to another type of value, and emits the mapped value only when the mapped value is not undefined.

Type parameters

Name
U

Parameters

Name	Type	Description
fn	(value: PointerEvent) => U	A function to map the current value. Return undefined to skip emitting.
initialValue?	U	-

Returns

Emitter<U>

Inherited from

Emitter.filterMap

Defined in

src/Emitter.ts:252

---

fold

▸ fold<U>(fn, initialState): Emitter<U>

Initializes with an initialState value. On each emitted event, calculates a new state based on the previous state and the current value, and emits this new state.

Type parameters

Name
U

Parameters

Name	Type	Description
fn	(prev: U, value: PointerEvent) => U	A function to calculate a new state
initialState	U	An initial state value

Returns

Emitter<U>

A new emitter

Inherited from

Emitter.fold

Defined in

src/Emitter.ts:633

---

interval

▸ interval(ms?, immediate?): Emitter<any>

Creates an emitter that keeps to emit the last value of the current emitter at the specified interval.

Parameters

Name	Type	Default value	Description
ms	number	0	The interval in milliseconds. Set 0 to use requestAnimationFrame.
immediate	boolean	false	If set to false, the new emitter waits to emit until the current emitter emits any value.

Returns

Emitter<any>

A new emitter.

Inherited from

Emitter.interval

Defined in

src/Emitter.ts:702

---

lerp

▸ lerp(lerp, rate, threshold?): Emitter<PointerEvent>

Smoothen the change rate of the input value.

Parameters

Name	Type	Default value	Description
lerp	Lerp<PointerEvent>	undefined	A function to interpolate the current value and the target value.
rate	number	undefined	The ratio of linear interpolation from the current value to the target value with each update.
threshold	number	1e-4	The threshold to determine whether the current value is close enough to the target value. If the difference between the current value and the target value is less than this value, the target value will be used as the current value and the interpolation will be stopped.

Returns

Emitter<PointerEvent>

A new emitter

Inherited from

Emitter.lerp

Defined in

src/Emitter.ts:506

---

longPress

▸ longPress(wait): Object

Parameters

Name	Type
wait	number

Returns

Object

Name	Type
pressed	Emitter<unknown>

Inherited from

Emitter.longPress

Defined in

src/Emitter.ts:476

---

map

▸ map<U>(fn, initialValue?): Emitter<U>

Transforms the payload of event with the given function.

Type parameters

Name
U

Parameters

Name	Type	Description
fn	(value: PointerEvent) => U	A function to transform the payload
initialValue?	U	-

Returns

Emitter<U>

A new emitter

Inherited from

Emitter.map

Defined in

src/Emitter.ts:224

---

not

▸ not(): Emitter<boolean>

Creates an emitter whose payload is negated.

Returns

Emitter<boolean>

Inherited from

Emitter.not

Defined in

src/Emitter.ts:294

---

resetBy

▸ resetBy(emitter, emitOnReset?): Emitter<PointerEvent>

Reset the state of current emitter emitter when the given event is fired.

Parameters

Name	Type	Default value	Description
emitter	Emitter<any>	undefined	The emitter that triggers the current emitter to be reset.
emitOnReset	boolean	true	If set to true, the current emitter will be triggered when it is reset.

Returns

Emitter<PointerEvent>

The current emitter emitter

Inherited from

Emitter.resetBy

Defined in

src/Emitter.ts:610

---

stash

▸ stash(...triggers): Emitter<any>

Creates an emitter that emits the current value when one of the given events is fired.

Parameters

Name	Type	Description
...triggers	Emitter<any>[]	Emitters to trigger the current emitter to emit.

Returns

Emitter<any>

A new emitter

Inherited from

Emitter.stash

Defined in

src/Emitter.ts:659

---

throttle

▸ throttle(wait, options?): Emitter<PointerEvent>

Creates throttled version of the current emitter.

Parameters

Name	Type	Description
wait	number	Milliseconds to wait.
options?	ThrottleSettings

Returns

Emitter<PointerEvent>

See

https://lodash.com/docs/4.17.15#debounced

Inherited from

Emitter.throttle

Defined in

src/Emitter.ts:410

---

trail

▸ trail(count?, emitAtCount?): Emitter<PointerEvent[]>

Emits an array caching a specified number of values that were emitted in the past.

Parameters

Name	Type	Default value	Description
count	number	2	The number of cache frames. Set 0 to store caches infinitely.
emitAtCount	boolean	true	When set to true, events will not be emitted until the count of cache reaches to count.

Returns

Emitter<PointerEvent[]>

Inherited from

Emitter.trail

Defined in

src/Emitter.ts:739

---

while

▸ while(emitter, resetOnDown?): Emitter<PointerEvent>

Emits while the given event is truthy. The event will be also emitted when the given emitter is changed from falsy to truthy when the resetOnDown flag is set to true.

Parameters

Name	Type	Default value	Description
emitter	Emitter<boolean>	undefined	An emitter to filter the events
resetOnDown	boolean	true	If set to true, the returned emitter will be reset when the given emitter is down.

Returns

Emitter<PointerEvent>

Inherited from

Emitter.while

Defined in

src/Emitter.ts:326

Methods

createDerived

▸ createDerived<U>(options): Emitter<U>

Type parameters

Name
U

Parameters

Name	Type
options	EmitterOptions<U> & { propagate: (e: PointerEvent, emit: (v: U) => void) => void }

Returns

Emitter<U>

Inherited from

Emitter.createDerived

Defined in

src/Emitter.ts:80

---

registerDerived

▸ registerDerived(emitter, listener): void

Parameters

Name	Type
emitter	Emitter<any>
listener	Listener<PointerEvent>

Returns

void

Inherited from

Emitter.registerDerived

Defined in

src/Emitter.ts:72

---

tween

▸ tween(lerp, durationMs): Emitter<PointerEvent>

Parameters

Name	Type
lerp	Lerp<PointerEvent>
durationMs	number

Returns

Emitter<PointerEvent>

Inherited from

Emitter.tween

Defined in

src/Emitter.ts:560

Properties

_disposed

• Protected _disposed: boolean = false

Inherited from

Emitter._disposed

Defined in

src/Emitter.ts:61

---

derivedEmitters

• Protected Readonly derivedEmitters: Map<Emitter<any>, Listener<PointerEvent>>

Stores all deviced events and their listeners. They will not be unregistered by removeAllListeners.

Inherited from

Emitter.derivedEmitters

Defined in

src/Emitter.ts:59

---

icon

• Optional icon: IconSequence

Inherited from

Emitter.icon

Defined in

src/Emitter.ts:49

---

stateful

• get stateful(): boolean

Returns true if the emitter has a state and can be reset.

Returns

boolean

Inherited from

Emitter.stateful

Defined in

src/Emitter.ts:137

---

value

• get value(): T

The latest value emitted from the emitter. If the emitter has never fired before, it just returns undefined.

Returns

T

Inherited from

Emitter.value

Defined in

src/Emitter.ts:162

---

button

▸ button(button): PointerEmitter

Creates a emitter that emits only when the given button is pressed.

Parameters

Name	Type	Description
button	number | "left" | "right" | "primary" | "secondary" | "middle"	Button to watch.

Returns

PointerEmitter

A new emitter.

Defined in

src/generator/pointer.ts:424

Accessors

disposed

• get disposed(): boolean

Returns

boolean

Inherited from

Emitter.disposed

Defined in

src/Emitter.ts:63

Commom Filters

split

▸ split(emitter, count, resetOnSwitch?): Emitter<PointerEvent>[]

Splits the current emitter into multiple emitters. Each emitter emits only when the given emitter is changed to the corresponding index.

Parameters

Name	Type	Default value	Description
emitter	Emitter<any>	undefined	An emitter to filter the current event
count	number	undefined	The number of emitters to be created.
resetOnSwitch	boolean	true	If set to true, the corresponding emitter will be reset when the index of current emitter is switched.

Returns

Emitter<PointerEvent>[]

Inherited from

Emitter.split

Defined in

src/Emitter.ts:355

Event Handlers

dispose

▸ dispose(): void

Disposes the emitter immediately and prevent to emit any value in the future

Returns

void

Inherited from

Emitter.dispose

Defined in

src/Emitter.ts:119

---

emit

▸ emit(value): void

Manually emits the event.

Parameters

Name	Type
value	PointerEvent

Returns

void

Inherited from

Emitter.emit

Defined in

src/Emitter.ts:190

---

log

▸ log(message?): PointerEmitter

Parameters

Name	Type	Default value
message	string	'Bndr'

Returns

PointerEmitter

Inherited from

Emitter.log

Defined in

src/Emitter.ts:757

---

off

▸ off(listener): void

Removes the listener function from the event.

Parameters

Name	Type
listener	Listener<PointerEvent>

Returns

void

Inherited from

Emitter.off

Defined in

src/Emitter.ts:181

---

on

▸ on(listener): PointerEmitter

Adds the listener function for the event.

Parameters

Name	Type	Description
listener	Listener<PointerEvent>	The callback function

Returns

PointerEmitter

Inherited from

Emitter.on

Defined in

src/Emitter.ts:171

---

once

▸ once(listener): void

Adds a one-time listener function for the event

Parameters

Name	Type
listener	Listener<PointerEvent>

Returns

void

Inherited from

Emitter.once

Defined in

src/Emitter.ts:202

---

removeAllListeners

▸ removeAllListeners(): void

Removes all listeners.

Returns

void

Inherited from

Emitter.removeAllListeners

Defined in

src/Emitter.ts:214

---

reset

▸ reset(): void

Resets the state of the emitter.

Returns

void

Inherited from

Emitter.reset

Defined in

src/Emitter.ts:145