dragonbones-runtime

declare function __extends(d: any, b: any): void; declare let __define: any; declare namespace egret { /** * The HashObject class is the base class for all objects in the Egret framework.The HashObject * class includes a hashCode property, which is a unique identification number of the instance. * @version Egret 2.4 * @platform Web,Native * @language en_US */ /** * Egret顶级对象。框架内所有对象的基类，为对象实例提供唯一的hashCode值。 * @version Egret 2.4 * @platform Web,Native * @language zh_CN */ interface IHashObject { /** * a unique identification number assigned to this instance. * @version Egret 2.4 * @platform Web,Native * @readOnly * @language en_US */ /** * 返回此对象唯一的哈希值,用于唯一确定一个对象。hashCode为大于等于1的整数。 * @version Egret 2.4 * @platform Web,Native * @readOnly * @language zh_CN */ hashCode: number; } /** * @private * 哈希计数 */ let $hashCount: number; /** * The HashObject class is the base class for all objects in the Egret framework.The HashObject * class includes a hashCode property, which is a unique identification number of the instance. * @version Egret 2.4 * @platform Web,Native * @language en_US */ /** * Egret顶级对象。框架内所有对象的基类，为对象实例提供唯一的hashCode值。 * @version Egret 2.4 * @platform Web,Native * @language zh_CN */ class HashObject implements IHashObject { /** * Initializes a HashObject * @version Egret 2.4 * @platform Web,Native * @language en_US */ /** * 创建一个 HashObject 对象 * @version Egret 2.4 * @platform Web,Native * @language zh_CN */ constructor(); /** * @private */ $hashCode: number; /** * a unique identification number assigned to this instance. * @version Egret 2.4 * @platform Web,Native * @language en_US */ /** * 返回此对象唯一的哈希值,用于唯一确定一个对象。hashCode为大于等于1的整数。 * @version Egret 2.4 * @platform Web,Native * @language zh_CN */ readonly hashCode: number; } /** * @private */ interface AsyncCallback { onSuccess: (data: any) => any; onFail: (error: number, data: any) => any; } } declare namespace egret { /** * The EventDispatcher class is the base class for all classes that dispatchEvent events. The EventDispatcher class implements * the IEventDispatcher interface and is the base class for the DisplayObject class. The EventDispatcher class allows * any object on the display list to be an event target and as such, to use the methods of the IEventDispatcher interface. * Event targets are an important part of the Egret event model. The event target serves as the focal point for how events * flow through the display list hierarchy. When an event such as a touch tap, Egret dispatches an event object into the * event flow from the root of the display list. The event object then makes its way through the display list until it * reaches the event target, at which point it begins its return trip through the display list. This round-trip journey * to the event target is conceptually divided into three phases: * the capture phase comprises the journey from the root to the last node before the event target's node, the target * phase comprises only the event target node, and the bubbling phase comprises any subsequent nodes encountered on * the return trip to the root of the display list. In general, the easiest way for a user-defined class to gain event * dispatching capabilities is to extend EventDispatcher. If this is impossible (that is, if the class is already extending * another class), you can instead implement the IEventDispatcher interface, create an EventDispatcher member, and write simple * hooks to route calls into the aggregated EventDispatcher. * @see egret.IEventDispatcher * @version Egret 2.4 * @platform Web,Native * @includeExample egret/events/EventDispatcher.ts * @language en_US */ /** * EventDispatcher 是 Egret 的事件派发器类，负责进行事件的发送和侦听。 * 事件目标是事件如何通过显示列表层次结构这一问题的焦点。当发生鼠标单击、触摸或按键等事件时， * 框架会将事件对象调度到从显示列表根开始的事件流中。然后该事件对象在显示列表中前进，直到到达事件目标， * 然后从这一点开始其在显示列表中的回程。在概念上，到事件目标的此往返行程被划分为三个阶段： * 捕获阶段包括从根到事件目标节点之前的最后一个节点的行程，目标阶段仅包括事件目标节点，冒泡阶段包括回程上遇到的任何后续节点到显示列表的根。 * 通常，使用户定义的类能够调度事件的最简单方法是扩展 EventDispatcher。如果无法扩展（即，如果该类已经扩展了另一个类），则可以实现 * IEventDispatcher 接口，创建 EventDispatcher 成员，并编写一些简单的映射，将调用连接到聚合的 EventDispatcher 中。 * @see egret.IEventDispatcher * @version Egret 2.4 * @platform Web,Native * @includeExample egret/events/EventDispatcher.ts * @language zh_CN */ class EventDispatcher extends HashObject implements IEventDispatcher { /** * create an instance of the EventDispatcher class. * @param target The target object for events dispatched to the EventDispatcher object. This parameter is used when * the EventDispatcher instance is aggregated by a class that implements IEventDispatcher; it is necessary so that the * containing object can be the target for events. Do not use this parameter in simple cases in which a class extends EventDispatcher. * @version Egret 2.4 * @platform Web,Native * @language en_US */ /** * 创建一个 EventDispatcher 类的实例 * @param target 此 EventDispatcher 所抛出事件对象的 target 指向。此参数主要用于一个实现了 IEventDispatcher 接口的自定义类， * 以便抛出的事件对象的 target 属性可以指向自定义类自身。请勿在直接继承 EventDispatcher 的情况下使用此参数。 * @version Egret 2.4 * @platform Web,Native * @language zh_CN */ constructor(target?: IEventDispatcher); /** * @private */ $EventDispatcher: Object; /** * @private * * @param useCapture */ $getEventMap(useCapture?: boolean): any; /** * @inheritDoc * @version Egret 2.4 * @platform Web,Native */ addEventListener(type: string, listener: Function, thisObject: any, useCapture?: boolean, priority?: number): void; /** * @inheritDoc * @version Egret 2.4 * @platform Web,Native */ once(type: string, listener: Function, thisObject: any, useCapture?: boolean, priority?: number): void; /** * @private */ $addListener(type: string, listener: Function, thisObject: any, useCapture?: boolean, priority?: number, dispatchOnce?: boolean): void; $insertEventBin(list: any[], type: string, listener: Function, thisObject: any, useCapture?: boolean, priority?: number, dispatchOnce?: boolean): boolean; /** * @inheritDoc * @version Egret 2.4 * @platform Web,Native */ removeEventListener(type: string, listener: Function, thisObject: any, useCapture?: boolean): void; $removeEventBin(list: any[], listener: Function, thisObject: any): boolean; /** * @inheritDoc * @version Egret 2.4 * @platform Web,Native */ hasEventListener(type: string): boolean; /** * @inheritDoc * @version Egret 2.4 * @platform Web,Native */ willTrigger(type: string): boolean; /** * @inheritDoc * @version Egret 2.4 * @platform Web,Native */ dispatchEvent(event: Event): boolean; /** * @private */ $notifyListener(event: Event, capturePhase: boolean): boolean; /** * Distribute a specified event parameters. * @param type The type of the event. Event listeners can access this information through the inherited type property. * @param bubbles Determines whether the Event object bubbles. Event listeners can access this information through * the inherited bubbles property. * @param data {any} data * @param cancelable Determines whether the Event object can be canceled. The default values is false. * @version Egret 2.4 * @platform Web,Native * @language en_US */ /** * 派发一个指定参数的事件。 * @param type {string} 事件类型 * @param bubbles {boolean} 确定 Event 对象是否参与事件流的冒泡阶段。默认值为 false。 * @param data {any} 事件data * @param cancelable {boolean} 确定是否可以取消 Event 对象。默认值为 false。 * @version Egret 2.4 * @platform Web,Native * @language zh_CN */ dispatchEventWith(type: string, bubbles?: boolean, data?: any, cancelable?: boolean): boolean; } } declare namespace egret.sys { /** * @private * 事件信息对象 */ interface EventBin { type: string; /** * @private */ listener: Function; /** * @private */ thisObject: any; /** * @private */ priority: number; /** * @private */ target: IEventDispatcher; /** * @private */ useCapture: boolean; /** * @private */ dispatchOnce: boolean; } } declare namespace egret { /** * @private */ const enum RenderMode { NONE = 1, FILTER = 2, CLIP = 3, SCROLLRECT = 4, } /** * The DisplayObject class is the base class for all objects that can be placed on the display list. The display list * manages all objects displayed in the runtime. Use the DisplayObjectContainer class to arrange the display * objects in the display list. DisplayObjectContainer objects can have child display objects, while other display objects, * such as Shape and TextField objects, are "leaf" nodes that have only parents and siblings, no children. * The DisplayObject class supports basic functionality like the x and y position of an object, as well as more advanced * properties of the object such as its transformation matrix. * The DisplayObject class contains several broadcast events.Normally, the target of any particular event is a specific * DisplayObject instance. For example, the target of an added event is the specific DisplayObject instance that was added * to the display list. Having a single target restricts the placement of event listeners to that target and in some cases * the target's ancestors on the display list. With broadcast events, however, the target is not a specific DisplayObject * instance, but rather all DisplayObject instances, including those that are not on the display list. This means that you * can add a listener to any DisplayObject instance to listen for broadcast events. * * @event egret.Event.ADDED Dispatched when a display object is added to the display list. * @event egret.Event.ADDED_TO_STAGE Dispatched when a display object is added to the on stage display list, either directly or through the addition of a sub tree in which the display object is contained. * @event egret.Event.REMOVED Dispatched when a display object is about to be removed from the display list. * @event egret.Event.REMOVED_FROM_STAGE Dispatched when a display object is about to be removed from the display list, either directly or through the removal of a sub tree in which the display object is contained. * @event egret.Event.ENTER_FRAME [broadcast event] Dispatched when the playhead is entering a new frame. * @event egret.Event.RENDER [broadcast event] Dispatched when the display list is about to be updated and rendered. * @event egret.TouchEvent.TOUCH_MOVE Dispatched when the user touches the device, and is continuously dispatched until the point of contact is removed. * @event egret.TouchEvent.TOUCH_BEGIN Dispatched when the user first contacts a touch-enabled device (such as touches a finger to a mobile phone or tablet with a touch screen). * @event egret.TouchEvent.TOUCH_END Dispatched when the user removes contact with a touch-enabled device (such as lifts a finger off a mobile phone or tablet with a touch screen). * @event egret.TouchEvent.TOUCH_TAP Dispatched when the user lifts the point of contact over the same DisplayObject instance on which the contact was initiated on a touch-enabled device (such as presses and releases a finger from a single point over a display object on a mobile phone or tablet with a touch screen). * @event egret.TouchEvent.TOUCH_RELEASE_OUTSIDE Dispatched when the user lifts the point of contact over the different DisplayObject instance on which the contact was initiated on a touch-enabled device (such as presses and releases a finger from a single point over a display object on a mobile phone or tablet with a touch screen). * @version Egret 2.4 * @platform Web,Native * @includeExample egret/display/DisplayObject.ts * @language en_US */ /** * DisplayObject 类是可放在显示列表中的所有对象的基类。该显示列表管理运行时中显示的所有对象。使用 DisplayObjectContainer 类排列 * 显示列表中的显示对象。DisplayObjectContainer 对象可以有子显示对象，而其他显示对象（如 Shape 和 TextField 对象）是“叶”节点，没有子项，只有父级和 * 同级。DisplayObject 类有一些基本的属性（如确定坐标位置的 x 和 y 属性），也有一些高级的对象属性（如 Matrix 矩阵变换）。 * DisplayObject 类包含若干广播事件。通常，任何特定事件的目标均为一个特定的 DisplayObject 实例。例如，added 事件的目标是已添加到显示列表 * 的目标 DisplayObject 实例。若只有一个目标，则会将事件侦听器限制为只能监听在该目标上（在某些情况下，可监听在显示列表中该目标的祖代上）。 * 但是对于广播事件，目标不是特定的 DisplayObject 实例，而是所有 DisplayObject 实例（包括那些不在显示列表中的实例）。这意味着您可以向任何 * DisplayObject 实例添加侦听器来侦听广播事件。 * * @event egret.Event.ADDED 将显示对象添加到显示列表中时调度。 * @event egret.Event.ADDED_TO_STAGE 在将显示对象直接添加到舞台显示列表或将包含显示对象的子树添加至舞台显示列表中时调度。 * @event egret.Event.REMOVED 将要从显示列表中删除显示对象时调度。 * @event egret.Event.REMOVED_FROM_STAGE 在从显示列表中直接删除显示对象或删除包含显示对象的子树时调度。 * @event egret.Event.ENTER_FRAME [广播事件] 播放头进入新帧时调度。 * @event egret.Event.RENDER [广播事件] 将要更新和呈现显示列表时调度。 * @event egret.TouchEvent.TOUCH_MOVE 当用户触碰设备时进行调度，而且会连续调度，直到接触点被删除。 * @event egret.TouchEvent.TOUCH_BEGIN 当用户第一次触摸启用触摸的设备时（例如，用手指触摸手机屏幕）调度。 * @event egret.TouchEvent.TOUCH_END 当用户移除与启用触摸的设备的接触时（例如，将手指从屏幕上抬起）调度。 * @event egret.TouchEvent.TOUCH_TAP 当用户在启用触摸设备上的已启动接触的同一 DisplayObject 实例上抬起接触点时（例如，手机点击屏幕后抬起）调度。 * @event egret.TouchEvent.TOUCH_RELEASE_OUTSIDE 当用户在启用触摸设备上的已启动接触的不同 DisplayObject 实例上抬起接触点时（例如，按住屏幕上的某个对象,然后从它上面挪开后再松开手指）调度。 * @version Egret 2.4 * @platform Web,Native * @includeExample egret/display/DisplayObject.ts * @language zh_CN */ class DisplayObject extends EventDispatcher { /** * Initializes a DisplayObject object * @version Egret 2.4 * @platform Web,Native * @language en_US */ /** * 创建一个显示对象 * @version Egret 2.4 * @platform Web,Native * @language zh_CN */ constructor(); /** * @private * 是否添加到舞台上，防止重复发送 removed_from_stage 消息 */ $hasAddToStage: boolean; /** * @private * 能够含有子项的类将子项列表存储在这个属性里。 */ $children: DisplayObject[]; private $name; /** * Indicates the instance name of the DisplayObject. The object can be identified in the child list of its parent * display object container by calling the getChildByName() method of the display object container. * @version Egret 2.4 * @platform Web,Native * @language en_US */ /** * 表示 DisplayObject 的实例名称。 * 通过调用父显示对象容器的 getChildByName() 方法，可以在父显示对象容器的子列表中标识该对象。 * @version Egret 2.4 * @platform Web,Native * @language zh_CN */ name: string; /** * @private */ $parent: DisplayObjectContainer; /** * Indicates the DisplayObjectContainer object that contains this display object. Use the parent property to specify * a relative path to display objects that are above the current display object in the display list hierarchy. * @version Egret 2.4 * @platform Web,Native * @language en_US */ /** * 表示包含此显示对象的 DisplayObjectContainer 对象。 * 使用 parent 属性可以指定高于显示列表层次结构中当前显示对象的显示对象的相对路径。 * @version Egret 2.4 * @platform Web,Native * @language zh_CN */ readonly parent: DisplayObjectContainer; /** * @private * 设置父级显示对象 */ $setParent(parent: DisplayObjectContainer): void; /** * @private * 显示对象添加到舞台 */ $onAddToStage(stage: Stage, nestLevel: number): void; /** * @private * 显示对象从舞台移除 */ $onRemoveFromStage(): void; /** * @private */ $stage: Stage; /** * @private * 这个对象在显示列表中的嵌套深度，舞台为1，它的子项为2，子项的子项为3，以此类推。当对象不在显示列表中时此属性值为0. */ $nestLevel: number; $useTranslate: boolean; private $updateUseTransform(); /** * The Stage of the display object. you can create and load multiple display objects into the display list, and * the stage property of each display object refers to the same Stage object. * If a display object is not added to the display list, its stage property is set to null. * @version Egret 2.4 * @platform Web,Native * @language en_US */ /** * 显示对象的舞台。 * 例如，您可以创建多个显示对象并加载到显示列表中，每个显示对象的 stage 属性是指向相同的 Stage 对象。 * 如果显示对象未添加到显示列表，则其 stage 属性会设置为 null。 * @version Egret 2.4 * @platform Web,Native * @language zh_CN */ readonly stage: Stage; /** * A Matrix object containing values that alter the scaling, rotation, and translation of the display object. * Note: to change the value of a display object's matrix, you must make a copy of the entire matrix object, then copy * the new object into the matrix property of the display object. * @example the following code increases the tx value of a display object's matrix * <pre> * let myMatrix:Matrix = myDisplayObject.matrix; * myMatrix.tx += 10; * myDisplayObject.matrix = myMatrix; * </pre> * @version Egret 2.4 * @platform Web,Native * @language en_US */ /** * 一个 Matrix 对象，其中包含更改显示对象的缩放、旋转和平移的值。 * 注意：要改变一个显示对象矩阵的值，您必引用整个矩阵对象，然后将它重新赋值给显示对象的 matrix 属性。 * @example 以下代码改变了显示对象矩阵的tx属性值： * <pre> * let myMatrix:Matrix = myDisplayObject.matrix; * myMatrix.tx += 10; * myDisplayObject.matrix = myMatrix; * </pre> * @version Egret 2.4 * @platform Web,Native * @language zh_CN */ matrix: Matrix; private $matrix; private $matrixDirty; /** * @private * 获取矩阵 */ $getMatrix(): Matrix; /** * @private * 设置矩阵 */ $setMatrix(matrix: Matrix, needUpdateProperties?: boolean): void; private $concatenatedMatrix; /** * @private * 获得这个显示对象以及它所有父级对象的连接矩阵。 */ $getConcatenatedMatrix(): Matrix; private $invertedConcatenatedMatrix; /** * @private * 获取链接矩阵 */ $getInvertedConcatenatedMatrix(): Matrix; $x: number; /** * Indicates the x coordinate of the DisplayObject instance relative to the local coordinates of the parent * DisplayObjectContainer. * If the object is inside a DisplayObjectContainer that has transformations, it is in * the local coordinate system of the enclosing DisplayObjectContainer. Thus, for a DisplayObjectContainer * rotated 90° counterclockwise, the DisplayObjectContainer's children inherit a coordinate system that is * rotated 90° counterclockwise. The object's coordinates refer to the registration point position. * @default 0 * @version Egret 2.4 * @platform Web,Native * @language en_US */ /** * 表示 DisplayObject 实例相对于父级 DisplayObjectContainer 本地坐标的 x 坐标。 * 如果该对象位于具有变形的 DisplayObjectContainer 内，则它也位于包含 DisplayObjectContainer 的本地坐标系中。 * 因此，对于逆时针旋转 90 度的 DisplayObjectContainer，该 DisplayObjectContainer 的子级将继承逆时针旋转 90 度的坐标系。 * @default 0 * @version Egret 2.4 * @platform Web,Native * @language zh_CN */ x: number; /** * @private * 获取x坐标 */ $getX(): number; /** * @private * 设置x坐标 */ $setX(value: number): boolean; $y: number; /** * Indicates the y coordinate of the DisplayObject instance relative to the local coordinates of the parent * DisplayObjectContainer. * If the object is inside a DisplayObjectContainer that has transformations, it is in * the local coordinate system of the enclosing DisplayObjectContainer. Thus, for a DisplayObjectContainer rotated * 90° counterclockwise, the DisplayObjectContainer's children inherit a coordinate system that is rotated 90° * counterclockwise. The object's coordinates refer to the registration point position. * @default 0 * @version Egret 2.4 * @platform Web,Native * @language en_US */ /** * 表示 DisplayObject 实例相对于父级 DisplayObjectContainer 本地坐标的 y 坐标。 * 如果该对象位于具有变形的 DisplayObjectContainer 内，则它也位于包含 DisplayObjectContainer 的本地坐标系中。 * 因此，对于逆时针旋转 90 度的 DisplayObjectContainer，该 DisplayObjectContainer 的子级将继承逆时针旋转 90 度的坐标系。 * @default 0 * @version Egret 2.4 * @platform Web,Native * @language zh_CN */ y: number; /** * @private * 获取y坐标 */ $getY(): number; /** * @private * 设置y坐标 */ $setY(value: number): boolean; private $scaleX; /** * Indicates the horizontal scale (percentage) of the object as applied from the registration point. * The default 1.0 equals 100% scale. * @default 1 * @version Egret 2.4 * @platform Web,Native * @language en_US */ /** * 表示从注册点开始应用的对象的水平缩放比例（百分比）。 * 1.0 等于 100% 缩放。 * @default 1 * @version Egret 2.4 * @platform Web,Native * @language zh_CN */ scaleX: number; /** * @private * * @returns */ $getScaleX(): number; /** * @private * 设置水平缩放值 */ $setScaleX(value: number): void; private $scaleY; /** * Indicates the vertical scale (percentage) of an object as applied from the registration point of the object. * 1.0 is 100% scale. * @default 1 * @version Egret 2.4 * @platform Web,Native * @language en_US */ /** * 表示从对象注册点开始应用的对象的垂直缩放比例（百分比）。1.0 是 100% 缩放。 * @default 1 * @version Egret 2.4 * @platform Web,Native * @language zh_CN */ scaleY: number; /** * @private * * @returns */ $getScaleY(): number; /** * @private * 设置垂直缩放值 */ $setScaleY(value: number): void; private $rotation; /** * Indicates the rotation of the DisplayObject instance, in degrees, from its original orientation. Values from * 0 to 180 represent clockwise rotation; values from 0 to -180 represent counterclockwise rotation. Values outside * this range are added to or subtracted from 360 to obtain a value within the range. For example, the statement * myDisplayObject.rotation = 450 is the same as myDisplayObject.rotation = 90. * @default 0 * @version Egret 2.4 * @platform Web,Native * @language en_US */ /** * 表示 DisplayObject 实例距其原始方向的旋转程度，以度为单位。 * 从 0 到 180 的值表示顺时针方向旋转；从 0 到 -180 的值表示逆时针方向旋转。对于此范围之外的值，可以通过加上或 * 减去 360 获得该范围内的值。例如，myDisplayObject.rotation = 450语句与 myDisplayObject.rotation = 90 是相同的。 * @default 0 * @version Egret 2.4 * @platform Web,Native * @language zh_CN */ rotation: number; /** * @private */ $getRotation(): number; $setRotation(value: number): void; private $skewX; private $skewXdeg; /** * 表示DisplayObject的x方向斜切 * @member {number} egret.DisplayObject#skewX * @default 0 * @version Egret 2.4 * @platform Web,Native */ skewX: number; /** * @private * * @param value */ $setSkewX(value: number): void; private $skewY; private $skewYdeg; /** * 表示DisplayObject的y方向斜切 * @member {number} egret.DisplayObject#skewY * @default 0 * @version Egret 2.4 * @platform Web,Native */ skewY: number; /** * @private * * @param value */ $setSkewY(value: number): void; /** * Indicates the width of the display object, in pixels. The width is calculated based on the bounds of the content * of the display object. * @version Egret 2.4 * @platform Web,Native * @language en_US */ /** * 表示显示对象的宽度，以像素为单位。宽度是根据显示对象内容的范围来计算的。 * @version Egret 2.4 * @platform Web,Native * @language zh_CN */ width: number; /** * @private * 获取显示宽度 */ $getWidth(): number; $explicitWidth: number; /** * @private * 设置显示宽度 */ $setWidth(value: number): void; /** * Indicates the height of the display object, in pixels. The height is calculated based on the bounds of the * content of the display object. * @version Egret 2.4 * @platform Web,Native * @language en_US */ /** * 表示显示对象的高度，以像素为单位。高度是根据显示对象内容的范围来计算的。 * @version Egret 2.4 * @platform Web,Native * @language zh_CN */ height: number; $explicitHeight: number; /** * @private * 获取显示高度 */ $getHeight(): number; /** * @private * 设置显示高度 */ $setHeight(value: number): void; /** * 测量宽度 * @returns {number} * @member {egret.Rectangle} egret.DisplayObject#measuredWidth * @version Egret 2.4 * @platform Web,Native */ readonly measuredWidth: number; /** * 测量高度 * @returns {number} * @member {egret.Rectangle} egret.DisplayObject#measuredWidth * @version Egret 2.4 * @platform Web,Native */ readonly measuredHeight: number; $anchorOffsetX: number; /** * X represents the object of which is the anchor. * @default 0 * @version Egret 2.4 * @platform Web,Native * @language en_US */ /** * 表示从对象绝对锚点X。 * @default 0 * @version Egret 2.4 * @platform Web,Native * @language zh_CN */ anchorOffsetX: number; /** * @private * * @param value * @returns */ $setAnchorOffsetX(value: number): void; $anchorOffsetY: number; /** * Y represents the object of which is the anchor. * @default 0 * @version Egret 2.4 * @platform Web,Native * @language en_US */ /** * 表示从对象绝对锚点Y。 * @default 0 * @version Egret 2.4 * @platform Web,Native * @language zh_CN */ anchorOffsetY: number; /** * @private * * @param value * @returns */ $setAnchorOffsetY(value: number): void; /** * @private */ $visible: boolean; /** * Whether or not the display object is visible. Display objects that are not visible are disabled. For example, * if visible=false for an DisplayObject instance, it cannot receive touch or other user input. * @default true * @version Egret 2.4 * @platform Web,Native * @language en_US */ /** * 显示对象是否可见。不可见的显示对象将被禁用。例如，如果实例的 visible 为 false，则无法接受触摸或用户交互操作。 * @default true * @version Egret 2.4 * @platform Web,Native * @language zh_CN */ visible: boolean; $setVisible(value: boolean): void; /** * @private * cacheAsBitmap创建的缓存位图节点。 */ $displayList: egret.sys.DisplayList; private $cacheAsBitmap; /** * If set to true, Egret runtime caches an internal bitmap representation of the display object. This caching can * increase performance for display objects that contain complex vector content. After you set the cacheAsBitmap * property to true, the rendering does not change, however the display object performs pixel snapping automatically. * The execution speed can be significantly faster depending on the complexity of the content.The cacheAsBitmap * property is best used with display objects that have mostly static content and that do not scale and rotate frequently. * Note: The display object will not create the bitmap caching when the memory exceeds the upper limit,even if you set it to true. * @default false * @version Egret 2.4 * @platform Web,Native * @language en_US */ /** * 如果设置为 true，则 Egret 运行时将缓存显示对象的内部位图表示形式。此缓存可以提高包含复杂矢量内容的显示对象的性能。 * 将 cacheAsBitmap 属性设置为 true 后，呈现并不更改，但是，显示对象将自动执行像素贴紧。执行速度可能会大大加快， * 具体取决于显示对象内容的复杂性。最好将 cacheAsBitmap 属性与主要具有静态内容且不频繁缩放或旋转的显示对象一起使用。 * 注意：在内存超过上限的情况下，即使将 cacheAsBitmap 属性设置为 true，显示对象也不使用位图缓存。 * @default false * @version Egret 2.4 * @platform Web,Native * @language zh_CN */ cacheAsBitmap: boolean; $setHasDisplayList(value: boolean): void; $cacheDirty: boolean; $cacheDirtyUp(): void; /** * @private */ $alpha: number; /** * Indicates the alpha transparency value of the object specified. Valid values are 0 (fully transparent) to 1 (fully opaque). * The default value is 1. Display objects with alpha set to 0 are active, even though they are invisible. * @default 1 * @version Egret 2.4 * @platform Web,Native * @language en_US */ /** * 表示指定对象的 Alpha 透明度值。 * 有效值为 0（完全透明）到 1（完全不透明）。alpha 设置为 0 的显示对象是可触摸的，即使它们不可见。 * @default 1 * @version Egret 2.4 * @platform Web,Native * @language zh_CN */ alpha: number; /** * @private * * @param value */ $setAlpha(value: number): void; /** * @private * The default touchEnabled property of DisplayObject * @default false * @version Egret 2.5 * @platform Web,Native * @language en_US */ /** * @private * 显示对象默认的 touchEnabled 属性 * @default false * @version Egret 2.5 * @platform Web,Native * @language zh_CN */ static defaultTouchEnabled: boolean; $touchEnabled: boolean; /** * Specifies whether this object receives touch or other user input. The default value is false, which means that * by default any DisplayObject instance that is on the display list cannot receive touch events. If touchEnabled is * set to false, the instance does not receive any touch events (or other user input events). Any children of * this instance on the display list are not affected. To change the touchEnabled behavior for all children of * an object on the display list, use DisplayObjectContainer.touchChildren. * @see egret.DisplayObjectContainer#touchChildren * @default false * @version Egret 2.4 * @platform Web,Native * @language en_US */ /** * 指定此对象是否接收触摸或其他用户输入。默认值为 false，这表示默认情况下，显示列表上的任何 DisplayObject 实例都不会接收触摸事件或 * 其他用户输入事件。如果将 touchEnabled 设置为 false，则实例将不接收任何触摸事件（或其他用户输入事件）。显示列表上的该实例的任 * 何子级都不会受到影响。要更改显示列表上对象的所有子级的 touchEnabled 行为，请使用 DisplayObjectContainer.touchChildren。 * @see egret.DisplayObjectContainer#touchChildren * @default false * @version Egret 2.4 * @platform Web,Native * @language zh_CN */ touchEnabled: boolean; /** * @private */ $getTouchEnabled(): boolean; /** * @private */ $setTouchEnabled(value: boolean): void; /** * @private */ $scrollRect: Rectangle; /** * The scroll rectangle bounds of the display object. The display object is cropped to the size defined by the rectangle, * and it scrolls within the rectangle when you change the x and y properties of the scrollRect object. A scrolled display * object always scrolls in whole pixel increments.You can scroll an object left and right by setting the x property of * the scrollRect Rectangle object. You can scroll an object up and down by setting the y property of the scrollRect * Rectangle object. If the display object is rotated 90° and you scroll it left and right, the display object actually * scrolls up and down. * * Note: to change the value of a display object's scrollRect, you must make a copy of the entire scrollRect object, then copy * the new object into the scrollRect property of the display object. * @example the following code increases the x value of a display object's scrollRect * <pre> * let myRectangle:Rectangle = myDisplayObject.scrollRect; * myRectangle.x += 10; * myDisplayObject.scrollRect = myRectangle; * </pre> * @version Egret 2.4 * @platform Web,Native * @language en_US */ /** * 显示对象的滚动矩形范围。显示对象被裁切为矩形定义的大小，当您更改 scrollRect 对象的 x 和 y 属性时，它会在矩形内滚动。 * 滚动的显示对象始终以整像素为增量进行滚动。您可以通过设置 scrollRect Rectangle 对象的 x 属性来左右滚动对象，还可以通过设置 * scrollRect 对象的 y 属性来上下滚动对象。如果显示对象旋转了 90 度，并且您左右滚动它，则实际上显示对象会上下滚动。 * * 注意：要改变一个显示对象 scrollRect 属性的值，您必引用整个 scrollRect 对象，然后将它重新赋值给显示对象的 scrollRect 属性。 * @example 以下代码改变了显示对象 scrollRect 的 x 属性值： * <pre> * let myRectangle:Rectangle = myDisplayObject.scrollRect; * myRectangle.x += 10; * myDisplayObject.scrollRect = myRectangle;//设置完scrollRect的x、y、width、height值之后，一定要对myDisplayObject重新赋值scrollRect，不然会出问题。 * </pre> * @version Egret 2.4 * @platform Web,Native * @language zh_CN */ scrollRect: Rectangle; /** * @private * * @param value */ private $setScrollRect(value); /** * @private */ $blendMode: number; /** * A value from the BlendMode class that specifies which blend mode to use. Determine how a source image (new one) * is drawn on the target image (old one). * If you attempt to set this property to an invalid value, Egret runtime set the value to BlendMode.NORMAL. * @default egret.BlendMode.NORMAL * @see egret.BlendMode * @version Egret 2.4 * @platform Web,Native * @language en_US */ /** * BlendMode 枚举中的一个值，用于指定要使用的混合模式，确定如何将一个源（新的）图像绘制到目标（已有）的图像上 * 如果尝试将此属性设置为无效值，则运行时会将此值设置为 BlendMode.NORMAL。 * @default egret.BlendMode.NORMAL * @see egret.BlendMode * @version Egret 2.4 * @platform Web,Native * @language zh_CN */ blendMode: string; /** * @private * 被遮罩的对象 */ $maskedObject: DisplayObject; /** * @private */ $mask: DisplayObject; /** * @private */ $maskRect: Rectangle; /** * The calling display object is masked by the specified mask object. To ensure that masking works when the Stage * is scaled, the mask display object must be in an active part of the display list. The mask object itself is not drawn. * Set mask to null to remove the mask. To be able to scale a mask object, it must be on the display list. To be * able to drag a mask object , it must be on the display list. * Note: A single mask object cannot be used to mask more than one calling display object. When the mask is assigned * to a second display object, it is removed as the mask of the first object, and that object's mask property becomes null. * @version Egret 2.4 * @platform Web,Native * @language en_US */ /** * 调用显示对象被指定的 mask 对象遮罩。要确保当舞台缩放时蒙版仍然有效，mask 显示对象必须处于显示列表的活动部分。 * 但不绘制 mask 对象本身。将 mask 设置为 null 可删除蒙版。要能够缩放遮罩对象，它必须在显示列表中。要能够拖动蒙版 * 对象，它必须在显示列表中。 * 注意：单个 mask 对象不能用于遮罩多个执行调用的显示对象。在将 mask 分配给第二个显示对象时，会撤消其作为第一个对象的遮罩， * 该对象的 mask 属性将变为 null。 * * 下面例子为 mask 为 Rectangle 类型对象，这种情况下，修改 mask 的值后，一定要对 myDisplayObject 重新赋值 mask，不然会出问题。 * @example 以下代码改变了显示对象 mask 的 x 属性值： * <pre> * let myMask:Rectangle = myDisplayObject.mask; * myMask.x += 10; * myDisplayObject.mask = myMask;//设置完 mask 的x、y、width、height值之后，一定要对myDisplayObject重新赋值 mask，不然会出问题。 * </pre> * @version Egret 2.4 * @platform Web,Native * @language zh_CN */ mask: DisplayObject | Rectangle; private $setMaskRect(value); $filters: Array<Filter | CustomFilter>; /** * An indexed array that contains each filter object currently associated with the display object. * @version Egret 3.1.0 * @platform Web * @language en_US */ /** * 包含当前与显示对象关联的每个滤镜对象的索引数组。 * @version Egret 3.1.0 * @platform Web * @language zh_CN */ filters: Array<Filter | CustomFilter>; /** * Returns a rectangle that defines the area of the display object relative to the coordinate system of the targetCoordinateSpace object. * @param targetCoordinateSpace The display object that defines the coordinate system to use. * @param resultRect A reusable instance of Rectangle for saving the results. Passing this parameter can reduce the number of reallocate objects *, which allows you to get better code execution performance.. * @returns The rectangle that defines the area of the display object relative to the targetCoordinateSpace object's coordinate system. * @version Egret 2.4 * @platform Web,Native * @language en_US */ /** * 返回一个矩形，该矩形定义相对于 targetCoordinateSpace 对象坐标系的显示对象区域。 * @param targetCoordinateSpace 定义要使用的坐标系的显示对象。 * @param resultRect 一个用于存储结果的可复用Rectangle实例，传入此参数能够减少内部创建对象的次数，从而获得更高的运行性能。 * @returns 定义与 targetCoordinateSpace 对象坐标系统相关的显示对象面积的矩形。 * @version Egret 2.4 * @platform Web,Native * @language zh_CN */ getTransformedBounds(targetCoordinateSpace: DisplayObject, resultRect?: Rectangle): Rectangle; /** * Obtain measurement boundary of display object * @param resultRect {Rectangle} Optional. It is used to import Rectangle object for saving results, preventing duplicate object creation. * @param calculateAnchor {boolean} Optional. It is used to determine whether to calculate anchor point. * @returns {Rectangle} * @version Egret 2.4 * @platform Web,Native * @language en_US */ /** * 获取显示对象的测量边界 * @param resultRect {Rectangle} 可选参数，传入用于保存结果的Rectangle对象，避免重复创建对象。 * @param calculateAnchor {boolean} 可选参数，是否会计算锚点。 * @returns {Rectangle} * @version Egret 2.4 * @platform Web,Native * @language zh_CN */ getBounds(resultRect?: Rectangle, calculateAnchor?: boolean): egret.Rectangle; /** * @private */ $getTransformedBounds(targetCoordinateSpace: DisplayObject, resultRect?: Rectangle): Rectangle; /** * Converts the point object from the Stage (global) coordinates to the display object's (local) coordinates. * @param stageX the x value in the global coordinates * @param stageY the y value in the global coordinates * @param resultPoint A reusable instance of Point for saving the results. Passing this parameter can reduce the * number of reallocate objects, which allows you to get better code execution performance. * @returns A Point object with coordinates relative to the display object. * @version Egret 2.4 * @platform Web,Native * @language en_US */ /** * 将从舞台（全局）坐标转换为显示对象的（本地）坐标。 * @param stageX 舞台坐标x * @param stageY 舞台坐标y * @param resultPoint 一个用于存储结果的可复用 Point 实例，传入此参数能够减少内部创建对象的次数，从而获得更高的运行性能。 * @returns 具有相对于显示对象的坐标的 Point 对象。 * @version Egret 2.4 * @platform Web,Native * @language zh_CN */ globalToLocal(stageX?: number, stageY?: number, resultPoint?: Point): Point; /** * Converts the point object from the display object's (local) coordinates to the Stage (global) coordinates. * @param localX the x value in the local coordinates * @param localY the x value in the local coordinates * @param resultPoint A reusable instance of Point for saving the results. Passing this parameter can reduce the * number of reallocate objects, which allows you to get better code execution performance. * @returns A Point object with coordinates relative to the Stage. * @version Egret 2.4 * @platform Web,Native * @language en_US */ /** * 将显示对象的（本地）坐标转换为舞台（全局）坐标。 * @param localX 本地坐标 x * @param localY 本地坐标 y * @param resultPoint 一个用于存储结果的可复用 Point 实例，传入此参数能够减少内部创建对象的次数，从而获得更高的运行性能。 * @returns 一个具有相对于舞台坐标的 Point 对象。 * @version Egret 2.4 * @platform Web,Native * @language zh_CN */ localToGlobal(localX?: number, localY?: number, resultPoint?: Point): Point; /** * @private * 获取显示对象占用的矩形区域集合，通常包括自身绘制的测量区域，如果是容器，还包括所有子项占据的区域。 */ $getOriginalBounds(): Rectangle; /** * @private * 测量子项占用的矩形区域 * @param bounds 测量结果存储在这个矩形对象内 */ $measureChildBounds(bounds: Rectangle): void; /** * @private */ $getContentBounds(): Rectangle; /** * @private * 测量自身占用的矩形区域，注意：此测量结果并不包括子项占据的区域。 * @param bounds 测量结果存储在这个矩形对象内 */ $measureContentBounds(bounds: Rectangle): void; /** * @private */ $parentDisplayList: egret.sys.DisplayList; /** * @private * 渲染节点,不为空表示自身有绘制到屏幕的内容 */ $renderNode: sys.RenderNode; $renderDirty: boolean; /** * @private * 获取渲染节点 */ $getRenderNode(): sys.RenderNode; private updateRenderMode(); $renderMode: RenderMode; /** * @private */ private $measureFiltersOffset(fromParent); /** * @private * 获取相对于指定根节点的连接矩阵。 * @param root 根节点显示对象 * @param matrix 目标显示对象相对于舞台的完整连接矩阵。 */ $getConcatenatedMatrixAt(root: DisplayObject, matrix: Matrix): void; /** * @private * 更新renderNode */ $updateRenderNode(): void; /** * @private */ $hitTest(stageX: number, stageY: number): DisplayObject; /** * Calculate the display object to determine whether it overlaps or crosses with the points specified by the x and y parameters. The x and y parameters specify the points in the coordinates of the stage, rather than the points in the display object container that contains display objects (except the situation where the display object container is a stage). * Note: Don't use accurate pixel collision detection on a large number of objects. Otherwise, this will cause serious performance deterioration. * @param x {number} x coordinate of the object to be tested. * @param y {number} y coordinate of the object to be tested. * @param shapeFlag {boolean} Whether to check the actual pixel of object (true) or check that of border (false).Write realized. * @returns {boolean} If display object overlaps or crosses with the specified point, it is true; otherwise, it is false. * @version Egret 2.4 * @platform Web,Native * @language en_US */ /** * 计算显示对象，以确定它是否与 x 和 y 参数指定的点重叠或相交。x 和 y 参数指定舞台的坐标空间中的点，而不是包含显示对象的显示对象容器中的点（除非显示对象容器是舞台）。 * 注意，不要在大量物体中使用精确碰撞像素检测，这回带来巨大的性能开销 * @param x {number} 要测试的此对象的 x 坐标。 * @param y {number} 要测试的此对象的 y 坐标。 * @param shapeFlag {boolean} 是检查对象 (true) 的实际像素，还是检查边框 (false) 的实际像素。 * @returns {boolean} 如果显示对象与指定的点重叠或相交，则为 true；否则为 false。 * @version Egret 2.4 * @platform Web,Native * @language zh_CN */ hitTestPoint(x: number, y: number, shapeFlag?: boolean): boolean; /** * @private */ static $enterFrameCallBackList: DisplayObject[]; /** * @private */ static $renderCallBackList: DisplayObject[]; /** * @private */ $addListener(type: string, listener: Function, thisObject: any, useCapture?: boolean, priority?: number, dispatchOnce?: boolean): void; /** * @inheritDoc * @version Egret 2.4 * @platform Web,Native */ removeEventListener(type: string, listener: Function, thisObject: any, useCapture?: boolean): void; /** * @inheritDoc * @version Egret 2.4 * @platform Web,Native */ dispatchEvent(event: Event): boolean; /** * @private * 获取事件流列表。注意：Egret框架的事件流与Flash实现并不一致。 * * 事件流有三个阶段：捕获，目标，冒泡。 * Flash里默认的的事件监听若不开启useCapture将监听目标和冒泡阶段。若开始capture将只能监听捕获当不包括目标的事件。 * 可以在Flash中写一个简单的测试：实例化一个非容器显示对象，例如TextField。分别监听useCapture为true和false时的鼠标事件。 * 点击后将只有useCapture为false的回调函数输出信息。也就带来一个问题「Flash的捕获阶段不能监听到最内层对象本身，只在父级列表有效」。 * * 而HTML里的事件流设置useCapture为true时是能监听到目标阶段的，也就是目标阶段会被触发两次，在捕获和冒泡过程各触发一次。这样可以避免 * 前面提到的监听捕获无法监听目标本身的问题。 * * Egret最终采用了HTML里目标节点触发两次的事件流方式。 */ $getPropagationList(target: DisplayObject): DisplayObject[]; /** * @private */ $dispatchPropagationEvent(event: Event, list: DisplayObject[], targetIndex: number): void; /** * @inheritDoc * @version Egret 2.4 * @platform Web,Native */ willTrigger(type: string): boolean; } } declare namespace egret { /** * @private * @version Egret 2.4 * @platform Web,Native */ class Filter extends HashObject { /** * @version Egret 2.4 * @platform Web,Native */ type: string; /** * @private */ $uniforms: any; constructor(); /** * @private */ $toJson(): string; } } declare namespace egret { /** * The DisplayObjectContainer class is a basic display list building block: a display list node that can contain children. * @version Egret 2.4 * @platform Web,Native * @includeExample egret/display/DisplayObjectContainer.ts * @language en_US */ /** * DisplayObjectContainer 类是基本显示列表构造块：一个可包含子项的显示列表节点。 * @version Egret 2.4 * @platform Web,Native * @includeExample egret/display/DisplayObjectContainer.ts * @language zh_CN */ class DisplayObjectContainer extends DisplayObject { /** * @private */ static $EVENT_ADD_TO_STAGE_LIST: DisplayObject[];