API / Surface

Class: Surface

Defined in: armature/Surface.ts:33

Internal

Extends

• Bone

Constructors

Constructor

new Surface(): Surface;

Returns

Surface

Inherited from

Bone.constructor

Properties

_alpha

_alpha: number;

Defined in: armature/TransformObject.ts:78

Internal

Inherited from

Bone._alpha

---

_armature

_armature: Armature;

Defined in: armature/TransformObject.ts:86

Internal

Inherited from

Bone._armature

---

_bone

_bone: Bone;

Defined in: armature/Surface.ts:55

---

_boneData

_boneData: BoneData;

Defined in: armature/Bone.ts:79

Internal

Inherited from

Bone._boneData

---

_cachedFrameIndices

_cachedFrameIndices: number[];

Defined in: armature/Bone.ts:87

Internal

Inherited from

Bone._cachedFrameIndices

---

_childrenTransformDirty

_childrenTransformDirty: boolean;

Defined in: armature/Bone.ts:68

Internal

Inherited from

Bone._childrenTransformDirty

---

_deformVertices

readonly _deformVertices: number[] = [];

Defined in: armature/Surface.ts:45

---

_globalAlpha

_globalAlpha: number;

Defined in: armature/TransformObject.ts:82

Internal

Inherited from

Bone._globalAlpha

---

_hasConstraint

_hasConstraint: boolean;

Defined in: armature/Bone.ts:73

Internal

Inherited from

Bone._hasConstraint

---

_transformDirty

_transformDirty: boolean;

Defined in: armature/Bone.ts:64

Internal

Inherited from

Bone._transformDirty

---

_vertices

readonly _vertices: number[] = [];

Defined in: armature/Surface.ts:44

---

animationPose

readonly animationPose: Transform;

Defined in: armature/Bone.ts:60

Internal

Inherited from

Bone.animationPose

---

global

readonly global: Transform;

Defined in: armature/TransformObject.ts:56

A transform relative to the armature coordinate system.

Inherited from

Bone.global

---

globalTransformMatrix

readonly globalTransformMatrix: Matrix;

Defined in: armature/TransformObject.ts:47

A matrix relative to the armature coordinate system.

Inherited from

Bone.globalTransformMatrix

---

hashCode

readonly hashCode: number;

Defined in: core/BaseObject.ts:156

A unique identification number assigned to the object.

Inherited from

Bone.hashCode

---

offset

readonly offset: Transform;

Defined in: armature/TransformObject.ts:65

The offset transform relative to the armature or the parent bone coordinate system.

Inherited from

Bone.offset

---

offsetMode

offsetMode: OffsetMode;

Defined in: armature/Bone.ts:56

The offset mode.

Inherited from

Bone.offsetMode

Accessors

armature

Get Signature

get armature(): Armature;

Defined in: armature/TransformObject.ts:129

The armature to which it belongs.

Returns

Armature

Inherited from

Bone.armature

---

boneData

Get Signature

get boneData(): BoneData;

Defined in: armature/Bone.ts:499

The bone data.

Returns

BoneData

Inherited from

Bone.boneData

---

name

Get Signature

get name(): string;

Defined in: armature/Bone.ts:534

The bone name.

Returns

string

Inherited from

Bone.name

---

parent

Get Signature

get parent(): Bone;

Defined in: armature/Bone.ts:544

The parent bone to which it belongs.

Returns

Bone

Inherited from

Bone.parent

---

visible

Get Signature

get visible(): boolean;

Defined in: armature/Bone.ts:511

The visible of all slots in the bone.

Default

true

Returns

boolean

Set Signature

set visible(value: boolean): void;

Defined in: armature/Bone.ts:514

Parameters

Parameter	Type
value	boolean

Returns

void

Inherited from

Bone.visible

Methods

_getGlobalTransformMatrix()

_getGlobalTransformMatrix(x: number, y: number): Matrix;

Defined in: armature/Surface.ts:171

Parameters

Parameter	Type
x	number
y	number

Returns

Matrix

---

_updateAlpha()

_updateAlpha(): void;

Defined in: armature/Bone.ts:331

Internal

Returns

void

Inherited from

Bone._updateAlpha

---

contains()

contains(value: Bone): boolean;

Defined in: armature/Bone.ts:480

Check whether the bone contains a specific bone.

Parameters

Parameter	Type
value	Bone

Returns

boolean

Inherited from

Bone.contains

---

invalidUpdate()

invalidUpdate(): void;

Defined in: armature/Bone.ts:469

Forces the bone to update the transform in the next frame. When the bone is not animated or its animation state is finished, the bone will not continue to update, and when the skeleton must be updated for some reason, the method needs to be called explicitly.

Returns

void

Example

    let bone = armature.getBone("arm");
    bone.offset.scaleX = 2.0;
    bone.invalidUpdate();

Inherited from

Bone.invalidUpdate

---

returnToPool()

returnToPool(): void;

Defined in: core/BaseObject.ts:167

Clear the object and return it back to object pool。

Returns

void

Inherited from

Bone.returnToPool

---

update()

update(cacheFrameIndex: number): void;

Defined in: armature/Surface.ts:487

Internal

Parameters

Parameter	Type
cacheFrameIndex	number

Returns

void

Overrides

Bone.update

---

updateByConstraint()

updateByConstraint(): void;

Defined in: armature/Bone.ts:442

Internal

Returns

void

Inherited from

Bone.updateByConstraint

---

updateGlobalTransform()

updateGlobalTransform(): void;

Defined in: armature/TransformObject.ts:116

For performance considerations, rotation or scale in the #global attribute of the bone or slot is not always properly accessible, some engines do not rely on these attributes to update rendering, such as Egret. The use of this method ensures that the access to the #global property is correctly rotation or scale.

Returns

void

Example

    bone.updateGlobalTransform();
    let rotation = bone.global.rotation;

Inherited from

Bone.updateGlobalTransform

---

borrowObject()

static borrowObject<T>(objectConstructor: () => T): T;

Defined in: core/BaseObject.ts:136

Get an instance of the specify class from object pool.

Type Parameters

Type Parameter
T extends BaseObject

Parameters

Parameter	Type	Description
objectConstructor	() => T	The specify class.

Returns

T

Inherited from

Bone.borrowObject

---

clearPool()

static clearPool(objectConstructor: typeof BaseObject): void;

Defined in: core/BaseObject.ts:111

Clear the cached instances of a specify object pool.

Parameters

Parameter	Type	Default value	Description
objectConstructor	typeof BaseObject	null	Specify class. (Clear all cached instances if not set)

Returns

void

Inherited from

Bone.clearPool

---

setMaxCount()

static setMaxCount(objectConstructor: typeof BaseObject, maxCount: number): void;

Defined in: core/BaseObject.ts:72

Set the maximum cache count of the specify object pool.

Parameters

Parameter	Type	Description
objectConstructor	typeof BaseObject	The specify class. (Set all object pools max cache count if not set)
maxCount	number	Max count.

Returns

void

Inherited from

Bone.setMaxCount

---

toString()

static toString(): string;

Defined in: armature/Surface.ts:34

Returns

string

Overrides

Bone.toString