🎨 AutoTintura

📖 项目使用说明

1. 安装

通过 npm 安装：

npm install auto-tintura

2. 快速上手

通过 ESM 方式引入库并一键分析图片背景色：

import { AutoTintura } from 'auto-tintura';

// 快捷分析图片并返回推荐的背景色（主色 + 纯色背景 + 渐变背景）
const result = await AutoTintura.getSmartBackground('https://example.com/photo.jpg', {
  brightnessPreference: 'auto',
  gradientDirection: 'vertical'
});

// 将渐变背景应用到页面
document.body.style.background = result.edgeBackground?.cssValue;
// 纯色背景
document.body.style.background = result.solidBackground.cssValue;

3. 核心能力

• 主色提取：基于 K-Means 聚类精准提取图片主色调
• 边缘分析：距离加权采样提取图片四边颜色，支持线性 / 高斯衰减
• 和谐配色：支持类似色、互补色、三角色、分裂互补色、矩形色等多种色彩和谐算法
• 渐变生成：支持垂直、水平、四角多方向渐变背景
• 无缝衔接：默认使用 seamless 策略，背景色尽量贴合图片边缘，降低视觉冲突
• 浏览器兼容检测：内置 checkBrowserSupport() 检测 Canvas 等能力

4. 详细文档

更多 API 用法、配置项与算法说明，请访问 GitHub 仓库阅读 README： kaidong77/autoTintura