andcolorpicker

Color picker library for Android

License	The Apache License, Version 2.0
Categories	IDE Development Tools
GroupId	codes.side
ArtifactId	andcolorpicker
Last Version	0.6.2
Release Date	Apr 19, 2021
Type	aar
Description	andcolorpicker Color picker library for Android
Project URL	https://github.com/side-codes/andColorPicker
Source Code Management	https://github.com/side-codes/andColorPicker/tree/master

Download andcolorpicker

Filename	Size
andcolorpicker-0.6.2.pom
andcolorpicker-0.6.2-sources.jar	33 KB

How to add to project

Apache Maven

<!-- https://jarcasting.com/artifacts/codes.side/andcolorpicker/ -->
<dependency>
    <groupId>codes.side</groupId>
    <artifactId>andcolorpicker</artifactId>
    <version>0.6.2</version>
    <type>aar</type>
</dependency>

Gradle Groovy

// https://jarcasting.com/artifacts/codes.side/andcolorpicker/
implementation 'codes.side:andcolorpicker:0.6.2'

Gradle Kotlin

// https://jarcasting.com/artifacts/codes.side/andcolorpicker/
implementation ("codes.side:andcolorpicker:0.6.2")

Apache Buildr

'codes.side:andcolorpicker:aar:0.6.2'

Apache Ivy

<dependency org="codes.side" name="andcolorpicker" rev="0.6.2">
  <artifact name="andcolorpicker" type="aar" />
</dependency>

Groovy Grape

@Grapes(
@Grab(group='codes.side', module='andcolorpicker', version='0.6.2')
)

Scala SBT

libraryDependencies += "codes.side" % "andcolorpicker" % "0.6.2"

Leiningen

[codes.side/andcolorpicker "0.6.2"]

Dependencies

runtime (5)

Group / Artifact	Type	Version
org.jetbrains.kotlin : kotlin-android-extensions-runtime	jar	1.4.32
org.jetbrains.kotlin : kotlin-stdlib-jdk7	jar	1.4.32
androidx.appcompat » appcompat	jar	1.3.0-rc01
androidx.core » core-ktx	jar	1.6.0-alpha02
androidx.constraintlayout » constraintlayout	jar	2.0.4

Project Modules

There are no modules declared in this project.

andColorPicker — Color Picker library for Android

🥑 Handy, 🐍 flexible, and ⚡ lightning-fast Android color picker views and utilities.

💊 Features

• Clean, easy-to-use components and API
• High performance
• Material styling in mind
• Standard Android SDK view family
• Wide color models support
• Tooling and utilities
• Alpha channel support
• Cutting edge tech stack
• Active development and support

🔨 Setup

Gradle dependency:

implementation "codes.side:andcolorpicker:0.6.2"

🎨 Picker types

HSL (hue, saturation, lightness)

• Add color model description

Layout XML Snippet

Basic HSL components:

<codes.side.andcolorpicker.hsl.HSLColorPickerSeekBar
  android:id="@+id/hueSeekBar"
  android:layout_width="match_parent"
  android:layout_height="wrap_content"
  app:hslColoringMode="pure"
  app:hslMode="hue" />

Supported hslMode values:

• hue (default)
• saturation
• lightness

Supported hslColoringMode values:

• pure (default)
• output

Alpha component:

<codes.side.andcolorpicker.alpha.HSLAlphaColorPickerSeekBar
  android:id="@+id/alphaSeekBar"
  android:layout_width="match_parent"
  android:layout_height="wrap_content" />

Kotlin Snippet

// Configure color model programmatically
hueSeekBar.mode = Mode.MODE_HUE // Mode.MODE_SATURATION, Mode.MODE_LIGHTNESS

// Configure coloring mode programmatically
hueSeekBar.coloringMode = ColoringMode.PURE_COLOR // ColoringMode.OUTPUT_COLOR

// Group pickers with PickerGroup to automatically synchronize color across them
val group = PickerGroup<IntegerHSLColor>().also {
  it.registerPickers(
    hueSeekBar,
    saturationSeekBar,
    lightnessSeekBar,
    alphaSeekBar
  )
}

// Get current color immediately
Log.d(
  TAG,
  "Current color is ${hueSeekBar.pickedColor}"
)

// Listen individual pickers or groups for changes
group.addListener(
  object : HSLColorPickerSeekBar.DefaultOnColorPickListener() {
    override fun onColorChanged(
      picker: ColorSeekBar<IntegerHSLColor>,
      color: IntegerHSLColor,
      value: Int
    ) {
      Log.d(
        TAG,
        "$color picked"
      )
      swatchView.setSwatchColor(
        color
      )
    }
  }
)

// Set desired color programmatically
group.setColor(
  IntegerHSLColor().also {
    it.setFromColorInt(
      Color.rgb(
        28,
        84,
        187
      )
    )
  }
)

// Set color components programmatically
hueSeekBar.progress = 50

RGB (red, green, blue)

Properties

• View name: RGBColorPickerSeekBar
• app:rgbMode for RGB component selection

LAB

Properties

• View name: LABColorPickerSeekBar
• app:labMode for LAB component selection

CMYK (cyan, magenta, yellow, key)

Properties

• View name: CMYKColorPickerSeekBar
• app:cmykMode for CMYK component selection
• app:cmykColoringMode for coloring mode selection

Supported cmykMode values:

• cyan (default)
• magenta
• yellow
• black

Supported cmykColoringMode values:

• pure (default)
• output

Swatches

SwatchView component:

<codes.side.andcolorpicker.view.swatch.SwatchView
  android:id="@+id/swatchView"
  android:layout_width="match_parent"
  android:layout_height="wrap_content" />

Kotlin Snippet:

swatchView.setSwatchPatternTint(
  Color.LTGRAY
)

swatchView.setSwatchColor(
  IntegerHSLColor().also {
    it.setFromColorInt(
      ColorUtils.setAlphaComponent(
        Color.MAGENTA,
        128
      )
    )
  }
)

📝 License

Copyright 2020 Illia Achour

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.

side.codes

We don't do that here

Versions

Version
0.6.2 Apr 19, 2021
0.6.1 Apr 18, 2021