kimitri / coltrane
Coltrane是一个命令行工具,用于在CSS(和SVG)颜色之间的不同表示形式之间进行转换。它支持Display P3、十六进制、hsl、hsla、rgb和rgba之间的转换。
Requires
- spatie/color: ^1.5
- symfony/console: ^6.0
README
Coltrane是一个命令行工具,用于在CSS(和SVG)颜色之间的不同表示形式之间进行转换。它支持Display-P3(包括和不包括alpha通道)、十六进制、hsl、hsla、rgb和rgba之间的转换。目前,它是少数几个支持宽色域Display-P3颜色的工具之一。
安装
Coltrane是用PHP编写的,可以使用Composer进行安装:composer global require kimitri/coltrane
之后,coltrane
可执行文件将被安装到Composer的二进制目录中(通常是~/.composer/vendor/bin
)。请确保将此目录包含在您的$PATH
中。
用法
Coltrane旨在集成到各种自动化工作流程中,因此它在各种用例中都表现良好。默认情况下,Coltrane从stdin
读取输入并将其输出到stdout
,但您可以通过指定--infile
和--outfile
(-i
和-o
)选项来使用普通旧文件。
调色板对齐
Coltrane还提供了一个方便的调色板对齐功能以及一些内置的调色板。调色板使用--palette
(-p
)选项指定,调色板是简单的文本文件,由没有前缀#字符的常规十六进制颜色组成(每行一个颜色)。此格式由Lospec网站(.HEX
文件)支持。要使用自定义调色板,只需将--palette
选项提供给您调色板文件的路径。
Coltrane附带从Lospec网站获得的许多复古主题调色板。这些内置调色板可以通过运行coltrane palettes
列出。要使用内置调色板,只需将--palette
选项提供给您内置调色板的名称。
Alpha通道
某些颜色格式(在Coltrane的情况下,这些是display-p3a、hsla和rgba)支持alpha通道,Coltrane提供了几种指定目标alpha值的方法。alpha值范围从0(完全透明)到1(完全不透明)。可以使用--alpha
(-a
)选项设置alpha,有两种不同的操作模式
- 使用静态alpha值(例如,使用
--alpha .8
使用alpha值为0.80)。 - 将alpha映射到输入颜色的R、G、B或alpha通道(例如,使用
--alpha r
使用相对红色通道值作为alpha)。请注意,R、G和B通道也用于hsla颜色。(alpha通道处理在版本1.2.0中已更改,原始alpha现在默认保留。)
用法示例
- 读取定义为十六进制值的CSS文件,并将相同CSS中的颜色转换为宽色域Display-P3:
coltrane hex2display-p3 -i source.css -o wide-gamut.css
- 从macOS剪贴板获取CSS字符串,将所有定义为
rgb()
的颜色转换为宽色域Display-P3,并将结果CSS存储回剪贴板:pbpaste | coltrane rgb2display-p3 | pbcopy
- 从macOS剪贴板中获取CSS字符串,将所有定义为十六进制值的颜色转换为使用输入颜色的原始alpha值,将它们对齐到经典CGA调色板,并将结果CSS写入文件:
pbpaste | coltrane hex2rgba -a a -p cga1-hi -o cga-is-still-cool.css