tt.createCanvas 收藏我的收藏
收藏我的收藏
基础库 1.31.0 开始支持本方法,这是一个同步方法。
创建一个画布对象。首次调用创建的是显示在屏幕上的画布,之后调用创建的都是离屏画布。
| 前提条件 | 无 | 
| 业务背景 | 无 | 
| 使用限制 | 无 | 
| 注意事项 | 如果上屏 Canvas 出现绘制模糊,则需要对上屏 Canvas 进行缩放。举例如下:假如tt.getSystemInfo中返回的screenWidth为360,screenHeight为 640,pixelRatio为 2,你需要主动设置canvas.width = screenWidth * pixelRatio; canvas.height = screenHeight * pixelRatio;才能获得清晰的渲染效果。但这样设置会对渲染速度和内存占用有一些影响。 | 
| 相关教程 | 无 | 
语法
tt.createCanvas()
参数说明
无
返回值
返回值为 object 类型,详细参数描述如下:
| 属性名 | 类型 | 说明 | 最低支持版本 | 
|---|---|---|---|
| dispose | function | 主动释放 canvas 的资源,释放后绑定的 context 将无法使用 | 1.31.0 | 
| toTempFilePath | function | Canvas.toTempFilePath。将当前 Canvas 保存为一个临时文件,并生成相应的临时文件路径,配置开启开放数据域后,主域所有 canvas 不能调用该接口 | 1.31.0 | 
| toTempFilePathSync | function | toTempFilePath 方法的同步版本,参数与 toTempFilePath 的参数 相同,返回值为 string 类型的临时文件路径,配置开启开放数据域后,主域所有 canvas 不能调用该接口 | 1.31.0 | 
| width | number | 画布的宽度 | 1.31.0 | 
| height | number | 画布的高度 | 1.31.0 | 
| getContext | function | Canvas.getContext。获取画布对象的绘图上下文 | 1.31.0 | 
| toDataURL | function | 把画布上的绘制内容以一个 string 的格式返回,配置开启开放数据域后,主域所有 canvas 不能调用该接口 | 1.31.0 | 
错误码
| errNo | errMsg | 说明 | 最低支持版本 | 
|---|---|---|---|
| 20000 | internal error | 小游戏框架内部错误,有需要请创建工单咨询 | 1.31.0 | 
扫码体验
请使用字节宿主APP扫码
代码示例
