README.md · Kirk/MiniCanvas

# MiniCanvas

#### 介绍

基于OpenHarmony的Cavas组件封装了一版极简操作的MiniCanvas，屏蔽了原有Canvas内部复杂的调用流程，支持一个API就可以实现相应的绘制能力，该库还在继续完善中，也欢迎PR。

#### 使用说明

1. **添加MiniCanvas依赖**

在项目`entry`目录执行如下命令安装`MiniCanvas`库：

```typescript
   npm install git+https://gitee.com/ark-ui/MiniCanvas.git
   ```

2. **引入MiniCanvas**

```typescript
   import { MiniCanvas, Paint, ICanvas } from '@ohos/mini_canvas'
   ```

3. **使用MiniCanvas**

```typescript
   @Entry @Component struct TestMiniCanvas {
     build() {
       Column() {
         MiniCanvas({
           onDraw: (canvas) => {
             
           }
         })
       }
       .size({width: "100%", height: "100%"})
     }
   }
   ```

4. **MiniCanvas绘制**

```typescript
   // import { MiniCanvas, Paint, ICanvas } from '@ohos/mini_canvas'
   // 源码方式引入
   import { MiniCanvas, Paint } from "./mini_canvas"
   
   @Entry @Component struct TestMiniCanvas {
     build() {
       Column() {
         MiniCanvas({
           // 在onDraw()方法内执行绘制
           onDraw: (canvas) => {
             // 创建画笔
             let paint = new Paint()
   
             // 绘制直线
             paint.setColor("#FF0000");
             paint.setStrokeWidth(5);
             canvas.drawLine(10, 10, 280, 10, paint);
   
             // 绘制圆以及圆环
             canvas.drawCircle(50, 50, 25, paint);
             paint.setStroke(true);
             paint.setStrokeWidth(3);
             canvas.drawCircle(250, 50, 25, paint);
   
             // 绘制椭圆以及椭圆环
             paint.setStroke(false);
             canvas.drawOval(20, 100, 150, 50, paint)
             paint.setStroke(true);
             paint.setColor(Color.Pink.toString())
             canvas.drawOval(190, 100, 150, 50, paint)
   
             // 绘制矩形
             paint.setStroke(false)
             canvas.drawRect(20, 180, 150, 50, paint)
             paint.setStroke(true)
             paint.setStrokeWidth(5)
             canvas.drawRect(190, 180, 150, 50, paint)
   
             // 绘制圆角矩形
             paint.setStroke(false);
             canvas.drawRoundRect(20, 250, 150, 50, 10, paint)
             paint.setStroke(true);
             canvas.drawRoundRect(190, 250, 150, 50, 10, paint)
   
   
             // 绘制圆弧
             canvas.drawArc(80, 330, 40, 0, 135, paint);
             paint.setStroke(false);
             canvas.drawArc(250, 330, 40, 0, 135, paint);
   
             // 绘制图片
             let bitmap = new ImageBitmap("pages/test.jpg")
             canvas.drawImage(bitmap, 10, 10, 800, 600, 20, 400, 320, 160, paint)
           },
           // 设置画布的属性
           attribute: {
             id: "mini_canvas",
             width: "100%",
             height: "100%",
             background: "#ffffff",
             clickListener: (event) => {
               console.log("onClicked: " + JSON.stringify(event));
             },
             touchListener: (event) => {
               console.log("onTouched: " + JSON.stringify(event));
             }
           },
         })
       }
       .size({width: "100%", height: "100%"})
     }
   }
   ```

5. **运行结果**

#### 参与贡献

1.  Fork 本仓库
2.  新建 xxx 分支
3.  提交代码
4.  新建 Pull Request

Kirk/MiniCanvas

简介

发行版

贡献者

近期动态

Kirk/MiniCanvas .gitee-modal { width: 500px !important; }

简介

发行版

贡献者

近期动态

搜索帮助

Kirk/MiniCanvas