文档手册

class Graphics.Image

2024-07-18 12:35:43

类 Graphics.Image

 表示图像。

Properties:

src

图像的只读、字符串、URL。

width

只读、整数、宽度。

height

只读、整数、高度。

size

 只读, 大小

packaging

只读、字符串、“png”、“webp”等。

constructor:

new Graphics.Image(width, height, painter(graphics) [,initColor]);

通过在位图上呈现任意绘图来构造新图像。

 参数:

  • width, height - 图像的长度、尺寸;

  • painter - 函数(图形),绘图功能来生成其内容。

  • initColor - 颜色,用于初始化位图位的初始颜色。

注意

创建图像的物理像素大小取决于当前的屏幕分辨率。如果需要精确像素大小的图像,请使用 ppx 长度单位:

new Graphics.Image(10ppx, 10ppx, ... ); // or
new Graphics.Image(Length.ppx(x), Length.ppx(y), ... );
注意

绘制器中图形的分辨率设置为 1 位图像素。

new Graphics.Image(width, height, element [,initColor])

通过在位图上呈现 DOM 元素来创建 new Image。

 参数:

  • width, height - 图像的长度、尺寸;

  • element - 要渲染的元素;

  • initColor - 颜色,用于初始化位图位的初始颜色。

Methods:

update()

image.update(painter(graphics)[,initColor])

通过在图像表面绘制来更新位图。

toBytes()

image.toBytes(packaging [,compression:int]) : ArrayBuffer

 参数:

  • packaging - 字符串,是 “png”,“jpeg”,“webp”,“bgra” 之一。

  • 压缩 - 整数,0 ...100,压缩系数(用于 JPEG)。

colorAt()

image.colorAt(x,y): Color | null

返回像素在 x/y 处的颜色。

compose()

image.compose(src, op, [dstx,dsty[,srcx,srcy,srcw,srch]]): Image

使用 src 映像撰写此映像,参数:

  • src - 要合成的图像;

  • op,字符串,组合方法,是以下之一: “src-over”, “dst-over”, “src-in”, “dst-in”, “src-out”, “dst-out”, “src-atop”, “dst-atop”, “xor”, “copy”。

 返回合成图像。

Static methods:

fromBytes()

Graphics.Image.fromBytes( data: ArrayBuffer ) : Image

从字节(PNG,JPEG等)构造图像。在发生故障时引发错误

load()

async Graphics.Image.load( url: string | request : Request [, sync: bool = false] ) : Promise(Image) | Image | null

 从 URL 加载图像。 注意

  • 如果 sync 为 false,则它是一个异步函数(返回 promise),因此需要 await 'ed.

  • 如果 sync 为 true,则为同步操作 - 返回 Image 实例或 null。

注意

此方法允许取消加载请求,请参阅 Fetch。