图片

优质

小牛编辑

113浏览

2023-12-01

属性:

属性名	类型	说明
buffer	ArrayBuffer	解码后的数据
format	number	数据格式 6 为RGBA8888 、4 为RGBA4444
width	number	图片宽度像素
height	number	图片高度像素

示例：

var img = BK.Image.loadImage("GameRes://texture/icon.png");
var width = img.width;
var height = img.height;
var buffer = img.buffer;
var format = img.format;

loadImage(object)

加载单张图片
手Q版本:7.8.0

object属性：

属性名	类型	是否必填	说明
image	string 或 ArrayBuffer	是	图片路径或者图片文件数据
format	number	否	图片加载格式

object.format 取值

6 //RGBA8888
4 //RGBA4444

示例：


var img = BK.Image.loadImage("GameRes://texture/icon.png");
var width = img.width;
var height = img.height;
var buffer = img.buffer;
var format = img.format;

loadImageWithBase64(object)

加载base64图片数据
手Q版本:7.8.0

object属性：

属性名	类型	是否必填	说明
buffer	ArrayBuffer	是	base64编码的图片数据

示例：


var bkImage = BK.Image.loadImageWithBase64({'buffer':base64ImageData});

saveImage(object)

保存图片
手Q版本:7.8.0

object属性：

属性名	类型	是否必填	说明
bitmap	ArrayBuffer	是	位图数据
width	number	是	图片宽度
height	number	是	图片高度
path	string	是	文件路径
ext	string	是	文件名后缀
isFlipY	number	否	是否上下翻转

示例：


BK.Image.saveImage({'bitmap':arrayBufferData,'width':200,'height':100,'path':"GameSandBox://test",'ext':"png"});

loadImages(object)

加载多张图片，此方法为批量异步加载接口
手Q版本:7.8.0

函数参数object属性：

属性名	类型	是否必填	说明
file	Array	是	要加载的图片文件数组
success	Function	否	接口调用成功回调
fail	Function	否	接口调用失败回调
complete	Function	否	接口调用完成回调

object.file 文件数组

属性名	类型	是否必填	说明
path	string	是	图片文件路径
format	number	否	图片格式

file.format 取值

6 //RGBA8888
4 //RGBA4444

object.success 回调函数

参数名	类型	其他
obj	Array	具体元素属性如下

obj 元素属性

参数名	类型	说明
path	string	路径
data	BK.Image	解码后数据
errcode	number	错误码
errmsg	string	错误信息

object.fail 回调函数参数

参数名	类型	说明
msg	string	错误信息
errcode	number	错误码

示例：

var files =  [];
files.push({'path':'GameRes://resource/img.png'});
files.push({'path':'GameRes://resource/icon.png','format':6});
BK.Image.loadImages({'file':files,
    'success': function (retObj) {
        for (let i = 0; i < retObj.length; i++) {
            if (retObj[i].errcode == 0) {
                var image = retObj[i].image;
                var str = "异步加载图片成功 :" + retObj[i].path + "  width：" + image.width + " height:" + image.height + '   buffer:' + image.buffer.length;
                BK.Script.log(1, 1, str);
            }
            else {
                var str = "异步加载图片失败 :" + retObj[i].path + "   code:" + retObj[i].errcode + " msg:" + retObj[i].errmsg;
                BK.Script.log(1, 1, str);
            }
        }
    },
    'fail':function(obj){
        BK.Script.log(1, 1, "异步加载图片 errcode:"+obj.errcode + ' msg:'+obj.msg);
    },'complete':function()
    {
        BK.Script.log(1, 1, "异步加载图片调用完成 ");
    }
});