Swift软件包 · v0.1.0

KLAdaptiveSurface

在图片取色进入界面之前整理成更适合阅读的表面颜色。

KLAdaptiveSurface是同步的颜色策略。它尽量保留来源色相,在颜色过暗或过浓时将其整理到可读范围,并为结果选择前景色。

支持平台
iOS 17+ · macOS 14+
开发工具
Swift 6.0+
许可证
MIT
第三方依赖

功能

  • 可配置明度和饱和度边界
  • 用脏色阈值避免改动本来干净的颜色
  • 支持保留色相、中性、冷色和暖色偏好
  • 支持自动、深色或浅色前景色策略

不包含的功能

软件包只整理一个 `CGColor`。图片加载、像素采样、重新计算时机、缓存以及SwiftUI或UIKit呈现由接入应用负责。

通过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)
KLAdaptiveSurface.normalize(_:using:)

根据值类型配置整理一个 `CGColor`。

KLAdaptiveSurface.Configuration

定义阈值、整理强度、色彩偏好和前景色策略。

KLAdaptiveSurface.Result

返回背景色、前景色、对比方向和整理状态。

示例App

Reading Surface Demo

可配置明度和饱和度边界 · 用脏色阈值避免改动本来干净的颜色

Widget Surface Demo

支持保留色相、中性、冷色和暖色偏好 · 支持自动、深色或浅色前景色策略