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 95ba48bbb241791d2a51b8418a82ee7e82c775c1..c7629322b08912ddfea84bc6f638e20de16a4838 100644 --- a/zh-cn/application-dev/reference/apis/js-apis-image.md +++ b/zh-cn/application-dev/reference/apis/js-apis-image.md @@ -1979,6 +1979,194 @@ receiver.release().then(() => { }) ``` +## image.createImageCreator9+ + +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); +``` + +## ImageCreator9+ + +图像创建模块，用于请求图像原生数据区域，并开放给应用编译原生图像数据的能力。 +在调用以下方法前需要先创建ImageCreator实例。 + +### 属性 + +**系统能力：** 以下各项对应的系统能力均为SystemCapability.Multimedia.Image.ImageCreator + +| 名称 | 类型 | 可读 | 可写 | 说明 | +| -------- | ---------------------------- | ---- | ---- | ------------------ | +| capacity | number | 是 | 否 | 同时访问的图像数。 | +| format | [ImageFormat](#imageformat9) | 是 | 否 | 图像格式。 | + +### dequeueImage9+ + +dequeueImage(callback: AsyncCallback\): void + +从free队列中获取buffer，用于绘制UI内容，并使用callback返回结果。 + +**系统能力：** 以下各项对应的系统能力均为SystemCapability.Multimedia.Image.ImageCreator + +**参数：** + +| 名称 | 类型 | 必填 | 说明 | +| ------------- | ---------------------------------------| ---- | -------------------- | +| callback | AsyncCallback\ | 是 | 回调函数，返回最新图片。 | + +**示例：** + +```js +111 +``` + +### dequeueImage9+ + +dequeueImage(): Promise\ + +从free队列中获取buffer，用于绘制UI内容，并使用promise返回结果。 + +**系统能力：** 以下各项对应的系统能力均为SystemCapability.Multimedia.Image.ImageCreator + +**返回值：** + +| 类型 | 说明 | +| --------------- | ------------- | +| Promise\ | 返回绘制的图像。 | + +**示例：** + +```js +111 +``` + +### dequeueImage9+ + +queueImage(interface: Image, callback: AsyncCallback\): void + +将绘制好的buffer放入Dirty队列，供消费者使用，并使用callback返回结果。 + +**系统能力：** 以下各项对应的系统能力均为SystemCapability.Multimedia.Image.ImageCreator + +**参数：** + +| 名称 | 类型 | 必填 | 说明 | +| ------------- | -------------------------| ---- | -------------------- | +| interface | Image | 是 | 绘制好的buffer图像。 | +| callback | AsyncCallback\ | 是 | 获取回调，失败时返回错误信息。 | + +**示例：** + +```js +111 +``` + +### dequeueImage9+ + +queueImage(interface: Image): Promise\ + +将绘制好的buffer放入Dirty队列，供消费者使用，并使用promise返回结果。 + +**系统能力：** 以下各项对应的系统能力均为SystemCapability.Multimedia.Image.ImageCreator + +**参数：** + +| 名称 | 类型 | 必填 | 说明 | +| ------------- | --------| ---- | ------------------- | +| interface | Image | 是 | 绘制好的buffer图像。 | + +**返回值：** + +| 类型 | 说明 | +| -------------- | ------------- | +| Promise\ | 获取回调，失败时返回错误信息。 | + +**示例：** + +```js +111 +``` + +### on9+ + +on(type: 'imageRelease', callback: AsyncCallback\): void + +监听imageRelease事件，并使用callback返回结果。 + +**系统能力：** 以下各项对应的系统能力均为SystemCapability.Multimedia.Image.ImageCreator + +**参数：** + +| 名称 | 类型 | 必填 | 说明 | +| ------------- | -------------------------| ---- | -------------------- | +| type | 'imageRelease' | 是 | 监听事件类型。 | +| callback | AsyncCallback\ | 是 | 获取回调，失败时返回错误信息。 | + +**示例：** + +```js +111 +``` + +### release9+ + +release(callback: AsyncCallback\): void + +释放当前图像，并使用callback返回结果。 + +**系统能力：** 以下各项对应的系统能力均为SystemCapability.Multimedia.Image.ImageCreator + +**参数：** + +| 名称 | 类型 | 必填 | 说明 | +| ------------- | -------------------------| ---- | -------------------- | +| callback | AsyncCallback\ | 是 | 获取回调，失败时返回错误信息。 | + +**示例：** + +```js +111 +``` +### release9+ + +release(): Promise\ + +**系统能力：** 以下各项对应的系统能力均为SystemCapability.Multimedia.Image.ImageCreator + +**返回值：** + +| 类型 | 说明 | +| -------------- | ------------- | +| Promise\ | 获取回调，失败时返回错误信息。 | + +**示例：** + +```js +111 +``` + ## Image9+ 提供基本的图像操作，包括获取图像信息、读写图像数据。调用[readNextImage](#readnextimage9)和[readLatestImage](#readlatestimage9)接口时会返回image。 @@ -2142,6 +2330,11 @@ img.release().then(() =>{ | RGB_565 | 2 | 格式为RGB_565 | | RGBA_8888 | 3 | 格式为RGBA_8888。 | | BGRA_88889+ | 4 | 格式为BGRA_8888。 | +| RGB_8889+ | 5 | 格式为RGB_888。 | +| ALPHA_89+ | 6 | 格式为ALPHA_8。 | +| RGBA_F169+ | 7 | 格式为RGBA_F16。 | +| NV219+ | 8 | 格式为NV21。 | +| NV129+ | 9 | 格式为NV12。 | ## AlphaType9+ @@ -2232,6 +2425,7 @@ PixelMap的初始化选项。 | ------- | ------ | ---- | ---- | --------------------------------------------------- | | format | string | 是 | 是 | 目标格式。
当前支持格式有：.jpg .png .gif .bmp .webp RAW。 | | quality | number | 是 | 是 | JPEG编码中设定输出图片质量的参数，取值范围为1-100。 | +| bufferSize | number | 是 | 是 | 用于设置图片大小，默认为10M。 | ## GetImagePropertyOptions7+ @@ -2260,6 +2454,12 @@ PixelMap的初始化选项。 | GPS_LONGITUDE | "GPSLongitude" | 图片经度。 | | GPS_LATITUDE_REF | "GPSLatitudeRef" | 纬度引用，例如N或S。 | | GPS_LONGITUDE_REF | "GPSLongitudeRef" | 经度引用，例如W或E。 | +| DATE_TIME_ORIGINAL9+ | "DateTimeOriginal" | 拍摄时间，例如2022:09:06 15:48:00。 | +| EXPOSURE_TIME9+ | "ExposureTime" | 曝光时间，例如1/33 sec.。| +| SCENE_TYPE9+ | "SceneType" | 拍摄场景，例如Directly photographed。 | +| ISO_SPEED_RATINGS9+ | "ISOSpeedRatings" | ISO感光度，例如400。 | +| F_NUMBER9+ | "FNumber" | 光圈值，例如f/1.8。 | + ## ImageFormat9+