vue + canvas 实现涂鸦面板

  • vue + canvas 实现涂鸦面板已关闭评论
  • 69 次浏览
  • A+
所属分类:Web前端
摘要

专栏分享:vue2源码专栏,vue router源码专栏,玩具项目专栏,硬核 ? 推荐 ?
欢迎各位 ITer 关注点赞收藏 ???


前言

专栏分享:vue2源码专栏vue router源码专栏玩具项目专栏,硬核 ? 推荐 ?
欢迎各位 ITer 关注点赞收藏 ???

此篇文章用于记录柏成从零开发一个canvas涂鸦面板的历程,最终效果如下:

vue + canvas 实现涂鸦面板

介绍

我们基于 canvas 实现了一款简单的涂鸦面板,用于在网页上进行绘图和创作。其支持以下快捷键:

功能 快捷键
撤销 Ctrl + Z
恢复 Ctrl + Y

我们可以通过 new Board 创建一个空白画板,其接收一个容器作为参数,下面是个基本例子:

<template>   <div class="drawing-board">     <div id="container" ref="container" style="width: 100%; height: 100%"></div>   </div> </template>  <script setup>   import { ref, onMounted } from 'vue'   import Board from '@/canvas/board.js'    const container = ref(null)   onMounted(() => {     // 创建一个空白画板     new Board(container.value)   }) </script> 

初始化

Board 的实现是一个类,在 src/canvas/board.js中定义

new Board(container)时做了什么?我们在构造函数中创建一个 canvas 画布追加到了 container 容器中,并定义了一系列属性,最后执行了 init 初始化方法

在初始化方法中,我们设置了画笔样式(其实可以动态去设置,让用户选择画笔颜色、粗细、线条样式等,时间有限,未实现此功能);注册监听了鼠标键盘事件,用于绘制画笔轨迹和实现撤销恢复快捷键操作

export default class BoardCanvas {   constructor(container) {     // 容器     this.container = container     // canvas画布     this.canvas = this.createCanvas(container)     // 绘制工具     this.ctx = this.canvas.getContext('2d')     // 起始点位置     this.startX = 0     this.stateY = 0     // 画布历史栈     this.pathSegmentHistory = []     this.index = 0      // 初始化     this.init()   }   // 创建画布   createCanvas(container) {     const canvas = document.createElement('canvas')     canvas.width = container.clientWidth     canvas.height = container.clientHeight     canvas.style.display = 'block'     canvas.style.backgroundColor = 'antiquewhite'     container.appendChild(canvas)     return canvas   }    // 初始化   init() {     this.addPathSegment()     this.setContext2DStyle()     // 阻止默认右击事件     this.canvas.addEventListener('contextmenu', (e) => e.preventDefault())     // 自定义鼠标按下事件     this.canvas.addEventListener('mousedown', this.mousedownEvent.bind(this))     // 自定义键盘按下事件     window.document.addEventListener('keydown', this.keydownEvent.bind(this))   }    // 设置画笔样式   setContext2DStyle() {     this.ctx.strokeStyle = '#EB7347'     this.ctx.lineWidth = 3     this.ctx.lineCap = 'round'     this.ctx.lineJoin = 'round'   } } 

自定义鼠标事件

我们之前在 init 初始化方法中注册了 onmousedown 鼠标按下事件,需要在此处实现鼠标按下拖拽可以绘制画笔轨迹的逻辑

mousedownEvent(e) {   const that = this   const ctx = this.ctx   ctx.beginPath()   ctx.moveTo(e.offsetX, e.offsetY)   ctx.stroke()    this.canvas.onmousemove = function (e) {     ctx.lineTo(e.offsetX, e.offsetY)     ctx.stroke()   }      this.canvas.onmouseup = this.canvas.onmouseout = function () {     that.addPathSegment()     this.onmousemove = null     this.onmouseup = null     this.onmouseout = null   } } 

自定义键盘事件

我们之前在 init 初始化方法中注册了 onkeydown 键盘按下事件,需要在此处实现撤销恢复的逻辑

// 键盘事件 keydownEvent(e) {   if (!e.ctrlKey) return   switch (e.keyCode) {     case 90:       this.undo()       break     case 89:       this.redo()       break   } } 

要实现撤销恢复操作,我们需要一个存储画布快照的栈!这又涉及到两个问题,我们如何获取到当前画布快照?如何根据快照数据恢复画布?

查阅 canvas官方API文档 得知,获取快照 API 为 getImageData;通过快照恢复画布的 API 为 putImageData

/*  * @name 返回一个 ImageData 对象,其中包含 Canvas 画布部分或完整的像素点信息  * @param { Number } sx 将要被提取的图像数据矩形区域的左上角 x 坐标  * @param { Number } sy 将要被提取的图像数据矩形区域的左上角 y 坐标  * @param { Number } sWidth  将要被提取的图像数据矩形区域的宽度  * @param { Number } sHeight 将要被提取的图像数据矩形区域的高度  * @return { Object } 返回一个 ImageData 对象,包含 Canvas 给定的矩形图像像素点信息  */ context.getImageData(sx, sy, sWidth, sHeight);    /*  * @name 将给定 ImageData 对象的数据绘制到位图上  * @param { Object } ImageData 对象,包含 Canvas 给定的矩形图像像素点信息  * @param { Number } dx 目标 Canvas 中被图像数据替换的起点横坐标  * @param { Number } dy 目标 Canvas 中被图像数据替换的起点纵坐标  */  context.putImageData(ImageData, dx, dy); 

我们对保存画布快照的逻辑进行了一次封装,如下:

// 添加路径片段 addPathSegment() {   const data = this.ctx.getImageData(0, 0, this.canvas.width, this.canvas.height)      // 删除当前索引后的路径片段,然后追加一个新的路径片段,更新索引   this.pathSegmentHistory.splice(this.index + 1)   this.pathSegmentHistory.push(data)   this.index = this.pathSegmentHistory.length - 1 } 

我们在构造函数中定义了一个存储画布快照的栈 - pathSegmentHistory;一个指向栈中当前快照的索引 - index

在初始化和绘制一个路径片段结束时都会调用 addPathSegment 方法,用于保存当前画布快照到栈中,并将索引指向栈中的最后一个成员

Tip:在保存快照数据之前,我们会先删除栈中位于索引之后的全部快照数据,目的是执行撤销操作后再绘制轨迹,要清空栈中的多余数据。举个栗子,如果我们先执行3次undo,再执行一次redo,最后绘制一条新的轨迹,则需要先清除栈中的最后两条快照数据,再添加一条新的当前画布快照数据,示意图如下

vue + canvas 实现涂鸦面板

撤销(undo)

当执行 undo 操作时,我们先将索引前移, 然后取出当前索引指向的快照数据,重新绘制画布

// 撤销 undo() {   if (this.index <= 0) return   this.index--   this.ctx.putImageData(this.pathSegmentHistory[this.index], 0, 0) } 

vue + canvas 实现涂鸦面板

恢复(redo)

当执行 redo 操作时,我们先将索引后移, 然后取出当前索引指向的快照数据,重新绘制画布

// 恢复 redo() {   if (this.index >= this.pathSegmentHistory.length - 1) return   this.index++   this.ctx.putImageData(this.pathSegmentHistory[this.index], 0, 0) }  

vue + canvas 实现涂鸦面板

源码

涂鸦面板demo代码:vue-canvas