kimitri/coltrane

Coltrane是一个命令行工具,用于在CSS(和SVG)颜色之间的不同表示形式之间进行转换。它支持Display P3、十六进制、hsl、hsla、rgb和rgba之间的转换。

1.2.1 2023-11-17 08:54 UTC

This package is auto-updated.

Last update: 2024-09-17 10:52:24 UTC


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现在默认保留。)

用法示例

  1. 读取定义为十六进制值的CSS文件,并将相同CSS中的颜色转换为宽色域Display-P3:coltrane hex2display-p3 -i source.css -o wide-gamut.css
  2. 从macOS剪贴板获取CSS字符串,将所有定义为rgb()的颜色转换为宽色域Display-P3,并将结果CSS存储回剪贴板:pbpaste | coltrane rgb2display-p3 | pbcopy
  3. 从macOS剪贴板中获取CSS字符串,将所有定义为十六进制值的颜色转换为使用输入颜色的原始alpha值,将它们对齐到经典CGA调色板,并将结果CSS写入文件:pbpaste | coltrane hex2rgba -a a -p cga1-hi -o cga-is-still-cool.css