#调色板 #颜色 #调色板 #图像 #命令行工具 #JSON 文本 #颜色提取

app auto-palette-cli

🎨 从图像中提取突出颜色调色的 CLI 工具

3 个版本 (破坏性更新)

0.5.0 2024 年 8 月 13 日
0.4.0 2024 年 6 月 7 日
0.3.0 2024 年 5 月 19 日

#87 in 图像

Download history 167/week @ 2024-05-18 5/week @ 2024-05-25 90/week @ 2024-06-01 42/week @ 2024-06-08 4/week @ 2024-06-15 12/week @ 2024-07-06 106/week @ 2024-08-10

每月 106 次下载

MIT 许可证

270KB
6.5K SLoC

auto-palette-cli

🎨 使用 auto-palette crate 从图像中提取颜色调色的 CLI 工具。

功能

  • 从图像中提取突出颜色调色。
  • 支持多种颜色提取算法(dbscandbscan++kmeans)。默认为 dbscan
  • 支持多种颜色选择主题(basiccolorfulvividmutedlightdark)。默认为 basic
  • 支持多种颜色格式(hexrgbcmykhslhsvlabluvlchablchuvoklaboklchxyz)。默认为 hex
  • 以多种格式输出颜色调色板(jsontexttable)。默认为 text

安装

cargo install auto-palette-cli

用法

$ auto-palette --help
🎨 A CLI tool to extract prominent color palettes from images.

Usage: auto-palette [OPTIONS] <PATH>

Arguments:
  <PATH>  Path to the image file.

Options:
  -a, --algorithm <name>  Algorithm for extracting the color palette. [default: dbscan] [possible values: dbscan, dbscan++, kmeans]
  -t, --theme <name>      Theme for selecting the swatches. [possible values: basic, colorful, vivid, muted, light, dark]
  -n, --count <number>    Number of colors to extract. [default: 5]
  -c, --color <name>      Output color format. [default: hex] [possible values: hex, rgb, cmyk, hsl, hsv, lab, luv, lchab, lchuv, oklab, oklch, xyz]
  -o, --output <name>     Output format. [default: text] [possible values: json, text, table]
      --no-resize         Disable image resizing before extracting the color palette.
  -h, --help              Print help (see more with '--help')
  -V, --version           Print version

示例

基本用法

以下是从图像中提取颜色调色的示例

$ auto-palette path/to/your_image.jpg
   #EB3739 (82, 293) 7751
   #A24F01 (114, 129) 132 
   #FB9C04 (96, 155) 112 
   #D25A6E (58, 228) 20  
   #8DA502 (94, 84) 16  

高级用法

以下是从图像中提取颜色调色,使用 vivid 主题、rgb 颜色格式和 table 输出格式的示例

$ auto-palette path/to/your_image.jpg -t vivid -n 6 -c rgb -o table
+---+--------------------+------------+------------+
| # | Color              | Position   | Population |
+---+--------------------+------------+------------+
| 1 | RGB(221, 226, 222) | (104, 96)  |       6778 |
| 2 | RGB(3, 144, 149)   | (114, 201) |       5476 |
| 3 | RGB(23, 37, 36)    | (120, 300) |       4300 |
| 4 | RGB(36, 88, 131)   | (183, 145) |       1348 |
| 5 | RGB(254, 29, 44)   | (183, 190) |        779 |
| 6 | RGB(253, 213, 116) | (25, 158)  |        567 |
+---+--------------------+------------+------------+

开发

构建

cargo run -- {image_path}

测试

cargo nextest run --tests --all-features --package auto-palette-cli

许可证

本项目采用MIT许可证发布。有关详细信息,请参阅许可证文件。

依赖项

~7.5MB
~137K SLoC