andColorPicker — Color Picker library for Android
💊
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.5.0"
🎨
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)saturationlightness
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:rgbModefor RGB component selection
LAB
Properties
- View name:
LABColorPickerSeekBar app:labModefor LAB component selection
CMYK (cyan, magenta, yellow, key)
Properties
- View name:
CMYKColorPickerSeekBar app:cmykModefor CMYK component selectionapp:cmykColoringModefor coloring mode selection
Supported cmykMode values:
cyan(default)magentayellowblack
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.
![[BUG] android.view.InflateException: Binary XML file line #14: Binary XML file line #14: Error inflating class codes.side.andcolorpicker.hsl.HSLColorPickerSeekBar](https://avatars.githubusercontent.com/u/29142585?v=4)
45 Oct 11, 2022
0 Jan 21, 2022
216 Jan 7, 2023
35 Dec 20, 2022
43 Jun 5, 2022
270 Dec 30, 2022
34 Nov 29, 2022
0 Oct 21, 2021
145 Dec 18, 2022
230 Dec 25, 2022
24 Sep 7, 2022
45 Apr 30, 2022
197 Jan 2, 2023
37 Jul 24, 2022
53 Apr 8, 2021
279 Nov 26, 2022