跳到主要内容

dragonBones.Slot

包    dragonBones

类    public class Slot

继承    dragonBones.Slot → dragonBones.TransformObject → dragonBones.BaseObject

子类    dragonBones.EgretSlot

  • 插槽附着在骨骼上，控制显示对象的显示状态和属性。一个骨骼上可以包含多个插槽。一个插槽中可以包含多个显示对象，同一时间只能显示其中的一个显示对象，但可以在动画播放的过程中切换显示对象实现帧动画。显示对象可以是普通的图片纹理，也可以是子骨架的显示容器，网格显示对象，还可以是自定义的其他显示对象。

公共属性​

属性
boundingBoxData : dragonBones.BoundingBoxData|null
- 插槽此时的自定义包围盒数据
childArmature : dragonBones.Armature|null
- 插槽此时显示的子骨架
display : any
- 插槽此时显示的显示对象
displayController : string|null
- 显示对象受到控制的动画状态或混合组名称，设置为 null 则表示受所有的动画状态控制
displayIndex : number
- 此时显示的显示对象在显示列表中的索引
displayList : Array<any>
- 包含显示对象或子骨架的显示列表
name : string
- 插槽名称
parent : dragonBones.Bone
- 所属的父骨骼
slotData : dragonBones.SlotData
- 插槽数据
visible : boolean
- 插槽的显示对象的可见

公共方法​

方法
containsPoint(x:number,y:number):boolean
- 检查特定点是否在插槽的自定义边界框内
getDisplay():any
- 已废弃，请参考 {@link #display}
intersectsSegment(xA:number,yA:number,xB:number,yB:number,intersectionPointA:{x:number;y:number;}|null,intersectionPointB:{x:number;y:number;}|null,normalRadians:{x:number;y:number;}|null):number
- 检查特定线段是否与插槽的自定义边界框相交
invalidUpdate():void
- 强制插槽在下一帧更新显示对象的状态
setDisplay(value:any):void
- 已废弃，请参考 {@link #display}

属性详细信息​

boundingBoxData​

boundingBoxData : dragonBones.BoundingBoxData|null

  • 支持版本:DragonBones 5.0

  • 运行平台:Web,Native

  • 插槽此时的自定义包围盒数据。

childArmature​

childArmature : dragonBones.Armature|null

  • 支持版本:DragonBones 3.0

  • 运行平台:Web,Native

  • 插槽此时显示的子骨架。注意，被替换的对象或子骨架并不会被回收，根据语言和引擎的不同，需要额外处理。

display​

display : any

  • 支持版本:DragonBones 3.0

  • 运行平台:Web,Native

  • 插槽此时显示的显示对象。

displayController​

displayController : string|null = null

  • 支持版本:DragonBones 4.5

  • 运行平台:Web,Native

  • 显示对象受到控制的动画状态或混合组名称，设置为 null 则表示受所有的动画状态控制。

displayIndex​

displayIndex : number

  • 支持版本:DragonBones 4.5

  • 运行平台:Web,Native

  • 此时显示的显示对象在显示列表中的索引。

displayList​

displayList : Array<any>

  • 支持版本:DragonBones 3.0

  • 运行平台:Web,Native

  • 包含显示对象或子骨架的显示列表。

name​

name : string

  • 支持版本:DragonBones 3.0

  • 运行平台:Web,Native

  • 插槽名称。

parent​

parent : dragonBones.Bone

  • 支持版本:DragonBones 3.0

  • 运行平台:Web,Native

  • 所属的父骨骼。

slotData​

slotData : dragonBones.SlotData

  • 支持版本:DragonBones 4.5

  • 运行平台:Web,Native

  • 插槽数据。

visible​

visible : boolean = true

  • 支持版本:DragonBones 5.6

  • 运行平台:Web,Native

  • 插槽的显示对象的可见。

方法详细信息​

containsPoint()​

public containsPoint(x:number,y:number):boolean

  • 检查特定点是否在插槽的自定义边界框内。点的坐标系为骨架内坐标系。自定义边界框需要在 DragonBones Pro 中自定义。

  • 支持版本:DragonBones 5.0

  • 运行平台:Web,Native

  • 参数

    • x:number - - 点的水平坐标。
    • y:number - - 点的垂直坐标。

getDisplay()​

public getDisplay():any

  • 已废弃，请参考 {@link #display}。

  • 支持版本:all

  • 运行平台:Web,Native

intersectsSegment()​

public intersectsSegment(xA:number,yA:number,xB:number,yB:number,intersectionPointA:{x:number;y:number;}|null,intersectionPointB:{x:number;y:number;}|null,normalRadians:{x:number;y:number;}|null):number

  • 检查特定线段是否与插槽的自定义边界框相交。线段和交点的坐标系均为骨架内坐标系。自定义边界框需要在 DragonBones Pro 中自定义。

  • 支持版本:DragonBones 5.0

  • 运行平台:Web,Native

  • 参数

    • xA:number - - 线段起点的水平坐标。
    • yA:number - - 线段起点的垂直坐标。
    • xB:number - - 线段终点的水平坐标。
    • yB:number - - 线段终点的垂直坐标。
    • intersectionPointA:{x:number;y:number;}|null - - 线段从起点到终点与边界框相交的第一个交点。 （如果未设置，则不计算交点）
    • intersectionPointB:{x:number;y:number;}|null - - 线段从终点到起点与边界框相交的第一个交点。 （如果未设置，则不计算交点）
    • normalRadians:{x:number;y:number;}|null - - 交点边界框切线的法线弧度。 [x: 第一个交点切线的法线弧度, y: 第二个交点切线的法线弧度] （如果未设置，则不计算法线）

  • 返回:相交的情况。 [-1: 不相交且线段在包围盒内, 0: 不相交, 1: 相交且有一个交点且终点在包围盒内, 2: 相交且有一个交点且起点在包围盒内, 3: 相交且有两个交点, N: 相交且有 N 个交点]

invalidUpdate()​

public invalidUpdate():void

  • 强制插槽在下一帧更新显示对象的状态。

  • 支持版本:DragonBones 4.5

  • 运行平台:Web,Native

setDisplay()​

public setDisplay(value:any):void

  • 已废弃，请参考 {@link #display}。

  • 支持版本:all

  • 运行平台:Web,Native

  • 参数