Swift패키지 · v0.1.0

KLAdaptiveSurface

이미지에서 얻은 색을 화면에 적용하기 전에 읽기 쉬운 표면 색으로 정리합니다.

KLAdaptiveSurface는 동기적인 색상 정책입니다. 원래 색조를 가능한 한 유지하면서 너무 어둡거나 강한 색만 읽기 쉬운 범위로 정리하고 결과에 맞는 전경색을 반환합니다.

지원OS
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

배경색, 전경색, 대비 방향, 정리 상태를 반환합니다.

데모 앱

Reading Surface Demo

밝기와 채도 범위 설정 · 탁한 색상 임계값으로 깨끗한 색상은 그대로 유지

Widget Surface Demo

색조 유지, 중립, 차가운 색, 따뜻한 색 선호도 · 자동, 어두운 색, 밝은 색 전경색 정책