dragonBones.Slot

   dragonBones

   public class Slot

继承    dragonBones.Slot → dragonBones.TransformObjectdragonBones.BaseObject

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

公共属性

属性
boundingBoxData : dragonBones.BoundingBoxData|null
- 插槽此时的自定义包围盒数据
childArmature : dragonBones.Armature|null
- 插槽此时显示的子骨架
display : any
- 插槽此时显示的显示对象
displayController : string|null
- 显示对象受到控制的动画状态或混合组名称,设置为 null 则表示受所有的动画状态控制
displayFrameCount : number
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)
- 已废弃,请参考 {@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 则表示受所有的动画状态控制。

displayFrameCount

displayFrameCount : number

  • 支持版本:all
  • 运行平台:Web,Native

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)

  • 已废弃,请参考 {@link #display}。
  • 支持版本:all
  • 运行平台:Web,Native
  • 参数