annie.Shape Class
矢量对象
Item Index
Methods
- _updateSplitBounds
- addDraw
- addEventListener
- addSound
- arcTo
- beginBitmapFill
- beginBitmapStroke
- beginFill
- beginLinearGradientFill
- beginLinearGradientStroke
- beginRadialGradientFill
- beginRadialGradientStroke
- beginStroke
- bezierCurveTo
- Bitmap
- changeColor
- clear
- clearCustomTransform
- closePath
- decodePath
- destroy
- dispatchEvent
- DisplayObject
- drawArc
- drawCircle
- drawEllipse
- drawRect
- drawRoundRect
- endFill
- endStroke
- getBitmapStyle static
- getDrawRect
- getGradientColor static
- getRGBA static
- getSound
- getWH
- globalToLocal
- hasEventListener
- hitTestPoint
- lineTo
- localToGlobal
- moveTo
- quadraticCurveTo
- removeAllEventListener
- removeEventListener
- removeSound
- setLineDash
- startDrag
- stopAllSounds
- stopDrag
Properties
Methods
_updateSplitBounds
()
private
更新boundsList矩阵
addDraw
-
commandName
-
params
添加一条绘画指令,具体可以查阅Html Canvas画图方法
Returns:
addEventListener
-
type
-
listener
-
useCapture
给对象添加一个侦听
Parameters:
Returns:
Example:
this.addEventListener(annie.Event.ADD_TO_STAGE,function(e){console.log(this);}.bind(this));
addSound
-
sound
返回一个id,这个id你要留着作为删除他时使用。 这个声音会根据这个显示对象添加到舞台时播放,移出舞台而关闭
Parameters:
-
sound
annie.Sound
Returns:
arcTo
-
x
-
y
从上一点画弧到某一点,如果没有设置上一点,则上一点默认为(0,0)
Returns:
beginBitmapFill
-
image
-
matrix
位图填充 一般给Annie2x用
Parameters:
-
image
Image -
matrix
Array
Returns:
beginBitmapStroke
-
image
-
matrix
-
lineWidth
-
cap
-
join
-
miter
线条位图填充 一般给Annie2x用
Parameters:
Returns:
beginFill
-
color
开始绘画填充,如果想画的东西有颜色填充,一定要从此方法开始
Parameters:
-
color
String颜色值 单色和RGBA格式
Returns:
beginLinearGradientFill
-
points
-
colors
线性渐变填充 一般给Annie2x用
Returns:
Example:
var shape=new annie.Shape();
shape.beginLinearGradientFill([0,0,200,0],[[0,"#ff0000",1],[0.164706,"#ffff00",1],[0.364706,"#00ff00",1],[0.498039,"#00ffff",1],[0.666667,"#0000ff",1],[0.831373,"#ff00ff",1],[1,"#ff0000",1]]);
shape.drawRect(0,0,200,200);
shape.endFill();
s.addChild(shape);
beginLinearGradientStroke
-
points
-
colors
-
lineWidth
-
cap
-
join
-
miter
画线性渐变的线条 一般给Annie2x用
Parameters:
Returns:
beginRadialGradientFill
-
points
-
colors
-
matrixDate
径向渐变填充 一般给Annie2x用
Returns:
Example:
var shape=new annie.Shape();
shape.beginRadialGradientFill([100,100,100,100,100],[[0,"#00ff00",1],[1,"#000000",1]]);
shape.drawRect(0,0,200,200);
shape.endFill();
s.addChild(shape);
beginRadialGradientStroke
-
points
-
colors
-
lineWidth
-
cap
-
join
-
miter
画径向渐变的线条 一般给Annie2x用
Parameters:
Returns:
beginStroke
-
color
-
lineWidth
-
cap
-
join
-
miter
给线条着色
Parameters:
Returns:
bezierCurveTo
-
cp1X
-
cp1Y
-
cp2X
-
cp2Y
-
x
-
y
三次贝赛尔曲线 从上一点画二次贝赛尔曲线到某一点,如果没有设置上一点,则上一占默认为(0,0)
Parameters:
Returns:
Bitmap
-
bitmapData
-
rect
Parameters:
-
bitmapData
Image | Video | Canvas一个HTMl Image的实例,小程序或者小游戏里则只能是一个图片的地址 -
rect
annie.Rectangle设置显示Image的区域,不设置值则全部显示Image的内容,小程序或者小游戏里没有这个参数
Example:
//html5
var imgEle=new Image();
imgEle.onload=function (e) {
var bitmap = new annie.Bitmap(imgEle)
//居中对齐
bitmap.x = (s.stage.desWidth - bitmap.width) / 2;
bitmap.y = (s.stage.desHeight - bitmap.height) / 2;
s.addChild(bitmap);
//截取图片的某一部分显示
var rect = new annie.Rectangle(0, 0, 200, 200),
rectBitmap = new annie.Bitmap(imgEle, rect);
rectBitmap.x = (s.stage.desWidth - bitmap.width) / 2;
rectBitmap.y = 100;
s.addChild(rectBitmap);
}
imgEle.src='http://test.annie2x.com/test.jpg';
//小程序或者小游戏
var imgEle="http://test.annie2x.com/test.jpg";
var bitmap=new annie.Bitmap(imgEle);
s.addChild(bitmap);
changeColor
-
infoObj
如果有的话,改变矢量对象的边框或者填充的颜色.
Parameters:
Returns:
clear
()
Void
public
清除掉之前所有绘画的东西
Returns:
clearCustomTransform
-
transId
如果你在mc更改了对象的x y scale rotation alpha,最后想还原,不再需要自我控制,可以调用这方法
Parameters:
-
transId
Number//0->x,1->y,2->scaleX,3->scaleY,4->rotation,5->alpha,-1->all
closePath
()
Void
public
闭合一个绘画路径
Returns:
destroy
()
Void
public
销毁一个对象 销毁之前一定要做完其他善后工作,否则有可能会出错 特别注意不能在对象自身方法或事件里调用此方法。 比如,不要在显示对象自身的 annie.Event.ON_REMOVE_TO_STAGE 或者其他类似事件调用,一定会报错
Returns:
dispatchEvent
-
event
-
data
-
useCapture
广播侦听
Parameters:
-
event
annie.Event | String广播所带的事件对象,如果传的是字符串则自动生成一个annie.Event对象,事件类型就是传入进来的字符串的值
-
data
Object广播后跟着事件一起传过去的其他任信息,默认值为null
-
useCapture
Booleantrue 捕获阶段 false 冒泡阶段 默认 true
Returns:
如果有收听者则返回true
Example:
var mySprite=new annie.Sprite(),
yourEvent=new annie.Event("yourCustomerEvent");
yourEvent.data={a:1,b:2,c:"hello",d:{aa:1,bb:2}};
mySprite.addEventListener("yourCustomerEvent",function(e){
console.log(e.data);
})
mySprite.dispatchEvent(yourEvent);
DisplayObject
()
public
drawArc
-
x
-
y
-
radius
-
start
-
end
画一个弧形
Returns:
drawCircle
-
x
-
y
-
radius
画一个圆
Returns:
drawEllipse
-
x
-
y
-
w
-
h
画一个椭圆
Returns:
drawRect
-
x
-
y
-
w
-
h
画一个矩形
Returns:
drawRoundRect
-
x
-
y
-
w
-
h
-
rTL
-
rTR
-
rBL
-
rBR
画一个带圆角的矩形
Parameters:
Returns:
endFill
()
Void
public
结束填充
Returns:
endStroke
()
Void
public
结束画线
Returns:
getBitmapStyle
-
image
设置位图填充时需要使用的方法,一般给用户使用较少,Annie2x工具自动使用
Parameters:
-
image
ImageHTML Image元素
Returns:
getGradientColor
-
points
-
colors
通过一系统参数获取生成颜色或渐变所需要的对象 一般给用户使用较少,Annie2x工具自动使用
Returns:
getWH
()
W: number; h: number
获取宽高
Returns:
}
hitTestPoint
-
hitPoint
-
isGlobalPoint
点击碰撞测试,就是舞台上的一个point是否在显示对象内,在则返回该对象,不在则返回null
Parameters:
-
hitPoint
annie.Point要检测碰撞的点
-
isGlobalPoint
Boolean是不是全局坐标的点,默认false是本地坐标
Returns:
lineTo
-
x
-
y
从上一点画到某一点,如果没有设置上一点,则上一点默认为(0,0)
Returns:
quadraticCurveTo
-
cpX
-
cpX
-
x
-
y
二次贝赛尔曲线 从上一点画二次贝赛尔曲线到某一点,如果没有设置上一点,则上一占默认为(0,0)
Returns:
removeAllEventListener
()
Void
public
移除对象中所有的侦听
Returns:
removeEventListener
-
type
-
listener
-
useCapture
移除对应类型的侦听
Parameters:
Returns:
setLineDash
-
data
设置虚线参数
Parameters:
-
data
Array一个长度为2的数组,第1个是虚线长度,第2个是虚线间隔,如果此参数为[]的空数组,则是清除虚线。 如[5,20]是画虚线,[]则是请除虚线,变为实线
Returns:
startDrag
-
isCenter
-
bounds
启动鼠标或者触摸拖动
Parameters:
-
isCenter
Boolean指定将可拖动的对象锁定到指针位置中心 (true),还是锁定到用户第一次单击该对象的位置 (false) 默认false
-
bounds
annie.Rectangle相对于显示对象父级的坐标的值,用于指定 Sprite 约束矩形
Returns:
stopAllSounds
()
Void
public
停止这个显示对象上的所有声音
Returns:
stopDrag
()
停止鼠标跟随
Properties
bitmapData
Any
public
小游戏不支持 小程序不支持
HTML的一个Image对象或者是canvas对象或者是video对象Default: null
cacheAsBitmap
Unknown
是否将这个对象缓存为位图了
height
Unknown
public
获取或者设置显示对象在父级里的y方向的高,不到必要不要用此属性获取高 如果你要同时获取宽高,建议使用getWH()方法获取宽和高
hitArea
Unknown
annie.Sprite显示容器的接受鼠标点击的区域。一但设置,容器里所有子级将不会触发任何鼠标相关的事件。 相当于 mouseChildren=false,但在有大量子级显示对象的情况下,此方法的性能搞出mouseChildren几个数量级,建议使用。
Sub-properties:
-
rect
annie.Rectangle
instanceId
Number
public
每一个annie引擎对象都会有一个唯一的id码。
Example:
//获取 annie引擎类对象唯一码
console.log(this.instanceId);
name
String
public
每一个显示对象都可以给他命一个名字,这样我们在查找子级的时候就可以直接用this.getChildrndByName("name")获取到这个对象的引用
Default: ""
stage
Stage
public
此显示对象所在的舞台对象,如果此对象没有被添加到显示对象列表中,此对象为空。
Default: null;
width
Unknown
public
获取或者设置显示对象在父级里的x方向的宽,不到必要不要用此属性获取高 如果你要同时获取宽高,建议使用 getWH()方法获取宽和高
Events
ADD_TO_STAGE
annie.DisplayObject显示对象加入到舞台事件
ENTER_FRAME
annie.DisplayObject显示对象 循环帧事件
MOUSE_DOWN
annie.DisplayObject鼠标或者手指按下事件
MOUSE_MOVE
annie.DisplayObject鼠标或者手指移动事件
MOUSE_OUT
annie.DisplayObject鼠标或者手指移出显示对象边界触发的事件
MOUSE_OVER
annie.DisplayObject鼠标或者手指移入到显示对象上里触发的事件
MOUSE_UP
annie.DisplayObject鼠标或者手指抬起事件
REMOVE_TO_STAGE
annie.DisplayObject显示对象从舞台移出事件