DragonBones Component Reference

The DragonBones component can render and play DragonBones resources.


Click the Add Component button at the bottom of the Properties panel and select DragonBones from Renderer Component to add the DragonBones component to the node.

The operation of the DragonBones component in the script refer to the DragonBones test in the example-cases.
About the DragonBones's scripting interface please refer to DragonBones API

DragonBones Properties

Properties Function Explanation
Dragon Asset The json data contains the DragonBones information (bind pose bones, slots, draw order,attachments, skins, etc) and animations, but does not hold any state.
Multiple ArmatureDisplay can share the same DragonBones data.
You can drag and drop the bone resources exported from DragonBones here.
Dragon Atlas Asset The json data contains the Texture information. You can drag and drop the Atlas resources exported from DragonBones here.
Armature The name of current armature.
Animation The name of current playing animation.
Animation Cache Mode Render mode, default is REALTIME mode. (new in v2.0.9)
REALTIME model, realtime calculate, support all functions of DragonBones.
SHARED_CACHE mode, caching and sharing dragonbones animation data, the equivalent of pre baked skeletal animation, have high performance, does not support the action blend, superposition and nest bone nested, only supports the start and end events, as for memory, when creating some same bones and the same action of animation, can present advantages of memory, the greater the amount of skeleton, the more obvious advantages, in conclusion SHARED_CACHE mode is suitable for the scene animation, special effects, monster, NPC and so on, can greatly increase the frame rate and reduce memory.
PRIVATE_CACHE mode, similar to SHARED_CACHE, but not share animation and texture data, so there is no advantage in memory, there is only a performance advantage, when trying to take advantage of caching pattern of high performance, but there is a change of texture, so you can't share the map data, then PRIVATE_CACHE is suitable for you.
Time Scale The time scale of this armature.
Play Times The play times of the default animation.
-1 means using the value of config file.
0 means repeat for ever.
>0 means repeat times.
Premultiplied Alpha Indicates whether to enable premultiplied alpha, default is True. (New in v2.0.7)
You should disable this option when image's transparent area appears to have opaque pixels.
or enable this option when image's half transparent area appears to be darken.
Debug Bones Indicates whether open debug bones.
Enable Batch Whether to enable animation batch, default is disabled. (New in v2.0.9)
When enable, drawcall will reduce, which is suitable for a large number of simple animations to play at the same time.
When disabled, drawcall will rise, but it can reduce the computational burden of the CPU. Suitable for complex animations.

Note: When the DragonBones component is used, the Anchor and Size properties on the Node component in the properties panel are invalid.

results matching ""

    No results matching ""