提交 1e0f6579 编写于 作者: R renhongwei

新增二期接口

Signed-off-by: Nrenhongwei <renhongwei9@huawei.com>
上级 f9f51ba2
...@@ -1979,6 +1979,194 @@ receiver.release().then(() => { ...@@ -1979,6 +1979,194 @@ receiver.release().then(() => {
}) })
``` ```
## image.createImageCreator<sup>9+</sup>
createImageCreator(width: number, height: number, format: number, capacity: number): ImageCreator
通过宽、高、图片格式、容量创建ImageCreator实例。
**系统能力:** SystemCapability.Multimedia.Image.ImageCreator
**参数:**
| 名称 | 类型 | 必填 | 说明 |
| -------- | ------ | ---- | ---------------------- |
| width | number | 是 | 图像的默认宽度。 |
| height | number | 是 | 图像的默认高度。 |
| format | number | 是 | 图像格式。 |
| capacity | number | 是 | 同时访问的最大图像数。 |
**返回值:**
| 类型 | 说明 |
| ------------------------------ | --------------------------------------- |
| [ImageCreator](#imageCreator9) | 如果操作成功,则返回ImageReceiver实例。 |
**示例:**
```js
var creator = image.createImageCreator(8192, 8, 4, 8);
```
## ImageCreator<sup>9+</sup>
图像创建模块,用于请求图像原生数据区域,并开放给应用编译原生图像数据的能力。
在调用以下方法前需要先创建ImageCreator实例。
### 属性
**系统能力:** 以下各项对应的系统能力均为SystemCapability.Multimedia.Image.ImageCreator
| 名称 | 类型 | 可读 | 可写 | 说明 |
| -------- | ---------------------------- | ---- | ---- | ------------------ |
| capacity | number | 是 | 否 | 同时访问的图像数。 |
| format | [ImageFormat](#imageformat9) | 是 | 否 | 图像格式。 |
### dequeueImage<sup>9+</sup>
dequeueImage(callback: AsyncCallback\<Image>): void
从free队列中获取buffer,用于绘制UI内容,并使用callback返回结果。
**系统能力:** 以下各项对应的系统能力均为SystemCapability.Multimedia.Image.ImageCreator
**参数:**
| 名称 | 类型 | 必填 | 说明 |
| ------------- | ---------------------------------------| ---- | -------------------- |
| callback | AsyncCallback\<Image> | 是 | 回调函数,返回最新图片。 |
**示例:**
```js
111
```
### dequeueImage<sup>9+</sup>
dequeueImage(): Promise\<Image>
从free队列中获取buffer,用于绘制UI内容,并使用promise返回结果。
**系统能力:** 以下各项对应的系统能力均为SystemCapability.Multimedia.Image.ImageCreator
**返回值:**
| 类型 | 说明 |
| --------------- | ------------- |
| Promise\<Image> | 返回绘制的图像。 |
**示例:**
```js
111
```
### dequeueImage<sup>9+</sup>
queueImage(interface: Image, callback: AsyncCallback\<void>): void
将绘制好的buffer放入Dirty队列,供消费者使用,并使用callback返回结果。
**系统能力:** 以下各项对应的系统能力均为SystemCapability.Multimedia.Image.ImageCreator
**参数:**
| 名称 | 类型 | 必填 | 说明 |
| ------------- | -------------------------| ---- | -------------------- |
| interface | Image | 是 | 绘制好的buffer图像。 |
| callback | AsyncCallback\<void> | 是 | 获取回调,失败时返回错误信息。 |
**示例:**
```js
111
```
### dequeueImage<sup>9+</sup>
queueImage(interface: Image): Promise\<void>
将绘制好的buffer放入Dirty队列,供消费者使用,并使用promise返回结果。
**系统能力:** 以下各项对应的系统能力均为SystemCapability.Multimedia.Image.ImageCreator
**参数:**
| 名称 | 类型 | 必填 | 说明 |
| ------------- | --------| ---- | ------------------- |
| interface | Image | 是 | 绘制好的buffer图像。 |
**返回值:**
| 类型 | 说明 |
| -------------- | ------------- |
| Promise\<void> | 获取回调,失败时返回错误信息。 |
**示例:**
```js
111
```
### on<sup>9+</sup>
on(type: 'imageRelease', callback: AsyncCallback\<void>): void
监听imageRelease事件,并使用callback返回结果。
**系统能力:** 以下各项对应的系统能力均为SystemCapability.Multimedia.Image.ImageCreator
**参数:**
| 名称 | 类型 | 必填 | 说明 |
| ------------- | -------------------------| ---- | -------------------- |
| type | 'imageRelease' | 是 | 监听事件类型。 |
| callback | AsyncCallback\<void> | 是 | 获取回调,失败时返回错误信息。 |
**示例:**
```js
111
```
### release<sup>9+</sup>
release(callback: AsyncCallback\<void>): void
释放当前图像,并使用callback返回结果。
**系统能力:** 以下各项对应的系统能力均为SystemCapability.Multimedia.Image.ImageCreator
**参数:**
| 名称 | 类型 | 必填 | 说明 |
| ------------- | -------------------------| ---- | -------------------- |
| callback | AsyncCallback\<void> | 是 | 获取回调,失败时返回错误信息。 |
**示例:**
```js
111
```
### release<sup>9+</sup>
release(): Promise\<void>
**系统能力:** 以下各项对应的系统能力均为SystemCapability.Multimedia.Image.ImageCreator
**返回值:**
| 类型 | 说明 |
| -------------- | ------------- |
| Promise\<void> | 获取回调,失败时返回错误信息。 |
**示例:**
```js
111
```
## Image<sup>9+</sup> ## Image<sup>9+</sup>
提供基本的图像操作,包括获取图像信息、读写图像数据。调用[readNextImage](#readnextimage9)[readLatestImage](#readlatestimage9)接口时会返回image。 提供基本的图像操作,包括获取图像信息、读写图像数据。调用[readNextImage](#readnextimage9)[readLatestImage](#readlatestimage9)接口时会返回image。
...@@ -2142,6 +2330,11 @@ img.release().then(() =>{ ...@@ -2142,6 +2330,11 @@ img.release().then(() =>{
| RGB_565 | 2 | 格式为RGB_565 | | RGB_565 | 2 | 格式为RGB_565 |
| RGBA_8888 | 3 | 格式为RGBA_8888。 | | RGBA_8888 | 3 | 格式为RGBA_8888。 |
| BGRA_8888<sup>9+</sup> | 4 | 格式为BGRA_8888。 | | BGRA_8888<sup>9+</sup> | 4 | 格式为BGRA_8888。 |
| RGB_888<sup>9+</sup> | 5 | 格式为RGB_888。 |
| ALPHA_8<sup>9+</sup> | 6 | 格式为ALPHA_8。 |
| RGBA_F16<sup>9+</sup> | 7 | 格式为RGBA_F16。 |
| NV21<sup>9+</sup> | 8 | 格式为NV21。 |
| NV12<sup>9+</sup> | 9 | 格式为NV12。 |
## AlphaType<sup>9+</sup> ## AlphaType<sup>9+</sup>
...@@ -2232,6 +2425,7 @@ PixelMap的初始化选项。 ...@@ -2232,6 +2425,7 @@ PixelMap的初始化选项。
| ------- | ------ | ---- | ---- | --------------------------------------------------- | | ------- | ------ | ---- | ---- | --------------------------------------------------- |
| format | string | 是 | 是 | 目标格式。</br>当前支持格式有:.jpg .png .gif .bmp .webp RAW。 | | format | string | 是 | 是 | 目标格式。</br>当前支持格式有:.jpg .png .gif .bmp .webp RAW。 |
| quality | number | 是 | 是 | JPEG编码中设定输出图片质量的参数,取值范围为1-100。 | | quality | number | 是 | 是 | JPEG编码中设定输出图片质量的参数,取值范围为1-100。 |
| bufferSize | number | 是 | 是 | 用于设置图片大小,默认为10M。 |
## GetImagePropertyOptions<sup>7+</sup> ## GetImagePropertyOptions<sup>7+</sup>
...@@ -2260,6 +2454,12 @@ PixelMap的初始化选项。 ...@@ -2260,6 +2454,12 @@ PixelMap的初始化选项。
| GPS_LONGITUDE | "GPSLongitude" | 图片经度。 | | GPS_LONGITUDE | "GPSLongitude" | 图片经度。 |
| GPS_LATITUDE_REF | "GPSLatitudeRef" | 纬度引用,例如N或S。 | | GPS_LATITUDE_REF | "GPSLatitudeRef" | 纬度引用,例如N或S。 |
| GPS_LONGITUDE_REF | "GPSLongitudeRef" | 经度引用,例如W或E。 | | GPS_LONGITUDE_REF | "GPSLongitudeRef" | 经度引用,例如W或E。 |
| DATE_TIME_ORIGINAL<sup>9+</sup> | "DateTimeOriginal" | 拍摄时间,例如2022:09:06 15:48:00。 |
| EXPOSURE_TIME<sup>9+</sup> | "ExposureTime" | 曝光时间,例如1/33 sec.。|
| SCENE_TYPE<sup>9+</sup> | "SceneType" | 拍摄场景,例如Directly photographed。 |
| ISO_SPEED_RATINGS<sup>9+</sup> | "ISOSpeedRatings" | ISO感光度,例如400。 |
| F_NUMBER<sup>9+</sup> | "FNumber" | 光圈值,例如f/1.8。 |
## ImageFormat<sup>9+</sup> ## ImageFormat<sup>9+</sup>
......
Markdown is supported
0% .
You are about to add 0 people to the discussion. Proceed with caution.
先完成此消息的编辑!
想要评论请 注册