更新记录

0.1.0（2026-10-03） 下载此版本

• 首次发布：图片主色/调色板/四边颜色提取（median-cut 量化 + stb_image 解码）
• getPalette(path, colorCount?)：返回图片尺寸、主色、调色板、四边平均色
• 支持 uni-app x App-Android / App-iOS / App-Harmony / Web / 微信小程序 / 支付宝小程序（HBuilderX 5.31+ 蒸汽模式）

平台兼容性

uni-app x(5.31)

其他

tui-color-thief-uasm

uni-app x 的图片主色提取插件（UASM 原生插件）。基于 median-cut 量化算法 + stb_image 解码，纯 C++ 实现，原生执行性能，支持本地路径与网络图片。

支持平台

要求 HBuilderX 5.31+（蒸汽模式）。

API

getPalette(path, colorCount?)

提取图片主色信息。

import { getPalette } from '@/uni_modules/tui-color-thief-uasm'

const res = await getPalette('/static/logo.png', 8)
console.log(res.width, res.height)      // 图片尺寸
console.log(res.dominant)               // 主色 [r, g, b]
console.log(res.palette)                // 调色板，按像素数降序
console.log(res.edges)                  // 四边平均色 [上, 右, 下, 左]

• path：本地路径（如 /static/logo.png）或网络图片 URL
• colorCount：调色板颜色数，默认 8

ColorThiefResult

限制说明

• 不支持 ICO 格式（stb_image 不含 ICO 解码）
• 图片会整体解码到内存，超大图片注意内存占用

推荐插件：TuiPlus Vapor 组件库

TuiPlus Vapor 专注 uni-app x 5.0 蒸汽模式的高性能 UI 组件库：内置 TuiVitex 编译器（简单组件编译为官方组件、复杂组件 Canvas 绘制）与 TuiEntine Canvas Flex 渲染引擎，蒸汽模式 + external-class + CSS 原子化最佳实践。

👉 https://ext.dcloud.net.cn/plugin?id=28497