Class ExpressionManager<Expression, ExpressionSpec>`Abstract`

Abstract expression manager.

Emits

ExpressionManagerEvents

Type Parameters

Expression = any
ExpressionSpec = any

Hierarchy

EventEmitter<keyof ExpressionManagerEvents>
- ExpressionManager
  - Cubism2ExpressionManager
  - Cubism4ExpressionManager

Constructors

`Protected` constructor

new ExpressionManager<Expression, ExpressionSpec>(settings: ModelSettings, options?: MotionManagerOptions): ExpressionManager<Expression, ExpressionSpec>
Type Parameters
- Expression = any
- ExpressionSpec = any
Parameters
- settings: ModelSettings
- Optional options: MotionManagerOptions
Returns ExpressionManager<Expression, ExpressionSpec>
Overrides EventEmitter<keyof ExpressionManagerEvents>.constructor
- Defined in src/cubism-common/ExpressionManager.ts:56

Properties

currentExpression

currentExpression: Expression

Current Expression. This will not be overwritten by defaultExpression.

defaultExpression

defaultExpression: Expression

An empty Expression to reset all the expression parameters.

`Readonly` `Abstract` definitions

definitions: ExpressionSpec[]

Expression definitions copied from ModelSettings.

destroyed

destroyed: boolean = false

Flags the instance has been destroyed.

expressions

expressions: (undefined | null | Expression)[] = []

The Expressions. The structure is the same as definitions, initially there's only an empty array, which means all expressions will be undefined. When an Expression has been loaded, it'll fill the place in which it should be; when it fails to load, the place will be filled with null.

reserveExpressionIndex

reserveExpressionIndex: number = -1

The pending Expression.

`Readonly` settings

settings: ModelSettings

The ModelSettings reference.

tag

tag: string

Tag for logging.

`Static` prefixed

prefixed: string | boolean

Methods

`Protected` `Abstract` _setExpression

_setExpression(motion: Expression): number
Applies the Expression to the model.
Parameters
- motion: Expression
Returns number
- Defined in src/cubism-common/ExpressionManager.ts:238

addListener

addListener(event: keyof ExpressionManagerEvents<any>, fn: ListenerFn, context?: any): ExpressionManager<Expression, ExpressionSpec>
Parameters
- event: keyof ExpressionManagerEvents<any>
- fn: ListenerFn
- Optional context: any
Returns ExpressionManager<Expression, ExpressionSpec>
Inherited from EventEmitter.addListener
- Defined in node_modules/eventemitter3/index.d.ts:33

`Abstract` createExpression

createExpression(data: object, definition: undefined | ExpressionSpec): Expression
Creates an Expression from the data.

Returns
The created Expression.
Parameters
- data: object
  
  Content of the expression file.
- definition: undefined | ExpressionSpec
  
  The expression definition. Can be undefined in order to create defaultExpression.
Returns Expression
- Defined in src/cubism-common/ExpressionManager.ts:233

destroy

destroy(): void
Destroys the instance.

Emits
destroy

Returns void
- Defined in src/cubism-common/ExpressionManager.ts:201

emit

emit(event: keyof ExpressionManagerEvents<any>, ...args: any[]): boolean
Calls each of the listeners registered for a given event.
Parameters
- event: keyof ExpressionManagerEvents<any>
- Rest ...args: any[]
Returns boolean
Inherited from EventEmitter.emit
- Defined in node_modules/eventemitter3/index.d.ts:27

eventNames

eventNames(): (keyof ExpressionManagerEvents<any>)[]
Return an array listing the events for which the emitter has registered listeners.

Returns (keyof ExpressionManagerEvents<any>)[]
Inherited from EventEmitter.eventNames
- Defined in node_modules/eventemitter3/index.d.ts:12

`Abstract` getExpressionFile

getExpressionFile(definition: ExpressionSpec): string
Retrieves the expression's file path by its definition.

Returns
The file path extracted from given definition. Not resolved.
Parameters
- definition: ExpressionSpec
Returns string
- Defined in src/cubism-common/ExpressionManager.ts:225

`Abstract` getExpressionIndex

getExpressionIndex(name: string): number
Retrieves the expression's index by its name.

Returns
The index. -1 if not found.
Parameters
- name: string
Returns number
- Defined in src/cubism-common/ExpressionManager.ts:219

`Protected` init

init(): void
Should be called in the constructor of derived class.

Returns void
- Defined in src/cubism-common/ExpressionManager.ts:65

`Abstract` isFinished

isFinished(): boolean
Checks if the expression playback has finished.

Returns boolean
- Defined in src/cubism-common/ExpressionManager.ts:213

listenerCount

listenerCount(event: keyof ExpressionManagerEvents<any>): number
Return the number of listeners listening to a given event.
Parameters
- event: keyof ExpressionManagerEvents<any>
Returns number
Inherited from EventEmitter.listenerCount
- Defined in node_modules/eventemitter3/index.d.ts:22

listeners

listeners(event: keyof ExpressionManagerEvents<any>): ListenerFn[]
Return the listeners registered for a given event.
Parameters
- event: keyof ExpressionManagerEvents<any>
Returns ListenerFn[]
Inherited from EventEmitter.listeners
- Defined in node_modules/eventemitter3/index.d.ts:17

`Protected` loadExpression

loadExpression(index: number): Promise<undefined | Expression>
Loads an Expression. Errors in this method will not be thrown, but be emitted with an "expressionLoadError" event.

Returns
Promise that resolves with the Expression, or with undefined if it can't be loaded.

Emits
expressionLoaded

Emits
expressionLoadError
Parameters
- index: number
  
  Index of the expression in definitions.
Returns Promise<undefined | Expression>
- Defined in src/cubism-common/ExpressionManager.ts:80

off

off(event: keyof ExpressionManagerEvents<any>, fn?: ListenerFn, context?: any, once?: boolean): ExpressionManager<Expression, ExpressionSpec>
Parameters
- event: keyof ExpressionManagerEvents<any>
- Optional fn: ListenerFn
- Optional context: any
- Optional once: boolean
Returns ExpressionManager<Expression, ExpressionSpec>
Inherited from EventEmitter.off
- Defined in node_modules/eventemitter3/index.d.ts:44

on

on(event: keyof ExpressionManagerEvents<any>, fn: ListenerFn, context?: any): ExpressionManager<Expression, ExpressionSpec>
Add a listener for a given event.
Parameters
- event: keyof ExpressionManagerEvents<any>
- fn: ListenerFn
- Optional context: any
Returns ExpressionManager<Expression, ExpressionSpec>
Inherited from EventEmitter.on
- Defined in node_modules/eventemitter3/index.d.ts:32

once

once(event: keyof ExpressionManagerEvents<any>, fn: ListenerFn, context?: any): ExpressionManager<Expression, ExpressionSpec>
Add a one-time listener for a given event.
Parameters
- event: keyof ExpressionManagerEvents<any>
- fn: ListenerFn
- Optional context: any
Returns ExpressionManager<Expression, ExpressionSpec>
Inherited from EventEmitter.once
- Defined in node_modules/eventemitter3/index.d.ts:38

removeAllListeners

removeAllListeners(event?: keyof ExpressionManagerEvents<any>): ExpressionManager<Expression, ExpressionSpec>
Remove all listeners, or those of the specified event.
Parameters
- Optional event: keyof ExpressionManagerEvents<any>
Returns ExpressionManager<Expression, ExpressionSpec>
Inherited from EventEmitter.removeAllListeners
- Defined in node_modules/eventemitter3/index.d.ts:49

removeListener

removeListener(event: keyof ExpressionManagerEvents<any>, fn?: ListenerFn, context?: any, once?: boolean): ExpressionManager<Expression, ExpressionSpec>
Remove the listeners of a given event.
Parameters
- event: keyof ExpressionManagerEvents<any>
- Optional fn: ListenerFn
- Optional context: any
- Optional once: boolean
Returns ExpressionManager<Expression, ExpressionSpec>
Inherited from EventEmitter.removeListener
- Defined in node_modules/eventemitter3/index.d.ts:43

resetExpression

resetExpression(): void
Resets model's expression using defaultExpression.

Returns void
- Defined in src/cubism-common/ExpressionManager.ts:141

restoreExpression

restoreExpression(): void
Restores model's expression to currentExpression.

Returns void
- Defined in src/cubism-common/ExpressionManager.ts:148

setExpression

setExpression(index: string | number): Promise<boolean>
Sets an Expression.

Returns
Promise that resolves with true if succeeded, with false otherwise.
Parameters
- index: string | number
  
  Either the index, or the name of the expression.
Returns Promise<boolean>
- Defined in src/cubism-common/ExpressionManager.ts:157

setRandomExpression

setRandomExpression(): Promise<boolean>
Sets a random Expression that differs from current one.

Returns
Promise that resolves with true if succeeded, with false otherwise.

Returns Promise<boolean>
- Defined in src/cubism-common/ExpressionManager.ts:114

`Protected` `Abstract` stopAllExpressions

stopAllExpressions(): void
Cancels expression playback.

Returns void
- Defined in src/cubism-common/ExpressionManager.ts:243

update

update(model: object, now: number): boolean
Updates parameters of the core model.

Returns
True if the parameters are actually updated.
Parameters
- model: object
- now: number
Returns boolean
- Defined in src/cubism-common/ExpressionManager.ts:189

`Protected` `Abstract` updateParameters

updateParameters(model: object, now: number): boolean
Updates parameters of the core model.

Returns
True if the parameters are actually updated.
Parameters
- model: object
- now: number
Returns boolean
- Defined in src/cubism-common/ExpressionManager.ts:249

Class ExpressionManager<Expression, ExpressionSpec>Abstract

Emits

Type Parameters

Expression = any

ExpressionSpec = any

Hierarchy

Index

Constructors

Properties

Methods

Constructors

Protected constructor

Type Parameters

Expression = any

ExpressionSpec = any

Parameters

settings: ModelSettings

Optional options: MotionManagerOptions

Returns ExpressionManager<Expression, ExpressionSpec>

Properties

currentExpression

defaultExpression

Readonly Abstract definitions

destroyed

expressions

reserveExpressionIndex

Readonly settings

tag

Static prefixed

Methods

Protected Abstract _setExpression

Parameters

motion: Expression

Returns number

addListener

Parameters

event: keyof ExpressionManagerEvents<any>

fn: ListenerFn

Optional context: any

Returns ExpressionManager<Expression, ExpressionSpec>

Abstract createExpression

Returns

Parameters

data: object

definition: undefined | ExpressionSpec

Returns Expression

destroy

Emits

Returns void

emit

Parameters

event: keyof ExpressionManagerEvents<any>

Rest ...args: any[]

Returns boolean

eventNames

Returns (keyof ExpressionManagerEvents<any>)[]

Abstract getExpressionFile

Returns

Parameters

definition: ExpressionSpec

Returns string

Abstract getExpressionIndex

Returns

Parameters

name: string

Returns number

Protected init

Returns void

Abstract isFinished

Returns boolean

listenerCount

Parameters

event: keyof ExpressionManagerEvents<any>

Returns number

listeners

Parameters

event: keyof ExpressionManagerEvents<any>

Returns ListenerFn[]

Protected loadExpression

Returns

Class ExpressionManager<Expression, ExpressionSpec>`Abstract`

`Protected` constructor

`Optional` options: MotionManagerOptions

`Readonly` `Abstract` definitions

`Readonly` settings

`Static` prefixed

`Protected` `Abstract` _setExpression

`Optional` context: any

`Abstract` createExpression

`Rest` ...args: any[]

`Abstract` getExpressionFile

`Abstract` getExpressionIndex

`Protected` init

`Abstract` isFinished

`Protected` loadExpression

`Optional` fn: ListenerFn

`Optional` context: any

`Optional` once: boolean

`Optional` context: any

`Optional` context: any

`Optional` event: keyof ExpressionManagerEvents<any>

`Optional` fn: ListenerFn

`Optional` context: any

`Optional` once: boolean

`Protected` `Abstract` stopAllExpressions

`Protected` `Abstract` updateParameters