A simple UIColor category to get color with hex code.

Related tags

Overview

TFTColor

A simple UIColor library to get UIColor object from RGB hex string/value, CMYK hex string/value or CMYK base component values. You can also retrieve back RGB hex string/value, CMYK hex string/value.

Features

Convert RGB Hex String/Value to UIColor
Convert CMYK Hex String/Value to UIColor
Get RGB Hex String/Value from UIColor
Get CMYK Hex String/Value from UIColor
Initialize CMYK from its base components

The beautiful part of this library is that you can input Hex values with #, 0x or 0X and the it will take care of this.
Also you can input hex value of any length and this will be handled.
The library also takes care of non-hex characters.

Supporting Formats for RGB Hex Strings:

#B
#BB
#RGB
#GGBB
#RGGBB
#RRGGBB

Supporting Formats for CMYK Hex Strings:

#K
#KK
#YKK
#CMYK
#MYYKK
#MMYYKK
#CMMYYKK
#CCMMYYKK

Requirements

iOS 8.0+
Xcode 7.3+

Installation

CocoaPods

You can use CocoaPods to install TFTColor by adding it to your Podfile:

platform :ios, '9.0'
use_frameworks!

target 'YourApp' do
    pod 'TFTColor'
end

Then, run the following command:

$ pod install

Manually

Swift

Download and drop TFTColor.swift in your project.

Objective-C

Download and drop TFTColor.h & TFTColor.m in your project.
Congratulations!

Usage example

Swift

import TFTColor

// UIColor from RGB Hex String
UIColor(rgbHexString: "FF34AE", alpha: 1.0)
UIColor(rgbHexString: "#ea", alpha: 1.0)

// UIColor from RGB Hex Value
UIColor(rgbHexValue: 0xFF34AE alpha: 1.0)

// RGB Hex String from UIColor
let redColor = UIColor.redColor
redColor.rgbHexString //"FF0000"

// RGB Hex Value from UIColor
redColor.rgbHexValue //0xFF0000

// UIColor from CMYK component values 
// Creates and returns a color object using the specified opacity and CMYK component values.
// The components of the color object, specified as a value from 0.0 to 1.0.
UIColor(cyan:0.5, magenta: 0.5, yellow: 0.5, black: 0.5, alpha: 1.0)

// UIColor from CMYK Hex String
UIColor(cmykHexString: "FF34AE34", alpha:1.0)
UIColor(cmykHexString: "#ea", alpha:1.0)

// UIColor from CMYK Hex Value
UIColor(cmykHexValue: 0xFF34AE34 alpha:1.0)

// CMYK Hex String from UIColor
redColor.cmykHexString //"00646400"

// CMYK Hex Value from UIColor
redColor.cmykHexValue //0x00646400

Objective-C

// UIColor from RGB Hex String
[UIColor colorWithRGBHexString:@"FF34AE" alpha:1.0f];
[UIColor colorWithRGBHexString:@"#ea" alpha:1.0f];

// UIColor from RGB Hex Value
[UIColor colorWithRGBHexValue:0xFF34AE alpha:1.0f];
 
// RGB Hex String from UIColor
[UIColor rgbHexStringForColor:[UIColor redColor]]; //@"FF0000"
 
// RGB Hex Value from UIColor
[UIColor rgbHexValueForColor:[UIColor redColor]]; //0xFF0000

// UIColor from CMYK component values
// Creates and returns a color object using the specified opacity and CMYK component values.
// The components of the color object, specified as a value from 0.0 to 1.0.
[UIColor colorWithCyan:0.5f magenta:0.5 yellow:0.5f black:0.5f alpha:1.0f];

// UIColor from CMYK Hex String
[UIColor colorWithCMYKHexString:@"FF34AE34" alpha:1.0f];
[UIColor colorWithCMYKHexString:@"#EA" alpha:1.0f]; 

// UIColor from CMYK Hex Value
[UIColor colorWithCMYKHexValue:0xFF34AE34 alpha:1.0f];

// CMYK Hex String from UIColor
[UIColor cmykHexStringForColor:[UIColor redColor]]; //"00646400" 

// CMYK Hex Value from UIColor
[UIColor cmykHexValueForColor:[UIColor redColor]]; //0x00646400

Contribute

We would love for you to contribute to TFTColor, check the LICENSE file for more info.

Meta

Burhanuddin Sunelwala – @burhanuddin353 – [email protected]

Distributed under the The MIT License (MIT) license. See LICENSE for more information.

https://github.com/burhanuddin353/TFTColor

You might also like...

SheetyColors is an action sheet styled color picker for iOS

📱 Based on UIAlertController: The SheetyColors API is based on UIKit's UIAlertController. Simply add buttons to it as you would for any other Action Sheet by defining UIAlertAction instances. Therefore, it nicely integrates with the look & feel of all other native system dialogs. However, you can also chose to use the color picker it self without an action sheet.

102 Nov 10, 2022

A tool to calculate the color ratio of UIImage in iOS.

Comments

Installation Section

Hey, your library is really interesting.

The only problem I found was the README.md, which lacks an Installation Section I created this iOS Open source Readme Template so you can take a look on how to easily create an Installation Section If you want, I can help you to organize the lib.

What are your thoughts? 😄

opened by lfarah 1