节点-选取
节点JS兼容叉 在 JavaScript 中的 potrace 加上一些添加,这反过来又是一个港口 原始波崔斯语 ——追踪位图的工具.
示例和演示
| 原始图像 | Potrace 输出 | 邮寄产出 |
|---|---|---|
![]() |
(从 浏览器版本的在线演示(中文(简体) )
使用量
安装
npm install potrace
基本用途
var potrace = require('potrace'),
fs = require('fs');
potrace.trace('./path/to/image.png', function(err, svg) {
if (err) throw err;
fs.writeFileSync('./output.svg', svg);
});
您也可以提供配置对象作为第二个参数.
var params = {
background: '#49ffd2',
color: 'blue',
threshold: 120
};
potrace.trace('./path/to/image.png', params, function(err, svg) {
/*...*/
});
如果您想在同一图像上多次运行波崔斯算法, 并设定不同的阈值, 将结果合并到一个文件中 - posterize 方法就是这样.
potrace.posterize('./path/to/image.png', { threshold: 180, steps: 4 }, function(err, svg) {
/*...*/
});
// or if you know exactly where you want to break it on different levels
potrace.posterize('./path/to/image.png', { steps: [40, 85, 135, 180] }, function(err, svg) {
/*...*/
});
高级使用和配置
两者 trace 财务报告和审定财务报表 posterize 方法返回实例 Potrace 财务报告和审定财务报表 Posterizer 分类为第三个参数.
您也可以直接即兴上课:
var potrace = require('potrace');
// Tracing
var trace = new potrace.Potrace();
// You can also pass configuration object to the constructor
trace.setParameters({
threshold: 128,
color: '#880000'
});
trace.loadImage('path/to/image.png', function(err) {
if (err) throw err;
trace.getSVG(); // returns SVG document contents
trace.getPathTag(); // will return just <path> tag
trace.getSymbol('traced-image'); // will return <symbol> tag with given ID
});
// Posterization
var posterizer = new potrace.Posterize();
posterizer.loadImage('path/to/image.png', function(err) {
if (err) throw err;
posterizer.setParameter({
color: '#ccc',
background: '#222',
steps: 3,
threshold: 200,
fillStrategy: potrace.Posterize.FILL_MEAN
});
posterizer.getSVG();
// or
posterizer.getSymbol('posterized-image');
});
回调函数提供给 loadImage 方法将结合 Potrace编号 :Posterizer 因此,如果它不违反你的代码风格 - 你可以只是做
new potrace.Potrace()
.loadImage('path/to/image.bmp', function() {
if (err) throw err;
this.getSymbol('foo');
});
Jimp 模块 用于后端,所以第一个参数为 loadImage 方法可以是 Jimp 能读到的任何东西: a Buffer,本地路径或url字符串。 所支持的格式有: PNG, JPEG 或 BMP. 也可以是 Jimp 实例( 前提是位图没有修改)
参数
Potrace 类预期以下参数:
- 转动政策 - 如何解决路径分解中的模糊问题。 可能值导出为常数 :
TURNPOLICY_BLACK, (中文(简体) ),TURNPOLICY_WHITE, (中文(简体) ),TURNPOLICY_LEFT, (中文(简体) ),TURNPOLICY_RIGHT, (中文(简体) ),TURNPOLICY_MINORITY, (中文(简体) ),TURNPOLICY_MAJORITY。参见 此文档 更多信息(第4页)
(默认 :TURNPOLICY_MINORITY(中文(简体) ) - 粪便大小 - 压制这种大小的光谱
(默认: 2) - α-最大值 - 角阈值参数
(默认:1) - 选择调查 - 曲线优化
(默认:真实) - 选择容忍 - 曲线优化可容性
(违约:0.2) - 阈值 - 低于这个界限的颜色被视为黑色.
数字应为0.255或
THRESHOLD_AUTO在此情况下,将自动使用 多层线程算法
(默认 :THRESHOLD_AUTO(中文(简体) ) - 黑色白色 - 指定从阈值变为矢量形状的颜色
(默认 :true(中文(简体) ) - 颜色 - 充满颜色。 导出为 < symbol> 时将被忽略( 默认 :
COLOR_AUTO,这意味着黑色或白色,取决于blackOnWhite(财产) - 背景情况 - 背景颜色。 导出为“ symbol” 时会被忽略 。 默认不存在( N)
COLOR_TRANSPARENT(中文(简体) )
Posterizer 类方法与 Potrace,但 .getPathTag()。 。 。 .
配置对象以下列属性扩展 :
- 填充战略 - 确定如何为每一层选择填充颜色。 可能值导出为常数 :
FILL_DOMINANT- 范围内最常使用的颜色(默认使用),FILL_MEAN- 算术平均值(平均),FILL_MEDIAN- 中间颜色,FILL_SPREAD- 忽略图像的颜色信息,只是将颜色在 0. < 阈值 > (或 < 阈值 >. 255) 范围内平均分布blackOnWhite设置为false, (中文(简体) ),
- 分布范围 - 如何选择每一层的颜色停止。 如果
steps是一个数组。 可能的值是:RANGES_AUTO- 执行自动阈值(使用 多层线程算法) (中文(简体) ). 已标注的源的可取方法,但计算出5个或更多阈值(时间复杂)需要很长时间
(默认使用)RANGES_EQUAL- 忽略图像的颜色信息,并将可用的颜色空间分割成等块
- 步骤 - 在生成的图像中指定所需分层的数量。 如果提供数字 -- -- 每个层的阈值将自动按照
rangeDistribution参数。 如果一个阵列提供了它,则它预期是一个阵列,每层都有预先计算出的阈值(在0.255之间)
(默认 :STEPS_AUTO将导致3或者说4,取决于threshold数值) - 阈值 - 将图像分解为前地和后地(而只有前地被分解为所期望的地层数). 基本上,当它成为最后一个(最不透明)层的门槛,然后
steps - 1中间阈值计算. 若为 步骤 是一个阈值的数组,而且数组的每个值都较低(如果 黑色白色 参数设置为false) 而不是阈值 - 阈值将被添加到数组中,否则会被忽略.
(默认 :Potrace.THRESHOLD_AUTO(中文(简体) ) - potrace 类接受的所有其他参数
注释:
- 当数量
steps大于 10 - 可以增加一层,以确保在需要时有最暗/最亮的颜色,以确保有可能非常重要的这一点细节,如阴影或线条艺术. - 由于生成了大量地层,由于地层是如何被合成的,在渲染阶段的数学出错,整体看起来会比原作更亮.
- 默认配置
steps, (中文(简体) ),threshold财务报告和审定财务报表rangeDistribution设置全部设置为自動,结果用上面提到的多级切入算法计算出4个阈值/颜色停止. 计算4个阈值平均需要3至5秒。 您可能想要明确限制steps至3至中度提高处理速度.
感谢
- 彼得·塞林格为 原始 Potrace 工具和算法
- @kilobtye 原创 javascript 端口
许可证
GNU通用公共许可版本2(GPLv2). 请看 许可证文件 更多信息.
