CyaneaOctopus 0.3.1

CyaneaOctopus 0.3.1

Adam McElhaney 维护。



  • Adam McElhaney

CyaneaOctopus by Adam McElhaney

Platform: iOS 9+ Language: Swift 3 CocoaPods compatible License: MIT



Swift 4

安装

CyaneaOctopus 可通过 CocoaPods 获取。要安装它,只需将以下行添加到 Podfile 中。

pod 'CyaneaOctopus'

附加安装

CyaneaOctopus.clr 这是一个用于 Interface Builder(以及其他使用颜色库的 Mac 应用)的颜色调色板库。要安装,从 Finder > 前往,按住 选项键 并单击 。将 .clr 文件复制到 /Library/Colors

Install

CyaneaOctopus.aco 这是一个针对 Adobe 产品的颜色调色板刻板。您可以通过在刻板面板中单击 加载刻板... 按钮来加载此刻板。

简介

CyaneaOctopus 是一个适用于 iOS 的轻量级且功能强大的纯 Swift 编写的颜色框架。它基于由 Vicc Alexander 开发的 Chameleon 框架。由于 Chameleon 框架似乎已经被遗弃,因此在这里将其重建为 CyaneaOctopus(另一种可以改变颜色的动物)。

借助CyaneaOctopus,您可以轻松停止对RGB值的调整,避免浪费数小时去寻找合适的颜色组合使用在您的应用程序中,也不必担心文本在应用程序的各种背景颜色上是否可读。

功能

  • 2种色调下的24种颜色
  • 渐变色
  • 从图像生成颜色
  • 调整任何颜色的亮度或暗度
  • 支持十六进制颜色
  • 全局应用程序主题
  • Swift 4.2

🌟产品功能

100%平面

CyaneaOctopus提供了超过24种精心挑选的颜色,这些颜色分为浅色和深色两种色调。

Swatches

从图像中获取颜色

CyaneaOctopus可让您轻松地从图像中提取非平面或平面颜色方案,无需繁琐的操作。您还可以轻松地生成图像的平均颜色。现在您可以根据图像调整个人资料或产品的UI颜色!

⚠️要求

  • Swift
  • Swift 至少需要iOS 9.0。
  • 使用任何iOS项目都需要Xcode 6.3。

🔑许可证

CyaneaOctopus在MIT许可证的条款和条件下发布和分发。

👥贡献

如果您遇到问题,请打开一个问题报告。我们积极欢迎pull requests。通过为CyaneaOctopus做出贡献,您同意您的贡献将根据其MIT许可证许可。

📗文档

CyaneaOctopus中所有可用的方法、属性和类型均在以下进行文档说明。

安装

CyaneaOctopus 可通过 CocoaPods 获取。要安装它,只需将以下行添加到 Podfile 中。

pod 'CyaneaOctopus'

手动安装

如果您愿意手动安装此框架,只需将 CyaneaOctopus 文件夹拖放到您的项目中,并确保您勾选以下复选框。

Manual Installation

使用方法

要使用 CyaneaOctopus 中的功能,请包含以下导入

如果你使用 Cocoapods 安装 CyaneaOctopus
Swift
import CyaneaOctopus

UIColor 方法

常规方法
Swift
view.backgroundColor = UIColor.flatGreenDark
CyaneaOctopus 缩写
Swift
view.backgroundColor = FlatGreenDark()

设置浅色的颜色与设置深色的颜色相同,只是不加 Dark 后缀。(默认情况下,所有不带 Dark 后缀的颜色都是浅色)。例如

常规用法
Swift
view.backgroundColor = UIColor.flatGreen
CyaneaOctopus 缩写
Swift
view.backgroundColor = FlatGreen()

渐变颜色

通过传入一个视图到颜色、一个UIColors数组和一个渐变方向,可以创建渐变颜色。

Swift
let colors : [UIColor] = [.flatBlueColor(),.flatRedColor(),.flatGreenColor()]
UIColor.gradientColor(view: view, colors: colors, direction: .leftToRight)
8 可能的渐变方向
  • 上至下
  • 左至右
  • 下至上
  • 右至左
  • 左上至右下
  • 右上至左下
  • 左下至右上
  • 右下至左上

随机颜色

生成随机单色颜色有四种方式。如果您对颜色是浅色调还是深色调没有偏好,您可以这样做

常规
Swift
view.backgroundColor = UIColor.randomFlat
CyaneaOctopus 简写
Swift
view.backgroundColor = RandomFlatColor()

UI阴影样式

  • UIShadeStyleLight (Swift中的 UIShadeStyle.Light
  • UIShadeStyleDark (Swift中的 UIShadeStyle.Dark

十六进制颜色

最受欢迎的功能之一,十六进制颜色,现已提供。您只需简单地提供一个带或不带#符号的十六进制字符串。

常规用法
Swift
UIColor(hexString:string)
CyaneaOctopus 缩写
Swift
HexColor(hexString)

十六进制值

获取UIColorhexValue同样简单。

Swift
FlatGreen.hexValue //Returns @"2ecc71"

浅色和深色颜色

有时你所需要的仅仅是将颜色调整为浅一些或者深一些。好吧,对于这些罕见但至关重要的时刻,CyaneaOctopus为你提供了解决方案。你现在可以通过以下方法将任何颜色变亮:

常规方法
Swift
color.lightenByPercentage(percentage: CGFloat)

你也可以生成一个颜色更深版本的颜色

常规方法
Swift
color.darkenByPercentage(percentage: CGFloat)

改变图片颜色

Cyanea Octopus支持对UIImages进行颜色叠加和着色。

着色
let dice = UIImage(named: "test")?.tint(.red)

所有灰度颜色都着上了所需的颜色。

着色
let dice = UIImage(named: "test")?.overlayColor(.yellow)

alpha通道被全色着色。

Color tint and overlay

从图片中提取颜色

CyaneaOctopus 现在支持从图片中提取颜色。您可以从图片中生成平铺和非平铺的颜色方案,或者轻松提取平均颜色。

要生成颜色方案,请按照以下步骤操作

常规方法
CyaneaOctopus 简写
Swift
ColorsFromImage(image, isFlatScheme)

要从图片中提取平均颜色,您也可以这样做

常规方法
Swift
UIColor(averageColorFromImage: UIImage)

👑作者

CyaneaOctopus 由 Adam McElhaney 开发于 2018 年,使用 Swift 4.2 编写。目前,由 @adammcelhaney 维护。

📝待办事项列表

  • 添加颜色柔化功能
  • 添加带色调的颜色
  • 添加互补色

🚗路线图

  • 添加“夜间模式”功能,可实时切换不同的主题。

📄变更日志

查看 Changelog.md