15个版本 (4个重大更改)

0.6.0 2021年9月15日
0.5.0 2021年9月10日
0.4.3 2021年8月22日
0.3.4 2021年8月19日
0.2.3 2021年8月14日

#776 in 图像

每月29次下载

MIT 许可证

235KB
5.5K SLoC

Censor

Version info

censor 是一个独立的调板分析器,灵感来自DawnBringer的GrafX2调板分析器,具有兼容的布局。它通过提供可视化和突出某些属性来帮助创建和评估受限的调板。

示例

Aerugo Aurora Cheese palette Obra Dinn

安装

使用 rustup 或仓库安装rust工具链。然后运行

$ cargo install censor-analyser

用法

要查看所有标志和描述,将 --help 传递给 censor 及其子命令。

censor analyse

默认输出写入工作目录中的 plot.png,即使文件存在。使用 -o another.png 参数指定另一个输出文件。要使用黑色、灰色和白色作为UI而不是选择调板颜色,请传递 -g 标志。光源是一个白点为温度T(默认为5500K)的日光光源;可以使用 -T 选项重新定义T;可以使用 -D50-D55-D65 选项进行以下预设。如果输入图像是png或jpeg并且包含嵌入式颜色配置文件,则该配置文件将复制到分析图像中。指定 -j 以测试实验性多线程模式。

分析图像 input.png 中的调板

$ censor analyse -i input.png

分析文本文件 input.hex 中的调板

$ censor analyse -f input.hex

分析手动指定的十六进制码 2e3037,ebe5ce

$ censor analyse -c 2e3037,ebe5ce

分析lospec.com上的调色板 aurora

$ censor analyse -l aurora

审查计算

调色板输入和光源选项与 censor analyse 相同。此外,还可以指定应计算哪些指标。 -a, --all 激活所有指标。还有针对单个指标的标志(请参阅帮助页面)。输出格式化为csv,以便与脚本友好。

审查守护进程

在端口 8008 上启动守护进程模式

$ censor daemon -p 8008

一旦守护进程启动,连接到端口后发送命令(每个连接一个命令)。语法与命令行应用相同,但

  1. 应省略第一个 censor
  2. daemon 命令不可用。
  3. analyse-o 选项不再是可选的。

一个有效的调色板分析请求示例(假设守护进程在Linux/Mac机器上的9876端口启动)

$ echo "analyse -l antiquity16 -o plot.png" | nc localhost 9876

成功时,返回 OK。出错时,返回 ERR,并在下一行打印更多错误信息,同时也会打印到守护进程的 stderr

审查抖动

将提供的图像调色板减少到指定的调色板。调色板输入、光源、输出文件选项相同。抖动方法由以下选项确定:--nodither 结果是找到每个像素最近的颜色;--bayer N 结果是使用大小为2^N的Bayer矩阵的有序抖动;--whitenoise WxH 结果是使用大小为WxH的白色噪声的有序抖动;--bluenoise WxH 结果是使用大小为WxH的蓝色噪声的有序抖动。默认情况下,应用大小为14x14的蓝色噪声 - 这通常会被频繁更改。其他方法将陆续添加。

还需要提供输入图像的路径。请注意,生成的图像始终以PNG格式。

一个有效的图像抖动命令示例:$ censor dither mona_lisa.jpg -l warmlight --bluenoise 18x18 -o mona_lisa.dithered.png

功能

  • 分析2-256色的调色板
  • 所有小部件都使用CAM16UCS和感知颜色距离
  • 从命令行参数、文本文件、图像和Lospec加载颜色
  • 针对大量分析请求的守护进程模式
  • 图像抖动
  • Web页面客户端分析调色板的支持WASM(目前有错误)

有可用的小部件

  • 固定色相和亮度的矩形色调
  • 光谱颜色(添加了非光谱CIExy线)
  • 光谱框(使用 y 参数化通过纯黑、光谱颜色和纯白的抛物线)
  • 索引调色板
  • 相似颜色(具有不同的亮度权重)
  • 内部相似度(是 (mean_d/min_d)/n^(2/3)
  • 循环检查
  • "光谱"分布(从白色点相对于最近的光谱颜色进行色调映射)
  • "温度"分布(归一化 -log(CCT),可能稍后更改)
  • 具有不同亮度权重的灰度
  • 从不同角度展示CAM16UCS空间中颜色的立方体
  • 色调-亮度图
  • 有用的颜色混合(即产生距离调色板其他点更远的点)
  • 亮度-纯度条
  • 按亮度排序的颜色和中性化剂
  • 12位RGB近似
  • 极坐标色调-纯度图
  • 固定纯度级别的极坐标色调-亮度
  • 互补色

依赖关系

~18MB
~137K SLoC