画布

qg.createCanvas()

创建一个画布对象。首次调用创建的是显示在屏幕上的画布，之后调用创建的都是离屏画布。

返回值 Canvas

画布对象

属性

Number width

画布的宽度

Number height

画布的高度

方法

Canvas.getContext(String contextType, Object contextAttributes)

获取画布对象的绘图上下文

参数

String contextType

上下文类型

Object contextAttributes

webgl 上下文属性，仅当 contextType 为 webgl 时有效

返回值 RenderingContext

画布对象的绘图上下文。

• 通过 Canvas.getContext('2d') 接口可以获取 CanvasRenderingContext2D 对象，实现了 HTML Canvas 2D Context 定义的大部分属性、方法。
• 通过 Canvas.getContext('webgl') 接口可以获取 WebGLRenderingContext 对象，实现了 WebGL 1.0 定义的所有属性、方法、常量。

2d 接口支持情况

Android 不支持的 2d 属性和接口

• globalCompositeOperation 不支持以下值： source-in source-out destination-atop lighter copy。如果使用，不会报错，但是将得到与预期不符的结果。
• isPointInPath

WebGL 接口支持情况

压缩纹理的支持

• Android 支持 etc1 格式

Canvas.toDataURL()

把画布上的绘制内容以一个 data URI 的格式返回

返回值 String

data URI 格式的字符串

Canvas.toTempFilePath(Object object)

将当前 Canvas 保存为一个临时文件。

fileType（目标文件的类型）

object.success(Object res) 回调函数

示例代码

canvas.toTempFilePath({
  x: 10,
  y: 10,
  width: 200,
  height: 150,
  destWidth: 400,
  destHeight: 300,
  success: res => {
    qg.shareAppMessage({
      imageUrl: res.tempFilePath
    });
  }
});

Canvas.toTempFilePathSync(Object object)

Canvas.toTempFilePath 的同步版本

fileType（目标文件的类型）

返回值 String tempFilePath

canvas 生成的临时文件路径 (本地路径)

示例代码

let tempFilePath = canvas.toTempFilePathSync({
  x: 10,
  y: 10,
  width: 200,
  height: 150,
  destWidth: 400,
  destHeight: 300
});
qg.shareAppMessage({
  imageUrl: tempFilePath
});