sciter图像对象方法

图像(Image)对象

图像(图片)。

常量

属性

方法

N/A

url

- string, 该图像的来源url。

width

- integer, pixels,图像的宽度。只读属性。

height

- integer, pixels, 图像的高度。只读属性。

this

( elementWidth:integer, elementHeight:integer, [imageWidth:integer, imageHeight:integer] [, clearBy: color], elem: Element  )  或者

( imageWidth:integer, imageHeight:integer [, clearBy: color], renderer: function  )

第一种格式的构造方法创建一个新的Image对象并且按照指定的elementWidth/Height渲染elem到它上。如果提供了imageWidth/Height参数，则函数将会尝试缩放元素到该指定宽高盒中。

第二种格式的构造方法创建一个新的Image对象并且调用function renderer(gfx:Graphics)函数，该函数将该图像的边界绘图对象作为函数的参数。

clearBy可选参数定义位图的初始化颜色。默认的图像初始化为argb(0,0,0,0)颜色。

destroy

()

销毁底层的本地位图。该方法用于在它不在需要时强制Image对象释放它的位图(可能是相当大的)。

toBytes

( [compressionLevel:integer]  ) : Bytes

保存图像的图像的内容为一个可被使用的字节向量，比如可以上传到服务器上。

compressionLevel是10..100中的一个值 - JPEG压缩层级。如果它被省略或者为0则该图像会保存为PNG编码。

fromBytes

( bytes : Bytes ) : Image

静态方法, 从字节流中构建图像。bytes可以包含任何支持的图像格式: PNG、JPEG等。

size

( )

该方法返回宽度、高度对，使用示例:
var (w,h) = img.size();

colorAt

( x: integer, y: integer [, c: color] ) : color

该方法返回图像在x,y点的像素颜色。如果c参数提供了，则会将x,y点的像素颜色替换为c颜色。

alphaMask

( mask: Image [, #luminance | #r | #g | #b | #a ] )

该方法允许从其他图像设置该图像的alpha通道。默认情况下，第二个参数不提供。#luminance - 使用掩码图像的亮度值作为该图像对应位置像素的alpha值。 #r、#g、#b、#a - 使用掩码图像的红、绿、蓝或alpha通道值作为该图像的alpha值。

compose

( src: Image , compositionOp, [dstX,dstY, [srcX,srcY,srcW, srcH ]]] ) : this image

这个方法可以合并两个images: this (dst) 和 src Image。

compositionOp是以下可选的合并操作: #src-over, #dst-over, #src-in, #dst-in, #src-out, #dst-out, #src-atop, #dst-atop, #xor, #copy。

update

( renderer: function [, clearBy: color ])

这个方法允许在一个已存在image上做渲染操作，通过function renderer(gfx:Graphics)回调函数的graphics对象参数来实现渲染。如果提供了clearBy参数，且是一个颜色值，则在渲染前将使用该颜色擦除图像。