From a8be92cee73a2a13bf7d9db0b259150956856c52 Mon Sep 17 00:00:00 2001
From: zhaona45 <zhaona45@huawei.com>
Date: Mon, 4 Aug 2025 10:24:37 +0800
Subject: [PATCH] =?UTF-8?q?image=E9=83=A8=E5=88=86=E6=8E=A5=E5=8F=A3null/u?=
 =?UTF-8?q?ndefined=E9=9D=99=E6=80=81=E5=8C=96=E6=98=BE=E7=A4=BA=E5=A3=B0?=
 =?UTF-8?q?=E6=98=8E?=
MIME-Version: 1.0
Content-Type: text/plain; charset=UTF-8
Content-Transfer-Encoding: 8bit

Signed-off-by: zhaona45 <zhaona45@huawei.com>
Change-Id: Ifd32ee0724e9c5ffb2353542167430ffdb64fdd8
---
 api/@ohos.multimedia.image.d.ts | 529 ++++++++++++++++++++++++++++----
 1 file changed, 465 insertions(+), 64 deletions(-)

diff --git a/api/@ohos.multimedia.image.d.ts b/api/@ohos.multimedia.image.d.ts
index e9e9f36629..b8057705f6 100644
--- a/api/@ohos.multimedia.image.d.ts
+++ b/api/@ohos.multimedia.image.d.ts
@@ -5348,11 +5348,23 @@ function createUnpremultipliedPixelMap(src: PixelMap, dst: PixelMap): Promise<vo
    * @syscap SystemCapability.Multimedia.Image.ImageSource
    * @crossplatform
    * @atomicservice
-   * @since arkts {'1.1':'11','1.2':'20'}
-   * @arkts 1.1&1.2
+   * @since 11
    */
   function createImageSource(uri: string): ImageSource;
 
+  /**
+   * Creates an ImageSource instance based on the URI.
+   *
+   * @param { string } uri Image source URI.
+   * @returns { ImageSource | undefined } returns the ImageSource instance if the operation is successful; returns undefined otherwise.
+   * @syscap SystemCapability.Multimedia.Image.ImageSource
+   * @crossplatform
+   * @atomicservice
+   * @since 20
+   * @arkts 1.2
+   */
+  function createImageSource(uri: string): ImageSource | undefined;
+
   /**
    * Creates an ImageSource instance based on the URI.
    *
@@ -5393,11 +5405,25 @@ function createUnpremultipliedPixelMap(src: PixelMap, dst: PixelMap): Promise<vo
    * @crossplatform
    * @form
    * @atomicservice
-   * @since arkts {'1.1':'12','1.2':'20'}
-   * @arkts 1.1&1.2
+   * @since 12
    */
   function createImageSource(uri: string, options: SourceOptions): ImageSource;
 
+  /**
+   * Creates an ImageSource instance based on the URI.
+   *
+   * @param { string } uri Image source URI.
+   * @param { SourceOptions } options The config of Image source.
+   * @returns { ImageSource | undefined } Returns the ImageSource instance if the operation is successful; returns undefined otherwise.
+   * @syscap SystemCapability.Multimedia.Image.ImageSource
+   * @crossplatform
+   * @form
+   * @atomicservice
+   * @since 20
+   * @arkts 1.2
+   */
+  function createImageSource(uri: string, options: SourceOptions): ImageSource | undefined;
+
   /**
    * Creates an ImageSource instance based on the file descriptor.
    *
@@ -5423,11 +5449,23 @@ function createUnpremultipliedPixelMap(src: PixelMap, dst: PixelMap): Promise<vo
    * @syscap SystemCapability.Multimedia.Image.ImageSource
    * @crossplatform
    * @atomicservice
-   * @since arkts {'1.1':'11','1.2':'20'}
-   * @arkts 1.1&1.2
+   * @since 11
    */
   function createImageSource(fd: int): ImageSource;
 
+  /**
+   * Creates an ImageSource instance based on the file descriptor.
+   *
+   * @param { int } fd ID of a file descriptor.
+   * @returns { ImageSource | undefined } Returns the ImageSource instance if the operation is successful; returns undefined otherwise.
+   * @syscap SystemCapability.Multimedia.Image.ImageSource
+   * @crossplatform
+   * @atomicservice
+   * @since 20
+   * @arkts 1.2
+   */
+  function createImageSource(fd: int): ImageSource | undefined;
+
   /**
    * Creates an ImageSource instance based on the file descriptor.
    *
@@ -5468,11 +5506,25 @@ function createUnpremultipliedPixelMap(src: PixelMap, dst: PixelMap): Promise<vo
    * @crossplatform
    * @form
    * @atomicservice
-   * @since arkts {'1.1':'12','1.2':'20'}
-   * @arkts 1.1&1.2
+   * @since 12
    */
   function createImageSource(fd: int, options: SourceOptions): ImageSource;
 
+  /**
+   * Creates an ImageSource instance based on the file descriptor.
+   *
+   * @param { int } fd ID of a file descriptor.
+   * @param { SourceOptions } options The config of Image source.
+   * @returns { ImageSource | undefined } Returns the ImageSource instance if the operation is successful; returns undefined otherwise.
+   * @syscap SystemCapability.Multimedia.Image.ImageSource
+   * @crossplatform
+   * @form
+   * @atomicservice
+   * @since 20
+   * @arkts 1.2
+   */
+  function createImageSource(fd: int, options: SourceOptions): ImageSource | undefined;
+
   /**
    * Creates an ImageSource instance based on the buffer.
    *
@@ -5509,11 +5561,24 @@ function createUnpremultipliedPixelMap(src: PixelMap, dst: PixelMap): Promise<vo
    * @crossplatform
    * @form
    * @atomicservice
-   * @since arkts {'1.1':'12','1.2':'20'}
-   * @arkts 1.1&1.2
+   * @since 12
    */
   function createImageSource(buf: ArrayBuffer): ImageSource;
 
+  /**
+   * Creates an ImageSource instance based on the buffer.
+   *
+   * @param { ArrayBuffer } buf The buffer of the image.
+   * @returns { ImageSource | undefined } Returns the ImageSource instance if the operation is successful; returns undefined otherwise.
+   * @syscap SystemCapability.Multimedia.Image.ImageSource
+   * @crossplatform
+   * @form
+   * @atomicservice
+   * @since 20
+   * @arkts 1.2
+   */
+  function createImageSource(buf: ArrayBuffer): ImageSource | undefined;
+
   /**
    * Creates an ImageSource instance based on the buffer.
    *
@@ -5554,11 +5619,25 @@ function createUnpremultipliedPixelMap(src: PixelMap, dst: PixelMap): Promise<vo
    * @crossplatform
    * @form
    * @atomicservice
-   * @since arkts {'1.1':'12','1.2':'20'}
-   * @arkts 1.1&1.2
+   * @since 12
    */
   function createImageSource(buf: ArrayBuffer, options: SourceOptions): ImageSource;
 
+  /**
+   * Creates an ImageSource instance based on the buffer.
+   *
+   * @param { ArrayBuffer } buf The buffer of the image.
+   * @param { SourceOptions } options The config of Image source.
+   * @returns { ImageSource | undefined } Returns the ImageSource instance if the operation is successful; returns undefined otherwise.
+   * @syscap SystemCapability.Multimedia.Image.ImageSource
+   * @crossplatform
+   * @form
+   * @atomicservice
+   * @since 20
+   * @arkts 1.2
+   */
+  function createImageSource(buf: ArrayBuffer, options: SourceOptions): ImageSource | undefined;
+
   /**
    * Creates an ImageSource instance based on the raw file descriptor.
    *
@@ -5568,11 +5647,25 @@ function createUnpremultipliedPixelMap(src: PixelMap, dst: PixelMap): Promise<vo
    * @syscap SystemCapability.Multimedia.Image.ImageSource
    * @crossplatform
    * @atomicservice
-   * @since arkts {'1.1':'11','1.2':'20'}
-   * @arkts 1.1&1.2
+   * @since 11
    */
   function createImageSource(rawfile: resourceManager.RawFileDescriptor, options?: SourceOptions): ImageSource;
 
+  /**
+   * Creates an ImageSource instance based on the raw file descriptor.
+   *
+   * @param { resourceManager.RawFileDescriptor } rawfile The raw file descriptor of the image.
+   * @param { SourceOptions } options The config of Image source.
+   * @returns { ImageSource | undefined } Returns the ImageSource instance if the operation is successful; returns undefined otherwise.
+   * @syscap SystemCapability.Multimedia.Image.ImageSource
+   * @crossplatform
+   * @atomicservice
+   * @since 20
+   * @arkts 1.2
+   */
+  function createImageSource(rawfile: resourceManager.RawFileDescriptor, options?: SourceOptions)
+    : ImageSource | undefined;
+
   /**
    * Creates an ImageSource instance based on the buffer in incremental.
    *
@@ -5588,11 +5681,22 @@ function createUnpremultipliedPixelMap(src: PixelMap, dst: PixelMap): Promise<vo
    * @returns { ImageSource } Returns the ImageSource instance if the operation is successful; returns undefined otherwise.
    * @syscap SystemCapability.Multimedia.Image.ImageSource
    * @crossplatform
-   * @since arkts {'1.1':'10','1.2':'20'}
-   * @arkts 1.1&1.2
+   * @since 10
    */
   function CreateIncrementalSource(buf: ArrayBuffer): ImageSource;
 
+  /**
+   * Creates an ImageSource instance based on the buffer in incremental.
+   *
+   * @param { ArrayBuffer } buf The buffer of the image.
+   * @returns { ImageSource | undefined } Returns the ImageSource instance if the operation is successful; returns undefined otherwise.
+   * @syscap SystemCapability.Multimedia.Image.ImageSource
+   * @crossplatform
+   * @since 20
+   * @arkts 1.2
+   */
+  function CreateIncrementalSource(buf: ArrayBuffer): ImageSource | undefined;
+
   /**
    * Creates an ImageSource instance based on the buffer in incremental.
    *
@@ -5610,11 +5714,23 @@ function createUnpremultipliedPixelMap(src: PixelMap, dst: PixelMap): Promise<vo
    * @returns { ImageSource } Returns the ImageSource instance if the operation is successful; returns undefined otherwise.
    * @syscap SystemCapability.Multimedia.Image.ImageSource
    * @crossplatform
-   * @since arkts {'1.1':'10','1.2':'20'}
-   * @arkts 1.1&1.2
+   * @since 10
    */
   function CreateIncrementalSource(buf: ArrayBuffer, options?: SourceOptions): ImageSource;
 
+  /**
+   * Creates an ImageSource instance based on the buffer in incremental.
+   *
+   * @param { ArrayBuffer } buf The buffer of the image.
+   * @param { SourceOptions } options The config of source.
+   * @returns { ImageSource | undefined } Returns the ImageSource instance if the operation is successful; returns undefined otherwise.
+   * @syscap SystemCapability.Multimedia.Image.ImageSource
+   * @crossplatform
+   * @since 20
+   * @arkts 1.2
+   */
+  function CreateIncrementalSource(buf: ArrayBuffer, options?: SourceOptions): ImageSource | undefined;
+
   /**
    * Creates an ImagePacker instance.
    *
@@ -5668,11 +5784,25 @@ function createUnpremultipliedPixelMap(src: PixelMap, dst: PixelMap): Promise<vo
    * @returns { ImageReceiver } Returns the ImageReceiver instance if the operation is successful; returns null otherwise.
    * @throws { BusinessError } 401 - Parameter error.Possible causes: 1.Mandatory parameters are left unspecified; 2.Incorrect parameter types;
    * @syscap SystemCapability.Multimedia.Image.ImageReceiver
-   * @since arkts {'1.1':'11','1.2':'20'}
-   * @arkts 1.1&1.2
+   * @since 11
    */
   function createImageReceiver(size: Size, format: ImageFormat, capacity: int): ImageReceiver;
 
+  /**
+   * Creates an ImageReceiver instance.
+   *
+   * @param { Size } size - The default {@link Size} in pixels of the Images that this receiver will produce.
+   * @param { ImageFormat } format - The format of the Image that this receiver will produce. This must be one of the
+   *            {@link ImageFormat} constants.
+   * @param { int } capacity - The maximum number of images the user will want to access simultaneously.
+   * @returns { ImageReceiver | undefined } Returns the ImageReceiver instance if the operation is successful; returns undefined otherwise.
+   * @throws { BusinessError } 401 - Parameter error.Possible causes: 1.Mandatory parameters are left unspecified; 2.Incorrect parameter types;
+   * @syscap SystemCapability.Multimedia.Image.ImageReceiver
+   * @since 20
+   * @arkts 1.2
+   */
+  function createImageReceiver(size: Size, format: ImageFormat, capacity: int): ImageReceiver | undefined;
+
   /**
    * Creates an ImageCreator instance.
    *
@@ -7511,11 +7641,20 @@ function createUnpremultipliedPixelMap(src: PixelMap, dst: PixelMap): Promise<vo
      *
      * @returns { PixelMap } Returns the pixel map.
      * @syscap SystemCapability.Multimedia.Image.Core
-     * @since arkts {'1.1':'13','1.2':'20'}
-     * @arkts 1.1&1.2
+     * @since 13
      */
     getMainPixelmap(): PixelMap;
 
+    /**
+     * Obtains the pixel map of the main image.
+     *
+     * @returns { PixelMap | undefined } Returns the pixel map.
+     * @syscap SystemCapability.Multimedia.Image.Core
+     * @since 20
+     * @arkts 1.2
+     */
+    getMainPixelmap(): PixelMap | undefined;
+
     /**
      * Obtains the hdr pixel map. This method uses a promise to return the PixelMap object.
      *
@@ -7524,11 +7663,23 @@ function createUnpremultipliedPixelMap(src: PixelMap, dst: PixelMap): Promise<vo
      * @throws { BusinessError } 7600201 - Unsupported operation. e.g.,1. The picture does not has a gainmap.
      * 2. MainPixelMap's allocator type is not DMA.
      * @syscap SystemCapability.Multimedia.Image.Core
-     * @since arkts {'1.1':'13','1.2':'20'}
-     * @arkts 1.1&1.2
+     * @since 13
      */
     getHdrComposedPixelmap(): Promise<PixelMap>;
 
+    /**
+     * Obtains the hdr pixel map. This method uses a promise to return the PixelMap object.
+     *
+     * @returns { Promise<PixelMap | undefined> } A Promise instance used to return the PixelMap object.
+     * @throws { BusinessError } 7600901 - Inner unknown error. Please check the logs for detailed information.
+     * @throws { BusinessError } 7600201 - Unsupported operation. e.g.,1. The picture does not has a gainmap.
+     * 2. MainPixelMap's allocator type is not DMA.
+     * @syscap SystemCapability.Multimedia.Image.Core
+     * @since 20
+     * @arkts 1.2
+     */
+    getHdrComposedPixelmap(): Promise<PixelMap | undefined>;
+
     /**
      * Obtains the gain map pixel map.
      * @returns { PixelMap | null } Returns the pixel map if the operation is successful; returns null otherwise.
@@ -7590,10 +7741,24 @@ function createUnpremultipliedPixelMap(src: PixelMap, dst: PixelMap): Promise<vo
      * @throws { BusinessError } 7600202 - Unsupported metadata. Possible causes: 1. Unsupported metadata type. 2. The
      * metadata type does not match the auxiliary picture type.
      * @syscap SystemCapability.Multimedia.Image.Core
-     * @since arkts {'1.1':'13','1.2':'20'}
-     * @arkts 1.1&1.2
+     * @since 13
+     */
+    getMetadata(metadataType: MetadataType): Promise<Metadata>;
+
+    /**
+     * Obtains the metadata of main picture.
+     *
+     * @param { MetadataType } metadataType The type of metadata.
+     * @returns { Promise<Metadata | undefined> } Return the metadata of main picture.
+     * @throws { BusinessError } 401 - Parameter error. Possible causes: 1.Mandatory parameters are left unspecified.
+     * 2.Incorrect parameter types. 3.Parameter verification failed.
+     * @throws { BusinessError } 7600202 - Unsupported metadata. Possible causes: 1. Unsupported metadata type. 2. The
+     * metadata type does not match the auxiliary picture type.
+     * @syscap SystemCapability.Multimedia.Image.Core
+     * @since 20
+     * @arkts 1.2
      */
-    getMetadata(metadataType: MetadataType): Promise<Metadata>
+    getMetadata(metadataType: MetadataType): Promise<Metadata | undefined>;
 
     /**
      * Marshalling picture and write into MessageSequence.
@@ -7709,21 +7874,40 @@ function createUnpremultipliedPixelMap(src: PixelMap, dst: PixelMap): Promise<vo
      *
      * @returns { Promise<ArrayBuffer> } A Promise instance used to return the pixel map data.
      * @syscap SystemCapability.Multimedia.Image.Core
-     * @since arkts {'1.1':'13','1.2':'20'}
-     * @arkts 1.1&1.2
+     * @since 13
      */
     readPixelsToBuffer(): Promise<ArrayBuffer>;
 
+    /**
+     * Reads image pixel map data and writes the data to an ArrayBuffer. This method uses
+     * a promise to return the result.
+     *
+     * @returns { Promise<ArrayBuffer | undefined> } A Promise instance used to return the pixel map data.
+     * @syscap SystemCapability.Multimedia.Image.Core
+     * @since 20
+     * @arkts 1.2
+     */
+    readPixelsToBuffer(): Promise<ArrayBuffer | undefined>;
+
     /**
      * Obtains the type of auxiliary picture.
      *
      * @returns { AuxiliaryPictureType } Returns the type of auxiliary picture.
      * @syscap SystemCapability.Multimedia.Image.Core
-     * @since arkts {'1.1':'13','1.2':'20'}
-     * @arkts 1.1&1.2
+     * @since 13
      */
     getType(): AuxiliaryPictureType;
 
+    /**
+     * Obtains the type of auxiliary picture.
+     *
+     * @returns { AuxiliaryPictureType | undefined } Returns the type of auxiliary picture.
+     * @syscap SystemCapability.Multimedia.Image.Core
+     * @since 20
+     * @arkts 1.2
+     */
+    getType(): AuxiliaryPictureType | undefined;
+
     /**
      * Set the metadata of auxiliary picture.
      *
@@ -7750,10 +7934,24 @@ function createUnpremultipliedPixelMap(src: PixelMap, dst: PixelMap): Promise<vo
      * @throws { BusinessError } 7600202 - Unsupported metadata. Possible causes: 1. Unsupported metadata type. 2. The
      * metadata type does not match the auxiliary picture type.
      * @syscap SystemCapability.Multimedia.Image.Core
-     * @since arkts {'1.1':'13','1.2':'20'}
-     * @arkts 1.1&1.2
+     * @since 13
+     */
+    getMetadata(metadataType: MetadataType): Promise<Metadata>;
+
+    /**
+     * Obtains the metadata of auxiliary picture.
+     *
+     * @param { MetadataType } metadataType The type of metadata.
+     * @returns { Promise<Metadata | undefined> } Return the metadata of auxiliary picture.
+     * @throws { BusinessError } 401 - Parameter error. Possible causes: 1.Mandatory parameters are left unspecified.
+     * 2.Incorrect parameter types. 3.Parameter verification failed.
+     * @throws { BusinessError } 7600202 - Unsupported metadata. Possible causes: 1. Unsupported metadata type. 2. The
+     * metadata type does not match the auxiliary picture type.
+     * @syscap SystemCapability.Multimedia.Image.Core
+     * @since 20
+     * @arkts 1.2
      */
-    getMetadata(metadataType: MetadataType): Promise<Metadata>
+    getMetadata(metadataType: MetadataType): Promise<Metadata | undefined>;
 
     /**
      * Obtains the information about this auxiliary picture.
@@ -7761,11 +7959,21 @@ function createUnpremultipliedPixelMap(src: PixelMap, dst: PixelMap): Promise<vo
      * @returns { AuxiliaryPictureInfo } Returns the auxiliary picture information. If the operation fails, an error
      * message is returned.
      * @syscap SystemCapability.Multimedia.Image.Core
-     * @since arkts {'1.1':'13','1.2':'20'}
-     * @arkts 1.1&1.2
+     * @since 13
      */
     getAuxiliaryPictureInfo(): AuxiliaryPictureInfo;
 
+    /**
+     * Obtains the information about this auxiliary picture.
+     *
+     * @returns { AuxiliaryPictureInfo | undefined } Returns the auxiliary picture information. If the operation fails, an error
+     * message is returned.
+     * @syscap SystemCapability.Multimedia.Image.Core
+     * @since 20
+     * @arkts 1.2
+     */
+    getAuxiliaryPictureInfo(): AuxiliaryPictureInfo | undefined;
+
     /**
      * Set the information about this auxiliary picture.
      *
@@ -7933,20 +8141,39 @@ function createUnpremultipliedPixelMap(src: PixelMap, dst: PixelMap): Promise<vo
      *
      * @returns { Promise<Record<string, string | null>> } Array of Records instance used to return the property values.
      * @syscap SystemCapability.Multimedia.Image.Core
-     * @since arkts {'1.1':'13','1.2':'20'}
-     * @arkts 1.1&1.2
+     * @since 13
+     */
+    getAllProperties(): Promise<Record<string, string | null>>;
+
+    /**
+     * Obtains the value of all properties in an image. This method uses a promise to return the property values
+     * in array of records.
+     *
+     * @returns { Promise<Record<string, string | null> | undefined> } Array of Records instance used to return the property values.
+     * @syscap SystemCapability.Multimedia.Image.Core
+     * @since 20
+     * @arkts 1.2
      */
-    getAllProperties(): Promise<Record<string, string | null>>
+    getAllProperties(): Promise<Record<string, string | null> | undefined>;
 
     /**
      * Obtains a clone of metadata. This method uses a promise to return the metadata.
      *
      * @returns { Promise<Metadata> } A Promise instance used to return the metadata.
      * @syscap SystemCapability.Multimedia.Image.Core
-     * @since arkts {'1.1':'13','1.2':'20'}
-     * @arkts 1.1&1.2
+     * @since 13
+     */
+    clone(): Promise<Metadata>;
+
+    /**
+     * Obtains a clone of metadata. This method uses a promise to return the metadata.
+     *
+     * @returns { Promise<Metadata | undefined> } A Promise instance used to return the metadata.
+     * @syscap SystemCapability.Multimedia.Image.Core
+     * @since 20
+     * @arkts 1.2
      */
-    clone(): Promise<Metadata>
+    clone(): Promise<Metadata | undefined>;
   }
 
   /**
@@ -8183,11 +8410,27 @@ function createUnpremultipliedPixelMap(src: PixelMap, dst: PixelMap): Promise<vo
      * @crossplatform
      * @form
      * @atomicservice
-     * @since arkts {'1.1':'12','1.2':'20'}
-     * @arkts 1.1&1.2
+     * @since 12
      */
     getImageInfo(index: int, callback: AsyncCallback<ImageInfo>): void;
 
+    /**
+     * Obtains information about an image with the specified sequence number and uses a callback
+     * to return the result.
+     *
+     * @param { int } index Sequence number of an image. The default value is 0, indicating the first image.
+     * When the value is N, it refers to the (N-1)th image. In single-frame image scenarios, the value must be 0.
+     * In multi-frame image scenarios such as animations, the valid range is 0 to (frame count - 1).
+     * @param { AsyncCallback<ImageInfo | undefined> } callback Callback used to return the image information.
+     * @syscap SystemCapability.Multimedia.Image.ImageSource
+     * @crossplatform
+     * @form
+     * @atomicservice
+     * @since 20
+     * @arkts 1.2
+     */
+    getImageInfo(index: int, callback: AsyncCallback<ImageInfo | undefined>): void;
+
     /**
      * Obtains information about this image and uses a callback to return the result.
      *
@@ -8220,11 +8463,23 @@ function createUnpremultipliedPixelMap(src: PixelMap, dst: PixelMap): Promise<vo
      * @crossplatform
      * @form
      * @atomicservice
-     * @since arkts {'1.1':'12','1.2':'20'}
-     * @arkts 1.1&1.2
+     * @since 12
      */
     getImageInfo(callback: AsyncCallback<ImageInfo>): void;
 
+    /**
+     * Obtains information about this image and uses a callback to return the result.
+     *
+     * @param { AsyncCallback<ImageInfo | undefined> } callback Callback used to return the image information.
+     * @syscap SystemCapability.Multimedia.Image.ImageSource
+     * @crossplatform
+     * @form
+     * @atomicservice
+     * @since 20
+     * @arkts 1.2
+     */
+    getImageInfo(callback: AsyncCallback<ImageInfo | undefined>): void;
+
     /**
      * Get image information from image source.
      *
@@ -8269,11 +8524,26 @@ function createUnpremultipliedPixelMap(src: PixelMap, dst: PixelMap): Promise<vo
      * @crossplatform
      * @form
      * @atomicservice
-     * @since arkts {'1.1':'12','1.2':'20'}
-     * @arkts 1.1&1.2
+     * @since 12
      */
     getImageInfo(index?: int): Promise<ImageInfo>;
 
+    /**
+     * Get image information from image source.
+     *
+     * @param { int } index Sequence number of an image. The default value is 0, indicating the first image.
+     * When the value is N, it refers to the (N-1)th image. In single-frame image scenarios, the value must be 0.
+     * In multi-frame image scenarios such as animations, the valid range is 0 to (frame count - 1).
+     * @returns { Promise<ImageInfo | undefined> } A Promise instance used to return the image information.
+     * @syscap SystemCapability.Multimedia.Image.ImageSource
+     * @crossplatform
+     * @form
+     * @atomicservice
+     * @since 20
+     * @arkts 1.2
+     */
+    getImageInfo(index?: int): Promise<ImageInfo | undefined>;
+
     /**
      * Get image information from image source synchronously.
      *
@@ -8283,11 +8553,24 @@ function createUnpremultipliedPixelMap(src: PixelMap, dst: PixelMap): Promise<vo
      * @returns { ImageInfo } The image information.
      * @syscap SystemCapability.Multimedia.Image.ImageSource
      * @crossplatform
-     * @since arkts {'1.1':'12','1.2':'20'}
-     * @arkts 1.1&1.2
+     * @since 12
      */
     getImageInfoSync(index?: int): ImageInfo;
 
+    /**
+     * Get image information from image source synchronously.
+     *
+     * @param { int } index Sequence number of an image. The default value is 0, indicating the first image.
+     * When the value is N, it refers to the (N-1)th image. In single-frame image scenarios, the value must be 0.
+     * In multi-frame image scenarios such as animations, the valid range is 0 to (frame count - 1).
+     * @returns { ImageInfo | undefined } The image information.
+     * @syscap SystemCapability.Multimedia.Image.ImageSource
+     * @crossplatform
+     * @since 20
+     * @arkts 1.2
+     */
+    getImageInfoSync(index?: int): ImageInfo | undefined;
+
     /**
      * Creates a PixelMap object based on image decoding parameters. This method uses a promise to
      * return the object.
@@ -8328,11 +8611,25 @@ function createUnpremultipliedPixelMap(src: PixelMap, dst: PixelMap): Promise<vo
      * @crossplatform
      * @form
      * @atomicservice
-     * @since arkts {'1.1':'12', '1.2':'20'}
-     * @arkts 1.1&1.2
+     * @since 12
      */
     createPixelMap(options?: DecodingOptions): Promise<PixelMap>;
 
+    /**
+     * Creates a PixelMap object based on image decoding parameters. This method uses a promise to
+     * return the object.
+     *
+     * @param { DecodingOptions } options Image decoding parameters.
+     * @returns { Promise<PixelMap | undefined> } A Promise instance used to return the PixelMap object.
+     * @syscap SystemCapability.Multimedia.Image.ImageSource
+     * @crossplatform
+     * @form
+     * @atomicservice
+     * @since 20
+     * @arkts 1.2
+     */
+    createPixelMap(options?: DecodingOptions): Promise<PixelMap | undefined>;
+
     /**
      * Creates a PixelMap object. This method uses a callback to return the object.
      *
@@ -8365,11 +8662,23 @@ function createUnpremultipliedPixelMap(src: PixelMap, dst: PixelMap): Promise<vo
      * @crossplatform
      * @form
      * @atomicservice
-     * @since arkts {'1.1':'12','1.2':'20'}
-     * @arkts 1.1&1.2
+     * @since 12
      */
     createPixelMap(callback: AsyncCallback<PixelMap>): void;
 
+    /**
+     * Creates a PixelMap object. This method uses a callback to return the object.
+     *
+     * @param { AsyncCallback<PixelMap | undefined> } callback Callback used to return the PixelMap object.
+     * @syscap SystemCapability.Multimedia.Image.ImageSource
+     * @crossplatform
+     * @form
+     * @atomicservice
+     * @since 20
+     * @arkts 1.2
+     */
+    createPixelMap(callback: AsyncCallback<PixelMap | undefined>): void;
+
     /**
      * Creates a PixelMap object based on image decoding parameters. This method uses a callback to
      * return the object.
@@ -8410,11 +8719,25 @@ function createUnpremultipliedPixelMap(src: PixelMap, dst: PixelMap): Promise<vo
      * @crossplatform
      * @form
      * @atomicservice
-     * @since arkts {'1.1':'12','1.2':'20'}
-     * @arkts 1.1&1.2
+     * @since 12
      */
     createPixelMap(options: DecodingOptions, callback: AsyncCallback<PixelMap>): void;
 
+    /**
+     * Creates a PixelMap object based on image decoding parameters. This method uses a callback to
+     * return the object.
+     *
+     * @param { DecodingOptions } options Image decoding parameters.
+     * @param { AsyncCallback<PixelMap | undefined> } callback Callback used to return the PixelMap object.
+     * @syscap SystemCapability.Multimedia.Image.ImageSource
+     * @crossplatform
+     * @form
+     * @atomicservice
+     * @since 20
+     * @arkts 1.2
+     */
+    createPixelMap(options: DecodingOptions, callback: AsyncCallback<PixelMap | undefined>): void;
+
     /**
      * Creates a PixelMap based on decoding parameters, the memory type used by the PixelMap can be specified by
      * allocatorType. By default, the system selects the memory type based on the image type, image size, platform
@@ -8437,11 +8760,38 @@ function createUnpremultipliedPixelMap(src: PixelMap, dst: PixelMap): Promise<vo
      * @throws { BusinessError } 7700301 - Failed to decode image.
      * @throws { BusinessError } 7700302 - Failed to allocate memory.
      * @syscap SystemCapability.Multimedia.Image.ImageSource
-     * @since arkts {'1.1':'15','1.2':'20'}
-     * @arkts 1.1&1.2
+     * @since 15
      */
     createPixelMapUsingAllocator(options?: DecodingOptions, allocatorType?: AllocatorType): Promise<PixelMap>;
 
+    /**
+     * Creates a PixelMap based on decoding parameters, the memory type used by the PixelMap can be specified by
+     * allocatorType. By default, the system selects the memory type based on the image type, image size, platform
+     * capability, etc. When processing the PixelMap returned by this interface, please always consider the impact of
+     * stride.
+     *
+     * @param { DecodingOptions } options Image decoding parameters.
+     * @param { AllocatorType } allocatorType Indicate which memory type will be used by the returned PixelMap.
+     * @returns { Promise<PixelMap | undefined> } A Promise instance used to return the PixelMap object.
+     * @throws { BusinessError } 401 - Parameter error.Possible causes: 1.Mandatory parameters are left unspecified.
+     * 2.Incorrect parameter types; 3.Parameter verification failed.
+     * @throws { BusinessError } 7700101 - Bad source. e.g.,1. Image has invalid width or height. 2. Image source incomplete.
+     * 3. Read image data failed. 4. Codec create failed.
+     * @throws { BusinessError } 7700102 - Unsupported mimetype.
+     * @throws { BusinessError } 7700103 - Image too large. This status code is thrown when an error occurs during the process of
+     * checking size.
+     * @throws { BusinessError } 7700201 - Unsupported allocator type, e.g., use share memory to decode a HDR image as
+     * only DMA supported hdr metadata.
+     * @throws { BusinessError } 7700203 - Unsupported options, e.g, cannot convert image into desired pixel format.
+     * @throws { BusinessError } 7700301 - Failed to decode image.
+     * @throws { BusinessError } 7700302 - Failed to allocate memory.
+     * @syscap SystemCapability.Multimedia.Image.ImageSource
+     * @since 20
+     * @arkts 1.2
+     */
+    createPixelMapUsingAllocator(options?: DecodingOptions, allocatorType?: AllocatorType)
+      : Promise<PixelMap | undefined>;
+
     /**
      * Create a PixelMap object based on image decoding parameters synchronously.
      *
@@ -8449,11 +8799,22 @@ function createUnpremultipliedPixelMap(src: PixelMap, dst: PixelMap): Promise<vo
      * @returns { PixelMap } Return the PixelMap. If decoding fails, return undefined.
      * @syscap SystemCapability.Multimedia.Image.ImageSource
      * @crossplatform
-     * @since arkts {'1.1':'12', '1.2':'20'}
-     * @arkts 1.1&1.2
+     * @since 12
      */
     createPixelMapSync(options?: DecodingOptions): PixelMap;
 
+    /**
+     * Create a PixelMap object based on image decoding parameters synchronously.
+     *
+     * @param { DecodingOptions } options - Image decoding parameters.
+     * @returns { PixelMap | undefined } Return the PixelMap. If decoding fails, return undefined.
+     * @syscap SystemCapability.Multimedia.Image.ImageSource
+     * @crossplatform
+     * @since 20
+     * @arkts 1.2
+     */
+    createPixelMapSync(options?: DecodingOptions): PixelMap | undefined;
+
     /**
      * Creates a PixelMap based on decoding parameters synchronously, the memory type used by the PixelMap can be
      * specified by allocatorType. By default, the system selects the memory type based on the image type, image size,
@@ -8476,11 +8837,37 @@ function createUnpremultipliedPixelMap(src: PixelMap, dst: PixelMap): Promise<vo
      * @throws { BusinessError } 7700301 - Failed to decode image.
      * @throws { BusinessError } 7700302 - Failed to allocate memory.
      * @syscap SystemCapability.Multimedia.Image.ImageSource
-     * @since arkts {'1.1':'15','1.2':'20'}
-     * @arkts 1.1&1.2
+     * @since 15
      */
     createPixelMapUsingAllocatorSync(options?: DecodingOptions, allocatorType?: AllocatorType): PixelMap;
 
+    /**
+     * Creates a PixelMap based on decoding parameters synchronously, the memory type used by the PixelMap can be
+     * specified by allocatorType. By default, the system selects the memory type based on the image type, image size,
+     * platform capability, etc. When processing the PixelMap returned by this interface, please always consider the
+     * impact of stride.
+     *
+     * @param { DecodingOptions } options Image decoding parameters.
+     * @param { AllocatorType } allocatorType Indicate which memory type will be used by the returned PixelMap.
+     * @returns { PixelMap | undefined } Return the PixelMap. If decoding fails, return undefined.
+     * @throws { BusinessError } 401 - Parameter error.Possible causes: 1.Mandatory parameters are left unspecified.
+     * 2.Incorrect parameter types; 3.Parameter verification failed.
+     * @throws { BusinessError } 7700101 - Bad source. e.g.,1. Image has invalid width or height. 2. Image source incomplete.
+     * 3. Read image data failed. 4. Codec create failed.
+     * @throws { BusinessError } 7700102 - Unsupported mimetype.
+     * @throws { BusinessError } 7700103 - Image too large. This status code is thrown when an error occurs during the process of
+     * checking size.
+     * @throws { BusinessError } 7700201 - Unsupported allocator type, e.g., use share memory to decode a HDR image as
+     * only DMA supported hdr metadata.
+     * @throws { BusinessError } 7700203 - Unsupported options, e.g, cannot convert image into desired pixel format.
+     * @throws { BusinessError } 7700301 - Failed to decode image.
+     * @throws { BusinessError } 7700302 - Failed to allocate memory.
+     * @syscap SystemCapability.Multimedia.Image.ImageSource
+     * @since 20
+     * @arkts 1.2
+     */
+    createPixelMapUsingAllocatorSync(options?: DecodingOptions, allocatorType?: AllocatorType): PixelMap | undefined;
+
     /**
      * Creates a PixelMap array based on image decoding parameters. This method uses a promise to
      * return the array. For animated images such as GIF and WebP, this interface returns the image data of each frame.
@@ -9213,11 +9600,25 @@ function createUnpremultipliedPixelMap(src: PixelMap, dst: PixelMap): Promise<vo
      * 2.Incorrect parameter types; 3.Parameter verification failed.
      * @throws { BusinessError } 7700301 - Failed to decode image.
      * @syscap SystemCapability.Multimedia.Image.ImageSource
-     * @since arkts {'1.1':'13','1.2':'20'}
-     * @arkts 1.1&1.2
+     * @since 13
      */
     createPicture(options?: DecodingOptionsForPicture): Promise<Picture>
 
+    /**
+     * Creates a Picture object based on image decoding parameters. This method uses a promise to
+     * return the object.
+     *
+     * @param { DecodingOptionsForPicture } options Image decoding parameters.
+     * @returns { Promise<Picture | undefined> } A Promise instance used to return the Picture object.
+     * @throws { BusinessError } 401 - Parameter error.Possible causes: 1.Mandatory parameters are left unspecified.
+     * 2.Incorrect parameter types; 3.Parameter verification failed.
+     * @throws { BusinessError } 7700301 - Failed to decode image.
+     * @syscap SystemCapability.Multimedia.Image.ImageSource
+     * @since 20
+     * @arkts 1.2
+     */
+    createPicture(options?: DecodingOptionsForPicture): Promise<Picture | undefined>
+
     /**
      * Decodes an image at the specified index into a Picture object.
      *
-- 
Gitee