ISprite

ISprite 精灵

构造函数 Constructor

构造函数 Constructor	说明 Description	备注 Note
ISprite(bitmap,viewport)	bitmap(Image)位图对象 viewport(IViewport) 精灵所在视窗，可缺省	无
ISprite(bcof,viewport)	bcof(IBCof)位图裁剪对象 viewport(IViewport) 精灵所在视窗，可缺省	无
ISprite(width,height,color)	width精灵宽 height 精灵高 color 精灵颜色	无

属性

属性	说明 Description	备注 Note
x(Number)	x坐标	无
y(Number)	y坐标	无
z(Number)	图层	无
zoomX(Number)	x轴缩放率	无
zoomY(Number)	y轴缩放率	无
opacity(Number)	不透明度 0~1	无
visible(bool)	是否可见	无
actionList(array)	动作列表	无
actionLoop(bool)	是否循环执行动作	无
tag(any)	tag对象	无
angle(Number)	旋转角度0~360	无
mirror(bool)	是否镜像	无
color(IColor)	遮罩颜色	无
width(Number)	宽度	无
height(Number)	高度	无
viewport(IViewport)	所属视窗	无
tiling(bool)	是否开启循环贴图	开启后获得宽高将会为Rwidth、Rheight
RWidth(Number)	设置循环贴图精灵宽度，tiling为true有效	无
RHeight(Number)	设置循环贴图精灵高度，tiling为true有效	无
yy(Number)	圆心x 取值范围0~1	无
yx(Number)	圆心y 取值范围0~1	无
speedX(Number)	x方向速度	无
speedY(Number)	y方向速度	无
aSpeedX(Number)	x方向加速度	无
aSpeedY(Number)	y方向加速度	无
onload(function)	精灵读取完毕回调	无
blendType(number)	精灵色彩混合模式值为0 正常模式值为1 加法混合值为2 减法混合	此属性在web端无效

函数

函数	说明 Description	备注 Note
endAction()	清空动作列表	无
isAnim()	是否有动画在执行	无
pauseAnim()	在当前情况下停止动画	无
pause()	暂停动画	无
restart()	重开动画	无
isPause()	是否暂停动画	无
stopAnim()	在目标位置处停止动画	无
fade(bo,eo,frame)	设置按钮淡入淡出动画 Fade in and out of the button bo(Number) 起始不透明度 initial opacity eo(Number) 结束不透明度 end opacity	无
fadeTo(o, frame)	设置按钮从当前不透明度起的淡入淡出动画 Fade in and out of the button from the current opacity o(Number) 目标不透明度 target opacity frame(Number)帧数 frame rate	无
slide(bx, by,ex,ey, frame)	设置按钮位移动画 Set coordinates to make the button move bx(Number) 起始x坐标 initial x by(Number) 起始y坐标 initial y ex(Number) 目标x坐标 target x ey(Number) 目标y坐标 target y frame(Number) 所需帧数 frame rate	无
slideTo( x, y, frame)	设置按钮从当前位置到目标位置的移动动画 Set coordinates to make the button move from the current position to the target position x(Number) 目标x坐标 target x y(Number) 目标y坐标 target y frame(Number) 所需帧数 frame rate	无
scale( bzx, bzy,ezx,ezy, frame)	设置按钮缩放动画 Set the scaling rate to zoom button bzx(Number) 起始x轴缩放率 initial scaling rate of x bzy(Number) 起始y轴缩放率 initial scaling rate of y ezx(Number) 目标x轴缩放率 target scaling rate of x ezy(Number) 目标y轴缩放率 target scaling rate of y frame(Number) 帧率 frame rate	无
scaleTo( zx, zy, frame)	设置按钮从当前缩放率到目标缩放率的动画 Set the scaling rate from current to target to zoom the button zx(Number) 目标x轴缩放率 target scaling rate of x zy(Number) 目标y轴缩放率 target scaling rate of y frame(Number) 帧率 frame rate	无
startRotate(speed)	设置循环旋转 speed(Number)旋转速度	无
stopRotate()	停止循环旋转	无
rotate(bAngle, eAngle, frames)	设置从起始值到结束值的旋转动画 bAngle(Number) 起始角度 eAngle(Number) 结束角度 frames 帧数	无
rotateTo(eAngle, frames)	设置从当前值到结束值的旋转动画 eAngle(Number) 结束角度 frames 帧数	无
flash(color, frames)	闪烁 color(Icolor) 闪烁颜色 frames(Number) 帧数	无
addAction(action,args)	设置action动作 action action枚举 args 对应参数	无
setOnEndSlide(e)	设置位移动画结束后的回调 e(function) 回调函数	无
setOnEndFade(e)	设置淡入淡出动画结束后的回调 e(function) 回调函数	无
setOnEndScale(e)	设置缩放动画结束后的回调 e(function) 回调函数	无
setOnEndRotae(e)	设置旋转动画结束后的回调 e(function) 回调函数	无
setOnEndFlash(e)	设置闪烁动画结束后的回调 e(function) 回调函数	无
setOnEndActionOne(e)	设置Action队列每完成一条后的回调 e(function) 回调函数	无
setOnEndAction(e)	设置Action动画队列全部执行完后的回调 e(function) 回调函数	无
setOnEndWait(e)	设置等待结束后的回调 e(function) 回调函数	无
clearBitmap()	清理精灵绑定位图的全部内容	无
setXY(x,y)	设置x,y坐标 x(Number) x坐标 y(Number) y坐标	无
isSelect(x,y)	在x,y点精灵是否被选中 x(Number) 要判定的x点 y(Number) 要判定的y点	无
isSelected()	精灵是否被鼠标/触摸选到	无
isSelectTouch()	精灵是否在多点触控的情况被选择到	无
drawRect(rect,color)	绘制矩形 rect(IRect)绘制的矩形对象 color(IColor) 填充颜色	无
drawTextQ(str,x,y,color,size)	绘制文字（高效） str(string) 要绘制的文字 x(Number) 相对于精灵的x坐标 y(Number) 相对于精灵y坐标	无
drawText(str,x,y,type,wcolor,isAutoL,lineSize)	绘制文字（支持转译） str(string) 要绘制的文字 x(Number) 相对于精灵的x坐标 y(Number) 相对于精灵y坐标 type(Number) 效果模式，0无效果，1投影，2描边	无
drawBitmap(bmp,x,y,isDispose)	绘制位图 bmp(Image) 要绘制的位图对象 x(Number) 相对于精灵的x坐标 y(Number) 相对于精灵的y坐标 isDispose(bool) 绘制完毕后是否释放bmp对象	无
drawBitmapRect(bmp,rect,isDispose)	将位图绘制到指定的rect区域 bmp(Image) 要绘制的位图对象 rect(IRect) 绘制区域，坐标相对于精灵 isDispose(bool) 绘制完毕后是否释放bmp对象	无
drawBitmapBCof(x,y,bcof,isDispose)	绘制裁剪位图对象 x(Number) 相对于精灵的x坐标 y(Number) 相对于精灵的y坐标 bcof(BCof) 要绘制的裁剪位图对象 isDispose(bool) 绘制完毕后释放 bcof对象	无
getBitmap()	获得绑定在精灵上的位图对象返回值 Image	无
dispose()	释放精灵对象	无
disposeMin()	释放精灵索引，不释放精灵绑定的位图对象	无
disposeBitmap()	释放精灵上绑定的位图对象，不释放精灵索引	无
setBCof(bcof)	为精灵设置剪切位图 bcof(BCof)	无
getBCof()	获得精灵上设置的剪切位图对象	无
setBitmap(bitmap)	为精灵重新绑定位图对象	无
GetRect()	获得精灵的矩形对象返回值 IRect	无
update()	精灵刷新	此函数不用写在状态机中
GetPolygonRect()	获得以IPolygon对象形式的多边形矩形返回值：IPolygon得到的多边形	无
drawLine(line,color,lineWidth)	绘制线段 line(ILine):要绘制的ILine对象 color(IColor):绘制线段的颜色 lineWidth(number):线段的宽度	无
drawPolygon(polygon,color1,color2,lineWidth)	绘制多边形 polygon(IPolygon):要绘制的多边形 color1：绘制多边形的填充颜色 color2:绘制多边形的描边颜色 lineWidth:描边宽度	无

附录·AddAction参数与对应函数（AddAction 可以让动画按顺序执行，而不是同时执行）

action参数	args参数	等同于函数
action.fade	Number,Number,Number	fade(bo,eo,frame)
action.fade	Number,Number	fadeTo(o,frame)
action.move	Number,Number,Number,Number,Number	slide(bx,by,ex,ey, frame)
action.move	Number,Number,Number	slideTo(x, y, frame)
action.zoom	Number,Number,Number,Number,Number	scale(bzx, bzy,ezx,ezy, frame)
action.zoom	Number,Number,Number	scaleTo(zx, zy, frame)
action.rotate	Number,Number,Number	rotate(bAngle,eAngle, frames)
action.rotate	Number,Number	rotateTo(eAngle,frames)
action.wait	Number	/

附录：drawText 转译

转译符	功能	范例
\n	转行	\n
\c[r,g,b]	更换颜色为r,g,b	\c[255,0,0]
\s[size]	更换尺寸为size	\s[20]
\b[path]	在文字绘制位置绘制一张位图	\b[Graphics/Icon/buff_1.png]