README.markdown

The InfinitApps Color Picker, known as InfColorPicker, is a view controller for use in iOS applications to allow the selection of a color from RGB space, but using an HSB representation of that color space to make selection of a color easier for a human.

InfColorPicker is distributed with an MIT license.

It is ARC-based and supports iPhone OS 5 and later (with one small change it could be made compatible back to iOS 4 if that's necessary).

Usage

The main component is the InfColorPickerController class, which can be instantiated and hosted in a few different ways, such as in a popover view controller for the iPad, pushed onto a navigation controller navigation stack, or presented modally on an iPhone.

The initial color can be set via the property sourceColor, which will be shown alongside the user-selected resultColor color, and these can be accessed and changed while the color picker is visible.

In order to receive the selected color(s) back from the controller, you have to have an object that implements one of the methods in the InfColorPickerControllerDelegate protocol.

Example

- (void) changeColor
{
	InfColorPickerController* picker = [ InfColorPickerController colorPickerViewController ];
	
	picker.sourceColor = self.color;
	picker.delegate = self;
	
	[ picker presentModallyOverViewController: self ];
}

- (void) colorPickerControllerDidFinish: (InfColorPickerController*) picker
{
	self.color = picker.resultColor;
	
	[ self dismissModalViewControllerAnimated: YES ];
}