本文简介
点赞 + 关注 + 收藏 = 学会了
喷雾笔刷 SprayBrush 是 fabric.js 提供的一个很好玩的工具，而且 fabric.js 也封装好了很多非常方便的属性让我们配置，用起来非常简单的。
先看看效果：
常规配置
喷雾笔刷作为一款笔刷工具，要使用它首先要让画布开启“绘画模式”。
将 isDrawingMode 设为 true 就可以开启。
<canvas id="c" width="500" height="400" style="border: 1px solid #ccc;"></canvas>
<script>
// 初始化
const canvas = new fabric.Canvas('c', {
isDrawingMode: true
})
</script>
如果不在画布初始化时开启绘画模式，也可以之后再开启
canvas.isDrawingMode = true
如果想切换回普通模式，只需把 isDrawingMode 改回 false 即可。
注册喷雾笔刷
喷雾笔刷叫 SprayBrush。
注册喷雾笔刷时需要把初始化的画布传进去，然后再赋值给 canvas.freeDrawingBrush
// 省略部分代码
canvas.freeDrawingBrush = new fabric.SprayBrush(canvas)
// 更推荐的写法
let sprayBrush = new fabric.SprayBrush(canvas)
canvas.freeDrawingBrush = sprayBrush
我更推荐把 sprayBrush 保存到一个变量里，这样比较方便之后配置各种效果。
除了上面这种写法，也可以这样写：
// 省略部分代码
let sprayBrush = new fabric.SprayBrush()
sprayBrush.initialize(canvas)
canvas.freeDrawingBrush = sprayBrush
initialize() 是 SprayBrush 初始化的一个方法，里面接收的参数是当前的画布 canvas 。
设置笔刷粗细
为了方便其他属性演示，所以先把笔刷的宽度设置大点。
// 省略部分代码
sprayBrush.width = 200
width 属性就是用来设置画笔粗细的，数值越大画笔就越粗。
设置喷雾密度
可以使用 density 属性设置喷雾密度，数值越大密度就越大。
density 的默认值是 20。
// 省略部分代码
sprayBrush.width = 200
sprayBrush.density = 100 // 设置喷雾密度
将 density 设置得小点对比一下
sprayBrush.width = 200
sprayBrush.density = 10
很直观的看到差距了。
设置喷点大小
“喷点” 就是喷雾中的每一个点，设置喷点宽度的属性名叫 dotWidth 。
dotWidth 默认值是 1。数值越大，喷点就越大。
// 省略部分代码
sprayBrush.width = 200 // 设置喷雾宽度
sprayBrush.dotWidth = 10 // 设置喷点大小
设置喷点方差
可以使用 dotWidthVariance 属性设置喷点的方差。
dotWidthVariance 可以在规定范围内随机生成大小不一的喷点。
dotWidthVariance 的默认值是1。数值越大，喷点随机大小就越大。
// 省略部分代码
sprayBrush.width = 200
sprayBrush.dotWidthVariance = 10
设置了 dotWidthVariance 后，dotWidth 的意义就不大了。
防重叠
喷雾笔刷默认是会删除重叠的点，官方文档说这是处于性能考虑的原因。
如果不希望删除重叠的点，可以将 optimizeOverlapping 设为 false 。
// 省略部分代码
sprayBrush.optimizeOverlapping = false
设置喷点的随机不透明度
可以通过 randomOpacity 属性设置喷点的不透明度是否随机。
// 省略部分代码
sprayBrush.randomOpacity = true
设置喷雾阴影
在喷雾笔刷的文档里没提到阴影，但既然基础笔刷可以设置阴影，喷雾笔刷同样也可以设置阴影的。
// 省略部分代码
sprayBrush.width = 200
sprayBrush.dotWidthVariance = 10
// 设置阴影效果
sprayBrush.shadow = new fabric.Shadow({
blur: 10,
offsetX: 10,
offsetY: 10,
color: '#30e3ca'
})
设置喷雾颜色
喷雾笔刷可以通过 color 设置喷雾颜色的，但官方文档好像忘了写这个属性了。
// 省略部分代码
sprayBrush.color = 'pink'
事件
前面讲到 initialize() 方法可以初始化画笔，除此之外喷雾笔刷还有其他事件方法。
喷雾准备生成前和生成后
喷雾也是一种路径，所以可以监听 canvas 的路径生成时的周期。
在喷雾准备生成前，可以监听 before:path:created ；喷雾生成后，可以监听 path:created。
// 省略部分代码
// 准备生成前
canvas.on('before:path:created', opt => {
console.log(opt.path)
})
// 生成后
canvas.on('path:created', opt => {
console.log(opt.path)
})
鼠标按下时 onMouseDown
sprayBrush.onMouseDown = function(t) {
this.sprayChunks.length = 0,
this.canvas.clearContext(this.canvas.contextTop),
this._setShadow(),
this.addSprayChunk(t),
this.render(this.sprayChunkPoints)
}
鼠标移动时 onMouseMove
sprayBrush.onMouseMove = function(t) {
!0 === this.limitedToCanvasSize && this._isOutSideCanvas(t) || (this.addSprayChunk(t),
this.render(this.sprayChunkPoints))
}
松开鼠标时 onMouseUp
sprayBrush.onMouseUp = function() {
var t = this.canvas.renderOnAddRemove;
this.canvas.renderOnAddRemove = !1;
for (var e = [], i = 0, r = this.sprayChunks.length; i < r; i++)
for (var n = this.sprayChunks[i], s = 0, o = n.length; s < o; s++) {
var a = new fabric.Rect({
width: n[s].width,
height: n[s].width,
left: n[s].x + 1,
top: n[s].y + 1,
originX: "center",
originY: "center",
fill: this.color
});
e.push(a)
}
this.optimizeOverlapping && (e = this._getOptimizedRects(e));
var c = new fabric.Group(e);
this.shadow && c.set("shadow", new fabric.Shadow(this.shadow)),
this.canvas.fire("before:path:created", {
path: c
}),
this.canvas.add(c),
this.canvas.fire("path:created", {
path: c
}),
this.canvas.clearContext(this.canvas.contextTop),
this._resetShadow(),
this.canvas.renderOnAddRemove = t,
this.canvas.requestRenderAll()
}
注意上面的注释，找到 circle 那段就是本例的重点
以上就是喷雾的基础用法，如果都搞明白了，那就做2个案例练练手呗~
🔴 修改喷点图形
喷雾的生成其实关键是在 onMouseUp 事件。
我们看到官方的代码中，生成喷雾使用了 Reat 元素作为喷点
我有个大胆的想法，如果把 Rect 改成其他元素是否可以生成其他图形的喷雾呢？
于是我用了 圆形 Circle 。
// 省略部分代码
sprayBrush.onMouseUp = function() {
var t = this.canvas.renderOnAddRemove;
this.canvas.renderOnAddRemove = !1;
for (var e = [], i = 0, r = this.sprayChunks.length; i < r; i++)
for (let n = this.sprayChunks[i], s = 0, o = n.length; s < o; s++) {
// 改成圆形喷头 ！！！！！！！！！！！！！！！！！
const circle = new fabric.Circle({
radius: n[s].width,
top: n[s].y + 1,
left: n[s].x + 1,
originX: "center",
originY: "center",
fill: this.color
})
e.push(circle)
}
this.optimizeOverlapping && (e = this._getOptimizedRects(e));
let c = new fabric.Group(e);
this.shadow && c.set("shadow", new fabric.Shadow(this.shadow)),
this.canvas.fire("before:path:created", {
path: c
}),
this.canvas.add(c),
this.canvas.fire("path:created", {
path: c
}),
this.canvas.clearContext(this.canvas.contextTop),
this._resetShadow(),
this.canvas.renderOnAddRemove = t,
this.canvas.requestRenderAll()
}
注意上面的代码注释，搜索 Circle 那行看看吧，这是修改喷点图形的关键点。
这个圆形喷雾是不是有点像 [圆形笔刷 CircleBrush]的效果~
喷点除了改成圆形，还可以设置成其他图形，其他图形可以查看Fabric.js 入门 - 基础图形。
甚至还能自定义图形。
要实现这种自定义图形，可以查看Fabric.js 自定义子类，创建属于自己的图形，然后在 onMouseUp() 事件中，把图形改成自己创建的那个即可。
🎨 随机色喷雾
理解了前面 “修改喷点图形” 的话，那要搞个随机色喷雾也是洒洒水啦~
只需把每个图形的 fill 设置成不一样就行了。
sprayBrush.onMouseUp = function() {
var t = this.canvas.renderOnAddRemove;
this.canvas.renderOnAddRemove = !1;
for (var e = [], i = 0, r = this.sprayChunks.length; i < r; i++)
for (let n = this.sprayChunks[i], s = 0, o = n.length; s < o; s++) {
// 每个点都生成自己的随机色（rgb）！！！！！！！！！！！！！！！
let r = Math.floor(Math.random() * 255)
let g = Math.floor(Math.random() * 255)
let b = Math.floor(Math.random() * 255)
let rect = new fabric.Rect({
width: n[s].width,
height: n[s].width,
left: n[s].x + 1,
top: n[s].y + 1,
originX: "center",
originY: "center",
fill: `rgb(${r}, ${g}, ${b})` // 每个图形的填充色都不一样了！！！！！！！！！！！
});
e.push(rect)
}
this.optimizeOverlapping && (e = this._getOptimizedRects(e));
let c = new fabric.Group(e);
this.shadow && c.set("shadow", new fabric.Shadow(this.shadow)),
this.canvas.fire("before:path:created", {
path: c
}),
this.canvas.add(c),
this.canvas.fire("path:created", {
path: c
}),
this.canvas.clearContext(this.canvas.contextTop),
this._resetShadow(),
this.canvas.renderOnAddRemove = t,
this.canvas.requestRenderAll()
}
好了，上面这个案例其实只是提供一个思路。这种随机色的配色是真的丑。。。
代码仓库
⭐ 喷雾笔刷