From e0b739a7355386b8a78044760d0e1a79b59e013e Mon Sep 17 00:00:00 2001 From: Gloria Date: Tue, 24 Jun 2025 20:06:32 +0800 Subject: [PATCH] Update docs against errors Signed-off-by: wusongqing --- .../application-models/app-uri-config.md | 2 +- .../application-models/application-models.md | 2 +- .../application-models/dataability-overview.md | 2 +- .../application-models/start-flight-apps.md | 4 ++-- .../start-local-pageability.md | 2 +- .../graphics/canvas-get-result-draw-arkts.md | 2 +- .../graphics/canvas-get-result-draw-c.md | 6 +++--- .../graphics/canvas-operation-state-arkts.md | 16 ++++++++-------- .../graphics/canvas-operation-state-c.md | 8 ++++---- .../graphics/complex-drawing-effect-arkts.md | 10 +++++----- .../graphics/geometric-shape-drawing-arkts.md | 14 +++++++------- .../graphics/graphic-drawing-overview.md | 2 +- .../graphics/textblock-drawing-arkts.md | 2 +- .../graphics/textblock-drawing-c.md | 6 +++--- en/application-dev/graphics/theme-font-c.md | 6 +++--- .../graphics3d/arkgraphics3D-overview.md | 2 +- .../audio/using-audiocapturer-for-recording.md | 2 +- en/application-dev/media/image/image-source-c.md | 2 +- en/application-dev/media/image/pixelmap-c.md | 2 +- .../media/media/avmetadataextractor.md | 2 +- .../media/media/avtranscoder-faq.md | 2 +- .../using-ndk-avmetadataextractor-for-media.md | 2 +- .../photoAccessHelper-movingphoto.md | 4 ++-- .../medialibrary/photoAccessHelper-savebutton.md | 4 ++-- ...js-apis-app-ability-actionExtensionAbility.md | 2 +- .../js-apis-app-ability-shareExtensionAbility.md | 2 +- .../js-apis-bundle-ShortcutInfo.md | 2 +- .../js-apis-inner-application-context.md | 2 +- .../drawing__shadow__layer_8h.md | 2 +- .../native__audio__session__manager_8h.md | 2 +- 30 files changed, 59 insertions(+), 59 deletions(-) diff --git a/en/application-dev/application-models/app-uri-config.md b/en/application-dev/application-models/app-uri-config.md index 96cc443e66db..d083dd37856b 100644 --- a/en/application-dev/application-models/app-uri-config.md +++ b/en/application-dev/application-models/app-uri-config.md @@ -31,7 +31,7 @@ URIs can be expressed in different formats based on the available fields. Among > **NOTE** > - The scheme of a third-party application cannot be the same as that of a system application. Otherwise, the third-party application cannot be started using the URI. -> - If multiple applications are configured with the same URLs, these applications will be matched during application redirection, and a dialog box will be displayed for uses to select. For better user experience, you can use the **path** field to distinguish the application to start. For example, use **https://www.example.com/path1** to start target application 1 and use **https://www.example.com/path2** to start target application 2. +> - If multiple applications are configured with the same URLs, these applications will be matched during application redirection, and a dialog box will be displayed for users to select. For better user experience, you can use the **path** field to distinguish the application to start. For example, use **https://www.example.com/path1** to start target application 1 and use **https://www.example.com/path2** to start target application 2. ### Description of linkFeature diff --git a/en/application-dev/application-models/application-models.md b/en/application-dev/application-models/application-models.md index 0289e6bc7617..7ce2b465bca9 100644 --- a/en/application-dev/application-models/application-models.md +++ b/en/application-dev/application-models/application-models.md @@ -10,7 +10,7 @@ The application model consists of the following elements: - Application component - An application component is the basic unit and entry for the running of an application. When a user starts, uses, or exits an application, the application component transits in different states. This is called the application component lifecycle. The application component provides lifecycle callbacks, through which you can detect application [status changes](uiability-lifecycle.md). When writing an application, you needs to compile application components and their lifecycle callbacks, and configure related information in the application configuration file. In this way, the operating system creates an application component instance based on the configuration file during running, and schedules the lifecycle callbacks to execute your code. + An application component is the basic unit and entry for the running of an application. When a user starts, uses, or exits an application, the application component transits in different states. This is called the application component lifecycle. The application component provides lifecycle callbacks, through which you can detect application [status changes](uiability-lifecycle.md). When writing an application, you need to compile application components and their lifecycle callbacks, and configure related information in the application configuration file. In this way, the operating system creates an application component instance based on the configuration file during running, and schedules the lifecycle callbacks to execute your code. - Process model diff --git a/en/application-dev/application-models/dataability-overview.md b/en/application-dev/application-models/dataability-overview.md index 3f04c214c421..dbcd099163fd 100644 --- a/en/application-dev/application-models/dataability-overview.md +++ b/en/application-dev/application-models/dataability-overview.md @@ -7,4 +7,4 @@ A DataAbility is an ability that uses the Data template. It provides unified dat A DataAbility helps applications manage access to data stored by themselves and other applications, and provides methods for sharing data with other applications, either on the same device or across devices. -Data can be stored in a database or files on disks. The DataAbility provide methods for inserting, deleting, updating, and querying data, and opening files. You should implement these methods. +Data can be stored in a database or files on disks. The DataAbility provides methods for inserting, deleting, updating, and querying data, and opening files. You should implement these methods. diff --git a/en/application-dev/application-models/start-flight-apps.md b/en/application-dev/application-models/start-flight-apps.md index 9af3ec356645..2e83fa6aebc3 100644 --- a/en/application-dev/application-models/start-flight-apps.md +++ b/en/application-dev/application-models/start-flight-apps.md @@ -13,7 +13,7 @@ If the **type** field in **startAbilityByType** is set to **flight**, two intent | Name | Type | Mandatory| Description | | ------------- | ------ | ---- | ------------------------------------------------------------ | | sceneType | number | No | Intent scene, which indicates the purpose of the current request. The default value is **1**. In scenarios of flight query by flight number, set it to **1** or leave it empty. | - | flightNo | string | Yes | Flight number, which is a two-digit code of the airline company plus a dight.| + | flightNo | string | Yes | Flight number, which is a two-digit code of the airline company plus a digit.| | departureDate | string | No | Flight departure date, in the format of YYYY-MM-DD. | - Flight query by origin and destination @@ -133,7 +133,7 @@ If the **type** field in **startAbilityByType** is set to **flight**, two intent | Name | Type | Mandatory| Description | | -------------------- | ------ | ---- | ---------------------------------------------------- | - | flightNo | string | Yes | Flight number, which is a two-digit code of the airline company plus a dight. | + | flightNo | string | Yes | Flight number, which is a two-digit code of the airline company plus a digit. | | departureDate | string | No | Flight departure date, in the format of YYYY-MM-DD. If this field is left blank, it indicates the current day. | - Flight query by origin and destination diff --git a/en/application-dev/application-models/start-local-pageability.md b/en/application-dev/application-models/start-local-pageability.md index 4288593e1a6d..8df2551c21f5 100644 --- a/en/application-dev/application-models/start-local-pageability.md +++ b/en/application-dev/application-models/start-local-pageability.md @@ -1,7 +1,7 @@ # Starting a Local PageAbility -The capabilities related to the PageAbility are provided through the **featureAbility** class. For example, **startAbility()** in **featureAbility** is used to the PageAbility. +The capabilities related to the PageAbility are provided through the **featureAbility** class. For example, **startAbility()** in **featureAbility** is used to start the PageAbility. **Table 1** featureAbility APIs diff --git a/en/application-dev/graphics/canvas-get-result-draw-arkts.md b/en/application-dev/graphics/canvas-get-result-draw-arkts.md index 0afaa2172ef7..301e08eb5b61 100644 --- a/en/application-dev/graphics/canvas-get-result-draw-arkts.md +++ b/en/application-dev/graphics/canvas-get-result-draw-arkts.md @@ -9,7 +9,7 @@ Canvas provides the capability of drawing basic graphics on the screen. You can Canvas is the core of graphics drawing. All drawing operations (including basic graphics drawing, text drawing, image drawing, and image transformation) mentioned in this chapter are based on Canvas. -Currently, ArkTS can obtain the canvas in either of the following ways: [Obtaining the Canvas That Can Be Directly Displayed](#obtaining-the-canvas-that-can-be-directly-displayed) and [Obtaining and Displaying the Off-Screen Canvas](#obtaining-and-displaying-the off-screen-canvas). The former can display the drawing result on the screen without additional operations after the drawing API is called, while the latter can display the drawing result using existing display methods. +Currently, ArkTS can obtain the canvas in either of the following ways: [Obtaining the Canvas That Can Be Directly Displayed](#obtaining-the-canvas-that-can-be-directly-displayed) and [Obtaining and Displaying the Off-Screen Canvas](#obtaining-and-displaying-the-off-screen-canvas). The former can display the drawing result on the screen without additional operations after the drawing API is called, while the latter can display the drawing result using existing display methods. ## Obtaining the Canvas That Can Be Directly Displayed diff --git a/en/application-dev/graphics/canvas-get-result-draw-c.md b/en/application-dev/graphics/canvas-get-result-draw-c.md index 0f330c82879d..fd95a5693bfd 100644 --- a/en/application-dev/graphics/canvas-get-result-draw-c.md +++ b/en/application-dev/graphics/canvas-get-result-draw-c.md @@ -23,9 +23,9 @@ The following table lists the common APIs for creating a Canvas. For details, se ## Obtaining the Canvas That Can Be Directly Displayed -Obtains the canvas that can be directly displayed by using the XComponent. +Obtain the canvas that can be directly displayed by using the XComponent. -1. Obtains the BufferHandle object from the NativeWindow corresponding to the XComponent. For details about APIs related to NativeWindow, see [_native_window](../reference/apis-arkgraphics2d/_native_window.md). +1. Obtain the BufferHandle object from the NativeWindow corresponding to the XComponent. For details about APIs related to NativeWindow, see [_native_window](../reference/apis-arkgraphics2d/_native_window.md). ```c++ uint64_t widht, height; @@ -46,7 +46,7 @@ Obtains the canvas that can be directly displayed by using the XComponent. BufferHandle* bufferHandle = OH_NativeWindow_GetBufferHandleFromNative(buffer); ``` -2. Obtains the corresponding memory address from BufferHandle. +2. Obtain the corresponding memory address from BufferHandle. ```c++ uint32_t* mappedAddr = static_cast(mmap(bufferHandle->virAddr, bufferHandle->size, PROT_READ | PROT_WRITE, MAP_SHARED, bufferHandle->fd, 0)); diff --git a/en/application-dev/graphics/canvas-operation-state-arkts.md b/en/application-dev/graphics/canvas-operation-state-arkts.md index 3cc9199ecb0e..45344fa2c1e7 100644 --- a/en/application-dev/graphics/canvas-operation-state-arkts.md +++ b/en/application-dev/graphics/canvas-operation-state-arkts.md @@ -26,7 +26,7 @@ Currently, the following tailoring operations are supported: - Crops a rounded rectangle. -- Tailor the user-defined path. +- Crops the user-defined path. - Crops a region. @@ -71,7 +71,7 @@ let rect: common2D.Rect = { left: 200, top: 200, right: 600, bottom: 600 }; canvas.clipRect(rect); // Draw a circle on the canvas. canvas.drawCircle(300, 300, 300); -// Remove the padding effect. +// Remove the filling effect. canvas.detachBrush(); ``` @@ -120,11 +120,11 @@ let brush = new drawing.Brush(); brush.setColor(0xFF, 0xFF, 0x00, 0x00); // Set the brush filling effect. canvas.attachBrush(brush); -// Perform the pan operation. +// Perform the translation operation. canvas.translate(300, 300); // Draw a rectangle. canvas.drawRect({ left: 200, top: 200, right: 600, bottom: 600 }); -// Remove the padding effect. +// Remove the filling effect. canvas.detachBrush(); ``` @@ -153,7 +153,7 @@ canvas.attachBrush(brush); canvas.rotate(45, 200, 200); // Draw a rectangle. canvas.drawRect({ left: 200, top: 200, right: 600, bottom: 600 }); -// Remove the padding effect. +// Remove the filling effect. canvas.detachBrush(); ``` @@ -178,16 +178,16 @@ let brush = new drawing.Brush(); brush.setColor({ alpha: 0xFF, red: 0xFF, green: 0x00, blue: 0x00 }); // Set the brush filling effect. canvas.attachBrush(brush); -// Perform the zoom-in operation. +// Perform the scaling operation. canvas.scale(2, 2); // Draw a rectangle. canvas.drawRect({ left: 200, top: 200, right: 600, bottom: 600 }); -// Remove the padding effect. +// Remove the filling effect. canvas.detachBrush(); ``` -| Original image| Effect after resizing| +| Original image| Effect After Scaling| | -------- | -------- | | ![Screenshot_20241129145853573](figures/Screenshot_20241129145853573.jpg) | ![Screenshot_20241129151044798](figures/Screenshot_20241129151044798.jpg) | diff --git a/en/application-dev/graphics/canvas-operation-state-c.md b/en/application-dev/graphics/canvas-operation-state-c.md index 0df4f6355389..e32665a1de1a 100644 --- a/en/application-dev/graphics/canvas-operation-state-c.md +++ b/en/application-dev/graphics/canvas-operation-state-c.md @@ -24,7 +24,7 @@ Currently, the following tailoring operations are supported: - Crops a rounded rectangle. -- Tailor the user-defined path. +- Crops the user-defined path. - Crops a region. @@ -112,7 +112,7 @@ The following figure shows a simple example. ```c++ // Create a brush object. OH_Drawing_Brush* brush = OH_Drawing_BrushCreate(); -// Fill color to be superimposed on the image. +// Set the fill color to be superimposed on the image. OH_Drawing_BrushSetColor(brush, OH_Drawing_ColorSetArgb(0xFF, 0xFF, 0x00, 0x00)); // Set the brush in the canvas. OH_Drawing_CanvasAttachBrush(canvas, brush); @@ -143,7 +143,7 @@ The following figure shows a simple example. ```c++ // Create a brush object. OH_Drawing_Brush* brush = OH_Drawing_BrushCreate(); -Fill color to be superimposed on the image. +// Set the fill color to be superimposed on the image. OH_Drawing_BrushSetColor(brush, OH_Drawing_ColorSetArgb(0xFF, 0xFF, 0x00, 0x00)); // Set the brush in the canvas. OH_Drawing_CanvasAttachBrush(canvas, brush); @@ -174,7 +174,7 @@ The following figure shows a simple example. ```c++ // Create a brush object. OH_Drawing_Brush* brush = OH_Drawing_BrushCreate(); -Fill color to be superimposed on the image. +// Set the fill color to be superimposed on the image. OH_Drawing_BrushSetColor(brush, OH_Drawing_ColorSetArgb(0xFF, 0xFF, 0x00, 0x00)); // Set the brush in the canvas. OH_Drawing_CanvasAttachBrush(canvas, brush); diff --git a/en/application-dev/graphics/complex-drawing-effect-arkts.md b/en/application-dev/graphics/complex-drawing-effect-arkts.md index 14888980b52e..f86e755642a5 100644 --- a/en/application-dev/graphics/complex-drawing-effect-arkts.md +++ b/en/application-dev/graphics/complex-drawing-effect-arkts.md @@ -40,7 +40,7 @@ brush.setBlendMode(drawing.BlendMode.PLUS); canvas.attachBrush(brush); // Draw a circle (source pixel). canvas.drawCircle(600, 600, 300); -// Remove the padding effect. +// Remove the filling effect. canvas.detachBrush(); ``` @@ -129,7 +129,7 @@ canvas.attachBrush(brush); let rect: common2D.Rect = { left: 100, top: 100, right: 900, bottom: 900 }; // Draw a rectangle. canvas.drawRect(rect); -// Remove the padding effect. +// Remove the filling effect. canvas.detachBrush(); ``` @@ -158,7 +158,7 @@ canvas.attachBrush(brush); let rect: common2D.Rect = { left: 100, top: 100, right: 900, bottom: 900 }; // Draw a rectangle. canvas.drawRect(rect); -// Remove the padding effect. +// Remove the filling effect. canvas.detachBrush(); ``` @@ -187,7 +187,7 @@ canvas.attachBrush(brush); let rect: common2D.Rect = { left: 100, top: 100, right: 900, bottom: 900 }; // Draw a rectangle. canvas.drawRect(rect); -// Remove the padding effect. +// Remove the filling effect. canvas.detachBrush(); ``` @@ -264,7 +264,7 @@ canvas.attachBrush(brush); let rect: common2D.Rect = { left: 300, top: 300, right: 900, bottom: 900 }; // Draw a rectangle. canvas.drawRect(rect); -// Remove the padding effect. +// Remove the filling effect. canvas.detachBrush(); ``` diff --git a/en/application-dev/graphics/geometric-shape-drawing-arkts.md b/en/application-dev/graphics/geometric-shape-drawing-arkts.md index d4711f21af02..a8cbc93b2bcb 100644 --- a/en/application-dev/graphics/geometric-shape-drawing-arkts.md +++ b/en/application-dev/graphics/geometric-shape-drawing-arkts.md @@ -170,13 +170,13 @@ pen.setStrokeWidth(10.0); canvas.attachPen(pen); // Create a brush. let brush = new drawing.Brush(); -Fill color to be superimposed on the image. +// Set the fill color to be superimposed on the image. brush.setColor(0xFF, 0x00, 0xFF, 0x00); // Set the brush filling effect. canvas.attachBrush(brush); -Draw a route. +// Draw a path. canvas.drawPath(path); -// Remove the padding effect. +// Remove the filling effect. canvas.detachBrush(); // Remove the stroke effect. canvas.detachPen(); @@ -210,7 +210,7 @@ region2.setRect(300, 300, 900, 900); region1.op(region2, drawing.RegionOp.XOR); Draw a region. canvas.drawRegion(region1); -// Remove the padding effect. +// Remove the filling effect. canvas.detachBrush(); ``` @@ -232,7 +232,7 @@ brush.setColor(0xFF, 0xFF, 0x00, 0x00); canvas.attachBrush(brush); // Draw a rectangle. canvas.drawRect(200, 200, 1000, 700); -// Remove the padding effect. +// Remove the filling effect. canvas.detachBrush(); ``` @@ -247,7 +247,7 @@ The rounded rectangle object is constructed using the new drawing.RoundRect() in - common2D.Rect (rectangle object). A rounded rectangle is formed by cutting rounded corners on the basis of the rectangle. -- Radius of the rounded corner on the Y axis. +- Radius of the rounded corner on the X axis. - Radius of the rounded corner on the Y axis. @@ -266,7 +266,7 @@ let rect: common2D.Rect = { left: 200, top: 200, right: 1000, bottom: 700 }; let rrect = new drawing.RoundRect(rect, 30, 30); // Draw a round rectangle on the canvas. canvas.drawRoundRect(rrect); -// Remove the padding effect. +// Remove the filling effect. canvas.detachBrush(); ``` diff --git a/en/application-dev/graphics/graphic-drawing-overview.md b/en/application-dev/graphics/graphic-drawing-overview.md index 48b328a8bea2..4e9fdfae6dd2 100644 --- a/en/application-dev/graphics/graphic-drawing-overview.md +++ b/en/application-dev/graphics/graphic-drawing-overview.md @@ -58,6 +58,6 @@ Currently, the drawing dependency can be displayed in either of the following mo ## Constraints -In a graphic drawing process, a unit used is a pixel unit px. +In the process of graphics rendering, the unit used is pixels (px). diff --git a/en/application-dev/graphics/textblock-drawing-arkts.md b/en/application-dev/graphics/textblock-drawing-arkts.md index 0f21f0172563..8cbc75d1bd45 100644 --- a/en/application-dev/graphics/textblock-drawing-arkts.md +++ b/en/application-dev/graphics/textblock-drawing-arkts.md @@ -110,7 +110,7 @@ font.setSize(200); const textBlob = drawing.TextBlob.makeFromString("Hello world", font, drawing.TextEncoding.TEXT_ENCODING_UTF8); // Draw a TextBlob. canvas.drawTextBlob(textBlob, 100, 300); -// Remove the padding effect. +// Remove the filling effect. canvas.detachBrush(); ``` diff --git a/en/application-dev/graphics/textblock-drawing-c.md b/en/application-dev/graphics/textblock-drawing-c.md index d6da0fe83518..d718fe3ed69b 100644 --- a/en/application-dev/graphics/textblock-drawing-c.md +++ b/en/application-dev/graphics/textblock-drawing-c.md @@ -99,11 +99,11 @@ You can also use a shader to implement the text gradient effect. For details abo The following is a brief example and schematic diagram of adding a linear gradient shader effect to the text: ```c++ -// Start point +// Start point. OH_Drawing_Point *startPt = OH_Drawing_PointCreate(100, 100); -To +// End point. OH_Drawing_Point *endPt = OH_Drawing_PointCreate(900, 900); -Color array. +// Color array. uint32_t colors[] = {0xFFFFFF00, 0xFFFF0000, 0xFF0000FF}; // Relative position array float pos[] = {0.0f, 0.5f, 1.0f}; diff --git a/en/application-dev/graphics/theme-font-c.md b/en/application-dev/graphics/theme-font-c.md index ea898ba50a42..1847d9735038 100644 --- a/en/application-dev/graphics/theme-font-c.md +++ b/en/application-dev/graphics/theme-font-c.md @@ -10,11 +10,11 @@ Theme fonts refer to the fonts that can be used in system theme applications. Th ![themeText_native](figures/themeText_native.jpg) -To switch the subject word, the app must subscribe to the subject word change event. After receiving the font change event, the app proactively calls the page refresh API to switch the subject word. Otherwise, the subject word takes effect only after the app is restarted. To draw the theme font, you need to use OH_Drawing_GetFontCollectionGlobalInstance to obtain the global font set object. Only the object returned by this API has the theme font information. +To switch the theme font, the app must subscribe to the theme font change event. After receiving the font change event, the app proactively calls the page refresh API to switch the theme font. Otherwise, the theme font takes effect only after the app is restarted. To draw the theme font, you need to use OH_Drawing_GetFontCollectionGlobalInstance to obtain the global font set object. Only the object returned by this API has the theme font information. > **NOTE** > -> The font set object created by OH_Drawing_CreateSharedFontCollection does not contain the subject word information and cannot be used to draw the subject word. +> The font set object created by OH_Drawing_CreateSharedFontCollection does not contain the theme font information and cannot be used to draw the theme font. ## Available APIs @@ -49,7 +49,7 @@ The following table lists the common APIs for registering and using theme fonts. }; ``` - When newConfig changes, the onConfigurationUpdate function is automatically triggered. The application may obtain the fontId from the sent configuration information, and determine whether the fontId is the same as the fontId stored locally in the application to identify the switching of the subject word. If they are inconsistent, the local font ID is updated and the C++ code is called to update the typesetting result. + When newConfig changes, the onConfigurationUpdate function is automatically triggered. The application may obtain the fontId from the sent configuration information, and determine whether the fontId is the same as the fontId stored locally in the application to identify the switching of the theme font. If they are inconsistent, the local font ID is updated and the C++ code is called to update the typesetting result. 3. This step and the following steps describe how to use the theme font on the C++ side. The calling path from ArkTS to C++ needs to be selected based on the actual situation. This example is not recommended. diff --git a/en/application-dev/graphics3d/arkgraphics3D-overview.md b/en/application-dev/graphics3d/arkgraphics3D-overview.md index fde5666d04f2..698f221d6e59 100644 --- a/en/application-dev/graphics3d/arkgraphics3D-overview.md +++ b/en/application-dev/graphics3d/arkgraphics3D-overview.md @@ -5,7 +5,7 @@ ArkGraphics 3D provides basic 3D scene rendering capabilities based on the light ## Function Description - Loads and parses a glTF model. You can place a glTF model file in an application sandbox and use the asynchronous APIs provided by ArkGraphics 3D to load the model and render the scene. For details, see [Scene](../reference/apis-arkgraphics3d/js-apis-inner-scene.md). For details about glTF, see [glTF-Specification](https://registry.khronos.org/glTF/specs/2.0/glTF-2.0.html). -- Provides APIs for customizing light nodes, camera nodes, and common nodes. You can customize scene lights and rendering angles. In additions, users can dynamically adjust the scene tree structure and node attributes to adjust a 3D scene. For details, see [Scene](../reference/apis-arkgraphics3d/js-apis-inner-scene.md) and [SceneNode](../reference/apis-arkgraphics3d/js-apis-inner-scene-nodes.md). +- Provides APIs for customizing light nodes, camera nodes, and common nodes. You can customize scene lights and rendering angles. In addition, users can dynamically adjust the scene tree structure and node attributes to adjust a 3D scene. For details, see [Scene](../reference/apis-arkgraphics3d/js-apis-inner-scene.md) and [SceneNode](../reference/apis-arkgraphics3d/js-apis-inner-scene-nodes.md). - Provides APIs for creating images, materials, environments, and shaders used in a 3D scene. You can also customize a shader to carry out custom 3D material rendering. For details, see [Scene](../reference/apis-arkgraphics3d/js-apis-inner-scene.md) and [SceneResource](../reference/apis-arkgraphics3d/js-apis-inner-scene-resources.md). - Provides APIs for controlling the animation status in a 3D scene, such as starting, pausing, and finishing an animation, and playing an animation from a specified position. Callback functions are also provided so that you can perform logic control when an animation starts or ends. For details, see [SceneResource](../reference/apis-arkgraphics3d/js-apis-inner-scene-resources.md). - Provides APIs for you to carry out post-processing, for example, tone mapping. For details, see [ScenePostProcessSettings](../reference/apis-arkgraphics3d/js-apis-inner-scene-post-process-settings.md). diff --git a/en/application-dev/media/audio/using-audiocapturer-for-recording.md b/en/application-dev/media/audio/using-audiocapturer-for-recording.md index b4a50267fb23..341021477bbb 100644 --- a/en/application-dev/media/audio/using-audiocapturer-for-recording.md +++ b/en/application-dev/media/audio/using-audiocapturer-for-recording.md @@ -4,7 +4,7 @@ The AudioCapturer is used to record Pulse Code Modulation (PCM) audio data. It i ## Development Guidelines -The full recording process involves creating an **AudioCapturer** instance, configuring audio recording parameters, starting and stopping recording, and releasing the instance. In this topic, you will learn how to use the AudioCapturer to recording audio data. Before the development, you are advised to read [AudioCapturer](../../reference/apis-audio-kit/js-apis-audio.md#audiocapturer8) for the API reference. +The full recording process involves creating an **AudioCapturer** instance, configuring audio recording parameters, starting and stopping recording, and releasing the instance. In this topic, you will learn how to use the AudioCapturer to record audio data. Before the development, you are advised to read [AudioCapturer](../../reference/apis-audio-kit/js-apis-audio.md#audiocapturer8) for the API reference. The figure below shows the state changes of the AudioCapturer. After an **AudioCapturer** instance is created, different APIs can be called to switch the AudioCapturer to different states and trigger the required behavior. If an API is called when the AudioCapturer is not in the given state, the system may throw an exception or generate other undefined behavior. Therefore, you are advised to check the AudioCapturer state before triggering state transition. diff --git a/en/application-dev/media/image/image-source-c.md b/en/application-dev/media/image/image-source-c.md index 0e98a131e81b..4f494883e2a5 100644 --- a/en/application-dev/media/image/image-source-c.md +++ b/en/application-dev/media/image/image-source-c.md @@ -6,7 +6,7 @@ This topic describes how to create an ImageSource object, obtain the width and h ### Adding a Link Library -Open the **src/main/cpp/CMakeLists.txt** file of the native project, add **libimage_source.so**, **libpixelmap.so**, and and **libhilog_ndk.z.so** (on which the log APIs depend) to the **target_link_libraries** dependency. +Open the **src/main/cpp/CMakeLists.txt** file of the native project, add **libimage_source.so**, **libpixelmap.so**, and **libhilog_ndk.z.so** (on which the log APIs depend) to the **target_link_libraries** dependency. ```txt target_link_libraries(entry PUBLIC libhilog_ndk.z.so libimage_source.so libpixelmap.so) diff --git a/en/application-dev/media/image/pixelmap-c.md b/en/application-dev/media/image/pixelmap-c.md index 019c08f41ef1..afd3e8e5e97e 100644 --- a/en/application-dev/media/image/pixelmap-c.md +++ b/en/application-dev/media/image/pixelmap-c.md @@ -1,6 +1,6 @@ # Using Image_NativeModule for PixelMap Operations -You can use the **Pixelmap** class to create, operation and release a PixelMap, and obtain its width, height, pixel format, alpha type, and row stride. +You can use the **Pixelmap** class to create, operate, and release a PixelMap, and obtain its width, height, pixel format, alpha type, and row stride. ## How to Develop diff --git a/en/application-dev/media/media/avmetadataextractor.md b/en/application-dev/media/media/avmetadataextractor.md index e60a64c7f2fa..1f5299f812b8 100644 --- a/en/application-dev/media/media/avmetadataextractor.md +++ b/en/application-dev/media/media/avmetadataextractor.md @@ -1,6 +1,6 @@ # Using AVMetadataExtractor to Extract Audio and Video Metadata (ArkTS) -You can use the [AVMetadataExtractor](media-kit-intro.md#avmetadataextractor) to obtain metadata from a raw media asset. This topc walks you through on how to obtain the metadata of an audio asset. The process of obtaining the metadata of a video asset is similar. The only difference is that the process of obtaining the album cover is not required for a video asset, because no album cover is available in the video asset. +You can use the [AVMetadataExtractor](media-kit-intro.md#avmetadataextractor) to obtain metadata from a raw media asset. This topic walks you through on how to obtain the metadata of an audio asset. The process of obtaining the metadata of a video asset is similar. The only difference is that the process of obtaining the album cover is not required for a video asset, because no album cover is available in the video asset. The full process of obtaining the metadata of an audio asset includes creating an AVMetadataExtractor instance, setting resources, obtaining the metadata, obtaining the album cover, and releasing the instance. diff --git a/en/application-dev/media/media/avtranscoder-faq.md b/en/application-dev/media/media/avtranscoder-faq.md index 3d244004a31d..0fbd54235809 100644 --- a/en/application-dev/media/media/avtranscoder-faq.md +++ b/en/application-dev/media/media/avtranscoder-faq.md @@ -12,4 +12,4 @@ If the audio track format is not specified during transcoding, the system conver For details about the transcoding capabilities, see [AVTranscoder](media-kit-intro.md#avtranscoder) and [AVCodec Supported Formats](../avcodec/avcodec-support-formats.md). -2. When receiving an error event, the application should send the source video. When receiving a complete event, the application first call **release** before performing operations such as sending or uploading the transcoded video. +2. When receiving an error event, the application should send the source video. When receiving a complete event, the application first calls **release** before performing operations such as sending or uploading the transcoded video. diff --git a/en/application-dev/media/media/using-ndk-avmetadataextractor-for-media.md b/en/application-dev/media/media/using-ndk-avmetadataextractor-for-media.md index 3d5400d1b922..68d063fd2a78 100644 --- a/en/application-dev/media/media/using-ndk-avmetadataextractor-for-media.md +++ b/en/application-dev/media/media/using-ndk-avmetadataextractor-for-media.md @@ -1,6 +1,6 @@ # Using AVMetadataExtractor to Obtain Metadata (C/C++) -You can use the AVMetadataExtractor to obtain metadata from a raw media asset. This topc walks you through on how to obtain the metadata of an audio asset. The process of obtaining the metadata of a video asset is similar. The only difference is that the process of obtaining the album cover is not required for a video asset, because no album cover is available in the video asset. +You can use the AVMetadataExtractor to obtain metadata from a raw media asset. This topic walks you through on how to obtain the metadata of an audio asset. The process of obtaining the metadata of a video asset is similar. The only difference is that the process of obtaining the album cover is not required for a video asset, because no album cover is available in the video asset. The full process of obtaining the metadata of an audio asset includes creating an AVMetadataExtractor instance, setting resources, obtaining the metadata, obtaining the album cover, and releasing the instance. diff --git a/en/application-dev/media/medialibrary/photoAccessHelper-movingphoto.md b/en/application-dev/media/medialibrary/photoAccessHelper-movingphoto.md index 7c2df11a627a..1242114fd3db 100644 --- a/en/application-dev/media/medialibrary/photoAccessHelper-movingphoto.md +++ b/en/application-dev/media/medialibrary/photoAccessHelper-movingphoto.md @@ -4,14 +4,14 @@ A moving photo is a photo form that combines an image and a video, empowering a The media library provides the capabilities of accessing and managing moving photo assets, including: -- [Saves Moving Photo Assets using SaveButton](#saves-moving-photo-assets) +- [Saving Moving Photo Assets](#saving-moving-photo-assets) - [Obtaining a Moving Photo Object](#obtaining-a-moving-photo-object) - [Playing Moving Photos with MovingPhotoView](movingphotoview-guidelines.md) - [Reading Moving Photo Assets](#reading-moving-photo-assets) Camera Kit provides the capability of taking moving photos. For details, see [Moving Photos](../camera/camera-moving-photo.md). -## Saves Moving Photo Assets +## Saving Moving Photo Assets Use the **SaveButton** security component to save the assets (image and video) of a moving photo. diff --git a/en/application-dev/media/medialibrary/photoAccessHelper-savebutton.md b/en/application-dev/media/medialibrary/photoAccessHelper-savebutton.md index bdfc36aabc3d..559232a15f5c 100644 --- a/en/application-dev/media/medialibrary/photoAccessHelper-savebutton.md +++ b/en/application-dev/media/medialibrary/photoAccessHelper-savebutton.md @@ -47,7 +47,7 @@ struct Index { For details about the **SaveButton** component, see [SaveButton](../../reference/apis-arkui/arkui-ts/ts-security-components-savebutton.md). -This following walks you through on how to create an image using the **SaveButton** security component. +The following walks you through on how to create an image using the **SaveButton** security component. **How to Develop** @@ -101,7 +101,7 @@ In addition to specifying the asset in the application sandbox directory using * ## Saving a Media Asset Using an Authorization Pop-Up -This following walks you through on how to save an image using an authorization pop-up. +The following walks you through on how to save an image using an authorization pop-up. **How to Develop** diff --git a/en/application-dev/reference/apis-ability-kit/js-apis-app-ability-actionExtensionAbility.md b/en/application-dev/reference/apis-ability-kit/js-apis-app-ability-actionExtensionAbility.md index d49fbcfbc9fd..4425fb758bc3 100644 --- a/en/application-dev/reference/apis-ability-kit/js-apis-app-ability-actionExtensionAbility.md +++ b/en/application-dev/reference/apis-ability-kit/js-apis-app-ability-actionExtensionAbility.md @@ -157,7 +157,7 @@ To manually create an ActionExtensionAbility in the DevEco Studio project, perfo } } onForeground() { - console.info(TAG, `ononForeground`); + console.info(TAG, `onForeground`); } onBackground() { console.info(TAG, `onBackground`); diff --git a/en/application-dev/reference/apis-ability-kit/js-apis-app-ability-shareExtensionAbility.md b/en/application-dev/reference/apis-ability-kit/js-apis-app-ability-shareExtensionAbility.md index 39a64f78d953..b9f69c9200ce 100644 --- a/en/application-dev/reference/apis-ability-kit/js-apis-app-ability-shareExtensionAbility.md +++ b/en/application-dev/reference/apis-ability-kit/js-apis-app-ability-shareExtensionAbility.md @@ -156,7 +156,7 @@ To manually create a ShareExtensionAbility in the DevEco Studio project, perform } } onForeground() { - console.info(TAG, `ononForeground`); + console.info(TAG, `onForeground`); } onBackground() { console.info(TAG, `onBackground`); diff --git a/en/application-dev/reference/apis-ability-kit/js-apis-bundle-ShortcutInfo.md b/en/application-dev/reference/apis-ability-kit/js-apis-bundle-ShortcutInfo.md index 723864c50127..59b24c44c071 100644 --- a/en/application-dev/reference/apis-ability-kit/js-apis-bundle-ShortcutInfo.md +++ b/en/application-dev/reference/apis-ability-kit/js-apis-bundle-ShortcutInfo.md @@ -27,4 +27,4 @@ The APIs of this module are deprecated since API version 9. The substitute APIs | wants | Array<[ShortcutWant](js-apis-bundle-ShortcutInfo-sys.md#shortcutwantdeprecated)> | Yes | No | Want list for the shortcut. | | isStatic | boolean | Yes | No | Whether the shortcut is static. The value **true** means that the shortcut is static, and **false** means the opposite. | | isHomeShortcut | boolean | Yes | No | Whether the shortcut is a home shortcut. The value **true** means that the shortcut is a home shortcut, and **false** means the opposite.| -| isEnabled | boolean | Yes | No | Whether the shortcut is enabled. The value **true** means that the shortcut is enabled., and **false** means the opposite. | +| isEnabled | boolean | Yes | No | Whether the shortcut is enabled. The value **true** means that the shortcut is enabled, and **false** means the opposite. | diff --git a/en/application-dev/reference/apis-ability-kit/js-apis-inner-application-context.md b/en/application-dev/reference/apis-ability-kit/js-apis-inner-application-context.md index e7c2edaa4a7a..7ebf2ac879a0 100644 --- a/en/application-dev/reference/apis-ability-kit/js-apis-inner-application-context.md +++ b/en/application-dev/reference/apis-ability-kit/js-apis-inner-application-context.md @@ -1,6 +1,6 @@ # Context -The Context module, inherited frome [BaseContext](js-apis-inner-application-baseContext.md), provides context for abilities or applications, including access to application-specific resources. +The Context module, inherited from [BaseContext](js-apis-inner-application-baseContext.md), provides context for abilities or applications, including access to application-specific resources. > **NOTE** > diff --git a/en/application-dev/reference/apis-arkgraphics2d/drawing__shadow__layer_8h.md b/en/application-dev/reference/apis-arkgraphics2d/drawing__shadow__layer_8h.md index f5b907dbf6d2..52ac928c42c2 100644 --- a/en/application-dev/reference/apis-arkgraphics2d/drawing__shadow__layer_8h.md +++ b/en/application-dev/reference/apis-arkgraphics2d/drawing__shadow__layer_8h.md @@ -3,7 +3,7 @@ ## Overview -The **, which is an enumerated value of** file declares the functions related to the shadow in the drawing module. +The **drawing_shadow_layer.h** file declares the functions related to the shadow in the drawing module. **File to include**: <native_drawing/drawing_shadow_layer.h> diff --git a/en/application-dev/reference/apis-audio-kit/native__audio__session__manager_8h.md b/en/application-dev/reference/apis-audio-kit/native__audio__session__manager_8h.md index e86c7d8b8ba6..94c42513e9f8 100644 --- a/en/application-dev/reference/apis-audio-kit/native__audio__session__manager_8h.md +++ b/en/application-dev/reference/apis-audio-kit/native__audio__session__manager_8h.md @@ -5,7 +5,7 @@ The **native_audio_session_manager.h** file declares the functions related to an audio session manager. -You can call the functions to create an audio session manager, activates or deactivates an audio session, checks whether an audio session is activated, and listens for audio session deactivation events. +You can call the functions to create an audio session manager, activate or deactivate an audio session, check whether an audio session is activated, and listen for audio session deactivation events. **Library**: libohaudio.so -- Gitee