普通小游戏开发
API
开放能力
数据分析
视频拍摄器
多端支持

Canvas.toTempFilePath

将当前 Canvas 保存为一个临时文件,并生成相应的临时文件路径。

语法

Canvas.toTempFilePath(options);

参数说明

options 为 object 类型,属性继承标准对象输入,扩展属性描述如下:

属性类型默认值是否必填说明
xnumber0截取 canvas 的左上角横坐标
ynumber0截取 canvas 的左上角纵坐标
widthnumbercanvas 的宽度截取 canvas 的宽度
heightnumbercanvas 的高度截取 canvas 的高度
destWidthnumbercanvas 的宽度目标文件的宽度,会将截取的部分拉伸或压缩至该数值
destHeightnumbercanvas 的高度目标文件的高度,会将截取的部分拉伸或压缩至该数值
fileTypestringpng目标文件的类型
qualitynumber1.0jpg 图片的质量,仅当 fileType 为 jpg 时有效。取值范围为 0.0(最低)- 1.0(最高),不含 0。不在范围内时当作 1.0

fileType 取值说明

说明
jpgjpg 文件
pngpng 文件

返回值

返回值为 object 类型,详细参数描述如下:

参数参数类型说明
errMsgstring状态信息
toTempFilePathstringcanvas 生成的临时文件路径

扫码体验

请使用字节宿主APP扫码

代码示例

开发者工具中预览

const canvas = tt.createCanvas();
canvas.getContext("2d");

// oTempFilePath 方法
canvas.toTempFilePath({
  x: 20,
  y: 20,
  width: 200,
  height: 150,
  destWidth: 400,
  destHeight: 300,
  success: (res) => {
    console.log(res.tempFilePath);
  },
});

// toTempFilePathSync 方法
const tempFilePath = canvas.toTempFilePathSync({
  x: 0,
  y: 0,
  width: canvas.width,
  height: canvas.height,
  destWidth: 500,
  destHeight: 400,
});
console.log(tempFilePath);

Bug & Tip

  • Tip:不要在 tt.createCanvas 后立即调用该方法,在 Canvas 创建后的初始状态下调用该方法可能会导致异常。
点击纠错
评价此篇文档