AnnieJS API Docs for: 1.1.3
show:

annie.Shape Class

Extends annie.DisplayObject
Defined in: libs/Shape.js:16
Module: annie

Available since 1.0.0

矢量对象

Methods

_changeMouseCount

(
  • type
  • isAdd
)
private

Inherited from annie.EventDispatcher: libs/EventDispatcher.js:135

Available since 1.0.0

增加或删除相应mouse或touch侦听记数

Parameters:

_onDispatchBubbledEvent

(
  • type
  • updateMc
)
private

Inherited from annie.DisplayObject: libs/DisplayObject.js:668

Available since 1.0.0

调用些方法会冒泡的将事件向显示列表下方传递

Parameters:

  • type String
  • updateMc Boolean

    是否更新movieClip时间轴信息

addDraw

(
  • commandName
  • params
)
public

Defined in libs/Shape.js:197

Available since 1.0.0

添加一条绘画指令,具体可以查阅Html Canvas画图方法

Parameters:

  • commandName String

    ctx指令的方法名 如moveTo lineTo arcTo等

  • params Array

addEventListener

(
  • type
  • listener
)
public

Inherited from annie.EventDispatcher: libs/EventDispatcher.js:107

Available since 1.0.0

给对象添加一个侦听

Parameters:

  • type String

    侦听类形

  • listener Function

    侦听后的回调方法,如果这个方法是类实例的方法,为了this引用的正确性,请在方法参数后加上.bind(this);

Example:

 this.addEventListener(annie.Event.ADD_TO_STAGE,function(e){trace(this);}.bind(this));

arcTo

(
  • x
  • y
)
public

Defined in libs/Shape.js:288

Available since 1.0.0

从上一点画弧到某一点,如果没有设置上一点，则上一占默认为(0,0)

Parameters:

beginBitmapFill

(
  • image
  • matrix
)
public

Defined in libs/Shape.js:449

Available since 1.0.0

位图填充 一般给Flash2x用

Parameters:

beginBitmapStroke

(
  • image
  • matrix
  • lineWidth
  • cap
  • join
  • miter
)
public

Defined in libs/Shape.js:505

Available since 1.0.0

线条位图填充 一般给Flash2x用

Parameters:

  • image Image
  • matrix annie.Matrix
  • lineWidth Number
  • cap String

    线头的形状 butt round square 默认 butt

  • join String

    线与线之间的交接处形状 bevel round miter 默认miter

  • miter Number

    正数,规定最大斜接长度,如果斜接长度超过 miterLimit 的值，边角会以 lineJoin 的 "bevel" 类型来显示 默认10

beginFill

(
  • color
)
public

Defined in libs/Shape.js:426

Available since 1.0.0

开始绘画填充,如果想画的东西有颜色填充,一定要从此方法开始

Parameters:

  • color String

    颜色值 单色和RGBA格式

beginLinearGradientFill

(
  • colors
  • ratios
  • points
  • matrixDate
)
public

Defined in libs/Shape.js:436

Available since 1.0.0

线性渐变填充 一般给Flash2x用

Parameters:

  • colors Array

    一组颜色值

  • ratios Array

    一组范围比例值

  • points Array

    一组点

  • matrixDate Object

    如果渐变填充有矩阵变形信息

beginLinearGradientStroke

(
  • colors
  • ratios
  • points
  • lineWidth
  • cap
  • join
  • miter
)
public

Defined in libs/Shape.js:485

Available since 1.0.0

画线性渐变的线条 一般给Flash2x用

Parameters:

  • colors Array

    一组颜色值

  • ratios Array

    一组范围比例值

  • points Array

    一组点

  • lineWidth Number
  • cap String

    线头的形状 butt round square 默认 butt

  • join String

    线与线之间的交接处形状 bevel round miter 默认miter

  • miter Number

    正数,规定最大斜接长度,如果斜接长度超过 miterLimit 的值，边角会以 lineJoin 的 "bevel" 类型来显示 默认10

beginRadialGradientFill

(
  • colors
  • ratios
  • points
  • matrixDate
)
public

Defined in libs/Shape.js:44

Available since 1.0.0

径向渐变填充 一般给Flash2x用

Parameters:

  • colors Array

    一组颜色值

  • ratios Array

    一组范围比例值

  • points Array

    一组点

  • matrixDate Object

    如果渐变填充有矩阵变形信息

beginRadialGradientStroke

(
  • colors
  • ratios
  • points
  • lineWidth
  • cap
  • join
  • miter
)
public

Defined in libs/Shape.js:57

Available since 1.0.0

画径向渐变的线条 一般给Flash2x用

Parameters:

  • colors Array

    一组颜色值

  • ratios Array

    一组范围比例值

  • points Array

    一组点

  • lineWidth Number
  • cap String

    线头的形状 butt round square 默认 butt

  • join String

    线与线之间的交接处形状 bevel round miter 默认miter

  • miter Number

    正数,规定最大斜接长度,如果斜接长度超过 miterLimit 的值，边角会以 lineJoin 的 "bevel" 类型来显示 默认10

beginStroke

(
  • color
  • lineWidth
)
public

Defined in libs/Shape.js:470

Available since 1.0.0

给线条着色

Parameters:

bezierCurveTo

(
  • cp1X
  • cp1Y
  • cp2X
  • cp2Y
  • x
  • y
)
public

Defined in libs/Shape.js:313

Available since 1.0.0

三次贝赛尔曲线 从上一点画二次贝赛尔曲线到某一点,如果没有设置上一点，则上一占默认为(0,0)

Parameters:

changeColor

(
  • infoObj
)
public

Defined in libs/Shape.js:830

Available since 1.0.2

如果有的话,改变矢量对象的边框或者填充的颜色.

Parameters:

  • infoObj Object
    • fillColor String | Any

      填充颜色值，如"#fff" 或者 "rgba(255,255,255,1)"或者是annie.Shape.getGradientColor()方法返回的渐变对象;

    • strokeColor String

      线条颜色值，如"#fff" 或者 "rgba(255,255,255,1)";

    • lineWidth Number

      线条的粗细，如"1,2,3...";

clear

() public

Defined in libs/Shape.js:407

Available since 1.0.0

清除掉之前所有绘画的东西

closePath

() public

Defined in libs/Shape.js:329

Available since 1.0.0

闭合一个绘画路径

decodePath

(
  • data
)
public

Defined in libs/Shape.js:77

Available since 1.0.0

解析一段路径 一般给Flash2x用

Parameters:

dispatchEvent

(
  • event
  • data
)
Boolean public

Inherited from annie.EventDispatcher: libs/EventDispatcher.js:154

Available since 1.0.0

广播侦听

Parameters:

  • event annie.Event | String

    广播所带的事件对象,如果传的是字符串则直接自动生成一个的事件对象,事件类型就是你传入进来的字符串的值

  • data Object

    广播后跟着事件一起传过去的其他任信息,默认值为null

Returns:

Boolean:

如果有收听者则返回true

Example:

 var mySprite=new annie.Sprite(),
     yourEvent=new annie.Event("yourCustomerEvent");
  yourEvent.data='Flash2x';
  mySprite.addEventListener("yourCustomerEvent",function(e){
     trace(e.data);
   })
  mySprite.dispatchEvent(yourEvent);

DisplayObject

() public

Inherited from annie.DisplayObject: libs/DisplayObject.js:27

Available since 1.0.0

drawArc

(
  • x
  • y
  • radius
  • start
  • end
)
public

Defined in libs/Shape.js:356

Available since 1.0.0

画一个弧形

Parameters:

drawCircle

(
  • x
  • y
  • radius
)
public

Defined in libs/Shape.js:370

Available since 1.0.0

画一个圆

Parameters:

drawEllipse

(
  • x
  • y
  • w
  • h
)
public

Defined in libs/Shape.js:382

Available since 1.0.0

画一个椭圆

Parameters:

drawRect

(
  • x
  • y
  • w
  • h
)
public

Defined in libs/Shape.js:338

Available since 1.0.0

画一个矩形

Parameters:

drawRoundRect

(
  • x
  • y
  • w
  • h
  • rTL
  • rTR
  • rBL
  • rBR
)
public

Defined in libs/Shape.js:210

Available since 1.0.0

画一个带圆角的矩形

Parameters:

endFill

() public

Defined in libs/Shape.js:538

Available since 1.0.0

结束填充

endStroke

() public

Defined in libs/Shape.js:558

Available since 1.0.0

结束画线

getBitmapStyle

(
  • image
)
CanvasPattern public static

Defined in libs/Shape.js:159

Available since 1.0.0

设置位图填充时需要使用的方法,一般给用户使用较少,Flash2x工具自动使用

Parameters:

  • image Image

    HTML Image元素

Returns:

CanvasPattern:

getBounds

() annie.Rectangle public

Inherited from annie.DisplayObject: libs/DisplayObject.js:521

Available since 1.0.0

获取对象的自身的没有任何形变的原始姿态下的原点坐标及宽高,抽像方法

Returns:

annie.Rectangle:

getDrawRect

() annie.Rectangle public

Inherited from annie.DisplayObject: libs/DisplayObject.js:533

Available since 1.0.0

获取对象形变后外切矩形。 可以从这个方法中读取到此显示对象变形后x方向上的宽和y方向上的高

Returns:

annie.Rectangle:

getGradientColor

(
  • colors
  • ratios
  • points
  • matrixDate
)
Any static

Defined in libs/Shape.js:132

Available since 1.0.0

通过一系统参数获取生成颜色或渐变所需要的对象 一般给用户使用较少,Flash2x工具自动使用

Parameters:

Returns:

Any:

getRGBA

(
  • color
  • alpha
)
String public static

Defined in libs/Shape.js:172

Available since 1.0.0

通过24位颜色值和一个透明度值生成RGBA值

Parameters:

  • color String

    字符串的颜色值,如:#33ffee

  • alpha Number

    0-1区间的一个数据 0完全透明 1完全不透明

Returns:

String:

getWH

() Width: number, height: number public

Inherited from annie.DisplayObject: libs/DisplayObject.js:734

Available since 1.0.9

如果需要同时获取宽和高的值，建议使用此方法更有效率

Returns:

Width: number, height: number:

}

globalToLocal

(
  • point
)
annie.Point public

Inherited from annie.DisplayObject: libs/DisplayObject.js:417

Available since 1.0.0

将全局坐标转换到本地坐标值

Parameters:

Returns:

annie.Point:

hasEventListener

(
  • type
)
Boolean public

Inherited from annie.EventDispatcher: libs/EventDispatcher.js:200

Available since 1.0.0

是否有添加过此类形的侦听

Parameters:

Returns:

Boolean:

如果有则返回true

hitTestPoint

(
  • globalPoint
  • isMouseEvent
)
Any public

Inherited from annie.DisplayObject but overwritten in libs/Shape.js:786

Available since 1.0.0

重写hitTestPoint

Parameters:

Returns:

Any:

lineTo

(
  • x
  • y
)
public

Defined in libs/Shape.js:277

Available since 1.0.0

从上一点画到某一点,如果没有设置上一点，则上一点默认为(0,0)

Parameters:

localToGlobal

(
  • point
)
annie.Point public

Inherited from annie.DisplayObject: libs/DisplayObject.js:429

Available since 1.0.0

将本地坐标转换到全局坐标值

Parameters:

Returns:

annie.Point:

moveTo

(
  • x
  • y
)
public

Defined in libs/Shape.js:266

Available since 1.0.0

绘画时移动到某一点

Parameters:

quadraticCurveTo

(
  • cpX
  • cpX
  • x
  • y
)
public

Defined in libs/Shape.js:299

Available since 1.0.0

二次贝赛尔曲线 从上一点画二次贝赛尔曲线到某一点,如果没有设置上一点，则上一占默认为(0,0)

Parameters:

removeAllEventListener

() public

Inherited from annie.EventDispatcher: libs/EventDispatcher.js:237

Available since 1.0.0

移除对象中所有的侦听

removeEventListener

(
  • type
  • listener
)
public

Inherited from annie.EventDispatcher: libs/EventDispatcher.js:214

Available since 1.0.0

移除对应类型的侦听

Parameters:

  • type String

    要移除的侦听类型

  • listener Function

    及侦听时绑定的回调方法

render

(
  • renderObj
)
public

Inherited from annie.DisplayObject: libs/DisplayObject.js:632

Available since 1.0.0

调用此方法将显示对象渲染到屏幕

Parameters:

  • renderObj annie.IRender

startDrag

(
  • isCenter
  • bounds
)
public

Inherited from annie.DisplayObject: libs/DisplayObject.js:448

Available since 1.1.2

启动鼠标或者触摸拖动

Parameters:

  • isCenter Boolean

    指定将可拖动的对象锁定到指针位置中心 (true)，还是锁定到用户第一次单击该对象的位置 (false) 默认false

  • bounds annie.Rectangle

    相对于显圣对象父级的坐标的值，用于指定 Sprite 约束矩形

stopDrag

() public

Inherited from annie.DisplayObject: libs/DisplayObject.js:481

Available since 1.1.2

停止鼠标或者触摸拖动

update

(
  • isDrawUpdate
)
public

Inherited from annie.DisplayObject but overwritten in libs/Shape.js:579

Available since 1.0.0

重写刷新

Parameters:

  • isDrawUpdate Object

    不是因为渲染目的而调用的更新，比如有些时候的强制刷新 默认为true

Properties

_command

Array private

Defined in libs/Shape.js:27

Available since 1.0.0

一个数组，每个元素也是一个数组[类型 0是属性,1是方法,名字 执行的属性或方法名,参数]

Default: []

_enterFrameEvent

annie.Event private

Inherited from annie.DisplayObject: libs/DisplayObject.js:79

Available since 1.0.0

因为每次enterFrame事件时都生成一个Event非常浪费资源,所以做成一个全局的

Default: null

_MECO

Unknown private

Inherited from annie.EventDispatcher: libs/EventDispatcher.js:254

Available since 1.0.0

全局的鼠标事件的监听数对象表

_offsetX

Number protected

Inherited from annie.DisplayObject: libs/DisplayObject.js:165

Available since 1.0.0

Default: 0

_offsetY

Number protected

Inherited from annie.DisplayObject: libs/DisplayObject.js:173

Available since 1.0.0

Default: 0

_texture

Any protected

Inherited from annie.DisplayObject: libs/DisplayObject.js:156

Available since 1.0.0

缓存起来的纹理对象。最后真正送到渲染器去渲染的对象

Default: null

_UI

Unknown

Inherited from annie.DisplayObject: libs/DisplayObject.js:34

更新信息

Sub-properties:

  • UM Object

    是否更新矩阵 UA 是否更新Alpha UF 是否更新滤镜

alpha

Number public

Inherited from annie.DisplayObject: libs/DisplayObject.js:278

Available since 1.0.0

显示对象透明度

Default: 1

anchorX

Number public

Inherited from annie.DisplayObject: libs/DisplayObject.js:332

Available since 1.0.0

显示对象上x方向的缩放或旋转点

Default: 0

anchorY

Number

Inherited from annie.DisplayObject: libs/DisplayObject.js:350

Available since 1.0.0

显示对象上y方向的缩放或旋转点

Default: 0

blendMode

String public

Inherited from annie.DisplayObject: libs/DisplayObject.js:126

Available since 1.0.0

显示对象的混合模式 支持的混合模式大概有

Default: 0

cAlpha

Number private

Inherited from annie.DisplayObject: libs/DisplayObject.js:60

Available since 1.0.0

显示对象在显示列表上的最终表现出来的透明度,此透明度会继承父级的透明度依次相乘得到最终的值

Default: 1

cFilters

Array private

Inherited from annie.DisplayObject: libs/DisplayObject.js:97

Available since 1.0.0

显示对象上对显示列表上的最终的所有滤镜组

Default: []

cMatrix

annie.Matrix private

Inherited from annie.DisplayObject: libs/DisplayObject.js:70

Available since 1.0.0

显示对象上对显示列表上的最终合成的矩阵,此矩阵会继承父级的显示属性依次相乘得到最终的值

Default: null

filters

Array public

Inherited from annie.DisplayObject: libs/DisplayObject.js:400

Available since 1.0.0

显示对象的滤镜数组

Default: null

height

Unknown public

Inherited from annie.DisplayObject: libs/DisplayObject.js:712

Available since 1.0.3

获取或者设置显示对象在父级里的y方向的高,不到必要不要用此属性获取高 如果你要同时获取款高，建议使用getWH()方法获取宽和高

hitTestWidthPixel

Boolean

Defined in libs/Shape.js:36

Available since 1.1.0

是否对矢量使用像素碰撞 默认开启

Default: true

instanceId

Unknown public

Inherited from annie.AObject: libs/EventDispatcher.js:28

Available since 1.0.0

每一个annie引擎对象都会有一个唯一的id码。

Example:

 //获取 annie引擎类对象唯一码
 trace(this.instanceId);

instanceType

Unknown public

Inherited from annie.AObject: libs/EventDispatcher.js:46

Available since 1.0.3

每一个annie类都有一个实例类型字符串，通过这个字符串，你能知道这个实例是从哪个类实例而来

mask

annie.DisplayObject public

Inherited from annie.DisplayObject: libs/DisplayObject.js:137

Available since 1.0.0

显示对象的遮罩, 是一个Shape显示对象或是一个只包含shape显示对象的MovieClip

Default: null

matrix

annie.Matrix public

Inherited from annie.DisplayObject: libs/DisplayObject.js:384

Available since 1.0.0

显示对象的变形矩阵

Default: null

mouseEnable

Boolean public

Inherited from annie.DisplayObject: libs/DisplayObject.js:88

Available since 1.0.0

是否可以接受点击事件,如果设置为false,此显示对象将无法接收到点击事件

Default: false

name

String public

Inherited from annie.DisplayObject: libs/DisplayObject.js:106

Available since 1.0.0

每一个显示对象都可以给他启一个名字,这样我们在查找子级的时候就可以直接用this.getChildrndByName("name")获取到这个对象的引用

Default: ""

parent

annie.Sprite public

Inherited from annie.DisplayObject: libs/DisplayObject.js:50

Available since 1.0.0

显示对象的父级

Default: null

rotation

Number public

Inherited from annie.DisplayObject: libs/DisplayObject.js:260

Available since 1.0.0

显示对象旋转角度

Default: 0

scaleX

Number public

Inherited from annie.DisplayObject: libs/DisplayObject.js:224

Available since 1.0.0

显示对象x方向的缩放值

Default: 1

scaleY

Number public

Inherited from annie.DisplayObject: libs/DisplayObject.js:242

Available since 1.0.0

显示对象y方向的缩放值

Default: 1

skewX

Number public

Inherited from annie.DisplayObject: libs/DisplayObject.js:296

Available since 1.0.0

显示对象x方向的斜切值

Default: 0

skewY

Number public

Inherited from annie.DisplayObject: libs/DisplayObject.js:314

Available since 1.0.0

显示对象y方向的斜切值

Default: 0

stage

Stage public

Inherited from annie.DisplayObject: libs/DisplayObject.js:40

Available since 1.0.0

此显示对象所在的舞台对象,如果此对象没有被添加到显示对象列表中,此对象为空。

Default: null;

visible

Boolean public

Inherited from annie.DisplayObject: libs/DisplayObject.js:368

Available since 1.0.0

显未对象是否可见

Default: 0

width

Unknown public

Inherited from annie.DisplayObject: libs/DisplayObject.js:689

Available since 1.0.3

获取或者设置显示对象在父级里的x方向的宽，不到必要不要用此属性获取高 如果你要同时获取款高，建议使用getWH()方法获取宽和高

x

Number public

Inherited from annie.DisplayObject: libs/DisplayObject.js:187

Available since 1.0.0

显示对象位置x

Default: 0

y

Number public

Inherited from annie.DisplayObject: libs/DisplayObject.js:205

Available since 1.0.0

显示对象位置y

Default: 0