这是一个实验中的功能
此功能某些浏览器尚在开发中,请参考浏览器兼容性表格以得到在不同浏览器中适合使用的前缀。由于该功能对应的标准文档可能被重新修订,所以在未来版本的浏览器中该功能的语法和行为可能随之改变。
CanvasRenderingContext2D
.filter
是Canvas 2D API 提供模糊、灰度等过滤效果的属性 。它类似于 CSS filter
属性,并且接受相同的函数。
语法
ctx.filter = "<filter-function1> [<filter-function2] [<filter-functionN]"; ctx.filter = "none";
Filter 函数
filter 属性接受DOMString
字符串,可以包含一个或多个 filter 函数 。
url(<url>)
url()
函数接受一个描述SVG过滤器的XML文件的位置, 并且可以包含一个针对特殊过滤元素的锚点。blur(<length>)
- length:CSS 长度。 给绘图提供一个高斯模糊。
brightness(<percentage>)
- Percentage:百分比。 给绘图提供一个线性乘法,调节亮度的高低。
contrast(<percentage>)
- Percentage:百分比。 调节图像的对比度。 当数值为
0%
时,图像会完全变黑。当数值为100%
时,图像没有任何变化。 drop-shadow(<offset-x>, <offset-y>, <blur-radius>, <spread-radius>, <color>)
- 给绘图提供阴影。 阴影事实上是在图像下面呈现出模糊的,通过对图像的透明遮罩进行偏移绘制出一种特殊的颜色,组合而成的效果。 这个函数接受5个参数:
grayscale(<percentage>)
- Percentage:百分比。将图像转换成灰色的图片。 当值为100%时,图像会完全变成灰色。 当值为0%时,图像没有任何变化。
hue-rotate(<degree>)
- Degree:度数。 对图像进行色彩旋转的处理。当值为0度时,图像没有任何变化。
invert(<percentage>)
- Percentage:百分比。反色图像(呈现出照片底片的效果)。当值为100%时,图像会完全反色处理。当值为0%时,图像没有任何变化。
opacity(<percentage>)
- Percentage:百分比。对图像进行透明度的处理。 当值为0%时,图像完全透明。当值为100%时,图像没有任何变化。
saturate(<percentage>)
- 对图像进行饱和度的处理。当值为0%时,图像完全不饱和。当值为100%时,图像没有任何变化。
sepia(<percentage>)
- 对图像进行深褐色处理(怀旧风格)。 当值为100%时,图像完全变成深褐色。当值为0%时,图像没有任何变化。
none
- 没有使用filter。
示例
使用 filter
属性
这是一段使用 filter
属性的简单的代码片段。
HTML
<canvas id="canvas"></canvas>
JavaScript
var canvas = document.getElementById("canvas"); var ctx = canvas.getContext("2d"); ctx.filter = "blur(5px)"; ctx.font = "48px serif"; ctx.strokeText("Hello world", 50, 100);
修改下面的代码并在线查看canvas的变化 (确保你的浏览器提供这些特性,查看浏览器兼容性列表):
Playable code
<canvas id="canvas" width="400" height="200" class="playable-canvas"></canvas> <div class="playable-buttons"> <input id="edit" type="button" value="Edit" /> <input id="reset" type="button" value="Reset" /> </div> <textarea id="code" class="playable-code"> ctx.filter = "blur(5px)"; ctx.font = "48px serif"; ctx.strokeText("Hello world", 50, 100);</textarea>
var canvas = document.getElementById("canvas"); var ctx = canvas.getContext("2d"); var textarea = document.getElementById("code"); var reset = document.getElementById("reset"); var edit = document.getElementById("edit"); var code = textarea.value; function drawCanvas() { ctx.clearRect(0, 0, canvas.width, canvas.height); eval(textarea.value); } reset.addEventListener("click", function() { textarea.value = code; drawCanvas(); }); edit.addEventListener("click", function() { textarea.focus(); }) textarea.addEventListener("input", drawCanvas); window.addEventListener("load", drawCanvas);
规范描述
当前的规范或草案不包含此内容, 但是正考虑进行标准化。参考 CSS Filter Effects 规范。
浏览器兼容性
Feature | Chrome | Firefox (Gecko) | Internet Explorer | Opera | Safari |
---|---|---|---|---|---|
Basic support | 未实现 | 35 (35) [1] | 未实现 | 未实现 | 未实现 |
Feature | Android | Chrome for Android | Firefox Mobile (Gecko) | IE Mobile | Opera Mobile | Safari Mobile |
---|---|---|---|---|---|---|
Basic support | 未实现 | 未实现 | 35.0 (35) [1] | 未实现 | 未实现 | 未实现 |
Gecko-specific 注解
- [1]
filter
属性默认是无效的。你可以通过设置canvas.filters.enabled
的值为true进行启用。
参见
- 接口定义,
CanvasRenderingContext2D
- CSS
filter