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"