diff --git a/zh-cn/application-dev/reference/apis/js-apis-image.md b/zh-cn/application-dev/reference/apis/js-apis-image.md
index 9dbb932ac72f046b8c5ebe056bb2b74b17534007..74446dfbb9f826742c440d847080c80c9545be43 100644
--- a/zh-cn/application-dev/reference/apis/js-apis-image.md
+++ b/zh-cn/application-dev/reference/apis/js-apis-image.md
@@ -8,28 +8,28 @@
---------
```
-import image from './@ohos.multimedia.image';
+import image from '@ohos.multimedia.image';
```
-## image.createPixelMap
+## image.createPixelMap8+
createPixelMap(colors: ArrayBuffer, opts: InitializetionOptions): Promise\
-通过colors和opts创建pixelmap。
+通过属性创建Pixelmap,通过Promise返回结果。
**系统能力:** SystemCapability.Multimedia.Image
**参数:**
-| 名称 | 类型 | 必填 | 说明 |
-| ------ | ----------------------------------------------- | ---- | ------------------------------------------------------------ |
-| colors | ArrayBuffer | 是 | 颜色数组。 |
-| opts | [InitializetionOptions](#InitializationOptions) | 是 | 创建像素的属性,包括透明度,尺寸,缩略值,像素格式和是否可编辑。 |
+| 名称 | 类型 | 必填 | 说明 |
+| ------ | ------------------------------------------------ | ---- | ------------------------------------------------------------ |
+| colors | ArrayBuffer | 是 | 颜色数组。 |
+| opts | [InitializetionOptions](#InitializationOptions8) | 是 | 创建像素的属性,包括透明度,尺寸,缩略值,像素格式和是否可编辑。 |
**返回值:**
-| 类型 | 说明 |
-| ------------------ | -------------- |
-| Promise\ | 返回pixelmap。 |
+| 类型 | 说明 |
+| -------------------------------- | -------------- |
+| Promise\<[PixelMap](#pixelmap7)> | 返回pixelmap。 |
**示例:**
@@ -41,21 +41,21 @@ image.createPixelMap(Color, opts)
})
```
-## image.createPixelMap
+## image.createPixelMap8+
createPixelMap(colors: ArrayBuffer, opts: InitializetionOptions) callback: AsyncCallback\): void
-通过属性创建pixelmap。
+通过属性创建Pixelmap,通过回调函数返回结果。
**系统能力:** SystemCapability.Multimedia.Image
**参数:**
-| 名称 | 类型 | 必填 | 说明 |
-| -------- | ----------------------------------------------- | ---- | -------------------- |
-| colors | ArrayBuffer | 是 | 颜色数组。 |
-| opts | [InitializetionOptions](#InitializationOptions) | 是 | 属性。 |
-| callback | AsyncCallback\ | 是 | 回调表示成功或失败。 |
+| 名称 | 类型 | 必填 | 说明 |
+| -------- | ------------------------------------------------ | ---- | -------------------- |
+| colors | ArrayBuffer | 是 | 颜色数组。 |
+| opts | [InitializetionOptions](#InitializationOptions8) | 是 | 属性。 |
+| callback | AsyncCallback\<[PixelMap](#pixelmap7)> | 是 | 回调表示成功或失败。 |
**示例:**
@@ -66,21 +66,19 @@ image.createPixelMap(Color, opts, (pixelmap) => {
})
```
-## PixelMap
+## PixelMap7+
图像像素类,用于读取或写入图像数据以及获取图像信息。在调用PixelMap的方法前,需要先通过createPixelMap创建一个PixelMap实例。
### 属性
-| 名称 | 类型 | 可读 | 可写 | 说明 |
-| ---------- | ------- | ---- | ---- | ------------------------------------------------------------ |
-| isEditable | boolean | 是 | 否 | 设定是否图像像素可被编辑。
**系统能力:** SystemCapability.Multimedia.Image |
+| 名称 | 类型 | 可读 | 可写 | 说明 |
+| ----------------------- | ------- | ---- | ---- | ------------------------------------------------------------ |
+| isEditable7+ | boolean | 是 | 否 | 设定是否图像像素可被编辑。
**系统能力:** SystemCapability.Multimedia.Image |
-### readPixelsToBuffer
+### readPixelsToBuffer7+
-```
-readPixelsToBuffer(dst: ArrayBuffer): Promise
-```
+readPixelsToBuffer(dst: ArrayBuffer): Promise\
读取图像像素数据,结果写入ArrayBuffer里,使用Promise形式返回。
@@ -123,11 +121,11 @@ pixelmap.readPixelsToBuffer(readBuffer).then(() => {
})
```
-### readPixelsToBuffer
+### readPixelsToBuffer7+
readPixelsToBuffer(dst: ArrayBuffer, callback: AsyncCallback\): void
-读取图像像素数据,结果写入ArrayBuffer里,使用callback形式返回。
+读取图像像素数据,结果写入ArrayBuffer里,使用callback形式返回。
**系统能力:** SystemCapability.Multimedia.Image
@@ -163,7 +161,7 @@ pixelmap.readPixelsToBuffer(readBuffer, () => {
})
```
-### readPixels
+### readPixels7+
readPixels(area: PositionArea): Promise\
@@ -173,9 +171,9 @@ readPixels(area: PositionArea): Promise\
**参数:**
-| 参数名 | 类型 | 必填 | 说明 |
-| ------ | ----------------------------- | ---- | ------------------------ |
-| area | [PositionArea](#PositionArea) | 是 | 区域大小,根据区域读取。 |
+| 参数名 | 类型 | 必填 | 说明 |
+| ------ | ------------------------------ | ---- | ------------------------ |
+| area | [PositionArea](#positionarea7) | 是 | 区域大小,根据区域读取。 |
**返回值:**
@@ -211,20 +209,20 @@ pixelmap.readPixels(area).then((data) => {
})
```
-### readPixels
+### readPixels7+
readPixels(area: PositionArea, callback: AsyncCallback\): void
-读区域的像素。
+读取区域内的图片数据,使用callback形式返回读取结果。
**系统能力:** SystemCapability.Multimedia.Image
**参数:**
-| 参数名 | 类型 | 必填 | 说明 |
-| -------- | ----------------------------- | ---- | ------------------------------ |
-| area | [PositionArea](#PositionArea) | 是 | 区域大小,根据区域读取。 |
-| callback | AsyncCallback\ | 是 | 获取回调,失败时返回错误信息。 |
+| 参数名 | 类型 | 必填 | 说明 |
+| -------- | ------------------------------ | ---- | ------------------------------ |
+| area | [PositionArea](#positionarea7) | 是 | 区域大小,根据区域读取。 |
+| callback | AsyncCallback\ | 是 | 获取回调,失败时返回错误信息。 |
**示例:**
@@ -247,19 +245,19 @@ pixelmap.readPixels(area,(data) => {
}
```
-### writePixels
+### writePixels7+
writePixels(area: PositionArea): Promise\
-先创建pixelmap,将pixelmap写入指定区域内,使用Promise形式返回写入结果。
+将Pixelmap写入指定区域内,使用Promise形式返回写入结果。
**系统能力:** SystemCapability.Multimedia.Image
**参数:**
-| 参数名 | 类型 | 必填 | 说明 |
-| ------ | ----------------------------- | ---- | -------------------- |
-| area | [PositionArea](#PositionArea) | 是 | 区域,根据区域写入。 |
+| 参数名 | 类型 | 必填 | 说明 |
+| ------ | ------------------------------ | ---- | -------------------- |
+| area | [PositionArea](#PositionArea7) | 是 | 区域,根据区域写入。 |
**返回值:**
@@ -277,20 +275,20 @@ pixelMap.writePixels(area).then(() => {
});
```
-### writePixels
+### writePixels7+
writePixels(area: PositionArea, callback: AsyncCallback\): void
-将指定的像素信息写入指定区域内。
+将Pixelmap写入指定区域内,使用callback形式返回写入结果。
**系统能力:** SystemCapability.Multimedia.Image
**参数:**
-| 参数名 | 类型 | 必填 | 说明 |
-| --------- | ----------------------------- | ---- | ------------------------------ |
-| area | [PositionArea](#PositionArea) | 是 | 区域,根据区域写入。 |
-| callback: | AsyncCallback\ | 是 | 获取回调,失败时返回错误信息。 |
+| 参数名 | 类型 | 必填 | 说明 |
+| --------- | ------------------------------ | ---- | ------------------------------ |
+| area | [PositionArea](#PositionArea7) | 是 | 区域,根据区域写入。 |
+| callback: | AsyncCallback\ | 是 | 获取回调,失败时返回错误信息。 |
**示例:**
@@ -305,19 +303,19 @@ pixelmap.writePixels(area, () => {
})
```
-### writeBufferToPixels
+### writeBufferToPixels7+
writeBufferToPixels(src: ArrayBuffer): Promise\
-将缓冲区的内容写入像素。
+读取缓冲区中的图片数据,结果写入Pixelmap中,使用Promise形式返回。
**系统能力:** SystemCapability.Multimedia.Image
**参数:**
-| 参数名 | 类型 | 必填 | 说明 |
-| ------ | ----------- | ---- | -------- |
-| src | ArrayBuffer | 是 | 缓冲区。 |
+| 参数名 | 类型 | 必填 | 说明 |
+| ------ | ----------- | ---- | -------------- |
+| src | ArrayBuffer | 是 | 图像像素数据。 |
**返回值:**
@@ -335,11 +333,11 @@ pixelMap.writeBufferToPixels(colorBuffer).then(() => {
});
```
-### writeBufferToPixels
+### writeBufferToPixels7+
writeBufferToPixels(src: ArrayBuffer, callback: AsyncCallback\): void
-将缓冲区的内容写入像素。
+读取缓冲区中的图片数据,结果写入Pixelmap中,使用Promise形式返回。
**系统能力:** SystemCapability.Multimedia.Image
@@ -362,7 +360,7 @@ pixelMap.writeBufferToPixels(colorBuffer, function(err) {
});
```
-### getImageInfo
+### getImageInfo7+
getImageInfo(): Promise\
@@ -372,9 +370,9 @@ getImageInfo(): Promise\
**返回值:**
-| 类型 | 说明 |
-| ------------------- | ----------------------------------------------------------- |
-| Promise\ | Promise实例,用于异步获取图像像素信息,失败时返回错误信息。 |
+| 类型 | 说明 |
+| --------------------------------- | ----------------------------------------------------------- |
+| Promise\<[ImageInfo](#imageinfo)> | Promise实例,用于异步获取图像像素信息,失败时返回错误信息。 |
**示例:**
@@ -386,7 +384,7 @@ pixelMap.getImageInfo().then(function(info) {
});
```
-### getImageInfo
+### getImageInfo7+
getImageInfo(callback: AsyncCallback\): void
@@ -396,9 +394,9 @@ getImageInfo(callback: AsyncCallback\): void
**参数:**
-| 参数名 | 类型 | 必填 | 说明 |
-| -------- | ------------------------- | ---- | ------------------------------------------------------------ |
-| callback | AsyncCallback\ | 是 | 获取图像像素信息回调,异步返回图像像素信息,失败时返回错误信息。 |
+| 参数名 | 类型 | 必填 | 说明 |
+| -------- | --------------------------------------- | ---- | ------------------------------------------------------------ |
+| callback | AsyncCallback\<[ImageInfo](#imageinfo)> | 是 | 获取图像像素信息回调,异步返回图像像素信息,失败时返回错误信息。 |
**示例:**
@@ -418,9 +416,9 @@ pixelmap.getImageInfo((imageInfo) => {
})
```
-### getBytesNumberPerRow
+### getBytesNumberPerRow7+
-getBytesNumberPerRow(): Promise\
+getBytesNumberPerRow(): number
获取图像像素每行字节数。
@@ -428,9 +426,9 @@ getBytesNumberPerRow(): Promise\
**返回值:**
-| 类型 | 说明 |
-| ---------------- | --------------------------------------------- |
-| Promise\ | Promise实例,用于异步获取图像像素的行字节数。 |
+| 类型 | 说明 |
+| ------ | -------------------- |
+| number | 图像像素的行字节数。 |
**示例:**
@@ -442,33 +440,9 @@ pixelmap.getBytesNumberPerRow().then((num) => {
})
```
-### getBytesNumberPerRow
-
-getBytesNumberPerRow(callback: AsyncCallback\): void
-
-获取图像像素每行字节数。
+### getPixelBytesNumber7+
-**系统能力:** SystemCapability.Multimedia.Image
-
-**参数:**
-
-| 参数名 | 类型 | 必填 | 说明 |
-| -------- | ---------------------- | ---- | ------------------ |
-| callback | AsyncCallback\ | 是 | 通过回调返回结果。 |
-
-**示例:**
-
-```js
-pixelmap.getBytesNumberPerRow( num => {
- console.info('TC_025-1 num is ' + num);
- expect(num == expectNum).assertTrue();
- done();
- })
-```
-
-### getPixelBytesNumber
-
-getPixelBytesNumber(): Promise\
+getPixelBytesNumber(): number
获取图像像素的总字节数。
@@ -476,9 +450,9 @@ getPixelBytesNumber(): Promise\
**返回值:**
-| 类型 | 说明 |
-| ---------------- | --------------------------------------------- |
-| Promise\ | Promise实例,用于异步获取图像像素的总字节数。 |
+| 类型 | 说明 |
+| ------ | -------------------- |
+| number | 图像像素的总字节数。 |
**示例:**
@@ -490,37 +464,19 @@ pixelmap.getPixelBytesNumber().then((num) => {
})
```
-### getPixelBytesNumber
+### release7+
-getPixelBytesNumber(callback: AsyncCallback\): void
+release():Promise\
-获取图像像素的总字节数。
+释放Pixelmap对象,使用Promise形式返回释放结果。
**系统能力:** SystemCapability.Multimedia.Image
-**参数:**
-
-| 参数名 | 类型 | 必填 | 说明 |
-| -------- | ---------------------- | ---- | ------------------ |
-| callback | AsyncCallback\ | 是 | 通过回调返回结果。 |
-
-**示例:**
-
-```js
-pixelmap.getPixelBytesNumber((num) => {
- console.info('TC_026-1 num is ' + num)
- expect(num == expectNum).assertTrue()
- done()
- })
-```
-
-### release
-
-release(): void
-
-释放pixelmap对象,使用Promise形式返回释放结果。
+**返回值:**
-**系统能力:** SystemCapability.Multimedia.Image
+| 类型 | 说明 |
+| -------------- | ------------------ |
+| Promise\ | 异步返回释放结果。 |
**示例:**
@@ -530,110 +486,80 @@ pixelmap.release()
done()
```
-## image.createImageSource
-
-createImageSource(uri: string): ImageSource
-
-创建图片源。
-
-**系统能力:** SystemCapability.Multimedia.Image
-
-**参数:**
-
-| 参数名 | 类型 | 必填 | 说明 |
-| ------ | ------ | ---- | ---------- |
-| uri | string | 是 | 图片路径。 |
-
-**返回值:**
-
-| 类型 | 说明 |
-| ----------- | ------------ |
-| ImageSource | 返回图片源。 |
-
-**示例:**
+### release7+
-```js
-const imageSourceApi = image.createImageSource('/data/local/tmp/test.jpg')
-```
-
-## image.createImageSource
-
-createImageSource(fd: number): ImageSource
+release(callback: AsyncCallback\): void
-创建图片源。
+释放Pixelmap对象,使用callback形式返回释放结果。
**系统能力:** SystemCapability.Multimedia.Image
**参数:**
-| 参数名 | 类型 | 必填 | 说明 |
-| ------ | ------ | ---- | ------------------ |
-| fd | number | 是 | 基于fd创建图片源。 |
-
-**返回值:**
-
-| 类型 | 说明 |
-| ----------- | ------------ |
-| ImageSource | 返回图片源。 |
+| 名称 | 类型 | 必填 | 说明 |
+| -------- | -------------------- | ---- | ------------------ |
+| callback | AsyncCallback\ | 是 | 异步返回释放结果。 |
**示例:**
```js
-const imageSourceApi = image.createImageSource(0)
+pixelmap.release(()=>{
+ expect(true).assertTrue();
+ console.log('TC_027-1 success');
+ done();
+ })
```
## image.createImageSource
-createImageSource(data: ArrayBuffer): ImageSource
+createImageSource(uri: string): ImageSource
-创建图片源。
+通过传入的uri创建图片源实例。
**系统能力:** SystemCapability.Multimedia.Image
**参数:**
-| 参数名 | 类型 | 必填 | 说明 |
-| ------ | ----------- | ---- | ------ |
-| data | ArrayBuffer | 是 | 数组。 |
+| 参数名 | 类型 | 必填 | 说明 |
+| ------ | ------ | ---- | ---------------------------------- |
+| uri | string | 是 | 图片路径,当前仅支持本地绝对路径。 |
**返回值:**
-| 类型 | 说明 |
-| ----------- | ------------ |
-| ImageSource | 返回图片源。 |
+| 类型 | 说明 |
+| --------------------------- | --------------------------------------- |
+| [ImageSource](#imagesource) | 返回ImageSource类实例,失败时返回null。 |
**示例:**
```js
-const data = new ArrayBuffer(96);
-const imageSourceApi = image.createImageSource(data);
+const imageSourceApi = image.createImageSource('/data/local/tmp/test.jpg')
```
-## image.createIncrementalSource
+## image.createImageSource7+
-createIncrementalSource(data: ArrayBuffer): ImageSource
+createImageSource(fd: number): ImageSource
-创建增量图片源。
+通过传入文件描述符来创建图片源实例。
**系统能力:** SystemCapability.Multimedia.Image
**参数:**
-| 参数名 | 类型 | 必填 | 说明 |
-| ------ | ----------- | ---- | ---- |
-| data | ArrayBuffer | 是 | 数组 |
+| 参数名 | 类型 | 必填 | 说明 |
+| ------ | ------ | ---- | -------------- |
+| fd | number | 是 | 文件描述符fd。 |
**返回值:**
-| 类型 | 说明 |
-| ----------- | ------------ |
-| ImageSource | 返回图片源。 |
+| 类型 | 说明 |
+| --------------------------- | --------------------------------------- |
+| [ImageSource](#imagesource) | 返回ImageSource类实例,失败时返回null。 |
**示例:**
```js
-const data = new ArrayBuffer(96);
-const imageSourceApi = image.createIncrementalSource(data);
+const imageSourceApi = image.createImageSource(0)
```
## ImageSource
@@ -656,10 +582,10 @@ getImageInfo(index: number, callback: AsyncCallback\): void
**参数:**
-| 参数名 | 类型 | 必填 | 说明 |
-| -------- | -------------------------------------- | ---- | ----------------------------------------------- |
-| index | number | 是 | 图片序号,创建图片源时的序号,不选择时默认为0。 |
-| callback | AsyncCallback<[ImageInfo](#ImageInfo)> | 是 | 获取图片信息回调,异步返回图片信息对象。 |
+| 参数名 | 类型 | 必填 | 说明 |
+| -------- | -------------------------------------- | ---- | ---------------------------------------- |
+| index | number | 是 | 创建图片源时的序号。 |
+| callback | AsyncCallback<[ImageInfo](#imageinfo)> | 是 | 获取图片信息回调,异步返回图片信息对象。 |
**示例:**
@@ -684,7 +610,7 @@ it('TC_046', 0, async function (done) {
getImageInfo(callback: AsyncCallback\): void
-获取指定序号的图片信息,使用callback形式返回图片信息。
+获取图片信息,使用callback形式返回图片信息。
**系统能力:** SystemCapability.Multimedia.Image
@@ -692,7 +618,7 @@ getImageInfo(callback: AsyncCallback\): void
| 名称 | 类型 | 必填 | 说明 |
| -------- | -------------------------------------- | ---- | ---------------------------------------- |
-| callback | AsyncCallback<[ImageInfo](#ImageInfo)> | 是 | 获取图片信息回调,异步返回图片信息对象。 |
+| callback | AsyncCallback<[ImageInfo](#imageinfo)> | 是 | 获取图片信息回调,异步返回图片信息对象。 |
**示例:**
@@ -714,15 +640,15 @@ getImageInfo(index?: number): Promise\
**参数:**
-| 名称 | 类型 | 必填 | 说明 |
-| ----- | ------ | ---- | ----------------------------------------------- |
-| index | number | 否 | 图片序号,创建图片源时的序号,不选择时默认为0。 |
+| 名称 | 类型 | 必填 | 说明 |
+| ----- | ------ | ---- | ------------------------------------- |
+| index | number | 否 | 创建图片源时的序号,不选择时默认为0。 |
**返回值:**
-| 类型 | 说明 |
-| --------------------------------- | ---------------------- |
-| Promise\<[ImageInfo](#ImageInfo)> | 返回获取到的图片信息。 |
+| 类型 | 说明 |
+| -------------------------------- | ---------------------- |
+| Promise<[ImageInfo](#imageinfo)> | 返回获取到的图片信息。 |
**示例:**
@@ -735,20 +661,20 @@ imageSourceApi.getImageInfo(0)
})
```
-### getImageProperty
+### getImageProperty7+
getImageProperty(key:string, options?: GetImagePropertyOptions): Promise\
-获取图片中给定索引处图像的指定属性键的值。
+获取图片中给定索引处图像的指定属性键的值,用Promise形式返回结果。
**系统能力:** SystemCapability.Multimedia.Image
**参数:**
-| 名称 | 类型 | 必填 | 说明 |
-| ------- | --------------------------------------------------- | ---- | ------------------------------------ |
-| key | string | 是 | 图片属性名。 |
-| options | [GetImagePropertyOptions](#GetImagePropertyOptions) | 否 | 图片属性,包括图片序号与默认属性值。 |
+| 名称 | 类型 | 必填 | 说明 |
+| ------- | ---------------------------------------------------- | ---- | ------------------------------------ |
+| key | string | 是 | 图片属性名。 |
+| options | [GetImagePropertyOptions](#getimagepropertyoptions7) | 否 | 图片属性,包括图片序号与默认属性值。 |
**返回值:**
@@ -762,11 +688,11 @@ getImageProperty(key:string, options?: GetImagePropertyOptions): Promise\7+
getImageProperty(key:string, callback: AsyncCallback\): void
-获取图片中给定索引处图像的指定属性键的值,使用callback形式返回结果。
+获取图片中给定索引处图像的指定属性键的值,用callback形式返回结果。
**系统能力:** SystemCapability.Multimedia.Image
@@ -783,7 +709,7 @@ getImageProperty(key:string, callback: AsyncCallback\): void
const w = imageSourceApi.getImageProperty("ImageWidth",w=>{})
```
-### getImageProperty
+### getImageProperty7+
getImageProperty(key:string, options: GetImagePropertyOptions, callback: AsyncCallback\): void
@@ -793,11 +719,11 @@ getImageProperty(key:string, options: GetImagePropertyOptions, callback: AsyncCa
**参数:**
-| 参数名 | 类型 | 必填 | 说明 |
-| -------- | --------------------------------------------------- | ---- | ------------------------------------------------------------ |
-| key | string | 是 | 图片属性名。 |
-| options | [GetImagePropertyOptions](#GetImagePropertyOptions) | 是 | 图片属性,包括图片序号与默认属性值。 |
-| callback | AsyncCallback\ | 是 | 获取图片属性回调,返回图片属性值,如获取失败则返回属性默认值。 |
+| 参数名 | 类型 | 必填 | 说明 |
+| -------- | ---------------------------------------------------- | ---- | ------------------------------------------------------------ |
+| key | string | 是 | 图片属性名。 |
+| options | [GetImagePropertyOptions](#getimagepropertyoptions7) | 是 | 图片属性,包括图片序号与默认属性值。 |
+| callback | AsyncCallback\ | 是 | 获取图片属性回调,返回图片属性值,如获取失败则返回属性默认值。 |
**示例:**
@@ -805,107 +731,21 @@ getImageProperty(key:string, options: GetImagePropertyOptions, callback: AsyncCa
imageSourceApi.getImageProperty("ImageWidth",PropertyOptions,(w)=>{})
```
-### modifyImageProperty
-
-modifyImageProperty(key:string, value:string, options?: GetImagePropertyOptions): Promise\
-
-修改属性的值。
-
-**系统能力:** SystemCapability.Multimedia.Image
-
-**参数:**
-
-| 参数名 | 类型 | 必填 | 说明 |
-| ------- | --------------------------------------------------- | ---- | ------------------------------------ |
-| key | string | 是 | 图片属性名。 |
-| value | string | 是 | 属性值。 |
-| options | [GetImagePropertyOptions](#GetImagePropertyOptions) | 是 | 图片属性,包括图片序号与默认属性值。 |
-
-**返回值:**
-
-| 类型 | 说明 |
-| -------------- | --------------------------- |
-| Promise\ | Promise实例,异步返回结果。 |
-
-**示例:**
-
-**示例:**
-
-```js
-imageSourceApi.modifyImageProperty("ImageWidth", "abc")
- .then(() => {
- const w = imageSourceApi.getImageProperty("ImageWidth")
- console.info('w', w);
- expect(w == 'abc').assertTrue();
- done();
- })
-```
-
-### modifyImageProperty
-
-modifyImageProperty(key:string, value:string, callback: AsyncCallback\): void
-
-修改属性的值,callback返回结果。
-
-**系统能力:** SystemCapability.Multimedia.Image
-
-**参数:**
-
-| 参数名 | 类型 | 必填 | 说明 |
-| -------- | -------------------- | ---- | ------------------------------ |
-| key | string | 是 | 图片属性名。 |
-| value | string | 是 | 属性值。 |
-| callback | AsyncCallback\ | 是 | 修改属性值,callback返回结果。 |
-
-**示例:**
-
-```js
-imageSourceApi.modifyImageProperty("ImageWidth", "abc",() => {})
-```
-
-### modifyImageProperty
-
-modifyImageProperty(key:string, value:string, options: GetImagePropertyOptions,callback: AsyncCallback\): void
-
-修改属性的值,callback返回结果。
-
-**系统能力:** SystemCapability.Multimedia.Image
-
-**参数:**
-
-| 参数名 | 类型 | 必填 | 说明 |
-| -------- | --------------------------------------------------- | ---- | ------------------------------------ |
-| key | string | 是 | 图片属性名。 |
-| value | string | 是 | 属性值。 |
-| options | [GetImagePropertyOptions](#GetImagePropertyOptions) | 是 | 图片属性,包括图片序号与默认属性值。 |
-| callback | AsyncCallback\ | 是 | 修改属性值,callback返回结果。 |
-
-**示例:**
-
-```js
-let PropertyOptions = {
- index:0,
- defaultValue:'a'
-imageSourceApi.modifyImageProperty("ImageWidth", "abc",PropertyOptions,() => {
-
- };
-```
-
-### createPixelMap
+### createPixelMap7+
createPixelMap(index: number, options: DecodingOptions, callback: AsyncCallback\): void
-通过图片解码参数创建pixelmap对象,使用callback形式返回结果。
+通过图片解码参数创建Pixelmap对象,使用callback形式返回结果。
**系统能力:** SystemCapability.Multimedia.Image
**参数:**
-| 名称 | 类型 | 必填 | 说明 |
-| ------------- | ------------------------------------ | ---- | -------------------- |
-| options | [DecodingOptions](#DecodingOptions) | 是 | 解码参数。 |
-| index | number | 是 | 图片索引。 |
-| AsyncCallback | AsyncCallback<[PixelMap](#PixelMap)> | 是 | 回调表示成功或失败。 |
+| 名称 | 类型 | 必填 | 说明 |
+| ------------- | ------------------------------------- | ---- | -------------------- |
+| options | [DecodingOptions](#decodingoptions7) | 是 | 解码参数。 |
+| index | number | 是 | 图片索引。 |
+| AsyncCallback | AsyncCallback<[PixelMap](#pixelmap7)> | 是 | 回调表示成功或失败。 |
**示例:**
@@ -917,7 +757,7 @@ imageSourceApi.createPixelMap().then(pixelmap => {
})
```
-### createPixelMap
+### createPixelMap7+
createPixelMap(options: DecodingOptions, callback: AsyncCallback\): void
@@ -927,10 +767,10 @@ createPixelMap(options: DecodingOptions, callback: AsyncCallback\): vo
**参数:**
-| 名称 | 类型 | 必填 | 说明 |
-| -------- | ------------------------------------ | ---- | -------------------- |
-| options | [DecodingOptions](#DecodingOptions) | 是 | 解码参数。 |
-| callback | AsyncCallback<[PixelMap](#PixelMap)> | 是 | 回调表示成功或失败。 |
+| 名称 | 类型 | 必填 | 说明 |
+| -------- | ------------------------------------- | ---- | -------------------- |
+| options | [DecodingOptions](#decodingoptions7) | 是 | 解码参数。 |
+| callback | AsyncCallback<[PixelMap](#pixelmap7)> | 是 | 回调表示成功或失败。 |
**示例:**
@@ -950,7 +790,7 @@ let decodingOptions = {
})
```
-### createPixelMap
+### createPixelMap7+
createPixelMap(opts: DecodingOptions, callback: AsyncCallback\): void
@@ -960,10 +800,10 @@ createPixelMap(opts: DecodingOptions, callback: AsyncCallback\): void
**参数:**
-| 名称 | 类型 | 必填 | 说明 |
-| -------- | ------------------------------------ | ---- | -------------------- |
-| opts | [DecodingOptions](#DecodingOptions) | 是 | 解码参数。 |
-| callback | AsyncCallback<[PixelMap](#PixelMap)> | 是 | 回调表示成功或失败。 |
+| 名称 | 类型 | 必填 | 说明 |
+| -------- | ------------------------------------- | ---- | -------------------- |
+| opts | [DecodingOptions](#decodingoptions7) | 是 | 解码参数。 |
+| callback | AsyncCallback<[PixelMap](#pixelmap7)> | 是 | 回调表示成功或失败。 |
**示例:**
@@ -981,103 +821,14 @@ let decodingOptions = {
console.info('TC_050-1 createPixelMap ');
expect(pixelmap !== null ).assertTrue();
done();
- })
-```
-
-### updateData
-
-updateData(data: Array\, isFinal: boolean, offset: number, length: number, callback: AsyncCallback\): void
-
-更新增量数据。
-
-**系统能力:** SystemCapability.Multimedia.Image
-
-**参数:**
-
-| 名称 | 类型 | 必填 | 说明 |
-| -------- | ----------------------- | ---- | -------------------- |
-| data | Array\ | 是 | 增量数据。 |
-| isFinal | boolean | 是 | 是否更新完。 |
-| offset | number | 是 | 偏移量。 |
-| length | number | 是 | 数组长。 |
-| callback | AsyncCallback\ | 是 | 回调表示成功或失败。 |
-
-**示例:**
-
-```js
-imageSourceIncrementalSApi.updateData(array, false, 0, 10,(error,data )=> {
- if(data !== undefined){
- expect(data).assertTrue();
- console.info('TC_053-1 success');
- done();
- }
-```
-
-### updateData
-
-updateData(data: Array\, isFinal: boolean, offset?: number, length?: number): Promise\
-
-更新增量数据。
-
-**系统能力:** SystemCapability.Multimedia.Image
-
-**参数:**
-
-| 名称 | 类型 | 必填 | 说明 |
-| ------- | -------------- | ---- | ------------ |
-| data | Array\ | 是 | 增量数据。 |
-| isFinal | boolean | 是 | 是否更新完。 |
-| offset | boolean | 否 | 偏移量。 |
-| length | number | 否 | 数组长。 |
-
-**返回值:**
-
-| 类型 | 说明 |
-| ----------------- | --------------------------------- |
-| Promise\ | Promise实例,异步返回成功或失败。 |
-
-**示例:**
-
-```js
- imageSourceIncrementalSApi.updateData(array, false, 0, 10).then(data => {
- expect(data).assertTrue();
- console.info('TC_053 success');
- done();
- })
-```
-
-### updateData
-
-updateData(data: Array\, isFinal: boolean, callback: AsyncCallback\): void
-
-更新增量数据。
-
-**系统能力:** SystemCapability.Multimedia.Image
-
-**参数:**
-
-| 名称 | 类型 | 必填 | 说明 |
-| -------- | ----------------------- | ---- | -------------------- |
-| data | Array\ | 是 | 增量数据。 |
-| isFinal | boolean | 是 | 是否更新完。 |
-| callback | AsyncCallback\ | 是 | 回调表示成功或失败。 |
-
-**示例:**
-
-```js
-imageSourceIncrementalSApi.updateData(array, false,(error,data) => {
- if(data !== undefined){
- expect(data).assertTrue();
- console.info('TC_053-2 success');
- done();
- }
+ })
```
### release
release(callback: AsyncCallback\): void
-释放图片源。
+释放图片源实例,使用callback形式返回结果。
**系统能力:** SystemCapability.Multimedia.Image
@@ -1102,7 +853,7 @@ imageSourceApi.release(() => {
release(): Promise\
-释放图片源。
+释放图片源实例,使用Promise形式返回结果。
**系统能力:** SystemCapability.Multimedia.Image
@@ -1126,15 +877,15 @@ release(): Promise\
createImagePacker(): ImagePacker
-创建imagepacker实例。
+创建ImagePacker实例。
**系统能力:** SystemCapability.Multimedia.Image
**返回值:**
-| 类型 | 说明 |
-| ----------- | ----------------- |
-| ImagePacker | 返回ImagePacker。 |
+| 类型 | 说明 |
+| ----------- | ---------------------- |
+| ImagePacker | 返回ImagePackers实例。 |
**示例:**
@@ -1150,7 +901,7 @@ const imagePackerApi = image.createImagePacker();
| 名称 | 类型 | 可读 | 可写 | 说明 |
| ---------------- | -------------- | ---- | ---- | ------------------------------------------------------------ |
-| supportedFormats | Array\ | 是 | 否 | 图片打包支持的格式,jpg。
**系统能力:** SystemCapability.Multimedia.Image |
+| supportedFormats | Array\ | 是 | 否 | 图片打包支持的格式,jpeg。
**系统能力:** SystemCapability.Multimedia.Image |
### packing
@@ -1164,8 +915,8 @@ packing(source: ImageSource, option: PackingOption, callback: AsyncCallback> | 是 | 获取图片打包回调,返回打包后数据。 |
**示例:**
@@ -1183,7 +934,7 @@ let packOpts = { format:["image/jpeg"], quality:98 }
packing(source: ImageSource, option: PackingOption): Promise>
-图片压缩或重新打包,使用promise形式返回结果。
+图片压缩或重新打包,使用Promise形式返回结果。
**系统能力:** SystemCapability.Multimedia.Image
@@ -1191,8 +942,8 @@ packing(source: ImageSource, option: PackingOption): Promise>
| 参数名 | 类型 | 必填 | 说明 |
| ------ | ------------------------------- | ---- | -------------- |
-| source | [ImageSource](#ImageSource) | 是 | 打包的图片源。 |
-| option | [PackingOption](#PackingOption) | 是 | 设置打包参数。 |
+| source | [ImageSource](#imagesource) | 是 | 打包的图片源。 |
+| option | [PackingOption](#packingoption) | 是 | 设置打包参数。 |
**返回值:**
@@ -1216,15 +967,15 @@ let packOpts = { format:["image/jpeg"], quality:98 }
release(callback: AsyncCallback\): void
-释放packer对象。
+释放图片打包实例,使用callback形式返回结果。
**系统能力:** SystemCapability.Multimedia.Image
**参数:**
-| 参数名 | 类型 | 必填 | 说明 |
-| -------- | -------------------- | ---- | ---------------------- |
-| callback | AsyncCallback\ | 是 | 回调表示成功还是失败。 |
+| 参数名 | 类型 | 必填 | 说明 |
+| -------- | -------------------- | ---- | ------------------------------ |
+| callback | AsyncCallback\ | 是 | 释放回调,失败时返回错误信息。 |
**示例:**
@@ -1239,15 +990,15 @@ imagePackerApi.release(()=>{
release(): Promise\
-释放packer对象。
+释放图片打包实例,使用Promise形式返回释放结果。
**系统能力:** SystemCapability.Multimedia.Image
**返回值:**
-| 类型 | 说明 |
-| :------------- | :------------------------------ |
-| Promise\ | Promise实例,用于异步返回结果。 |
+| 类型 | 说明 |
+| :------------- | :------------------------------------------------------ |
+| Promise\ | Promise实例,用于异步获取释放结果,失败时返回错误信息。 |
**示例:**
@@ -1258,128 +1009,150 @@ imagePackerApi.release();
done();
```
-## PositionArea
+## PositionArea7+
+
+表示图片指定区域内的数据。
+
+**系统能力:** 以下各项对应的系统能力均为SystemCapability.Multimedia.Image
+
+| 名称 | 类型 | 可读 | 可写 | 说明 |
+| ------ | ------------------ | ---- | ---- | -------------------- |
+| pixels | ArrayBuffer | 是 | 否 | 像素。 |
+| offset | number | 是 | 否 | 偏移量。 |
+| stride | number | 是 | 否 | 像素间距。 |
+| region | [Region](#region8) | 是 | 否 | 区域,按照区域读写。 |
-| 名称 | 类型 | 可读 | 可写 | 说明 |
-| ------ | ----------------- | ---- | ---- | ------------------------------------------------------------ |
-| pixels | ArrayBuffer | 是 | 否 | 像素。
**系统能力:** SystemCapability.Multimedia.Image |
-| offset | number | 是 | 否 | 偏移量。
**系统能力:** SystemCapability.Multimedia.Image |
-| stride | number | 是 | 否 | 像素间距。
**系统能力:** SystemCapability.Multimedia.Image |
-| region | [Region](#Region) | 是 | 否 | 区域,按照区域读写。
**系统能力:** SystemCapability.Multimedia.Image |
+## **ImageInfo**
-## **ImageInfo**
+表示图片信息。
-| 名称 | 类型 | 可读 | 可写 | 说明 |
-| ----------- | --------------------------------- | ---- | ---- | ------------------------------------------------------------ |
-| size | [Size](#Size) | 是 | 是 | 图片大小。
**系统能力:** SystemCapability.Multimedia.Image |
-| pixelFormat | [PixelMapFormat](#PixelMapFormat) | 是 | 是 | 图片格式。
**系统能力:** SystemCapability.Multimedia.Image |
-| colorSpace | [ColorSpace](#ColorSpace) | 是 | 是 | 色域。
**系统能力:** SystemCapability.Multimedia.Image |
-| alphaType | [AlphaType](#AlphaType) | 是 | 是 | 透明度。
**系统能力:** SystemCapability.Multimedia.Image |
+**系统能力:** 以下各项对应的系统能力均为SystemCapability.Multimedia.Image
-## Size
+| 名称 | 类型 | 可读 | 可写 | 说明 |
+| ---- | ------------- | ---- | ---- | ---------- |
+| size | [Size](#size) | 是 | 是 | 图片大小。 |
-| 名称 | 类型 | 可读 | 可写 | 说明 |
-| ------ | ------ | ---- | ---- | ------------------------------------------------------------ |
-| height | number | 是 | 是 | 输出图片的高。
**系统能力:** SystemCapability.Multimedia.Image |
-| width | number | 是 | 是 | 输出图片的宽。
**系统能力:** SystemCapability.Multimedia.Image |
+## Size
-## PixelMapFormat
+表示图片尺寸。
+
+**系统能力:** 以下各项对应的系统能力均为SystemCapability.Multimedia.Image
+
+| 名称 | 类型 | 可读 | 可写 | 说明 |
+| ------ | ------ | ---- | ---- | -------------- |
+| height | number | 是 | 是 | 输出图片的高。 |
+| width | number | 是 | 是 | 输出图片的宽。 |
+
+## PixelMapFormat7+
枚举,像素格式。
-| 名称 | 默认值 | 描述 |
-| --------- | ------ | ------------------------------------------------------------ |
-| UNKNOWN | 0 | 未知格式。
**系统能力:** SystemCapability.Multimedia.Image |
-| ARGB_8888 | 1 | 格式为ARGB_8888。
**系统能力:** SystemCapability.Multimedia.Image |
-| RGB_565 | 2 | 格式为RGB_565。
**系统能力:** SystemCapability.Multimedia.Image |
-
-## ColorSpace
-
-枚举,色块。
-
-| 名称 | 默认值 | 描述 |
-| -------------------- | ------ | ------------------------------------------------------------ |
-| UNKNOWN | 0 | 色块基于unknown color space。
**系统能力:** SystemCapability.Multimedia.Image |
-| DISPLAY_P3 | 1 | 色块基于 SMPTE RP 431-2-2007 and IEC 61966-2.1:199。
**系统能力:** SystemCapability.Multimedia.Image |
-| SRGB | 2 | 色块基于IEC 61966-2.1:1999。
**系统能力:** SystemCapability.Multimedia.Image |
-| LINEAR_SRGB | 3 | 色块基于the IEC 61966-2.1:1999。
**系统能力:** SystemCapability.Multimedia.Image |
-| EXTENDED_SRGB | 4 | 色块基于IEC 61966-2-2:2003。
**系统能力:** SystemCapability.Multimedia.Image |
-| LINEAR_EXTENDED_SRGB | 5 | 色块基于IEC 61966-2-2:2003。
**系统能力:** SystemCapability.Multimedia.Image |
-| GENERIC_XYZ | 6 | 色块基于D50。
**系统能力:** SystemCapability.Multimedia.Image |
-| GENERIC_LAB | 7 | 色块基于 CIE XYZ D50。
**系统能力:** SystemCapability.Multimedia.Image |
-| ACES | 8 | 色块基于SMPTE ST 2065-1:2012。
**系统能力:** SystemCapability.Multimedia.Image |
-| ACES_CG | 9 | 色块基于Academy S-2014-004。
**系统能力:** SystemCapability.Multimedia.Image |
-| ADOBE_RGB_1998 | 10 | 色块基于 Adobe RGB。
**系统能力:** SystemCapability.Multimedia.Image |
-| DCI_P3 | 11 | 色块基于SMPTE RP 431-2-2007。
**系统能力:** SystemCapability.Multimedia.Image |
-| ITU_709 | 12 | 色块基于Rec.ITU-R BT.709-5。
**系统能力:** SystemCapability.Multimedia.Image |
-| ITU_2020 | 13 | 色块基于Rec.ITU-R BT.2020-1。
**系统能力:** SystemCapability.Multimedia.Image |
-| ROMM_RGB | 14 | 色块基于ISO 22028-2:2013。
**系统能力:** SystemCapability.Multimedia.Image |
-| NTSC_1953 | 15 | 色块基于NTSC 1953 standard。
**系统能力:** SystemCapability.Multimedia.Image |
-| SMPTE_C | 16 | 色块基于 SMPTE C。
**系统能力:** SystemCapability.Multimedia.Image |
-
-## AlphaType
+**系统能力:** 以下各项对应的系统能力均为SystemCapability.Multimedia.Image
+
+| 名称 | 默认值 | 描述 |
+| --------- | ------ | ----------------- |
+| UNKNOWN | 0 | 未知格式。 |
+| RGBA_8888 | 3 | 格式为RGBA_8888。 |
+| RGB_565 | 2 | 格式为RGB_565。 |
+
+## AlphaType8+
枚举,透明度。
-| 名称 | 默认值 | 描述 |
-| -------- | ------ | ------------------------------------------------------------ |
-| UNKNOWN | 0 | 未知透明度。
**系统能力:** SystemCapability.Multimedia.Image |
-| OPAQUE | 1 | 没有alpha或图片全透明。
**系统能力:** SystemCapability.Multimedia.Image |
-| PREMUL | 2 | RGB前乘alpha。
**系统能力:** SystemCapability.Multimedia.Image |
-| UNPREMUL | 3 | RGB不前乘alpha。
**系统能力:** SystemCapability.Multimedia.Image |
+**系统能力:** 以下各项对应的系统能力均为SystemCapability.Multimedia.Image
+
+| 名称 | 默认值 | 描述 |
+| -------- | ------ | ----------------------- |
+| UNKNOWN | 0 | 未知透明度。 |
+| OPAQUE | 1 | 没有alpha或图片全透明。 |
+| PREMUL | 2 | RGB前乘alpha。 |
+| UNPREMUL | 3 | RGB不前乘alpha。 |
-## ScaleMode
+## ScaleMode8+
枚举,缩略值。
-| 名称 | 默认值 | 描述 |
-| --------------- | ------ | ------------------------------------------------------------ |
-| CENTER_CROP | 1 | 缩放图像以填充目标图像区域并居中裁剪区域外的效果。
**系统能力:** SystemCapability.Multimedia.Image |
-| FIT_TARGET_SIZE | 2 | 图像适合目标尺寸的效果。
**系统能力:** SystemCapability.Multimedia.Image |
+**系统能力:** 以下各项对应的系统能力均为SystemCapability.Multimedia.Image
-## InitializationOptions
+| 名称 | 默认值 | 描述 |
+| --------------- | ------ | -------------------------------------------------- |
+| CENTER_CROP | 1 | 缩放图像以填充目标图像区域并居中裁剪区域外的效果。 |
+| FIT_TARGET_SIZE | 2 | 图像适合目标尺寸的效果。 |
-| 名称 | 类型 | 可读 | 可写 | 说明 |
-| ----------- | --------------------------------- | ---- | ---- | ------------------------------------------------------------ |
-| alphaType | [AlphaType](#AlphaType) | 是 | 是 | 透明度。
**系统能力:** SystemCapability.Multimedia.Image |
-| editable | boolean | 是 | 是 | 是否可编辑。
**系统能力:** SystemCapability.Multimedia.Image |
-| pixelFormat | [PixelMapFormat](#PixelMapFormat) | 是 | 是 | 像素格式。
**系统能力:** SystemCapability.Multimedia.Image |
-| scalemode | [ScaleMode](#ScaleMode) | 是 | 是 | 缩略值。
**系统能力:** SystemCapability.Multimedia.Image |
-| size | [Size](#Size) | 是 | 是 | 创建图片大小。
**系统能力:** SystemCapability.Multimedia.Image |
+## InitializationOptions8+
-## DecodingOptions
+**系统能力:** 以下各项对应的系统能力均为SystemCapability.Multimedia.Image
+
+| 名称 | 类型 | 可读 | 可写 | 说明 |
+| ----------- | ---------------------------------- | ---- | ---- | -------------- |
+| alphaType | [AlphaType](#alphatype8) | 是 | 是 | 透明度。 |
+| editable | boolean | 是 | 是 | 是否可编辑。 |
+| pixelFormat | [PixelMapFormat](#pixelmapformat7) | 是 | 是 | 像素格式。 |
+| scaleMode | [ScaleMode](#scalemode8) | 是 | 是 | 缩略值。 |
+| size | [Size](#size) | 是 | 是 | 创建图片大小。 |
+
+## DecodingOptions7+
解码设置选项。
-| 名称 | 类型 | 可读 | 可写 | 说明 |
-| ------------------ | --------------------------------- | ---- | ---- | ------------------------------------------------------------ |
-| sampleSize | number | 是 | 是 | 缩略图采样大小。
**系统能力:** SystemCapability.Multimedia.Image |
-| rotateDegrees | number | 是 | 是 | 旋转角度。
**系统能力:** SystemCapability.Multimedia.Image |
-| editable | boolean | 是 | 是 | 是否可编辑。
**系统能力:** SystemCapability.Multimedia.Image |
-| desiredSize | [Size](#Size) | 是 | 是 | 期望输出大小。
**系统能力:** SystemCapability.Multimedia.Image |
-| desiredRegion | [Region](#Region) | 是 | 是 | 解码区域。
**系统能力:** SystemCapability.Multimedia.Image |
-| desiredPixelFormat | [PixelMapFormat](#PixelMapFormat) | 是 | 是 | 解码的像素格式。
**系统能力:** SystemCapability.Multimedia.Image |
-| reusedPixelMap | [PixelMap](#PixelMap) | 是 | 是 | 将当前buffer地址给新创建的pixelmap。
**系统能力:** SystemCapability.Multimedia.Image |
-
-## Region
-
-| 名称 | 类型 | 可读 | 可写 | 说明 |
-| ---- | ------------- | ---- | ---- | ------------------------------------------------------------ |
-| size | [Size](#Size) | 是 | 是 | 区域大小。
**系统能力:** SystemCapability.Multimedia.Image |
-| x | number | 是 | 是 | 区域坐标。
**系统能力:** SystemCapability.Multimedia.Image |
-| y | number | 是 | 是 | 区域坐标。
**系统能力:** SystemCapability.Multimedia.Image |
-
-## PackingOption
-
-| 名称 | 类型 | 可读 | 可写 | 说明 |
-| ------- | ------ | ---- | ---- | ------------------------------------------------------------ |
-| format | string | 是 | 是 | 目标格式。
**系统能力:** SystemCapability.Multimedia.Image |
-| quality | number | 是 | 是 | 目标图片质量。
**系统能力:** SystemCapability.Multimedia.Image |
-
-## GetImagePropertyOptions
-
-| 名称 | 类型 | 可读 | 可写 | 说明 |
-| ------------ | ------ | ---- | ---- | ---------- |
-| index | number | 是 | 是 | 图片序号。
**系统能力:** SystemCapability.Multimedia.Image |
-| defaultValue | string | 是 | 是 | 默认属性值
**系统能力:** SystemCapability.Multimedia.Image |
+**系统能力:** 以下各项对应的系统能力均为SystemCapability.Multimedia.Image
+
+| 名称 | 类型 | 可读 | 可写 | 说明 |
+| ------------------ | ---------------------------------- | ---- | ---- | ---------------- |
+| sampleSize | number | 是 | 是 | 缩略图采样大小。 |
+| rotateDegrees | number | 是 | 是 | 旋转角度。 |
+| editable | boolean | 是 | 是 | 是否可编辑。 |
+| desiredSize | [Size](#size) | 是 | 是 | 期望输出大小。 |
+| desiredRegion | [Region](#region8) | 是 | 是 | 解码区域。 |
+| desiredPixelFormat | [PixelMapFormat](#pixelmapformat7) | 是 | 是 | 解码的像素格式。 |
+| index | numer | 是 | 是 | 解码图片序号 |
+
+## Region8+
+
+表示区域信息。
+
+**系统能力:** 以下各项对应的系统能力均为SystemCapability.Multimedia.Image
+
+| 名称 | 类型 | 可读 | 可写 | 说明 |
+| ---- | ------------- | ---- | ---- | ---------- |
+| size | [Size](#size) | 是 | 是 | 区域大小。 |
+| x | number | 是 | 是 | 区域坐标。 |
+| y | number | 是 | 是 | 区域坐标。 |
+
+## PackingOption
+
+表示图片打包选项。
+
+**系统能力:** 以下各项对应的系统能力均为SystemCapability.Multimedia.Image
+
+| 名称 | 类型 | 可读 | 可写 | 说明 |
+| ------- | ------ | ---- | ---- | -------------- |
+| format | string | 是 | 是 | 目标格式。 |
+| quality | number | 是 | 是 | 目标图片质量。 |
+
+## GetImagePropertyOptions7+
+
+表示查询图片属性的索引。
+
+**系统能力:** 以下各项对应的系统能力均为SystemCapability.Multimedia.Image
+
+| 名称 | 类型 | 可读 | 可写 | 说明 |
+| ------------ | ------ | ---- | ---- | ------------ |
+| index | number | 是 | 是 | 图片序号。 |
+| defaultValue | string | 是 | 是 | 默认属性值。 |
+
+## PropertyKey7+
+
+枚举,Exif(Exchangeable image file format)图片信息。
+
+| 名称 | 默认值 | 说明 |
+| ----------------- | ----------------- | -------------------- |
+| BITS_PER_SAMPLE | "BitsPerSample" | 每个像素字节数。 |
+| ORIENTATION | "Orientation" | 图片方向。 |
+| IMAGE_LENGTH | "ImageLength" | 图片长度。 |
+| IMAGE_WIDTH | "ImageWidth" | 图片宽度。 |
+| GPS_LATITUDE | "GPSLatitude" | 图片纬度。 |
+| GPS_LONGITUDE | "GPSLongitude" | 图片经度。 |
+| GPS_LATITUDE_REF | "GPSLatitudeRef" | 纬度引用,例如N或S。 |
+| GPS_LONGITUDE_REF | "GPSLongitudeRef" | 经度引用,例如W或E。 |