ReColor
An Android library that tries to do cool stuff with colors.
Usage
Add this to your gradle file:
implementation 'com.simmorsal.recolor:recolor:1.1.0'methods
stable: * setViewBackgroundColor() * setCardViewColor() * setTextViewColor() * setImageButtonColorFilter() * setImageViewColorFilter() * setStatusBarColor() * setNavigationBarColor() * pulseStatusBar() * pulseNavigationBar() * stop() * getColorIntArray() * getColorHEXList() * setOnReColorFinish() experimental: * setMenuIconColor()
Explanations:
-
setViewBackgroundColor():
changes the background color of any View you give it:
setViewBackground(view, startingColor, endingColor, duration);
// usage:
ReColor reColor = new ReColor(context);
reColor.setViewBackgroundColor(view, "FFFFFF", "#AA000000", 400);
// or like this:
new ReColor(context).setViewBackgroundColor(view, "#FFFFFF", "AA000000", 400);-
setCardViewColor():
changes CardView color:
new ReColor(context).setCardViewColor(cardView, startingColor, endingColor, duration);
// usage:
new ReColor(context).setCardViewColor(cardView, "FFFFFF", "000000", 300);-
setTextViewColor():
changes TextView color:
new ReColor(context).setTextViewColor(textView, startingColor, endingColor, duration);
// usage:
new ReColor(context).setTextViewColor(textView, "FFFFFF", "000000", 300);-
setImageButtonColorFilter():
changes ImageButton's color filter:
new ReColor(context).setImageButtonColorFilter(imageButton, startingColor, endingColor, duration);
// usage:
new ReColor(context).setImageButtonColorFilter(imageButton, "FFFFFF", "000000", 300);-
setImageViewColorFilter():
changes ImageView's color filter:
new ReColor(context).setImageViewColorFilter(imageView, startingColor, endingColor, duration);
// usage:
new ReColor(context).setImageViewColorFilter(imageView, "FFFFFF", "000000", 300);-
setStatusBarColor():
changes Status Bar color. you can pass null as startingColor so it would be automatically retrieved from status bar itself:
new ReColor(context).setStatusBarColor(startingColor, endingColor, duration);
// usage:
new ReColor(context).setStatusBarColor(null, "000000", 300);
// or:
new ReColor(context).setStatusBarColor("FFFFFF", "000000", 300);-
setNavigationBarColor():
changes Navigation Bar color. like the status bar, you can pass null as startingColor so it would be retrieved automatically:
new ReColor(context).setNavigationBarColor(startingColor, endingColor, duration);
// usage:
new ReColor(context).setNavigationBarColor(null, "000000", 300);
// or
new ReColor(context).setNavigationBarColor("FFFFFF", "000000", 300);-
pulseStatusBar():
this method pulses the status bar color to the pulseColor, pulseCount times, each pulse taking pulseSpeed milliseconds:
new ReColor(context).pulseStatusBar(pulseColor, pulseSpeed, pulseCount);
//usage:
new ReColor(context).pulseStatusBar("FFFFFF", 100, 4);-
pulseNavigationBar():
just like pulseStatusBar(), but on Navigation Bar:
new ReColor(context).pulseNavigationBar(pulseColor, pulseSpeed, palseCount);
//usage:
new ReColor(context).pulseNavigationBar("FFFFFF", 150, 5);-
stop():
this method stops a reColoring on any of the above methods, and also returns the last color set by that particular ReColor object, in any of the above methods:
ReColor reColor = new ReColor(context);
reColor.Stop();
// usage:
// Consider a LinearLayout's background being reColored
ReColor reColor = new ReColor(context)
.setViewBackgroundColor(linearLayout, "FFFFFF", "000000", 2000);
// now you want to stop reColoring when a button is clicked
// (i also store the returned value)
@OnClick{
String lastColor = reColor.stop();
// now i want to use the returned color to start reColoring to a new color
reColor.setViewBackgroundColor(linearLayout, lastColor, "9C27B0", 500);
}-
getColorHEXList():
returns a List<String> of HEX color values between startingColor and endingColor with a List length of listLength, so you can use it in your code:
new ReColor(context).getColorHEXList(startingColor, endingColor, listLength);
// usage:
List<String> colorList = new ReColor(context)
.getColorHEXList("FFFFFF", "000000", 100);-
getColorIntArray():
returns an int[] of color-int values between startingColor and endingColor with a List length of listLength, so you can use it in your code:
new ReColor(context).getColorIntArray(startingColor, endingColor, listLength);
// usage:
int[] colorList = new ReColor(context)
.getColorIntArray("FFFFFF", "000000", 100);-
setOnReColorFinish():
you can implement this on a ReColor object to get notified when reColoring finishes:
ReColor reColor = new ReColor(context);
reColor.setViewBackgroundColor(view, "FFFFFF", "000000", 1000);
reColor.setOnReColorFinish(new OnReColorFinish() {
@Override
public void onFinish() {
Log.i(TAG, "reColoring finished");
}
});
// or
new ReColor(context)
.setViewBackgroundColor(view, "FFFFFF", "000000", 1000)
.setOnReColorFinish(new OnReColorFinish() {
@Override
public void onFinish() {
Log.i(TAG, "reColoring finished");
}
});Experimental methods:
-
setMenuIconColor():
changes MenuIcon of a MenuItem color:
new ReColor(context).setMenuIconColor(menuItem, startingColor, endingColor, duration);this method is experimental because while it's reColoring a MenuIcon, the menu becomes unresponsive to touch. So the best way to use it is to give it a duration of 200 or less. and if you're simulating pulsing, wait a bit before the next pulse begins. this is my implementation of pulsing:
MenuItem menuItem = navigationBarMenu.getItem(0);
final String startColor = "c60055", endColor = "40c4ff";
Handler handler = new Handler().post(new Runnable() {
@Override
public void run() {
new ReColor().setMenuIconColor(menuItem, startColor, endColor, 100)
.setOnReColorFinish(new OnReColorFinish() {
@Override
public void onFinish() {
new ReColor().setMenuIconColor(menuItem, endColor, startColor, 100)
.setOnReColorFinish(new OnReColorFinish() {
@Override
public void onFinish() {
handler.postDelayed(this, 1500);
}
});
}
});
}
};
}Important notes
-
ONLY reColor one widget per object of ReColor class. In other words, DO NOT create one object of ReColor class and use it to reColor multiple widgets - at least at the same time.
-
you can pass color values in any of the following formats:
"RRGGBB"-"AARRGGBB"-"#RRGGBB"-"#AARRGGBB"