Swift套件 · v0.1.2

KLAdaptivePalette

從宿主容器實際可見的影像區域產生調色盤。

KLAdaptivePalette會使用 `CGImage`、容器尺寸、內容模式與裁切錨點分析實際顯示的影像區域,回傳來源色、候選色、前景色與決定性的快取鍵。

支援平台
iOS 17+ · macOS 14+
開發工具
Swift 6.0+
授權條款
MIT
第三方相依套件

功能

  • 支援 `.aspectFill` 與 `.aspectFit` 的可見區域分析
  • 回傳依權重排序的色彩候選
  • 依實際背景亮度選擇前景色
  • 快取範圍限定在單一 `KLPaletteAnalyzer` 實例內

不包含的功能

套件只分析 `CGImage` 像素。影像載入、工作排程、持久化與宿主視圖組合由整合端App負責。

透過SwiftPM安裝

Package.swiftSwift
.package(url: "https://github.com/KoenLee1023/KLAdaptivePalette.git", from: "0.1.2")

使用方式

整合範例Swift
let request = KLPaletteRequest(
    image: image,
    cacheID: mediaID,
    containerSize: size
)
let palette = KLPaletteAnalyzer().analyze(request)
KLPaletteAnalyzer

分析 `KLPaletteRequest`,並為相同像素與顯示幾何回傳決定性的快取鍵。

KLPaletteRequest

保存 `CGImage`、快取ID、容器尺寸、內容模式與正規化裁切錨點。

KLAdaptivePalette

回傳可見區域的來源色、候選色、強調色、背景色與前景色。

範例App

PaletteInspector

支援 `.aspectFill` 與 `.aspectFit` 的可見區域分析 · 回傳依權重排序的色彩候選

AdaptiveSurface

依實際背景亮度選擇前景色 · 快取範圍限定在單一 `KLPaletteAnalyzer` 實例內