Home

Awesome

Multi-ColorPicker

API License <br> You can get colors from your gallery pictures or custom images just using touch with multi-selectors.

gif0

Examples

gif1 example2-2

Including in your project

build.gradle

repositories {
    mavenCentral() // or jcenter() works as well
}

dependencies {
    implementation "com.github.skydoves:multicolorpicker:1.0.8"
}

or Maven

<dependency>
  <groupId>com.github.skydoves</groupId>
  <artifactId>multicolorpicker</artifactId>
  <version>1.0.8</version>
</dependency>

How to use

You can use like using just ImageView and you can get colors from any images.

Add XML Namespace

First add below XML Namespace inside your XML layout file.

xmlns:app="http://schemas.android.com/apk/res-auto"

ColorPickerView in layout

<com.skydoves.multicolorpicker.MultiColorPickerView
        android:id="@+id/multiColorPickerView"
        android:layout_width="300dp"
        android:layout_height="300dp"
        app:palette="@drawable/palette"/>

Attribute in xml

app:palette="@drawable/palette" // set palette image

get Colors from Listener

multiColorPickerView.addSelector(selectorDrawable, new ColorListener() {
            @Override
            public void onColorSelected(ColorEnvelope envelope) {
                int color = envelope.getColor();
                int[] rgb = envelope.getRgb();
                String htmlCode = envelope.getHtmlCode();

                // TODO
            }
        });

MultiColorPickerView Methods

MethodsReturnDescription
addSelector(Drawable drawable, ColorListener listener)Selectoradds a Selector and returning it
setPaletteDrawable(Drawable drawable)voidchanges palette's drawable
getMixedColor(Float ratio(0~1))voidreturns mixed color from selectors seleted color
setSelectedAlpha(Float ratio(0~1)voidsets active selector's alpha
getSelectorsSize()intreturns selectors size
setFlagView(FlagView flagView)voidsets a FlagView on colorpicker
setFlagMode(FlagMode flagmode)voidsets FlagMode(Always, Last, None)
setFlagFlipable(boolean flipable)voidsets flag's flip-able when flag go over top boundary

Selector Methods

MethodsReturnDescription
getX()intreturns selector's X axis
getY()intreturns selector's Y axis
getColor()intreturns the selector's selected color
getColorHtml()Stringreturns the selector's selected color html code
getColorRGB()int[3]returns the selector's selected color rgb array
onMove(int x, int y)voidmoves the selector's point
onMoveCenter()voidmoves the selector's point to center
onSelect()voidselects point at selector's position (used with onMove())
onSelect(int x, int y)voidmoves and selects point

License

Copyright 2017 skydoves

Licensed under the Apache License, Version 2.0 (the "License");
you may not use this file except in compliance with the License.
You may obtain a copy of the License at

   http://www.apache.org/licenses/LICENSE-2.0

Unless required by applicable law or agreed to in writing, software
distributed under the License is distributed on an "AS IS" BASIS,
WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
See the License for the specific language governing permissions and
limitations under the License.