抖音开放平台Logo
控制台

tt.createCanvas
收藏
我的收藏

​基础库 1.31.0 开始支持本方法，低版本需做兼容处理。​
创建一个画布对象。首次调用创建的是显示在屏幕上的画布，之后调用创建的都是离屏画布。​

​语法​

js
复制
tt.createCanvas();

​参数说明​

无​

​返回值​

返回值为object类型，属性如下：​
参数​
参数类型​
说明​
width​
number​
画布的宽度​
height​
number​
画布的高度​
getContext(string contextType)​
Function​
获取画布对象的绘图上下文​
toTempFilePath(Object object)​
Function​
将当前 Canvas 保存为一个临时文件，并生成相应的临时文件路径​
toTempFilePathSync(Object object)​
Function​
toTempFilePath 方法的同步版本，参数与 toTempFilePath 的参数 相同，返回值为 string 类型的临时文件路径​
toDataURL()​
Function​
把画布上的绘制内容以一个 string 的格式返回​
dispose()​
Function​
主动释放 canvas 的资源，释放后绑定的 context 将无法使用​

​扫码体验​

​代码示例​

开发者工具中预览​
js
复制
const canvas = tt.createCanvas();
canvas.getContext("2d");
canvas.toDataURL();
canvas.dispose();

​Bug & Tip​

    1.​如果上屏 Canvas 出现绘制模糊，则需要对上屏 Canvas 进行缩放。举例如下：假如tt.getSystemInfo中返回的screenWidth为360，screenHeight为 640，pixelRatio为 2，你需要主动设置canvas.width = screenWidth * pixelRatio; canvas.height = screenHeight * pixelRatio;才能获得清晰的渲染效果。但这样设置会对渲染速度和内存占用有一些影响。​
​