Color picker for Android
Java
Switch branches/tags
Nothing to show
Clone or download
Fetching latest commit…
Cannot retrieve the latest commit at this time.
Permalink
Failed to load latest commit information.
res Added MultiColorPicker. Jul 29, 2013
src/com/chiralcode/colorpicker Added MultiColorPicker. Jul 29, 2013
.gitattributes Added usage examples. Jul 29, 2013
.gitignore Added usage examples. Jul 29, 2013
AndroidManifest.xml Added MultiColorPicker. Jul 29, 2013
README.md Added MultiColorPicker. Jul 29, 2013
license.txt Added usage examples. Jul 29, 2013
project.properties

README.md

Color Picker for Android

Easy to use, fully functional color picker with compact design based on HSV color model. Project consists two main classes which can be easily extended and suited to user requirements.

  • ColorPicker.java - basic color picker which allows user to pick a single color

Screenshot 1 Screenshot 2 Screenshot 3

  • MultiColorPicker.java - color picker implementation which allows user to pick multiple colors with adjacent hue value

Screenshot 1 Screenshot 2 Screenshot 3

Usage

Color Picker has been implemented as an extension of a View class. This gives a possibility to use it as any other Android component. Following are the most basic usage examples.

In activity

Color Picker can be put in layout xml file just like any other component.

<com.chiralcode.colorpicker.ColorPicker
    android:id="@+id/colorPicker"
    android:layout_width="wrap_content"
    android:layout_height="wrap_content" />

Example can be found in ColorPickerActivity.java file.

In dialog

Using Color Picker in dialog requires extending AlertDialog class. Listener interface OnColorSelectedListener is required to return selected color value back to the caller.

    ColorPickerDialog colorPickerDialog = new ColorPickerDialog(this, initialColor, new OnColorSelectedListener() {

        @Override
        public void onColorSelected(int color) {
            // do action
        }

    });
    colorPickerDialog.show();

See ColorPickerDialog.java for working sample.

In preference

Color Picker can be used also on Preferece Screen. Usage is the same as for any other preferences. You can provide default, initial color value by setting android:defaultValue attribute. Value selected in dialog will be stored under the key provided with android:key attribute.

<com.chiralcode.colorpicker.ColorPickerPreference
    android:defaultValue="0xffffffff"
    android:key="preferenceKeyName"
    android:title="@string/pref_name"
    android:summary="@string/pref_summary" />

Provided demo implementation extends DialogPreference. See ColorPickerPreference.java.

License

Code is licensed under the Apache License, Version 2.0.