@safe-engine/cocos 2.2.7 → 2.3.4

package/dist/dragonbones/db-cocos/CocosArmatureDisplay.js

@@ -0,0 +1,240 @@
+/**
+ * The MIT License (MIT)
+ *
+ * Copyright (c) 2012-2018 DragonBones team and other contributors
+ *
+ * Permission is hereby granted, free of charge, to any person obtaining a copy of
+ * this software and associated documentation files (the "Software"), to deal in
+ * the Software without restriction, including without limitation the rights to
+ * use, copy, modify, merge, publish, distribute, sublicense, and/or sell copies of
+ * the Software, and to permit persons to whom the Software is furnished to do so,
+ * subject to the following conditions:
+ *
+ * The above copyright notice and this permission notice shall be included in all
+ * copies or substantial portions of the Software.
+ *
+ * THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+ * IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY, FITNESS
+ * FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE AUTHORS OR
+ * COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER LIABILITY, WHETHER
+ * IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM, OUT OF OR IN
+ * CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE SOFTWARE.
+ */
+import { BoundingBoxType, DragonBones, } from '@cocos/dragonbones-js';
+export class CocosArmatureDisplay extends cc.Sprite {
+    /**
+     * @private
+     */
+    debugDraw = false;
+    _debugDraw = false;
+    // private _disposeProxy: boolean = false;
+    _armature = null;
+    _debugDrawer = null;
+    // eventDispatcher: cc.EventManager = null as any;
+    listenerCount = {};
+    events = {};
+    constructor() {
+        // 1. super init first
+        super();
+        super.ctor(); // always call this for compatibility with cocos2dx JS Javascript class system
+        // this.eventDispatcher = cc.eventManager;
+    }
+    hasEvent(type) {
+        return this.hasDBEventListener(type);
+    }
+    addEvent(type, listener, thisObject) {
+        // console.log('addEvent', type, listener, thisObject);
+        this.addDBEventListener(type, listener, thisObject);
+    }
+    removeEvent(type, listener, thisObject) {
+        this.removeDBEventListener(type, listener, thisObject);
+    }
+    /**
+     * @inheritDoc
+     */
+    dbInit(armature) {
+        this._armature = armature;
+    }
+    /**
+     * @inheritDoc
+     */
+    dbClear() {
+        if (this._debugDrawer !== null) {
+            this._debugDrawer.removeFromParent();
+        }
+        this._armature = null;
+        this._debugDrawer = null;
+        super.removeFromParent();
+    }
+    /**
+     * @inheritDoc
+     */
+    dbUpdate() {
+        const drawed = DragonBones.debugDraw || this.debugDraw;
+        if (drawed || this._debugDraw) {
+            this._debugDraw = drawed;
+            if (this._debugDraw) {
+                if (this._debugDrawer === null) {
+                    this._debugDrawer = new cc.Sprite();
+                    const boneDrawer = new cc.DrawNode();
+                    this._debugDrawer.addChild(boneDrawer);
+                }
+                this.addChild(this._debugDrawer);
+                const boneDrawer = this._debugDrawer.children[0];
+                boneDrawer.clear();
+                const bones = this._armature.getBones();
+                for (let i = 0, l = bones.length; i < l; ++i) {
+                    const bone = bones[i];
+                    const boneLength = bone.boneData.length;
+                    const startX = bone.globalTransformMatrix.tx;
+                    const startY = bone.globalTransformMatrix.ty;
+                    const endX = startX + bone.globalTransformMatrix.a * boneLength;
+                    const endY = startY + bone.globalTransformMatrix.b * boneLength;
+                    boneDrawer.setLineWidth(2.0);
+                    boneDrawer.setColor(cc.color('0x00FFFF'));
+                    boneDrawer.drawSegment(cc.p(startX, startY), cc.p(endX, endY));
+                    // boneDrawer.lineStyle(0.0, 0, 0.0);
+                    // boneDrawer.beginFill(0x00FFFF, 0.7);
+                    boneDrawer.drawCircle(cc.p(startX, startY), 3.0, Math.PI * 2, 64);
+                    // boneDrawer.endFill();
+                }
+                const slots = this._armature.getSlots();
+                for (let i = 0, l = slots.length; i < l; ++i) {
+                    const slot = slots[i];
+                    const boundingBoxData = slot.boundingBoxData;
+                    if (boundingBoxData) {
+                        let child = this._debugDrawer.getChildByName(slot.name);
+                        if (!child) {
+                            child = new cc.DrawNode();
+                            child.setName(slot.name);
+                            this._debugDrawer.addChild(child);
+                        }
+                        child.clear();
+                        child.setLineWidth(2.0);
+                        child.setColor(cc.color('0xFF00FF'));
+                        child.setOpacity(0.7);
+                        // child.lineStyle(2.0, 0xff00ff, 0.7);
+                        switch (boundingBoxData.type) {
+                            case BoundingBoxType.Rectangle:
+                                child.drawRect(cc.p(-boundingBoxData.width * 0.5, -boundingBoxData.height * 0.5), cc.p(boundingBoxData.width * 0.5, boundingBoxData.height * 0.5));
+                                break;
+                            case BoundingBoxType.Ellipse:
+                                child.drawCircle(cc.p(0.0, 0.0), boundingBoxData.width * 0.5, 0, 64);
+                                //   -boundingBoxData.width * 0.5,
+                                //   -boundingBoxData.height * 0.5,
+                                //   boundingBoxData.width,
+                                //   boundingBoxData.height
+                                // );
+                                break;
+                            case BoundingBoxType.Polygon: {
+                                const { vertices } = boundingBoxData;
+                                const points = [];
+                                for (let i = 0, l = vertices.length; i < l; i += 2) {
+                                    const x = vertices[i];
+                                    const y = vertices[i + 1];
+                                    // if (i === 0) {
+                                    //   child.moveTo(x, y);
+                                    // } else {
+                                    //   child.lineTo(x, y);
+                                    // }
+                                    // child.drawSegment(cc.p(x, y), cc.p(vertices[i + 2], vertices[i + 3]));
+                                    points.push(cc.p(x, y));
+                                }
+                                // child.lineTo(vertices[0], vertices[1]);
+                                child.drawPoly(points);
+                                break;
+                            }
+                            default:
+                                break;
+                        }
+                        // child.endFill();
+                        slot.updateTransformAndMatrix();
+                        slot.updateGlobalTransform();
+                        const transform = slot.global;
+                        child.setTransform(transform.x, transform.y, transform.scaleX, transform.scaleY, transform.rotation, transform.skew, 0.0, slot._pivotX, slot._pivotY);
+                    }
+                    else {
+                        const child = this._debugDrawer.getChildByName(slot.name);
+                        if (child) {
+                            this._debugDrawer.removeChild(child);
+                        }
+                    }
+                }
+            }
+            else if (this._debugDrawer !== null && this._debugDrawer.parent === this) {
+                this.removeChild(this._debugDrawer);
+            }
+        }
+    }
+    /**
+     * @inheritDoc
+     */
+    dispose(disposeProxy = true) {
+        // disposeProxy;
+        if (this._armature !== null) {
+            this._armature.dispose();
+            this._armature = null;
+        }
+    }
+    /**
+     * @inheritDoc
+     */
+    destroy() {
+        this.dispose();
+    }
+    /**
+     * @private
+     */
+    dispatchDBEvent(type, eventObject) {
+        // console.log('dispatchDBEvent', type, eventObject);
+        // this.eventDispatcher.dispatchCustomEvent(type, eventObject);
+        if (this.events[type]) {
+            const ev = new cc.EventCustom(type);
+            ev.setUserData(eventObject);
+            this.events[type].forEach((fc) => fc(ev));
+        }
+    }
+    /**
+     * @inheritDoc
+     */
+    hasDBEventListener(type) {
+        // console.log('hasDBEventListener', type);
+        return (this.listenerCount[type] || 0) > 0;
+        // return this.eventDispatcher.isEnabled();
+    }
+    /**
+     * @inheritDoc
+     */
+    addDBEventListener(type, listener, target) {
+        // console.log('addDBEventListener', type);
+        this.listenerCount[type] = (this.listenerCount[type] || 0) + 1;
+        // this.eventDispatcher.addCustomListener(type, listener.bind(target));
+        const bound = target ? listener.bind(target) : listener;
+        if (this.events[type]) {
+            this.events[type].push(bound);
+        }
+        else {
+            this.events[type] = [bound];
+        }
+    }
+    /**
+     * @inheritDoc
+     */
+    removeDBEventListener(type, listener, target) {
+        this.listenerCount[type] = (this.listenerCount[type] || 0) - 1;
+        // this.eventDispatcher.removeCustomListeners(type);
+        this.events[type] = undefined;
+    }
+    /**
+     * @inheritDoc
+     */
+    get armature() {
+        return this._armature;
+    }
+    /**
+     * @inheritDoc
+     */
+    get animation() {
+        return this._armature.animation;
+    }
+}

package/dist/dragonbones/db-cocos/CocosFactory.d.ts

@@ -0,0 +1,128 @@
+/**
+ * The MIT License (MIT)
+ *
+ * Copyright (c) 2012-2018 DragonBones team and other contributors
+ *
+ * Permission is hereby granted, free of charge, to any person obtaining a copy of
+ * this software and associated documentation files (the "Software"), to deal in
+ * the Software without restriction, including without limitation the rights to
+ * use, copy, modify, merge, publish, distribute, sublicense, and/or sell copies of
+ * the Software, and to permit persons to whom the Software is furnished to do so,
+ * subject to the following conditions:
+ *
+ * The above copyright notice and this permission notice shall be included in all
+ * copies or substantial portions of the Software.
+ *
+ * THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+ * IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY, FITNESS
+ * FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE AUTHORS OR
+ * COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER LIABILITY, WHETHER
+ * IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM, OUT OF OR IN
+ * CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE SOFTWARE.
+ */
+import { Armature, BaseFactory, BuildArmaturePackage, DataParser, DisplayData, Slot, SlotData } from '@cocos/dragonbones-js';
+import { CocosArmatureDisplay } from './CocosArmatureDisplay';
+import { CocosTextureAtlasData } from './CocosTextureAtlasData';
+/**
+ * - The PixiJS factory.
+ * @version DragonBones 3.0
+ * @language en_US
+ */
+/**
+ * - PixiJS 工厂。
+ * @version DragonBones 3.0
+ * @language zh_CN
+ */
+export declare class CocosFactory extends BaseFactory {
+    private static _dragonBonesInstance;
+    private static _factory;
+    private static _clockHandler;
+    static advanceTime(passedTime: number): void;
+    static useSharedTicker: boolean;
+    /**
+     * - A global factory instance that can be used directly.
+     * @version DragonBones 4.7
+     * @language en_US
+     */
+    /**
+     * - 一个可以直接使用的全局工厂实例。
+     * @version DragonBones 4.7
+     * @language zh_CN
+     */
+    static get factory(): CocosFactory;
+    /**
+     * - 一个获取全局工厂实例(单例)的方法, 和get factory相比, 优点是可以传参数。
+     * @version DragonBones 4.7
+     * @language zh_CN
+     */
+    static newInstance(): CocosFactory;
+    /**
+     * @inheritDoc
+     */
+    constructor(dataParser?: DataParser | null);
+    protected _buildTextureAtlasData(textureAtlasData: CocosTextureAtlasData | null, textureAtlas: cc.Texture2D | null): CocosTextureAtlasData;
+    protected _buildArmature(dataPackage: BuildArmaturePackage): Armature;
+    protected _buildSlot(_dataPackage: BuildArmaturePackage, slotData: SlotData, armature: DisplayData[]): Slot;
+    /**
+     * - Create a armature from cached DragonBonesData instances and TextureAtlasData instances, then use the {@link #clock} to update it.
+     * The difference is that the armature created by {@link #buildArmature} is not WorldClock instance update.
+     * @param armatureName - The armature data name.
+     * @param dragonBonesName - The cached name of the DragonBonesData instance. (If not set, all DragonBonesData instances are retrieved, and when multiple DragonBonesData instances contain a the same name armature data, it may not be possible to accurately create a specific armature)
+     * @param skinName - The skin name, you can set a different ArmatureData name to share it's skin data. (If not set, use the default skin data)
+     * @returns The armature display container.
+     * @see dragonBones.IArmatureProxy
+     * @see dragonBones.BaseFactory#buildArmature
+     * @version DragonBones 4.5
+     * @example
+     * <pre>
+     *     let armatureDisplay = factory.buildArmatureDisplay("armatureName", "dragonBonesName");
+     * </pre>
+     * @language en_US
+     */
+    /**
+     * - 通过缓存的 DragonBonesData 实例和 TextureAtlasData 实例创建一个骨架，并用 {@link #clock} 更新该骨架。
+     * 区别在于由 {@link #buildArmature} 创建的骨架没有 WorldClock 实例驱动。
+     * @param armatureName - 骨架数据名称。
+     * @param dragonBonesName - DragonBonesData 实例的缓存名称。 （如果未设置，将检索所有的 DragonBonesData 实例，当多个 DragonBonesData 实例中包含同名的骨架数据时，可能无法准确的创建出特定的骨架）
+     * @param skinName - 皮肤名称，可以设置一个其他骨架数据名称来共享其皮肤数据。 （如果未设置，则使用默认的皮肤数据）
+     * @returns 骨架的显示容器。
+     * @see dragonBones.IArmatureProxy
+     * @see dragonBones.BaseFactory#buildArmature
+     * @version DragonBones 4.5
+     * @example
+     * <pre>
+     *     let armatureDisplay = factory.buildArmatureDisplay("armatureName", "dragonBonesName");
+     * </pre>
+     * @language zh_CN
+     */
+    buildArmatureDisplay(armatureName: string, dragonBonesName?: string, skinName?: string, textureAtlasName?: string): CocosArmatureDisplay | null;
+    /**
+     * - Create the display object with the specified texture.
+     * @param textureName - The texture data name.
+     * @param textureAtlasName - The texture atlas data name (Of not set, all texture atlas data will be searched)
+     * @version DragonBones 3.0
+     * @language en_US
+     */
+    /**
+     * - 创建带有指定贴图的显示对象。
+     * @param textureName - 贴图数据名称。
+     * @param textureAtlasName - 贴图集数据名称。 （如果未设置，将检索所有的贴图集数据）
+     * @version DragonBones 3.0
+     * @language zh_CN
+     */
+    getTextureDisplay(textureName: string, textureAtlasName?: string | null): cc.Sprite | null;
+    /**
+     * - A global sound event manager.
+     * Sound events can be listened to uniformly from the manager.
+     * @version DragonBones 4.5
+     * @language en_US
+     */
+    /**
+     * - 全局声音事件管理器。
+     * 声音事件可以从该管理器统一侦听。
+     * @version DragonBones 4.5
+     * @language zh_CN
+     */
+    get soundEventManager(): CocosArmatureDisplay;
+}
+//# sourceMappingURL=CocosFactory.d.ts.map

package/dist/dragonbones/db-cocos/CocosFactory.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"CocosFactory.d.ts","sourceRoot":"","sources":["../../../src/dragonbones/db-cocos/CocosFactory.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;GAqBG;AAEH,OAAO,EACL,QAAQ,EACR,WAAW,EAEX,oBAAoB,EACpB,UAAU,EACV,WAAW,EAEX,IAAI,EACJ,QAAQ,EACT,MAAM,uBAAuB,CAAA;AAE9B,OAAO,EAAE,oBAAoB,EAAE,MAAM,wBAAwB,CAAA;AAE7D,OAAO,EAAE,qBAAqB,EAAoB,MAAM,yBAAyB,CAAA;AAEjF;;;;GAIG;AACH;;;;GAIG;AACH,qBAAa,YAAa,SAAQ,WAAW;IAC3C,OAAO,CAAC,MAAM,CAAC,oBAAoB,CAA2B;IAC9D,OAAO,CAAC,MAAM,CAAC,QAAQ,CAA4B;IACnD,OAAO,CAAC,MAAM,CAAC,aAAa;WAOd,WAAW,CAAC,UAAU,EAAE,MAAM,GAAG,IAAI;IAOnD,OAAc,eAAe,UAAO;IAEpC;;;;OAIG;IACH;;;;OAIG;IACH,WAAkB,OAAO,IAAI,YAAY,CAMxC;IAED;;;;OAIG;WACW,WAAW,IAAI,YAAY;IAOzC;;OAEG;gBACgB,UAAU,GAAE,UAAU,GAAG,IAAW;IAWvD,SAAS,CAAC,sBAAsB,CAC9B,gBAAgB,EAAE,qBAAqB,GAAG,IAAI,EAC9C,YAAY,EAAE,EAAE,CAAC,SAAS,GAAG,IAAI,GAChC,qBAAqB;IAaxB,SAAS,CAAC,cAAc,CAAC,WAAW,EAAE,oBAAoB,GAAG,QAAQ;IASrE,SAAS,CAAC,UAAU,CAAC,YAAY,EAAE,oBAAoB,EAAE,QAAQ,EAAE,QAAQ,EAAE,QAAQ,EAAE,WAAW,EAAE,GAAG,IAAI;IAM3G;;;;;;;;;;;;;;;OAeG;IACH;;;;;;;;;;;;;;;OAeG;IACI,oBAAoB,CACzB,YAAY,EAAE,MAAM,EACpB,eAAe,SAAK,EACpB,QAAQ,SAAK,EACb,gBAAgB,SAAK,GACpB,oBAAoB,GAAG,IAAI;IAU9B;;;;;;OAMG;IACH;;;;;;OAMG;IACI,iBAAiB,CAAC,WAAW,EAAE,MAAM,EAAE,gBAAgB,GAAE,MAAM,GAAG,IAAW,GAAG,EAAE,CAAC,MAAM,GAAG,IAAI;IAQvG;;;;;OAKG;IACH;;;;;OAKG;IACH,IAAW,iBAAiB,IAAI,oBAAoB,CAEnD;CACF"}

package/dist/dragonbones/db-cocos/CocosFactory.js

@@ -0,0 +1,190 @@
+/**
+ * The MIT License (MIT)
+ *
+ * Copyright (c) 2012-2018 DragonBones team and other contributors
+ *
+ * Permission is hereby granted, free of charge, to any person obtaining a copy of
+ * this software and associated documentation files (the "Software"), to deal in
+ * the Software without restriction, including without limitation the rights to
+ * use, copy, modify, merge, publish, distribute, sublicense, and/or sell copies of
+ * the Software, and to permit persons to whom the Software is furnished to do so,
+ * subject to the following conditions:
+ *
+ * The above copyright notice and this permission notice shall be included in all
+ * copies or substantial portions of the Software.
+ *
+ * THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+ * IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY, FITNESS
+ * FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE AUTHORS OR
+ * COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER LIABILITY, WHETHER
+ * IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM, OUT OF OR IN
+ * CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE SOFTWARE.
+ */
+import { Armature, BaseFactory, BaseObject, DragonBones, } from '@cocos/dragonbones-js';
+import { CocosArmatureDisplay } from './CocosArmatureDisplay';
+import { CocosSlot } from './CocosSlot';
+import { CocosTextureAtlasData } from './CocosTextureAtlasData';
+/**
+ * - The PixiJS factory.
+ * @version DragonBones 3.0
+ * @language en_US
+ */
+/**
+ * - PixiJS 工厂。
+ * @version DragonBones 3.0
+ * @language zh_CN
+ */
+export class CocosFactory extends BaseFactory {
+    static _dragonBonesInstance = null;
+    static _factory = null;
+    static _clockHandler(passedTime) {
+        this._dragonBonesInstance.advanceTime(passedTime);
+    }
+    /*
+     * `passedTime` is elapsed time, specified in seconds.
+     */
+    static advanceTime(passedTime) {
+        this._dragonBonesInstance.advanceTime(passedTime);
+    }
+    /*
+     * whether use `PIXI.Ticker.shared`
+     */
+    static useSharedTicker = true;
+    /**
+     * - A global factory instance that can be used directly.
+     * @version DragonBones 4.7
+     * @language en_US
+     */
+    /**
+     * - 一个可以直接使用的全局工厂实例。
+     * @version DragonBones 4.7
+     * @language zh_CN
+     */
+    static get factory() {
+        if (CocosFactory._factory === null) {
+            CocosFactory._factory = new CocosFactory(null);
+        }
+        return CocosFactory._factory;
+    }
+    /**
+     * - 一个获取全局工厂实例(单例)的方法, 和get factory相比, 优点是可以传参数。
+     * @version DragonBones 4.7
+     * @language zh_CN
+     */
+    static newInstance() {
+        if (CocosFactory._factory === null) {
+            CocosFactory._factory = new CocosFactory(null);
+        }
+        return CocosFactory._factory;
+    }
+    /**
+     * @inheritDoc
+     */
+    constructor(dataParser = null) {
+        super(dataParser);
+        if (CocosFactory._dragonBonesInstance === null) {
+            const eventManager = new CocosArmatureDisplay();
+            CocosFactory._dragonBonesInstance = new DragonBones(eventManager);
+        }
+        this._dragonBones = CocosFactory._dragonBonesInstance;
+    }
+    _buildTextureAtlasData(textureAtlasData, textureAtlas) {
+        if (textureAtlasData) {
+            // console.log(textureAtlasData, 'textureAtlasData', textureAtlas)
+            const scale = cc.director.getContentScaleFactor();
+            textureAtlasData.scale = scale;
+            textureAtlasData.renderTexture = textureAtlas;
+        }
+        else {
+            textureAtlasData = BaseObject.borrowObject(CocosTextureAtlasData);
+        }
+        return textureAtlasData;
+    }
+    _buildArmature(dataPackage) {
+        const armature = BaseObject.borrowObject(Armature);
+        const armatureDisplay = new CocosArmatureDisplay();
+        armature.init(dataPackage.armature, armatureDisplay, armatureDisplay, this._dragonBones);
+        return armature;
+    }
+    _buildSlot(_dataPackage, slotData, armature) {
+        const slot = BaseObject.borrowObject(CocosSlot);
+        slot.init(slotData, armature, new cc.Sprite(), new cc.Sprite());
+        return slot;
+    }
+    /**
+     * - Create a armature from cached DragonBonesData instances and TextureAtlasData instances, then use the {@link #clock} to update it.
+     * The difference is that the armature created by {@link #buildArmature} is not WorldClock instance update.
+     * @param armatureName - The armature data name.
+     * @param dragonBonesName - The cached name of the DragonBonesData instance. (If not set, all DragonBonesData instances are retrieved, and when multiple DragonBonesData instances contain a the same name armature data, it may not be possible to accurately create a specific armature)
+     * @param skinName - The skin name, you can set a different ArmatureData name to share it's skin data. (If not set, use the default skin data)
+     * @returns The armature display container.
+     * @see dragonBones.IArmatureProxy
+     * @see dragonBones.BaseFactory#buildArmature
+     * @version DragonBones 4.5
+     * @example
+     * <pre>
+     *     let armatureDisplay = factory.buildArmatureDisplay("armatureName", "dragonBonesName");
+     * </pre>
+     * @language en_US
+     */
+    /**
+     * - 通过缓存的 DragonBonesData 实例和 TextureAtlasData 实例创建一个骨架，并用 {@link #clock} 更新该骨架。
+     * 区别在于由 {@link #buildArmature} 创建的骨架没有 WorldClock 实例驱动。
+     * @param armatureName - 骨架数据名称。
+     * @param dragonBonesName - DragonBonesData 实例的缓存名称。 （如果未设置，将检索所有的 DragonBonesData 实例，当多个 DragonBonesData 实例中包含同名的骨架数据时，可能无法准确的创建出特定的骨架）
+     * @param skinName - 皮肤名称，可以设置一个其他骨架数据名称来共享其皮肤数据。 （如果未设置，则使用默认的皮肤数据）
+     * @returns 骨架的显示容器。
+     * @see dragonBones.IArmatureProxy
+     * @see dragonBones.BaseFactory#buildArmature
+     * @version DragonBones 4.5
+     * @example
+     * <pre>
+     *     let armatureDisplay = factory.buildArmatureDisplay("armatureName", "dragonBonesName");
+     * </pre>
+     * @language zh_CN
+     */
+    buildArmatureDisplay(armatureName, dragonBonesName = '', skinName = '', textureAtlasName = '') {
+        const armature = this.buildArmature(armatureName, dragonBonesName || '', skinName || '', textureAtlasName || '');
+        if (armature !== null) {
+            this._dragonBones.clock.add(armature);
+            return armature.display;
+        }
+        return null;
+    }
+    /**
+     * - Create the display object with the specified texture.
+     * @param textureName - The texture data name.
+     * @param textureAtlasName - The texture atlas data name (Of not set, all texture atlas data will be searched)
+     * @version DragonBones 3.0
+     * @language en_US
+     */
+    /**
+     * - 创建带有指定贴图的显示对象。
+     * @param textureName - 贴图数据名称。
+     * @param textureAtlasName - 贴图集数据名称。 （如果未设置，将检索所有的贴图集数据）
+     * @version DragonBones 3.0
+     * @language zh_CN
+     */
+    getTextureDisplay(textureName, textureAtlasName = null) {
+        const textureData = this._getTextureData(textureAtlasName !== null ? textureAtlasName : '', textureName);
+        if (textureData !== null && textureData.renderTexture !== null) {
+            return new cc.Sprite(textureData.renderTexture);
+        }
+        return null;
+    }
+    /**
+     * - A global sound event manager.
+     * Sound events can be listened to uniformly from the manager.
+     * @version DragonBones 4.5
+     * @language en_US
+     */
+    /**
+     * - 全局声音事件管理器。
+     * 声音事件可以从该管理器统一侦听。
+     * @version DragonBones 4.5
+     * @language zh_CN
+     */
+    get soundEventManager() {
+        return this._dragonBones.eventManager;
+    }
+}

package/dist/dragonbones/db-cocos/CocosSlot.d.ts

@@ -0,0 +1,49 @@
+/**
+ * The MIT License (MIT)
+ *
+ * Copyright (c) 2012-2018 DragonBones team and other contributors
+ *
+ * Permission is hereby granted, free of charge, to any person obtaining a copy of
+ * this software and associated documentation files (the "Software"), to deal in
+ * the Software without restriction, including without limitation the rights to
+ * use, copy, modify, merge, publish, distribute, sublicense, and/or sell copies of
+ * the Software, and to permit persons to whom the Software is furnished to do so,
+ * subject to the following conditions:
+ *
+ * The above copyright notice and this permission notice shall be included in all
+ * copies or substantial portions of the Software.
+ *
+ * THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+ * IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY, FITNESS
+ * FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE AUTHORS OR
+ * COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER LIABILITY, WHETHER
+ * IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM, OUT OF OR IN
+ * CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE SOFTWARE.
+ */
+import { Slot } from '@cocos/dragonbones-js';
+export declare class CocosSlot extends Slot {
+    _updateGlueMesh(): void;
+    static toString(): string;
+    private _textureScale;
+    private _renderDisplay;
+    protected _onClear(): void;
+    protected _initDisplay(value: any, isRetain: boolean): void;
+    protected _disposeDisplay(value: any, isRelease: boolean): void;
+    protected _onUpdateDisplay(): void;
+    protected _addDisplay(): void;
+    protected _replaceDisplay(value: any): void;
+    protected _removeDisplay(): void;
+    protected _updateZOrder(): void;
+    /**
+     * @internal
+     */
+    _updateVisible(): void;
+    protected _updateBlendMode(): void;
+    protected _updateColor(): void;
+    protected _updateFrame(): void;
+    protected _updateMesh(): void;
+    protected _updateTransform(): void;
+    protected _updateTransformV3(): void;
+    protected _identityTransform(): void;
+}
+//# sourceMappingURL=CocosSlot.d.ts.map

package/dist/dragonbones/db-cocos/CocosSlot.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"CocosSlot.d.ts","sourceRoot":"","sources":["../../../src/dragonbones/db-cocos/CocosSlot.ts"],"names":[],"mappings":"AACA;;;;;;;;;;;;;;;;;;;;;GAqBG;AAEH,OAAO,EAAsC,IAAI,EAAa,MAAM,uBAAuB,CAAA;AAK3F,qBAAa,SAAU,SAAQ,IAAI;IACjC,eAAe,IAAI,IAAI;WACT,QAAQ,IAAI,MAAM;IAIhC,OAAO,CAAC,aAAa,CAAQ;IAC7B,OAAO,CAAC,cAAc,CAAS;IAE/B,SAAS,CAAC,QAAQ,IAAI,IAAI;IAQ1B,SAAS,CAAC,YAAY,CAAC,KAAK,EAAE,GAAG,EAAE,QAAQ,EAAE,OAAO,GAAG,IAAI;IAO3D,SAAS,CAAC,eAAe,CAAC,KAAK,EAAE,GAAG,EAAE,SAAS,EAAE,OAAO,GAAG,IAAI;IAQ/D,SAAS,CAAC,gBAAgB,IAAI,IAAI;IAIlC,SAAS,CAAC,WAAW,IAAI,IAAI;IAK7B,SAAS,CAAC,eAAe,CAAC,KAAK,EAAE,GAAG,GAAG,IAAI;IAS3C,SAAS,CAAC,cAAc,IAAI,IAAI;IAIhC,SAAS,CAAC,aAAa,IAAI,IAAI;IAO/B;;OAEG;IACI,cAAc,IAAI,IAAI;IAI7B,SAAS,CAAC,gBAAgB,IAAI,IAAI;IAMlC,SAAS,CAAC,YAAY,IAAI,IAAI;IAc9B,SAAS,CAAC,YAAY,IAAI,IAAI;IAwG9B,SAAS,CAAC,WAAW,IAAI,IAAI;IAyJ7B,SAAS,CAAC,gBAAgB,IAAI,IAAI;IAqBlC,SAAS,CAAC,kBAAkB,IAAI,IAAI;IAuBpC,SAAS,CAAC,kBAAkB,IAAI,IAAI;CAiBrC"}