# ink-ohos

**Repository Path**: chinasoft5_ohos/ink-ohos

## Basic Information

- **Project Name**: ink-ohos
- **Description**: ink-ohos是一个获取签名或绘图的功能库
- **Primary Language**: Java
- **License**: Apache-2.0
- **Default Branch**: master
- **Homepage**: None
- **GVP Project**: No

## Statistics

- **Stars**: 1
- **Forks**: 0
- **Created**: 2021-06-10
- **Last Updated**: 2022-09-06

## Categories & Tags

**Categories**: harmonyos-draw

**Tags**: None

## README

# ink-ohos

#### 项目介绍
- 项目名称：ink-ohos
- 所属系列：openharmony的第三方组件适配移植
- 功能：ink-ohos是一个获取签名或绘图的功能库
- 项目移植状态：主功能完成
- 调用差异：无
- 开发版本：sdk6，DevEco Studio2.2 Beta1
- 基线版本：Release 1.0.2

#### 效果演示
![效果演示](./art/sample.gif)

#### 安装教程

1.在项目根目录下的build.gradle文件中，
 ```
allprojects {
    repositories {
        maven {
            url 'https://s01.oss.sonatype.org/content/repositories/releases/'
        }
    }
}
 ```

2.在entry模块的build.gradle文件中，

 ```
 dependencies {
    implementation('com.gitee.chinasoft_ohos:ink-ohos:1.0.0')
    ......  
 }
 ```
在sdk6，DevEco Studio2.2 Beta1下项目可直接运行
如无法运行，删除项目.gradle,.idea,build,gradle,build.gradle文件，
并依据自己的版本创建新项目，将新项目的对应文件复制到根目录下

#### 使用说明

要使用库，必须在项目中包含InkView类。一个简单的解决方案是将其直接引用到布局中
```xml
<com.simplify.ink.InkView
    ohos:id="$+id:ink"
    ohos:height="match_parent"
    ohos:width="match_parent"/>
```

然后，在代码中获取控件并对其进行初始化：
```
InkView ink = (InkView) findComponentById(ResourceTable.Id_ink);
ink.setColor(Color.getIntColor("#000000"));
ink.setMinStrokeWidth(1.5f);
ink.setMaxStrokeWidth(6f);
```

可以使用xml文件的自定义属性来打开和关闭功能：
```
// 将下面这行代码添加到根布局中的元素中
xmlns:app="http://schemas.huawei.com/res/ohos-auto"

<com.simplify.ink.InkView
    ohos:id="$+id:ink"
    ohos:height="match_parent"
    ohos:width="match_parent"
    app:ink_flags="interpolation|responsive_weight"/>
```

或者在代码中手动设置标志：
```
InkView ink = (InkView) findComponentById(ResourceTable.Id_ink);
ink.setFlags(InkView.FLAG_INTERPOLATION | InkView.FLAG_RESPONSIVE_WEIGHT);
```

默认情况下，interpolation 和responsive_weight 标志处于启用状态。

可以通过以下方法以pixelMap的形式获取图形：
```
PixelMap drawing = ink.getBitmap();
```
也可以包括背景色：
```
PixelMap drawing = ink.getBitmap(Color.getIntColor("#F44336"));
```

#### 测试信息

CodeCheck代码测试无异常

CloudTest代码测试无异常

病毒安全检测通过

当前版本demo功能与原组件基本无差异

#### 版本迭代
- 1.0.0
- 0.0.1-SNAPSHOT

#### 版权和许可信息
 Apache License 2.0