colorific：终极图像色彩提取工具，3行代码实现自动调色板检测

colorific：终极图像色彩提取工具，3行代码实现自动调色板检测

【免费下载链接】colorificAutomatic color palette detection项目地址: https://gitcode.com/gh_mirrors/co/colorific

colorific 是一款基于 Python 的终极图像色彩提取工具，能够自动检测图像中的主要色彩并生成调色板，仅需 3 行代码即可轻松实现专业级的色彩分析功能。无论是设计师、开发者还是摄影爱好者，都能通过它快速获取图像的核心色彩信息。

🌟 为什么选择 colorific？

在数字设计和开发过程中，准确提取图像色彩是一项常见需求。colorific 凭借以下优势脱颖而出：

• 自动检测：智能识别图像中的主要色彩，无需手动选择
• 背景分离：自动区分主体色彩与背景色，让结果更精准
• 简单高效：极简 API 设计，3 行代码即可完成色彩提取
• 多平台支持：完美兼容 Python 2.7 和 Python 3.3+ 版本

🚀 快速安装指南

安装 colorific 非常简单，推荐使用 virtualenv 创建独立环境：

$ virtualenv colorific-sandbox $ ./colorific-sandbox/bin/pip install colorific

安装完成后，可通过以下命令验证：

$ ./colorific-sandbox/bin/colorific --help

💡 核心功能使用教程

基础命令行使用

colorific 支持多种使用方式，最基础的是通过命令行处理单张图片：

$ echo tests/nasa_ares_logo.png | colorific tests/nasa_ares_logo.png #0065b9,#bbd6ec,#ff0000 #ffffff

输出结果包含：文件名、主要色彩（按重要性排序）和检测到的背景色。

批量处理图像

要处理目录中的所有图片，可结合 find 命令使用：

$ find . -name '*.jpg' | colorific

对于大量图片，还可以使用多进程模式加速处理：

$ find . -name '*.jpg' | colorific -p 8

生成可视化调色板

使用-o参数可以为每张图片生成带颜色代码的调色板图片：

$ colorific -o tests/nasa_ares_logo.png

执行后会生成nasa_ares_logo_palette.png文件，直观展示提取的色彩及对应的十六进制代码。

🐍 Python API 集成

作为开发者，你可以直接在 Python 代码中集成 colorific 的强大功能：

from colorific.palette import extract_colors # 提取图像色彩 palette = extract_colors("tests/nasa_ares_logo.png") # 输出主要色彩 print([color.value for color in palette.colors])

核心功能实现位于 colorific/palette.py 文件中，你可以根据需求进行定制开发。

📋 配置与参数调整

colorific 提供了多种参数来优化色彩提取结果：

• min_saturation：最小饱和度阈值，过滤低饱和度颜色
• min_distance：色彩间最小距离，避免相似颜色重复出现
• max_colors：最大提取色彩数量，默认值为 5
• min_prominence：色彩最小占比，过滤次要颜色

通过调整这些参数，可以获得更符合需求的色彩提取结果。

📝 总结

colorific 作为一款专业的图像色彩提取工具，以其简单易用的 API 和强大的功能，为设计师和开发者提供了高效的色彩分析解决方案。无论是命令行快速处理，还是集成到 Python 项目中，都能轻松应对各种色彩提取需求。

如果你正在寻找一款能够自动检测图像调色板的工具，colorific 绝对是你的不二之选！

🔧 开发与贡献

colorific 的源代码托管在 GitCode 上，欢迎大家参与开发和贡献：

$ git clone https://gitcode.com/gh_mirrors/co/colorific

项目遵循 ISC 开源许可协议，详细信息可查看 LICENSE.txt 文件。

【免费下载链接】colorificAutomatic color palette detection项目地址: https://gitcode.com/gh_mirrors/co/colorific