add ark graphics 3d api

Signed-off-by: huxiaoming5@huawei.com <huxiaoming5@huawei.com>
Change-Id: I660817c4812e1838da47cfafcd6e1307b366cecc

api/graphics3d/Scene.d.ts

@@ -69,7 +69,7 @@ export interface SceneNodeParameters {
   /**
    * The path of the scene node parameters.
    *
-   * @type { string }
+   * @type { ?string }
    * @syscap SystemCapability.ArkUi.Graphics3D
    * @since 12
    */
@@ -79,6 +79,7 @@ export interface SceneNodeParameters {
 /**
  * The scene resource factory.
  *
+ * @interface SceneResourceFactory
  * @syscap SystemCapability.ArkUi.Graphics3D
  * @since 12
  */
@@ -208,7 +209,7 @@ export class Scene {
    *
    * @param { string } path - the path of the node
    * @param { ?NodeType } type - verify the type of node, if it does not match, return null
-   * @returns { Node | null} if the node is found by it's path
+   * @returns { Node | null } if the node is found by it's path
    * @syscap SystemCapability.ArkUi.Graphics3D
    * @since 12
    */

api/graphics3d/SceneNodes.d.ts

@@ -44,7 +44,7 @@ export interface LayerMask {
    * Set whether the layer mask is enabled.
    *
    * @param { number } index - the layer mask
-   * @param { boolean } whether layer mask is enabled 
+   * @param { boolean } enabled - whether layer mask is enabled
    * @syscap SystemCapability.ArkUi.Graphics3D
    * @since 12
    */
@@ -113,7 +113,7 @@ export interface Container<T> {
    * Insert a item.
    *
    * @param { T } item - the item insert to the container
-   * @param { T } sibling - insert after this item, insert to the head if sibling is null
+   * @param { T | null } sibling - insert after this item, insert to the head if sibling is null
    * @syscap SystemCapability.ArkUi.Graphics3D
    * @since 12
    */
@@ -131,7 +131,8 @@ export interface Container<T> {
   /**
    * Returns a child at given index from this Container's child list.
    *
-   * @param { T } index - the index of the child to return
+   * @param { number } index - the index of the child to return
+   * @returns { T | null } return the item specified by the index
    * @syscap SystemCapability.ArkUi.Graphics3D
    * @since 12
    */
@@ -396,7 +397,7 @@ export interface DirectionalLight extends Light {
  * Defines camera.
  *
  * @interface Camera
- * @extends node
+ * @extends Node
  * @syscap SystemCapability.ArkUi.Graphics3D
  * @since 12
  */

api/graphics3d/SceneResources.d.ts

@@ -114,7 +114,7 @@ export interface SceneResource {
   /**
    * Scene resource type.
    *
-   * @type { string }
+   * @type { SceneResourceType }
    * @readonly
    * @syscap SystemCapability.ArkUi.Graphics3D
    * @since 12
@@ -266,7 +266,7 @@ export interface Mesh extends SceneResource {
   /**
    * The sub meshes of the mesh.
    *
-   * @type { SubMesh }
+   * @type { SubMesh[] }
    * @readonly
    * @syscap SystemCapability.ArkUi.Graphics3D
    * @since 12
@@ -314,7 +314,7 @@ export interface Animation extends SceneResource {
   /**
    * The duration of the animation.
    *
-   * @type { boolean }
+   * @type { number }
    * @readonly
    * @syscap SystemCapability.ArkUi.Graphics3D
    * @since 12
@@ -344,7 +344,7 @@ export interface Animation extends SceneResource {
   /**
    * Register a callback when animation finished.
    *
-   * @param { () => void } callback - the callback invoked when animation finished
+   * @param { function } callback - the callback invoked when animation finished
    * @syscap SystemCapability.ArkUi.Graphics3D
    * @since 12
    */
@@ -353,7 +353,7 @@ export interface Animation extends SceneResource {
   /**
    * Register a callback when animation started.
    *
-   * @param { () => void } callback - the callback invoked when animation started
+   * @param { function } callback - the callback invoked when animation started
    * @syscap SystemCapability.ArkUi.Graphics3D
    * @since 12
    */
@@ -497,7 +497,7 @@ export interface Environment extends SceneResource {
   /**
    * The environment image of the environment.
    *
-   * @type { ?Image | null }
+   * @type { ?(Image | null) }
    * @syscap SystemCapability.ArkUi.Graphics3D
    * @since 12
    */
@@ -506,7 +506,7 @@ export interface Environment extends SceneResource {
   /**
    * The radiance image of the environment.
    *
-   * @type { ?Image | null }
+   * @type { ?(Image | null) }
    * @syscap SystemCapability.ArkUi.Graphics3D
    * @since 12
    */

api/graphics3d/SceneTypes.d.ts

@@ -291,6 +291,7 @@ export interface Rect {
 /**
  * 3D position information.
  *
+ * @typedef Position3
  * @syscap SystemCapability.ArkUi.Graphics3D
  * @since 12
  */
@@ -299,6 +300,7 @@ export type Position3 = Vec3;
 /**
  * 3D rotation info as euler angles.
  *
+ * @typedef Rotation3
  * @syscap SystemCapability.ArkUi.Graphics3D
  * @since 12
  */
@@ -307,6 +309,7 @@ export type Rotation3 = Vec3;
 /**
  * 3D scale information.
  *
+ * @typedef Scale3
  * @syscap SystemCapability.ArkUi.Graphics3D
  * @since 12
  */