Multi-ColorPicker

Additional

Language
Kotlin
Version
N/A
Created
Oct 21, 2017
Updated
Sep 26, 2018 (Retired)
Owner
Jaewoong Eum (skydoves)
Contributor
Jaewoong Eum (skydoves)
1
Activity
Badge
Generate
Download
Source code

Multi-ColorPicker


You can get colors from your gallery pictures or custom images just using touch with multi-selectors.

Examples

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

Methods Return Description
addSelector(Drawable drawable, ColorListener listener) Selector adds a Selector and returning it
setPaletteDrawable(Drawable drawable) void changes palette's drawable
getMixedColor(Float ratio(0~1)) void returns mixed color from selectors seleted color
setSelectedAlpha(Float ratio(0~1) void sets active selector's alpha
getSelectorsSize() int returns selectors size
setFlagView(FlagView flagView) void sets a FlagView on colorpicker
setFlagMode(FlagMode flagmode) void sets FlagMode(Always, Last, None)
setFlagFlipable(boolean flipable) void sets flag's flip-able when flag go over top boundary

Selector Methods

Methods Return Description
getX() int returns selector's X axis
getY() int returns selector's Y axis
getColor() int returns the selector's selected color
getColorHtml() String returns the selector's selected color html code
getColorRGB() int[3] returns the selector's selected color rgb array
onMove(int x, int y) void moves the selector's point
onMoveCenter() void moves the selector's point to center
onSelect() void selects point at selector's position (used with onMove())
onSelect(int x, int y) void moves 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.