egotoadcitadel/palette-from-image-ai

选用指南

AI 根据 README 整理 · 2026/10/14 20:26:02

适用场景

适用于从截图、照片、游戏画面、纹理或绘画中提取颜色调色板，支持批量处理整个文件夹的图像，并可对比两个调色板的差异。

查看 README 依据

**palette-from-image-ai** is a Windows desktop tool that reads any image — a screenshot, a photo, a game capture, a texture, a painting — and turns it into a usable color palette. Not five swatches scraped off a Wikipedia page either. The embedded vision model segments the image, clusters color by perceptual distance, weights each cluster by how much of the frame it actually owns, and emits a palette you can drop straight into a shader, a CSS file, an ASE swatch, a Godot theme, a clip-studio brush set, or a materials list.

| **Harmony constraints** | Analogous, complementary, triadic, split-comp | Palette looks intentional | | **12 export formats** | HEX, RGB, HSL, LAB, ASE, GPL, CSS, JSON, PNG, ACO, SKETCH, SVG | Fits any pipeline | | **Batch mode** | Drop a folder, get a palette per image | Whole asset packs in one pass | | **Palette diff** | Compare two palettes, see the delta | Track art-direction changes | | **Locked swatches** | Pin a color, re-extract the rest around it | Brand-color-safe | | **Eyeball sampler** | Click any pixel for exact value | Manual override always available |

目标用户

面向设计师和像素艺术家，用于个人艺术创作、商业项目、游戏资产管线、纹理/着色器创作以及教育研究。

查看 README 依据

| Can I pin a brand color? | Yes — add the swatch, click the lock icon, re-extract. The rest of the palette re-derives around it. | | Why is the first launch slow? | Shader cache build. ~3 seconds once, instant after. | | Will there be a macOS or Linux build? | The engine is portable; a Linux CLI build is on the roadmap. macOS is unlikely due to the DX12 path. | --- ## 🧰 Usage Guidelines | Allowed | Not allowed | |---|---| | Personal art and design work | Redistributing the `.exe` under a different name | | Commercial projects (MIT) | Removing the license header from source |

| Game asset pipelines | Selling the app as-is without modification | | Texture / shader authoring | Claiming authorship of the underlying vision model | | Educational use and research | Using it to scrape copyrighted images at scale | --- ## 🩹 Changelog - **v2.4.1** — Fixed ASE export on palettes with fewer than 6 swatches. Watch Folder now respects file locks. - **v2.4.0** — Added SVG swatch sheet export. GPU path is now default-on when a DX12 device is present. - **v2.3.2** — Region sampler no longer biases toward the frame center on wide-aspect images.

使用方式

通过图形界面拖放图像或使用文件菜单打开，也可通过命令行脚本模式运行，支持多种导出格式。

查看 README 依据

3. 🖼️ **Drop an image in.** Drag any PNG/JPG/WEBP onto the window, or use *File → Open Image*. 4. 🎚️ **Tune the palette.** Slide the swatch count (5–16), pick a harmony mode if you want one, lock any color you want to keep. 5. 📤 **Export.** Hit *Export*, choose your format, done. Or right-click the swatch strip → *Copy as HEX*. That's the whole loop. First-run to exported palette is under a minute. --- ## 📦 Installation ### 1. Get the archive

- **GPU Acceleration Toggle** — DX12 compute path for large images. - **Custom Distance Function** — swap CIEDE2000 for CMC or CIE94 if you need it. - **Threshold Override** — expose the dedup threshold directly for finicky images. - **CLI Mode** — `.exe --input foo.png --count 8 --format css` for scripting. - **Watch Folder** — point it at a folder; new images get processed automatically. --- ## 🚦 All Modules Status | Module | Status | Description | |---|---|---| | Segmenter | ✅ Working | Region splitting on all supported formats |

部署要求

需要Windows 10 21H2或Windows 11，4核CPU，4GB内存，450MB存储空间，支持DX11的集成显卡或DX12独立显卡（可选），无需运行时依赖。

查看 README 依据

No installer. No PATH changes. No Python. No Node. Delete the folder and it's fully uninstalled. --- ## 🖥️ System Requirements | Component | Minimum | Recommended | |---|---|---| | **OS** | Windows 10 21H2 (x64) | Windows 11 23H2+ (x64) | | **CPU** | 4-core, SSE4.2 | 8-core, AVX2 | | **RAM** | 4 GB | 16 GB | | **GPU** | Integrated (DX11) | Discrete DX12, 4 GB VRAM | | **Storage** | 450 MB free | 1.2 GB free (SSD) | | **Display** | 1280×720 | 1920×1080 or higher | | **Input** | Mouse + keyboard | + colorimeter (optional) | | **Runtime** | None | None |

The app runs entirely CPU-side if you don't have a DX12 GPU. Expect ~5–8s per 4K image on CPU, ~1.2s with GPU acceleration enabled. --- ## 📊 Comparison | Aspect | Online palette sites | Generic k-means scripts | This Tool | |---|---|---|---| | Region awareness | No | No | Yes — segmentation-based | | Perceptual distance | Varies | Rarely | Yes — CIEDE2000 | | Offline | No | Yes | Yes | | Export formats | 2–4 | 1–2 | 12 | | Batch processing | Paid tiers only | Manual scripting | Built-in | | Swatch locking | No | No | Yes | | Harmony constraints | Sometimes | No | Yes — 4 modes |

已知限制

首次运行可能显示SmartScreen警告（未签名），高饱和图像可能产生扁平调色板，批处理在网络驱动器上可能停滞，GPU加速仅支持DX12，超大TIFF（>200MP）无法打开，macOS版本不太可能。

查看 README 依据

| Custom Distance Function | ✅ Working | CMC, CIE94, CIEDE2000 | | Threshold Override | ✅ Working | Exposed | | Role Tagger | ✅ Working | Editable labels | | Recent Palettes | ✅ Working | 20-item history | | Portable Profile | ✅ Working | Local config | | Reorder Drag | ✅ Working | Order preserved on export | | Swatch Count Slider | ✅ Working | 5–16 range | --- ## ⚠️ Known Issues | Issue | Solution | |---|---| | SmartScreen warning on first run | Click *More info* → *Run anyway*. The `.exe` is unsigned; a signed build is on the roadmap. |

| Palette looks flat on highly saturated images | Lower the dedup threshold in *Settings → Advanced* to 2.0 and re-extract. | | Batch mode stalls on network drives | Copy images to a local folder first — the segmenter needs memory-mapped file access. | | ASE file not showing in Photoshop | Photoshop caches swatches. Restart Photoshop after importing. | | GPU toggle greyed out | Your GPU doesn't expose a DX12 compute queue. App runs CPU-only; no functional loss beyond speed. | | Very large TIFFs (>200 MP) fail to open | Downscale to under 100 MP first. The 16-bit TIFF path is on the roadmap. |

| Can I pin a brand color? | Yes — add the swatch, click the lock icon, re-extract. The rest of the palette re-derives around it. | | Why is the first launch slow? | Shader cache build. ~3 seconds once, instant after. | | Will there be a macOS or Linux build? | The engine is portable; a Linux CLI build is on the roadmap. macOS is unlikely due to the DX12 path. | --- ## 🧰 Usage Guidelines | Allowed | Not allowed | |---|---| | Personal art and design work | Redistributing the `.exe` under a different name | | Commercial projects (MIT) | Removing the license header from source |