Merge branch 'master' of https://gitee.com/openharmony/docs

zh-cn/application-dev/application-models/accessibilityextensionability.md

@@ -10,15 +10,6 @@ AccessibilityExtensionAbility基于ExtensionAbility框架，提供无障碍扩
 >
 > Model: Stage
 
-本文档将从以下场景来介绍AccessibilityExtensionAbility的基本开发：
-
-- [AccessibilityExtensionAbility概述](#accessibilityextensionability概述)
-- [如何创建一个无障碍扩展服务](#如何创建一个无障碍扩展服务)
-- [如何处理一个无障碍事件](#如何处理一个无障碍事件)
-- [如何声明无障碍扩展服务具备的能力](#如何声明无障碍扩展服务具备的能力)
-- [如何开启自定义的无障碍扩展服务](#如何开启自定义的无障碍扩展服务)
-- [相关示例](#相关示例)
-
 ## AccessibilityExtensionAbility概述
 
 “信息无障碍”译自“Accessibility”，是指任何人在任何情况下都能平等、方便地获取信息并利用信息。其目的是缩小全社会不同阶层、不同地区、不同年龄、不同健康状况的人群在信息理解、信息交互、信息利用方面的数字鸿沟，使其更加方便地参与社会生活，享受数字发展带来的便利。
@@ -133,9 +124,9 @@ onAccessibilityEvent(accessibilityEvent) {
 
 若开启或关闭成功，则会打印`enable ability successfully`或`disable ability successfully`。
 
-## 相关示例
+## 相关实例
 
-针对AccessibilityExtensionAbility开发，有以下相关示例可供参考：
+针对AccessibilityExtensionAbility开发，有以下相关实例可供参考：
 
 [AccessibilityExtAbility的创建和使用（ArkTS）（API 9）（Full SDK）](https://gitee.com/openharmony/applications_app_samples/tree/master/code/SystemFeature/ApplicationModels/AccessibilityExtAbility)
 

zh-cn/application-dev/application-models/serviceextensionability.md

@@ -449,9 +449,9 @@ ServiceExtensionAbility服务组件在[onConnect()](../reference/apis/js-apis-ap
   }
   ```
 
-## 相关示例
+## 相关实例
 
-针对ServiceExtensionAbility开发，有以下相关示例可供参考：
+针对ServiceExtensionAbility开发，有以下相关实例可供参考：
 
 - [`AbilityConnectServiceExtension`：Ability与ServiceExtensionAbility通信（ArkTS）（API9）（Full SDK）](https://gitee.com/openharmony/applications_app_samples/tree/master/code/BasicFeature/IDL/AbilityConnectServiceExtension)
 - [`StageModel`：Stage模型（ArkTS）（API9）（Full SDK）](https://gitee.com/openharmony/applications_app_samples/tree/master/code/BasicFeature/ApplicationModels/StageModel)

zh-cn/application-dev/media/Readme-CN.md

@@ -54,7 +54,8 @@
   - [图片开发概述](image-overview.md)
   - [图片解码](image-decoding.md)
   - 图片处理
-    - [图像变换](image-transformation.md)
+    - [图像变换(ArkTS)](image-transformation.md)
+    - [图像变换(Native)](image-transformation-native.md)
     - [位图操作](image-pixelmap-operation.md)
   - [图片编码](image-encoding.md)
   - [图片工具](image-tool.md)

zh-cn/application-dev/media/image-transformation-native.md

+# 图像变换(Native)
+
+开发者可以通过本指导了解如何使用Native Image进行图片处理，包括图片的裁剪、旋转、缩放、翻转、偏移、设置透明度等。
+
+## 开发步骤
+
+
+**添加依赖**
+
+在进行应用开发之前，开发者需要打开native工程的src/main/cpp/CMakeLists.txt，在target_link_libraries依赖中添加image的libpixelmap_ndk.z.so以及日志依赖libhilog_ndk.z.so。
+
+    ```txt
+    target_link_libraries(entry PUBLIC libace_napi.z.so libhilog_ndk.z.so libpixelmap_ndk.z.so)
+    ```
+
+**添加接口映射**
+
+打开src/main/cpp/hello.cpp文件，在Init函数中添加接口映射如下：
+
+    ```c++
+    EXTERN_C_START
+    static napi_value Init(napi_env env, napi_value exports)
+    {
+        napi_property_descriptor desc[] = {
+            { "createPixelMap", nullptr, CreatePixelMap, nullptr, nullptr, nullptr, napi_default, nullptr },
+            { "createAlphaPixelMap", nullptr, CreateAlphaPixelMap, nullptr, nullptr, nullptr, napi_default, nullptr },
+            { "transform", nullptr, Transform, nullptr, nullptr, nullptr, napi_default, nullptr }
+        };
+
+        napi_define_properties(env, exports, sizeof(desc) / sizeof(desc[0]), desc);
+        return exports;
+    }
+    EXTERN_C_END
+    ```
+
+
+**Native接口调用**
+
+具体接口说明请参考[API文档](../reference/native-apis/image.md)
+
+在hello.cpp文件中获取JS的资源对象，并转为Native的资源对象，即可调用Native接口，调用方式示例代码如下：
+    
+1. 根据像素数组创建PixelMap对象。
+
+    ```c++
+    //创建PixelMap对象
+    napi_value CreatePixelMap(napi_env env, napi_callback_info info)
+    {
+        napi_value udfVar = nullptr;
+        napi_value thisVar = nullptr;
+        napi_value argValue[2] = {0};
+        size_t argCount = 2;
+
+        void* buffer = nullptr;
+        size_t bufferSize = 0;
+        struct OhosPixelMapCreateOps createOps;
+        napi_value pixelmap = nullptr;
+
+        napi_get_undefined(env, &udfVar);
+        napi_get_cb_info(env, info, &argCount, argValue, &thisVar, nullptr);
+        if (napi_get_arraybuffer_info(env, argValue[0], &buffer, &bufferSize) != napi_ok ||
+            buffer == nullptr || bufferSize == 0) {
+            return udfVar;
+        }
+
+        createOps.width = 4;
+        createOps.height = 6;
+        createOps.pixelFormat = 4;
+        createOps.alphaType = 0;
+        int32_t res = OH_PixelMap_CreatePixelMap(env, createOps, (uint8_t *)buffer, bufferSize, &pixelmap);
+        if (res != OHOS_IMAGE_RESULT_SUCCESS || pixelmap == nullptr) {
+            return udfVar;
+        }
+        return pixelmap;
+    }
+
+    //创建仅含有alpha通道的PixelMap对象
+    napi_value CreateAlphaPixelMap(napi_env env, napi_callback_info info)
+    {
+        napi_value udfVar = nullptr;
+        napi_value thisVar = nullptr;
+        napi_value argValue[1] = {0};
+        size_t argCount = 1;
+
+        napi_value alphaPixelmap = nullptr;
+
+        napi_get_undefined(env, &udfVar);
+
+        if (napi_get_cb_info(env, info, &argCount, argValue, &thisVar, nullptr) != napi_ok ||
+            argCount < 1 || argValue[0] == nullptr) {
+            return udfVar;
+        }
+        int32_t res = OH_PixelMap_CreateAlphaPixelMap(env, argValue[0], &alphaPixelmap);
+        if (res != OHOS_IMAGE_RESULT_SUCCESS || alphaPixelmap == nullptr) {
+            return udfVar;
+        }
+        return alphaPixelmap;
+    }
+    ```
+
+2. 图像变换。具体操作参考示例代码注释。
+
+    ```c++
+    napi_value Transform(napi_env env, napi_callback_info info)
+    {
+        napi_value thisVar = nullptr;
+        napi_value argValue[1] = {0};
+        size_t argCount = 1;
+
+        if (napi_get_cb_info(env, info, &argCount, argValue, &thisVar, nullptr) != napi_ok ||
+            argCount < 1 || argValue[0] == nullptr) {
+            return nullptr;
+        }
+        napi_value result = nullptr;
+        napi_get_undefined(env, &result);
+
+        NativePixelMap* native = OH_PixelMap_InitNativePixelMap(env, argValue[0]);
+        if (native == nullptr) {
+            return result;
+        }
+
+        //获取图片信息。
+        struct OhosPixelMapInfo pixelmapInfo;
+        OH_PixelMap_GetImageInfo(native, &pixelmapInfo);
+
+        //获取PixelMap对象每行字节数。
+        int32_t rowBytes;
+        OH_PixelMap_GetBytesNumberPerRow(native, &rowBytes);
+
+        //获取PixelMap对象是否可编辑的状态。
+        int32_t editable = 0;
+        OH_PixelMap_GetIsEditable(native, &editable);
+
+        //获取PixelMap对象是否支持Alpha通道。
+        int32_t supportAlpha = 0;
+        OH_PixelMap_IsSupportAlpha(native, &supportAlpha);
+
+        //设置PixelMap对象的Alpha通道。
+        int32_t alphaAble = 0;
+        OH_PixelMap_SetAlphaAble(native, alphaAble);
+
+        //获取PixelMap对象像素密度。
+        int32_t densityG;
+        OH_PixelMap_GetDensity(native, &densityG);
+
+        //设置PixelMap对象像素密度。
+        int32_t densityS = 100;
+        OH_PixelMap_SetDensity(native, densityS);
+
+        //设置PixelMap对象的透明度。
+        float opacity = 0.5;
+        OH_PixelMap_SetOpacity(native, opacity);
+
+        //设置缩放比例。
+        //scaleX：宽为原来的0.5。
+        //scaleY：高为原来的0.5。
+        float scaleX = 0.5;
+        float scaleY = 0.5;
+        OH_PixelMap_Scale(native, scaleX, scaleY);
+
+        //设置偏移。
+        //translateX：向下偏移50。
+        //translateY：向右偏移50。
+        float translateX = 50;
+        float translateY = 50;
+        OH_PixelMap_Translate(native, translateX, translateY);
+
+        //设置顺时针旋转90度。
+        float angle = 90;
+        OH_PixelMap_Rotate(native, angle);
+
+        //设置翻转
+        //flipX：水平翻转。0为不翻转，1为翻转。
+        //flipY：垂直翻转。0为不翻转，1为翻转。
+        int32_t flipX = 0;
+        int32_t flipY = 1;
+        OH_PixelMap_Flip(native, flipX, flipY);
+
+        //设置裁剪区域。
+        // cropX：裁剪起始点横坐标0
+        // cropY：裁剪起始点纵坐标0
+        // cropH：裁剪高度10，方向为从上往下（裁剪后的图片高度为10）
+        // cropW：裁剪宽度10，方向为从左到右（裁剪后的图片宽度为10
+        int32_t cropX = 1;
+        int32_t cropY = 1;
+        int32_t cropW = 10;
+        int32_t cropH = 10;
+        OH_PixelMap_Crop(native, cropX, cropY, cropW, cropH);
+
+        uint8_t* pixelAddr = nullptr;
+        //获取PixelMap对象数据的内存地址，并锁定该内存。
+        OH_PixelMap_AccessPixels(native, &pixelAddr);
+        //释放PixelMap对象数据的内存锁。
+        OH_PixelMap_UnAccessPixels(native);
+
+        return result;
+    }
+    ```
+
+**JS侧调用**
+
+1. 打开src\main\ets\pages\index.ets, 导入"libentry.so";
+    
+2. 调用Native接口，传入JS的资源对象。示例如下:
+
+    ```js
+    import testNapi from 'libentry.so'
+    import image from '@ohos.multimedia.image'
+
+    @Entry
+    @Component
+    struct Index {
+        @State _pixelMap: image.PixelMap = undefined;
+        build() {
+            Row() {
+            Column() {
+                Button("PixelMap")
+                .width(100)
+                .height(100)
+                .onClick(() => {
+                    const color = new ArrayBuffer(96);
+                    var bufferArr = new Uint8Array(color);
+                    for (var i = 0; i < bufferArr.length; i++) {
+                        bufferArr[i] = 0x80;
+                    }
+
+                    this._pixelMap = testNapi.createPixelMap(color);
+                    testNapi.transform(this._pixelMap);
+                })
+
+                Image(this._pixelMap)
+                .width(500)
+                .height(500)
+                .objectFit(ImageFit.Cover)
+            }
+            .width('100%')
+            }
+            .height('100%')
+        }
+    }
+    ```
\ No newline at end of file

zh-cn/application-dev/media/image-transformation.md

-# 图像变换
+# 图像变换(ArkTS)
 
 图片处理指对PixelMap进行相关的操作，如获取图片信息、裁剪、缩放、偏移、旋转、翻转、设置透明度、读写像素数据等。图片处理主要包括图像变换、[位图操作](image-pixelmap-operation.md)，本文介绍图像变换。
 

zh-cn/application-dev/reference/apis/js-apis-abilityAccessCtrl.md

@@ -197,7 +197,7 @@ grantUserGrantedPermission(tokenID: number, permissionName: Permissions, permiss
 | tokenID      | number              | 是   | 目标应用的身份标识。可通过应用的[ApplicationInfo](js-apis-bundleManager-applicationInfo.md)获得。|
 | permissionName | Permissions              | 是   | 被授予的权限名称，合法的权限名取值可在[系统权限定义列表](../../security/permission-list.md)中查询。 |
 | permissionFlags  | number | 是   | 授权选项<br>- 0表示权限未经过用户主动设置。<br>- 1表示当次用户若选择禁止该权限，下次权限弹窗仍可以弹出申请用户授权。<br>- 2表示当次用户若选择禁止该权限，下次不会再弹出权限弹窗，需要用户在setting的权限管理中进行授权。<br>- 4表示当次权限设置为系统授权，用户不可更改这个权限授权状态。 |
-| callback | AsyncCallback&lt;void&gt; | 是 | 授予应用user grant权限。当授予权限成功时，err为undefine；否则为错误对象。 |
+| callback | AsyncCallback&lt;void&gt; | 是 | 授予应用user grant权限。当授予权限成功时，err为undefined；否则为错误对象。 |
 
 **错误码：**
 
@@ -308,7 +308,7 @@ revokeUserGrantedPermission(tokenID: number, permissionName: Permissions, permis
 | tokenID      | number              | 是   | 目标应用的身份标识。可通过应用的[ApplicationInfo](js-apis-bundleManager-applicationInfo.md)获得。           |
 | permissionName | Permissions              | 是   | 被撤销的权限名称，合法的权限名取值可在[系统权限定义列表](../../security/permission-list.md)中查询。 |
 | permissionFlags  | number | 是   | 授权选项<br>- 0表示权限未经过用户主动设置。<br>- 1表示当次用户若选择禁止该权限，下次权限弹窗仍可以弹出申请用户授权。<br>- 2表示当次用户若选择禁止该权限，下次不会再弹出权限弹窗，需要用户在setting的权限管理中进行授权。<br>- 4表示当次权限设置为系统授权，用户不可更改这个权限授权状态。 |
-| callback | AsyncCallback&lt;void&gt; | 是 | 撤销应用user grant权限。当撤销权限成功时，err为undefine；否则为错误对象。 |
+| callback | AsyncCallback&lt;void&gt; | 是 | 撤销应用user grant权限。当撤销权限成功时，err为undefined；否则为错误对象。 |
 
 **错误码：**
 

zh-cn/application-dev/reference/apis/js-apis-privacyManager.md

@@ -87,7 +87,7 @@ addPermissionUsedRecord(tokenID: number, permissionName: Permissions, successCou
 | permissionName | Permissions | 是   | 应用权限名称。 |
 | successCount | number | 是   | 访问成功的次数。 |
 | failCount | number | 是   | 访问失败的次数。 |
-| callback | AsyncCallback<void> | 是   | 回调函数。当添加使用记录成功时，err为undefine；否则为错误对象。 |
+| callback | AsyncCallback<void> | 是   | 回调函数。当添加使用记录成功时，err为undefined；否则为错误对象。 |
 
 **错误码：**
 
@@ -195,7 +195,7 @@ getPermissionUsedRecord(request: PermissionUsedRequest, callback: AsyncCallback&
 | 参数名   | 类型                 | 必填 | 说明                                       |
 | -------- | -------------------  | ---- | ------------------------------------------ |
 | request | [PermissionUsedRequest](#permissionusedrequest) | 是 | 查询权限使用记录的请求。 |
-| callback | AsyncCallback<[PermissionUsedResponse](#permissionusedresponse)> | 是 | 回调函数。当查询记录成功时，err为undefine，data为查询到的权限使用记录；否则为错误对象。 |
+| callback | AsyncCallback<[PermissionUsedResponse](#permissionusedresponse)> | 是 | 回调函数。当查询记录成功时，err为undefined，data为查询到的权限使用记录；否则为错误对象。 |
 
 **错误码：**
 
@@ -306,7 +306,7 @@ startUsingPermission(tokenID: number, permissionName: Permissions, callback: Asy
 | -------------- | --------------------- | ---- | ------------------------------------ |
 | tokenID        | number                | 是   | 调用方的应用身份标识。可通过应用的[ApplicationInfo](js-apis-bundle-ApplicationInfo.md)获得。 |
 | permissionName | Permissions                | 是   | 需要使用的权限名。                     |
-| callback       | AsyncCallback&lt;void&gt; | 是   | 回调函数。当开始使用权限成功时，err为undefine；否则为错误对象。 |
+| callback       | AsyncCallback&lt;void&gt; | 是   | 回调函数。当开始使用权限成功时，err为undefined；否则为错误对象。 |
 
 **错误码：**
 
@@ -409,7 +409,7 @@ stopUsingPermission(tokenID: number, permissionName: Permissions, callback: Asyn
 | -------------- | --------------------- | ---- | ------------------------------------ |
 | tokenID        | number                | 是   | 调用方的应用身份标识。可通过应用的[ApplicationInfo](js-apis-bundle-ApplicationInfo.md)获得。 |
 | permissionName | Permissions                | 是   | 需要使用的权限名。                      |
-| callback       | AsyncCallback&lt;void&gt; | 是   | 回调函数。当停止使用权限成功时，err为undefine；否则为错误对象。 |
+| callback       | AsyncCallback&lt;void&gt; | 是   | 回调函数。当停止使用权限成功时，err为undefined；否则为错误对象。 |
 
 **错误码：**