Ecosyste.ms: Awesome
An open API service indexing awesome lists of open source software.
https://github.com/LarsWerkman/Lobsterpicker
A great material designed colorpicker by Marie Schweiz
https://github.com/LarsWerkman/Lobsterpicker
Last synced: 2 months ago
JSON representation
A great material designed colorpicker by Marie Schweiz
- Host: GitHub
- URL: https://github.com/LarsWerkman/Lobsterpicker
- Owner: LarsWerkman
- License: apache-2.0
- Created: 2014-11-03T21:07:35.000Z (about 10 years ago)
- Default Branch: master
- Last Pushed: 2016-07-11T14:02:54.000Z (over 8 years ago)
- Last Synced: 2024-11-23T02:33:22.038Z (2 months ago)
- Language: Java
- Size: 80.1 KB
- Stars: 533
- Watchers: 19
- Forks: 65
- Open Issues: 14
-
Metadata Files:
- Readme: README.md
- License: LICENSE
Awesome Lists containing this project
- awesome-android-ui - https://github.com/LarsWerkman/Lobsterpicker
- awesome-android-ui - https://github.com/LarsWerkman/Lobsterpicker
README
# Lobsterpicker
Designed by Marie Schweiz, Developed by Lars Werkman
Lobsterpicker is a library for android material design made to support apps and developers if a color should be choosen by a user. The library is offering a dialog with all shades of material design colors. Give it a try and download our demo app via google play
## How you can use it:
Include one or multiple of the views inside of you layout:
```xml
```
## summary of options
* color wheel you prefer (wheel only)
* color wheel and a before and after circle in the middle
* color wheel and a slider for switching between different color spaces
* color wheel, a slider for the colorspace and the opacity
* slider only, toggle for 5 different shades you define
* slider only and opacity
#### color wheel you prefer (wheel only)
```java
LobsterPicker lobsterPicker = (LobsterPicker) findViewById(R.id.lobsterpicker);
//To retrieve the selected color use
lobsterPicker.getColor();
//You'r also able to add a listener
lobsterPicker.addOnColorListener(new OnColorListener() {
@Override
public void onColorChanged(@ColorInt int color) {
}
@Override
public void onColorSelected(@ColorInt int color) {
}
});
```
#### color wheel and a before and after circle in the middle
By default this is disabled your able to enable it in xml
```xml
app:color_history_enabled="true"
```
Or in Java
```java
LobsterPicker lobsterPicker = (LobsterPicker) findViewById(R.id.lobsterpicker);
//To enable to color feedback use
lobsterPicker.setColorHistoryEnabled(true);
//To set a previous picked color or reference color use
lobsterPicker.setHistory(Color.RED);
```
#### color wheel and a slider for switching between different color spaces
To connect a slider to the color wheel use
```java
LobsterPicker lobsterPicker = (LobsterPicker) findViewById(R.id.lobsterpicker);
LobsterShadeSlider shadeSlider = (LobsterShadeSlider) findViewById(R.id.shadeslider);
//To connect them
lobsterpicker.addDecorator(shadeSlider);
```
All sliders implement the `ColorDecorator` interface, which enables them to manipulate the user selected color.
Important to notice is the sequence you add decorators, because the first decorator that is added will be the first to manipulate the color.
#### color wheel, a slider for the colorspace and the opacity
To connect both the `LobsterShadeSlider` and `LobsterOpacitySlider` isn't any diffent then the previous mentioned method
```java
LobsterPicker lobsterPicker = (LobsterPicker) findViewById(R.id.lobsterpicker);
LobsterShadeSlider shadeSlider = (LobsterShadeSlider) findViewById(R.id.shadeslider);
LobsterOpacitySlider opacitySlider = (LobsterOpacitySlider) findViewById(R.id.opacityslider);
//To connect them
lobsterpicker.addDecorator(shadeSlider);
lobsterpicker.addDecorator(opacitySlider);
```
#### slider only, toggle for 5 different shades you define
The `LobsterShadeSlider` can also be used as a standalone color selector.
```java
//To retrieve to color is the same mehtod used for the LobsterPicker
shadeSlider.getColor();
```
To use your own colors this can be done by implementing the `ColorAdapter` interface.
Or use the existing `BitmapColorAdapter` which takes a Drawable as color source.
```java
lobsterPicker.setColorAdapter(new BitmapColorAdapter(this, R.drawable.default_shader_pallete));
```
#### slider only and opacity
Just like for the `LobsterPicker` you have to add the opacity slider as a decorator
```java
LobsterShadeSlider shadeSlider = (LobsterShadeSlider) findViewById(R.id.shadeslider);
LobsterOpacitySlider opacitySlider = (LobsterOpacitySlider) findViewById(R.id.opacityslider);
//To connect them
shadeSlider.addDecorator(opacitySlider);
```
## Download
Maven:
```xml
com.larswerkman
lobsterpicker
1.0.1
```
Gradle:
```groovy
compile 'com.larswerkman:lobsterpicker:1.0.1'
```
## License
```license
Copyright (C) 2015 Marie Schweiz & Lars Werkman
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.
```
## Credits
This library is written and developed by Lars Werkman. For feedback, requests and collaboration please use Github or write us.
Lars Werkman
Freelance android developer
[email protected]
Marie Schweiz
Freelance android designer
[email protected]