圖片處理

導入模塊

import image from '@ohos.multimedia.image';

image.createPixelMap8+

createPixelMap(colors: ArrayBuffer, options: InitializationOptions): Promise<PixelMap>

通過屬性創(chuàng)建PixelMap，默認采用BGRA_8888格式處理數(shù)據(jù)，通過Promise返回結(jié)果。

系統(tǒng)能力： SystemCapability.Multimedia.Image.Core

參數(shù)：

返回值：

示例：

const color = new ArrayBuffer(96);  //96為需要創(chuàng)建的像素buffer大小，取值為：height * width *4
let bufferArr = new Uint8Array(color);
let opts = { editable: true, pixelFormat: 3, size: { height: 4, width: 6 } }
image.createPixelMap(color, opts).then((pixelmap) => {
    console.log('Succeeded in creating pixelmap.');
}).catch(error => {
    console.log('Failed to create pixelmap.');
})

image.createPixelMap8+

createPixelMap(colors: ArrayBuffer, options: InitializationOptions, callback: AsyncCallback<PixelMap>): void

通過屬性創(chuàng)建PixelMap，默認采用BGRA_8888格式處理數(shù)據(jù)，通過回調(diào)函數(shù)返回結(jié)果。

系統(tǒng)能力： SystemCapability.Multimedia.Image.Core

參數(shù)：

示例：

const color = new ArrayBuffer(96);  //96為需要創(chuàng)建的像素buffer大小，取值為：height * width *4
let bufferArr = new Uint8Array(color);
let opts = { editable: true, pixelFormat: 3, size: { height: 4, width: 6 } }
image.createPixelMap(color, opts, (error, pixelmap) => {
    if(error) {
        console.log('Failed to create pixelmap.');
    } else {
        console.log('Succeeded in creating pixelmap.');
    }
})

PixelMap7+

圖像像素類，用于讀取或?qū)懭雸D像數(shù)據(jù)以及獲取圖像信息。在調(diào)用PixelMap的方法前，需要先通過createPixelMap創(chuàng)建一個PixelMap實例。目前pixelmap序列化大小最大128MB，超過會送顯失敗。大小計算方式為（寬*高*每像素占用字節(jié)數(shù)）。

屬性

系統(tǒng)能力： SystemCapability.Multimedia.Image.Core

readPixelsToBuffer7+

readPixelsToBuffer(dst: ArrayBuffer): Promise<void>

讀取圖像像素數(shù)據(jù)，結(jié)果寫入ArrayBuffer里，使用Promise形式返回。指定BGRA_8888格式創(chuàng)建pixelmap，讀取的像素數(shù)據(jù)與原數(shù)據(jù)保持一致。

系統(tǒng)能力： SystemCapability.Multimedia.Image.Core

參數(shù)：

返回值：

示例：

const readBuffer = new ArrayBuffer(96);  //96為需要創(chuàng)建的像素buffer大小，取值為：height * width *4
pixelmap.readPixelsToBuffer(readBuffer).then(() => {
    console.log('Succeeded in reading image pixel data.');  //符合條件則進入 
}).catch(error => {
    console.log('Failed to read image pixel data.');  //不符合條件則進入
})

readPixelsToBuffer7+

readPixelsToBuffer(dst: ArrayBuffer, callback: AsyncCallback<void>): void

讀取圖像像素數(shù)據(jù)，結(jié)果寫入ArrayBuffer里，使用callback形式返回。指定BGRA_8888格式創(chuàng)建pixelmap，讀取的像素數(shù)據(jù)與原數(shù)據(jù)保持一致。

系統(tǒng)能力： SystemCapability.Multimedia.Image.Core

參數(shù)：

示例：

const readBuffer = new ArrayBuffer(96);  //96為需要創(chuàng)建的像素buffer大小，取值為：height * width *4
pixelmap.readPixelsToBuffer(readBuffer, (err, res) => {
    if(err) {
        console.log('Failed to read image pixel data.');  //不符合條件則進入
    } else {
        console.log('Succeeded in reading image pixel data.');  //符合條件則進入
    }
})

readPixels7+

readPixels(area: PositionArea): Promise<void>

讀取區(qū)域內(nèi)的圖片數(shù)據(jù)，使用Promise形式返回讀取結(jié)果。

系統(tǒng)能力： SystemCapability.Multimedia.Image.Core

參數(shù)：

返回值：

示例：

const area = {
    pixels: new ArrayBuffer(8),
    offset: 0,
    stride: 8,
    region: { size: { height: 1, width: 2 }, x: 0, y: 0 }
}
pixelmap.readPixels(area).then(() => {
    console.log('Succeeded in reading the image data in the area.'); //符合條件則進入
}).catch(error => {
    console.log('Failed to read the image data in the area.'); //不符合條件則進入
})

readPixels7+

readPixels(area: PositionArea, callback: AsyncCallback<void>): void

讀取區(qū)域內(nèi)的圖片數(shù)據(jù)，使用callback形式返回讀取結(jié)果。

系統(tǒng)能力： SystemCapability.Multimedia.Image.Core

參數(shù)：

示例：

const color = new ArrayBuffer(96);  //96為需要創(chuàng)建的像素buffer大小，取值為：height * width *4
let bufferArr = new Uint8Array(color);
let opts = { editable: true, pixelFormat: 3, size: { height: 4, width: 6 } }
image.createPixelMap(color, opts, (err, pixelmap) => {
    if(pixelmap == undefined){
        console.info('createPixelMap failed.');
    } else {
        const area = { pixels: new ArrayBuffer(8),
            offset: 0,
            stride: 8,
            region: { size: { height: 1, width: 2 }, x: 0, y: 0 }};
        pixelmap.readPixels(area, () => {
            console.info('readPixels success');
        })
    }
})

writePixels7+

writePixels(area: PositionArea): Promise<void>

將PixelMap寫入指定區(qū)域內(nèi)，使用Promise形式返回寫入結(jié)果。

系統(tǒng)能力： SystemCapability.Multimedia.Image.Core

參數(shù)：

返回值：

示例：

const color = new ArrayBuffer(96);  //96為需要創(chuàng)建的像素buffer大小，取值為：height * width *4
let bufferArr = new Uint8Array(color);
let opts = { editable: true, pixelFormat: 3, size: { height: 4, width: 6 } }
image.createPixelMap(color, opts)
    .then( pixelmap => {
        if (pixelmap == undefined) {
            console.info('createPixelMap failed.');
        }
        const area = { pixels: new ArrayBuffer(8),
            offset: 0,
            stride: 8,
            region: { size: { height: 1, width: 2 }, x: 0, y: 0 }
        }
        let bufferArr = new Uint8Array(area.pixels);
        for (var i = 0; i < bufferArr.length; i++) {
            bufferArr[i] = i + 1;
        }

        pixelmap.writePixels(area).then(() => {
            console.info('Succeeded to write pixelmap into the specified area.');
        })
    }).catch(error => {
        console.log('error: ' + error);
    })

writePixels7+

writePixels(area: PositionArea, callback: AsyncCallback<void>): void

將PixelMap寫入指定區(qū)域內(nèi)，使用callback形式返回寫入結(jié)果。

系統(tǒng)能力： SystemCapability.Multimedia.Image.Core

參數(shù)：

示例：

const area = { pixels: new ArrayBuffer(8),
    offset: 0,
    stride: 8,
    region: { size: { height: 1, width: 2 }, x: 0, y: 0 }
}
let bufferArr = new Uint8Array(area.pixels);
for (var i = 0; i < bufferArr.length; i++) {
    bufferArr[i] = i + 1;
}
pixelmap.writePixels(area, (error) => {
    if (error != undefined) {
        console.info('Failed to write pixelmap into the specified area.');
    } else {
        console.info('Succeeded to write pixelmap into the specified area.');
    }
})

writeBufferToPixels7+

writeBufferToPixels(src: ArrayBuffer): Promise<void>

讀取緩沖區(qū)中的圖片數(shù)據(jù)，結(jié)果寫入PixelMap中，使用Promise形式返回。

系統(tǒng)能力： SystemCapability.Multimedia.Image.Core

參數(shù)：

返回值：

示例：

const color = new ArrayBuffer(96);  //96為需要創(chuàng)建的像素buffer大小，取值為：height * width *4
let bufferArr = new Uint8Array(color);
for (var i = 0; i < bufferArr.length; i++) {
    bufferArr[i] = i + 1;
}
pixelmap.writeBufferToPixels(color).then(() => {
    console.log("Succeeded in writing data from a buffer to a PixelMap.");
}).catch((err) => {
    console.error("Failed to write data from a buffer to a PixelMap.");
})

writeBufferToPixels7+

writeBufferToPixels(src: ArrayBuffer, callback: AsyncCallback<void>): void

讀取緩沖區(qū)中的圖片數(shù)據(jù)，結(jié)果寫入PixelMap中，使用callback形式返回。

系統(tǒng)能力： SystemCapability.Multimedia.Image.Core

參數(shù)：

示例：

const color = new ArrayBuffer(96);  //96為需要創(chuàng)建的像素buffer大小，取值為：height * width *4
let bufferArr = new Uint8Array(color);
for (var i = 0; i < bufferArr.length; i++) {
    bufferArr[i] = i + 1;
}
pixelmap.writeBufferToPixels(color, function(err) {
    if (err) {
        console.error("Failed to write data from a buffer to a PixelMap.");
        return;
    } else {
        console.log("Succeeded in writing data from a buffer to a PixelMap.");
    }
});

getImageInfo7+

getImageInfo(): Promise<ImageInfo>

獲取圖像像素信息，使用Promise形式返回獲取的圖像像素信息。

系統(tǒng)能力： SystemCapability.Multimedia.Image.Core

返回值：

示例：

const color = new ArrayBuffer(96);  //96為需要創(chuàng)建的像素buffer大小，取值為：height * width *4
let opts = { editable: true, pixelFormat: 2, size: { height: 6, width: 8 } }
image.createPixelMap(color, opts).then(pixelmap => {
    if (pixelmap == undefined) {
        console.error("Failed to obtain the image pixel map information.");
    }
    pixelmap.getImageInfo().then(imageInfo => {
        if (imageInfo == undefined) {
            console.error("Failed to obtain the image pixel map information.");
        }
        if (imageInfo.size.height == 4 && imageInfo.size.width == 6) {
            console.log("Succeeded in obtaining the image pixel map information.");
        }
    })
})

getImageInfo7+

getImageInfo(callback: AsyncCallback<ImageInfo>): void

獲取圖像像素信息，使用callback形式返回獲取的圖像像素信息。

系統(tǒng)能力： SystemCapability.Multimedia.Image.Core

參數(shù)：

示例:

const color = new ArrayBuffer(96);  //96為需要創(chuàng)建的像素buffer大小，取值為：height * width *4
let opts = { editable: true, pixelFormat: 3, size: { height: 4, width: 6 } }
image.createPixelMap(color, opts, (err, pixelmap) => {
    if (pixelmap == undefined) {
        console.error("Failed to obtain the image pixel map information.");
    }
    pixelmap.getImageInfo((err, imageInfo) => {
        if (imageInfo == undefined) {
            console.error("Failed to obtain the image pixel map information.");
        }
        if (imageInfo.size.height == 4 && imageInfo.size.width == 6) {
            console.log("Succeeded in obtaining the image pixel map information.");
        }
    })
})

getBytesNumberPerRow7+

getBytesNumberPerRow(): number

獲取圖像像素每行字節(jié)數(shù)。

系統(tǒng)能力： SystemCapability.Multimedia.Image.Core

返回值：

示例：

const color = new ArrayBuffer(96);  //96為需要創(chuàng)建的像素buffer大小，取值為：height * width *4
let bufferArr = new Uint8Array(color);
let opts = { editable: true, pixelFormat: 3, size: { height: 4, width: 6 } }
image.createPixelMap(color, opts, (err,pixelmap) => {
    let rowCount = pixelmap.getBytesNumberPerRow();
})

getPixelBytesNumber7+

getPixelBytesNumber(): number

獲取圖像像素的總字節(jié)數(shù)。

系統(tǒng)能力： SystemCapability.Multimedia.Image.Core

返回值：

示例：

let pixelBytesNumber = pixelmap.getPixelBytesNumber();

getDensity9+

getDensity():number

獲取當前圖像像素的密度。

系統(tǒng)能力： SystemCapability.Multimedia.Image.Core

返回值：

示例：

let getDensity = pixelmap.getDensity();

opacity9+

opacity(rate: number, callback: AsyncCallback<void>): void

通過設置透明比率來讓PixelMap達到對應的透明效果，使用callback形式返回。

系統(tǒng)能力： SystemCapability.Multimedia.Image.Core

參數(shù)：

示例：

var rate = 0.5;
pixelmap.opacity(rate, (err) => {
    if (err) {
        console.error("Failed to set opacity.");
        return;
    } else {
        console.log("Succeeded in setting opacity.");
    }
})

opacity9+

opacity(rate: number): Promise<void>

通過設置透明比率來讓PixelMap達到對應的透明效果，使用Promise形式返回。

系統(tǒng)能力： SystemCapability.Multimedia.Image.Core

參數(shù)：

返回值：

示例：

async function Demo() {
    await pixelmap.opacity(0.5);
}

createAlphaPixelmap9+

createAlphaPixelmap(): Promise<PixelMap>

根據(jù)Alpha通道的信息，來生成一個僅包含Alpha通道信息的pixelmap，可用于陰影效果，使用Promise形式返回。

系統(tǒng)能力： SystemCapability.Multimedia.Image.Core

返回值：

示例：

async function Demo() {
    await pixelmap.createAlphaPixelmap();
}   

createAlphaPixelmap9+

createAlphaPixelmap(callback: AsyncCallback<PixelMap>): void

根據(jù)Alpha通道的信息，來生成一個僅包含Alpha通道信息的pixelmap，可用于陰影效果，使用callback形式返回。

系統(tǒng)能力： SystemCapability.Multimedia.Image.Core

參數(shù)：

示例：

pixelmap.createAlphaPixelmap((err, alphaPixelMap) => {
    if (alphaPixelMap == undefined) {
        console.info('Failed to obtain new pixel map.');
    } else {
        console.info('Succeed in obtaining new pixel map.');
    }
})

scale9+

scale(x: number, y: number, callback: AsyncCallback<void>): void

根據(jù)輸入的寬高對圖片進行縮放，使用callback形式返回。

系統(tǒng)能力： SystemCapability.Multimedia.Image.Core

參數(shù)：

示例：

async function Demo() {
    await pixelmap.scale(2.0, 1.0);
}

scale9+

scale(x: number, y: number): Promise<void>

根據(jù)輸入的寬高對圖片進行縮放，使用Promise形式返回。

系統(tǒng)能力： SystemCapability.Multimedia.Image.Core

參數(shù)：

返回值：

示例：

async function Demo() {
    await pixelmap.scale(2.0, 1.0);
}

translate9+

translate(x: number, y: number, callback: AsyncCallback<void>): void

根據(jù)輸入的坐標對圖片進行位置變換，使用callback形式返回。

系統(tǒng)能力： SystemCapability.Multimedia.Image.Core

參數(shù)：

示例：

async function Demo() {
    await pixelmap.translate(3.0, 1.0);
}

translate9+

translate(x: number, y: number): Promise<void>

根據(jù)輸入的坐標對圖片進行位置變換，使用Promise形式返回。

系統(tǒng)能力： SystemCapability.Multimedia.Image.Core

參數(shù)：

返回值：

示例：

async function Demo() {
    await pixelmap.translate(3.0, 1.0);
}

rotate9+

rotate(angle: number, callback: AsyncCallback<void>): void

根據(jù)輸入的角度對圖片進行旋轉(zhuǎn)，使用callback形式返回。

系統(tǒng)能力： SystemCapability.Multimedia.Image.Core

參數(shù)：

示例：

var angle = 90.0;
pixelmap.rotate(angle, (err) => {
    if (err) {
        console.error("Failed to set rotation.");
        return;
    } else {
        console.log("Succeeded in setting rotation.");
    }
})

rotate9+

rotate(angle: number): Promise<void>

根據(jù)輸入的角度對圖片進行旋轉(zhuǎn)，使用Promise形式返回。

系統(tǒng)能力： SystemCapability.Multimedia.Image.Core

參數(shù)：

返回值：

示例：

async function Demo() {
    await pixelmap.rotate(90.0);
}

flip9+

flip(horizontal: boolean, vertical: boolean, callback: AsyncCallback<void>): void

根據(jù)輸入的條件對圖片進行翻轉(zhuǎn)，使用callback形式返回。

系統(tǒng)能力： SystemCapability.Multimedia.Image.Core

參數(shù)：

示例：

async function Demo() {
    await pixelmap.flip(false, true);
}

flip9+

flip(horizontal: boolean, vertical: boolean): Promise<void>

根據(jù)輸入的條件對圖片進行翻轉(zhuǎn)，使用Promise形式返回。

系統(tǒng)能力： SystemCapability.Multimedia.Image.Core

參數(shù)：

返回值：

示例：

async function Demo() {
    await pixelmap.flip(false, true);
}

crop9+

crop(region: Region, callback: AsyncCallback<void>): void

根據(jù)輸入的尺寸對圖片進行裁剪，使用callback形式返回。

系統(tǒng)能力： SystemCapability.Multimedia.Image.Core

參數(shù)：

示例：

async function Demo() {
    await pixelmap.crop({ x: 0, y: 0, size: { height: 100, width: 100 } });
}

crop9+

crop(region: Region): Promise<void>

根據(jù)輸入的尺寸對圖片進行裁剪，使用Promise形式返回。

系統(tǒng)能力： SystemCapability.Multimedia.Image.Core

參數(shù)：

返回值：

示例：

async function Demo() {
    await pixelmap.crop({ x: 0, y: 0, size: { height: 100, width: 100 } });
}

release7+

release():Promise<void>

釋放PixelMap對象，使用Promise形式返回釋放結(jié)果。

系統(tǒng)能力： SystemCapability.Multimedia.Image.Core

返回值：

示例：

pixelmap.release().then(() => {
    console.log('Succeeded in releasing pixelmap object.');
}).catch(error => {
    console.log('Failed to release pixelmap object.');
})

release7+

release(callback: AsyncCallback<void>): void

釋放PixelMap對象，使用callback形式返回釋放結(jié)果。

系統(tǒng)能力： SystemCapability.Multimedia.Image.Core

參數(shù)：

示例：

pixelmap.release(() => {
    console.log('Succeeded in releasing pixelmap object.');
})

image.createImageSource

createImageSource(uri: string): ImageSource

通過傳入的uri創(chuàng)建圖片源實例。

系統(tǒng)能力： SystemCapability.Multimedia.Image.ImageSource

參數(shù)：

返回值：

示例：

//Stage模型
const context = getContext(this);
const path = context.cacheDir + "/test.jpg";
const imageSourceApi = image.createImageSource(path);

//FA模型
import featureAbility from '@ohos.ability.featureAbility';

const context = featureAbility.getContext();
const path = context.getCacheDir() + "/test.jpg";
const imageSourceApi = image.createImageSource(path);

image.createImageSource9+

createImageSource(uri: string, options: SourceOptions): ImageSource

通過傳入的uri創(chuàng)建圖片源實例。

系統(tǒng)能力： SystemCapability.Multimedia.Image.ImageSource

參數(shù)：

返回值：

示例：

var sourceOptions = { sourceDensity: 120 };
let imageSource = image.createImageSource('test.png', sourceOptions);

image.createImageSource7+

createImageSource(fd: number): ImageSource

通過傳入文件描述符來創(chuàng)建圖片源實例。

系統(tǒng)能力： SystemCapability.Multimedia.Image.ImageSource

參數(shù)：

返回值：

示例：

const imageSourceApi = image.createImageSource(0);

image.createImageSource9+

createImageSource(fd: number, options: SourceOptions): ImageSource

通過傳入文件描述符來創(chuàng)建圖片源實例。

系統(tǒng)能力： SystemCapability.Multimedia.Image.ImageSource

參數(shù)：

返回值：

示例：

var sourceOptions = { sourceDensity: 120 };
const imageSourceApi = image.createImageSource(0, sourceOptions);

image.createImageSource9+

createImageSource(buf: ArrayBuffer): ImageSource

通過緩沖區(qū)創(chuàng)建圖片源實例。

系統(tǒng)能力： SystemCapability.Multimedia.Image.ImageSource

參數(shù)：

示例：

const buf = new ArrayBuffer(96);  //96為需要創(chuàng)建的像素buffer大小，取值為：height * width *4
const imageSourceApi = image.createImageSource(buf);

image.createImageSource9+

createImageSource(buf: ArrayBuffer, options: SourceOptions): ImageSource

通過緩沖區(qū)創(chuàng)建圖片源實例。

系統(tǒng)能力： SystemCapability.Multimedia.Image.ImageSource

參數(shù)：

返回值：

示例：

const data = new ArrayBuffer(112);
const imageSourceApi = image.createImageSource(data);

image.CreateIncrementalSource9+

CreateIncrementalSource(buf: ArrayBuffer): ImageSource

通過緩沖區(qū)以增量的方式創(chuàng)建圖片源實例。

系統(tǒng)能力： SystemCapability.Multimedia.Image.ImageSource

參數(shù)：

返回值：

示例：

const buf = new ArrayBuffer(96);  //96為需要創(chuàng)建的像素buffer大小，取值為：height * width *4
const imageSourceIncrementalSApi = image.CreateIncrementalSource(buf);

image.CreateIncrementalSource9+

CreateIncrementalSource(buf: ArrayBuffer, options?: SourceOptions): ImageSource

通過緩沖區(qū)以增量的方式創(chuàng)建圖片源實例。

系統(tǒng)能力： SystemCapability.Multimedia.Image.ImageSource

參數(shù)：

返回值：

示例：

const buf = new ArrayBuffer(96);  //96為需要創(chuàng)建的像素buffer大小，取值為：height * width *4
const imageSourceIncrementalSApi = image.CreateIncrementalSource(buf);

ImageSource

圖片源類，用于獲取圖片相關信息。在調(diào)用ImageSource的方法前，需要先通過createImageSource構(gòu)建一個ImageSource實例。

屬性

系統(tǒng)能力： SystemCapability.Multimedia.Image.ImageSource

getImageInfo

getImageInfo(index: number, callback: AsyncCallback<ImageInfo>): void

獲取指定序號的圖片信息，使用callback形式返回圖片信息。

系統(tǒng)能力： SystemCapability.Multimedia.Image.ImageSource

參數(shù)：

示例：

imageSourceApi.getImageInfo(0,(error, imageInfo) => { 
    if(error) {
        console.log('getImageInfo failed.');
    } else {
        console.log('getImageInfo succeeded.');
    }
})

getImageInfo

getImageInfo(callback: AsyncCallback<ImageInfo>): void

獲取圖片信息，使用callback形式返回圖片信息。

系統(tǒng)能力： SystemCapability.Multimedia.Image.ImageSource

參數(shù)：

示例：

imageSourceApi.getImageInfo(imageInfo => { 
    console.log('Succeeded in obtaining the image information.');
})

getImageInfo

getImageInfo(index?: number): Promise<ImageInfo>

獲取圖片信息，使用Promise形式返回圖片信息。

系統(tǒng)能力： SystemCapability.Multimedia.Image.ImageSource

參數(shù)：

返回值：

示例：

imageSourceApi.getImageInfo(0)
    .then(imageInfo => {
        console.log('Succeeded in obtaining the image information.');
    }).catch(error => {
        console.log('Failed to obtain the image information.');
    })

getImageProperty7+

getImageProperty(key:string, options?: GetImagePropertyOptions): Promise<string>

獲取圖片中給定索引處圖像的指定屬性鍵的值，用Promise形式返回結(jié)果。

系統(tǒng)能力： SystemCapability.Multimedia.Image.ImageSource

參數(shù)：

返回值：

示例：

imageSourceApi.getImageProperty("BitsPerSample")
    .then(data => {
        console.log('Succeeded in getting the value of the specified attribute key of the image.');
    })

getImageProperty7+

getImageProperty(key:string, callback: AsyncCallback<string>): void

獲取圖片中給定索引處圖像的指定屬性鍵的值，用callback形式返回結(jié)果。

系統(tǒng)能力： SystemCapability.Multimedia.Image.ImageSource

參數(shù)：

示例：

imageSourceApi.getImageProperty("BitsPerSample",(error,data) => { 
    if(error) {
        console.log('Failed to get the value of the specified attribute key of the image.');
    } else {
        console.log('Succeeded in getting the value of the specified attribute key of the image.');
    }
})

getImageProperty7+

getImageProperty(key:string, options: GetImagePropertyOptions, callback: AsyncCallback<string>): void

獲取圖片指定屬性鍵的值，callback形式返回結(jié)果。

系統(tǒng)能力： SystemCapability.Multimedia.Image.ImageSource

參數(shù)：

示例：

let property = { index: 0, defaultValue: '9999' }
imageSourceApi.getImageProperty("BitsPerSample",property,(error,data) => { 
    if(error) {
        console.log('Failed to get the value of the specified attribute key of the image.');
    } else {
        console.log('Succeeded in getting the value of the specified attribute key of the image.');
    }
})

modifyImageProperty9+

modifyImageProperty(key: string, value: string): Promise<void>

通過指定的鍵修改圖片屬性的值，使用Promise形式返回結(jié)果。

系統(tǒng)能力： SystemCapability.Multimedia.Image.ImageSource

參數(shù)：

返回值：

示例：

imageSourceApi.modifyImageProperty("ImageWidth", "120").then(() => {
    const w = imageSourceApi.getImageProperty("ImageWidth")
    console.info('w', w);
})

modifyImageProperty9+

modifyImageProperty(key: string, value: string, callback: AsyncCallback<void>): void

通過指定的鍵修改圖片屬性的值，callback形式返回結(jié)果。

系統(tǒng)能力： SystemCapability.Multimedia.Image.ImageSource

參數(shù)：

示例：

imageSourceApi.modifyImageProperty("ImageWidth", "120",() => {})

updateData9+

updateData(buf: ArrayBuffer, isFinished: boolean, value: number, length: number): Promise<void>

更新增量數(shù)據(jù)，使用Promise形式返回結(jié)果。

系統(tǒng)能力： SystemCapability.Multimedia.Image.ImageSource

參數(shù)：

返回值：

示例：

const array = new ArrayBuffer(100);
imageSourceApi.updateData(array, false, 0, 10).then(data => {
    console.info('Succeeded in updating data.');
})

updateData9+

updateData(buf: ArrayBuffer, isFinished: boolean, value: number, length: number, callback: AsyncCallback<void>): void

更新增量數(shù)據(jù)，callback形式返回結(jié)果。

系統(tǒng)能力： SystemCapability.Multimedia.Image.ImageSource

參數(shù)：

示例：

const array = new ArrayBuffer(100);
imageSourceApi.updateData(array, false, 0, 10,(error,data )=> {
    if(data !== undefined){
        console.info('Succeeded in updating data.');     
    }
})

createPixelMap7+

createPixelMap(options?: DecodingOptions): Promise<PixelMap>

通過圖片解碼參數(shù)創(chuàng)建PixelMap對象。

系統(tǒng)能力： SystemCapability.Multimedia.Image.ImageSource

參數(shù)：

返回值：

示例：

imageSourceApi.createPixelMap().then(pixelmap => {
    console.log('Succeeded in creating pixelmap object through image decoding parameters.');
}).catch(error => {
    console.log('Failed to create pixelmap object through image decoding parameters.');
})

createPixelMap7+

createPixelMap(callback: AsyncCallback<PixelMap>): void

通過默認參數(shù)創(chuàng)建PixelMap對象，使用callback形式返回結(jié)果。

系統(tǒng)能力： SystemCapability.Multimedia.Image.ImageSource

參數(shù)：

示例：

imageSourceApi.createPixelMap((err, pixelmap) => {
                    console.info('Succeeded in creating pixelmap object.');
                })

createPixelMap7+

createPixelMap(options: DecodingOptions, callback: AsyncCallback<PixelMap>): void

通過圖片解碼參數(shù)創(chuàng)建PixelMap對象。

系統(tǒng)能力： SystemCapability.Multimedia.Image.ImageSource

參數(shù)：

示例：

let decodingOptions = {
    sampleSize: 1,
    editable: true,
    desiredSize: { width: 1, height: 2 },
    rotate: 10,
    desiredPixelFormat: 3,
    desiredRegion: { size: { height: 1, width: 2 }, x: 0, y: 0 },
    index: 0
};
imageSourceApi.createPixelMap(decodingOptions, pixelmap => { 
    console.log('Succeeded in creating pixelmap object.');
})

release

release(callback: AsyncCallback<void>): void

釋放圖片源實例，使用callback形式返回結(jié)果。

系統(tǒng)能力： SystemCapability.Multimedia.Image.ImageSource

參數(shù)：

示例：

imageSourceApi.release(() => { 
    console.log('release succeeded.');
})

release

release(): Promise<void>

釋放圖片源實例，使用Promise形式返回結(jié)果。

系統(tǒng)能力： SystemCapability.Multimedia.Image.ImageSource

返回值：

示例：

imageSourceApi.release().then(()=>{
    console.log('Succeeded in releasing the image source instance.');
}).catch(error => {
    console.log('Failed to release the image source instance.');
})

image.createImagePacker

createImagePacker(): ImagePacker

創(chuàng)建ImagePacker實例。

系統(tǒng)能力： SystemCapability.Multimedia.Image.ImagePacker

返回值：

示例：

const imagePackerApi = image.createImagePacker();

ImagePacker

圖片打包器類，用于圖片壓縮和打包。在調(diào)用ImagePacker的方法前，需要先通過createImagePacker構(gòu)建一個ImagePacker實例，當前支持格式有：jpeg webp。

屬性

系統(tǒng)能力： SystemCapability.Multimedia.Image.ImagePacker

packing

packing(source: ImageSource, option: PackingOption, callback: AsyncCallback<ArrayBuffer>): void

圖片壓縮或重新打包，使用callback形式返回結(jié)果。

系統(tǒng)能力： SystemCapability.Multimedia.Image.ImagePacker

參數(shù)：

示例：

const imageSourceApi = image.createImageSource(0);
let packOpts = { format:"image/jpeg", quality:98 };
imagePackerApi.packing(imageSourceApi, packOpts, data => {})

packing

packing(source: ImageSource, option: PackingOption): Promise<ArrayBuffer>

圖片壓縮或重新打包，使用Promise形式返回結(jié)果。

系統(tǒng)能力： SystemCapability.Multimedia.Image.ImagePacker

參數(shù)：

返回值：

示例：

const imageSourceApi = image.createImageSource(0);
let packOpts = { format:"image/jpeg", quality:98 }
imagePackerApi.packing(imageSourceApi, packOpts)
    .then( data => {
        console.log('packing succeeded.');
    }).catch(error => {
        console.log('packing failed.');
    })

packing8+

packing(source: PixelMap, option: PackingOption, callback: AsyncCallback<ArrayBuffer>): void

圖片壓縮或重新打包，使用callback形式返回結(jié)果。

系統(tǒng)能力： SystemCapability.Multimedia.Image.ImagePacker

參數(shù)：

示例：

const color = new ArrayBuffer(96);  //96為需要創(chuàng)建的像素buffer大小，取值為：height * width *4
let bufferArr = new Uint8Array(color);
let opts = { editable: true, pixelFormat: 3, size: { height: 4, width: 6 } }
image.createPixelMap(color, opts).then((pixelmap) => {
    let packOpts = { format:"image/jpeg", quality:98 }
    imagePackerApi.packing(pixelmap, packOpts, data => { 
        console.log('Succeeded in packing the image.');
    })
})

packing8+

packing(source: PixelMap, option: PackingOption): Promise<ArrayBuffer>

圖片壓縮或重新打包，使用Promise形式返回結(jié)果。

系統(tǒng)能力： SystemCapability.Multimedia.Image.ImagePacker

參數(shù)：

返回值：

示例：

const color = new ArrayBuffer(96);  //96為需要創(chuàng)建的像素buffer大小，取值為：height * width *4
let bufferArr = new Uint8Array(color);
let opts = { editable: true, pixelFormat: 3, size: { height: 4, width: 6 } }
image.createPixelMap(color, opts).then((pixelmap) => {
    let packOpts = { format:"image/jpeg", quality:98 }
    imagePackerApi.packing(pixelmap, packOpts)
        .then( data => {
            console.log('Succeeded in packing the image.');
        }).catch(error => {
            console.log('Failed to pack the image..');
        })
})

release

release(callback: AsyncCallback<void>): void

釋放圖片打包實例，使用callback形式返回結(jié)果。

系統(tǒng)能力： SystemCapability.Multimedia.Image.ImagePacker

參數(shù)：

示例：

imagePackerApi.release(()=>{ 
    console.log('Succeeded in releasing image packaging.');
})

release

release(): Promise<void>

釋放圖片打包實例，使用Promise形式返回釋放結(jié)果。

系統(tǒng)能力： SystemCapability.Multimedia.Image.ImagePacker

返回值：

示例：

imagePackerApi.release().then(()=>{
    console.log('Succeeded in releasing image packaging.');
}).catch((error)=>{ 
    console.log('Failed to release image packaging.'); 
}) 

image.createImageReceiver9+

createImageReceiver(width: number, height: number, format: number, capacity: number): ImageReceiver

通過寬、高、圖片格式、容量創(chuàng)建ImageReceiver實例。

系統(tǒng)能力： SystemCapability.Multimedia.Image.ImageReceiver

參數(shù)：

返回值：

示例：

var receiver = image.createImageReceiver(8192, 8, 2000, 8);

ImageReceiver9+

圖像接收類，用于獲取組件surface id，接收最新的圖片和讀取下一張圖片，以及釋放ImageReceiver實例。

在調(diào)用以下方法前需要先創(chuàng)建ImageReceiver實例。

屬性

系統(tǒng)能力： SystemCapability.Multimedia.Image.ImageReceiver

getReceivingSurfaceId9+

getReceivingSurfaceId(callback: AsyncCallback<string>): void

用于獲取一個surface id供Camera或其他組件使用。使用callback返回結(jié)果。

系統(tǒng)能力： SystemCapability.Multimedia.Image.ImageReceiver

參數(shù)：

示例:

receiver.getReceivingSurfaceId((err, id) => { 
    if(err) {
        console.log('getReceivingSurfaceId failed.');
    } else {
        console.log('getReceivingSurfaceId succeeded.');
    }
});

getReceivingSurfaceId9+

getReceivingSurfaceId(): Promise<string>

用于獲取一個surface id供Camera或其他組件使用。使用promise返回結(jié)果。

系統(tǒng)能力： SystemCapability.Multimedia.Image.ImageReceiver

返回值：

示例：

receiver.getReceivingSurfaceId().then( id => { 
    console.log('getReceivingSurfaceId succeeded.');
}).catch(error => {
    console.log('getReceivingSurfaceId failed.');
})

readLatestImage9+

readLatestImage(callback: AsyncCallback<Image>): void

從ImageReceiver讀取最新的圖片，并使用callback返回結(jié)果。

系統(tǒng)能力： SystemCapability.Multimedia.Image.ImageReceiver

參數(shù)：

示例：

receiver.readLatestImage((err, img) => { 
    if(err) {
        console.log('readLatestImage failed.');
    } else {
        console.log('readLatestImage succeeded.');
    }
});

readLatestImage9+

readLatestImage(): Promise<Image>

從ImageReceiver讀取最新的圖片，并使用promise返回結(jié)果。

系統(tǒng)能力： SystemCapability.Multimedia.Image.ImageReceiver

返回值：

示例：

receiver.readLatestImage().then(img => {
    console.log('readLatestImage succeeded.');
}).catch(error => {
    console.log('readLatestImage failed.');
})

readNextImage9+

readNextImage(callback: AsyncCallback<Image>): void

從ImageReceiver讀取下一張圖片，并使用callback返回結(jié)果。

系統(tǒng)能力： SystemCapability.Multimedia.Image.ImageReceiver

參數(shù)：

示例：

receiver.readNextImage((err, img) => { 
    if(err) {
        console.log('readNextImage failed.');
    } else {
        console.log('readNextImage succeeded.');
    }
});

readNextImage9+

readNextImage(): Promise<Image>

從ImageReceiver讀取下一張圖片，并使用promise返回結(jié)果。

系統(tǒng)能力： SystemCapability.Multimedia.Image.ImageReceiver

返回值：

示例：

receiver.readNextImage().then(img => {
    console.log('readNextImage succeeded.');
}).catch(error => {
    console.log('readNextImage failed.');
})

on9+

on(type: 'imageArrival', callback: AsyncCallback<void>): void

接收圖片時注冊回調(diào)。

系統(tǒng)能力： SystemCapability.Multimedia.Image.ImageReceiver

參數(shù)：

示例：

receiver.on('imageArrival', () => {})

release9+

release(callback: AsyncCallback<void>): void

釋放ImageReceiver實例并使用回調(diào)返回結(jié)果。

系統(tǒng)能力： SystemCapability.Multimedia.Image.ImageReceiver

參數(shù)：

示例：

receiver.release(() => {})

release9+

release(): Promise<void>

釋放ImageReceiver實例并使用promise返回結(jié)果。

系統(tǒng)能力： SystemCapability.Multimedia.Image.ImageReceiver

返回值：

示例：

receiver.release().then(() => {
    console.log('release succeeded.');
}).catch(error => {
    console.log('release failed.');
})

image.createImageCreator9+

createImageCreator(width: number, height: number, format: number, capacity: number): ImageCreator

通過寬、高、圖片格式、容量創(chuàng)建ImageCreator實例。

系統(tǒng)能力： SystemCapability.Multimedia.Image.ImageCreator

參數(shù)：

返回值：

示例：

var creator = image.createImageCreator(8192, 8, 4, 8);

ImageCreator9+

圖像創(chuàng)建模塊，用于請求圖像原生數(shù)據(jù)區(qū)域，并開放給應用編譯原生圖像數(shù)據(jù)的能力。

在調(diào)用以下方法前需要先創(chuàng)建ImageCreator實例。

屬性

系統(tǒng)能力： SystemCapability.Multimedia.Image.ImageCreator

dequeueImage9+

dequeueImage(callback: AsyncCallback<Image>): void

從空閑隊列中獲取buffer圖片，用于繪制UI內(nèi)容，并使用callback返回結(jié)果。

系統(tǒng)能力： SystemCapability.Multimedia.Image.ImageCreator

參數(shù)：

示例：

creator.dequeueImage((err, img) => {
    if (err) {
        console.info('dequeueImage failded.');
    }
    console.info('dequeueImage succeeded.');
});

dequeueImage9+

dequeueImage(): Promise<Image>

從空閑隊列中獲取buffer圖片，用于繪制UI內(nèi)容，并使用promise返回結(jié)果。

系統(tǒng)能力： SystemCapability.Multimedia.Image.ImageCreator

返回值：

示例：

creator.dequeueImage().then(img => {
    console.info('dequeueImage succeeded.');
}).catch(error => {
    console.log('dequeueImage failed: ' + error);
})

queueImage9+

queueImage(interface: Image, callback: AsyncCallback<void>): void

將繪制好的圖片放入Dirty隊列，并使用callback返回結(jié)果。

系統(tǒng)能力： SystemCapability.Multimedia.Image.ImageCreator

參數(shù)：

示例：

creator.dequeueImage().then(img => {
    //繪制圖片
    img.getComponent(4).then(component => {
        var bufferArr = new Uint8Array(component.byteBuffer);
        for (var i = 0; i < bufferArr.length; i += 4) {
            bufferArr[i] = 0; //B
            bufferArr[i + 1] = 0; //G
            bufferArr[i + 2] = 255; //R
            bufferArr[i + 3] = 255; //A
        }
    })
    creator.queueImage(img, (err) => {
        if (err) {
            console.info('queueImage failed: ' + err);
        }
        console.info('queueImage succeeded');
    })
})

queueImage9+

queueImage(interface: Image): Promise<void>

將繪制好的圖片放入Dirty隊列，并使用promise返回結(jié)果。

系統(tǒng)能力： SystemCapability.Multimedia.Image.ImageCreator

參數(shù)：

返回值：

示例：

creator.dequeueImage().then(img => {
    //繪制圖片
    img.getComponent(4).then(component => {
        var bufferArr = new Uint8Array(component.byteBuffer);
        for (var i = 0; i < bufferArr.length; i += 4) {
            bufferArr[i] = 0; //B
            bufferArr[i + 1] = 0; //G
            bufferArr[i + 2] = 255; //R
            bufferArr[i + 3] = 255; //A
        }
    })
    creator.queueImage(img).then(() => {
        console.info('queueImage succeeded.');
    }).catch(error => {
        console.info('queueImage failed: ' + error);
    })
})

on9+

on(type: 'imageRelease', callback: AsyncCallback<void>): void

監(jiān)聽imageRelease事件，并使用callback返回結(jié)果。

系統(tǒng)能力： SystemCapability.Multimedia.Image.ImageCreator

參數(shù)：

示例：

creator.on('imageRelease', (err) => {
    if (err) {
        console.info('on faild' + err);
    }
    console.info('on succeeded');
})

release9+

release(callback: AsyncCallback<void>): void

釋放當前圖像，并使用callback返回結(jié)果。

系統(tǒng)能力： SystemCapability.Multimedia.Image.ImageCreator

參數(shù)：

示例：

creator.release((err) => {
    if (err) {
        console.info('release failed: ' + err);
    }
    console.info('release succeeded');
});

release9+

release(): Promise<void>

釋放當前圖像，并使用promise返回結(jié)果。

系統(tǒng)能力： SystemCapability.Multimedia.Image.ImageCreator

返回值：

示例：

creator.release().then(() => {
    console.info('release succeeded');
}).catch(error => {
    console.info('release failed');
})