Swift套件 · v0.1.0
KLAdaptiveSurface
在圖片取色進入介面前，整理成更適合閱讀的表面色彩。
KLAdaptiveSurface是同步的色彩策略。它盡量保留來源色相，在顏色過暗或過濃時整理至可讀範圍，並為結果選擇前景色。
功能
- 可設定明度與飽和度邊界
- 以髒色閾值避免改動原本乾淨的色彩
- 支援保留色相、中性、冷色與暖色色彩偏好
- 支援自動、深色或淺色前景色策略
不包含的功能
套件只整理一個 `CGColor`。圖片載入、像素取樣、重新計算時機、快取，以及SwiftUI或UIKit呈現由整合端App負責。
透過SwiftPM安裝
Package.swiftSwift
.package(url: "https://github.com/KoenLee1023/KLAdaptiveSurface.git", from: "0.1.0")使用方式
整合範例Swift
let surface = KLAdaptiveSurface.normalize(
sampledColor,
using: .reading
)
apply(surface.background, foreground: surface.foreground)API文件
開啟完整API文件。KLAdaptiveSurface.normalize(_:using:)依值型別設定整理一個 `CGColor`。
KLAdaptiveSurface.Configuration定義閾值、整理強度、色彩偏好與前景色策略。
KLAdaptiveSurface.Result回傳背景色、前景色、對比方向與整理狀態。
範例App
Reading Surface Demo
可設定明度與飽和度邊界 · 以髒色閾值避免改動原本乾淨的色彩
Widget Surface Demo
支援保留色相、中性、冷色與暖色色彩偏好 · 支援自動、深色或淺色前景色策略