Skip to content
Color cross fade utility for Android
Java
Branch: master
Clone or download
Fetching latest commit…
Cannot retrieve the latest commit at this time.
Permalink
Type Name Latest commit message Commit time
Failed to load latest commit information.
app
library
.gitignore
LICENSE
README.md
build.gradle
settings.gradle

README.md

Color Cross Fade

Simple color cross fade utility for Android. Supported types: RGB, ARGB, HSV, HSV (with alpha).

Maven Central

Introduction

The main concept of CCFAnimator is to be able to evaluate a color value that lies between two supplied colors given the fraction (.0F - 1.F). This gives ability to smoothly transition from one state to other, for example during ViewPager page changes (positionOffset value of OnPageChangeListener), during scroll changes of numerous scrolling widgets (RecyclerView, ListView, ScrollView, etc) and much more places where there is a state change & this change could be represented as a float in range .0F - 1.F.

Also, CCFAnimator could be used as a ValueAnimator, to just trigger color animations. CCFAnimator.asValueAnimator(OnNewColorListener) returns a ValueAnimator that could be further customized (animation duration, interpolation, etc).

There is an ability to animate between more than two (2) colors. Use build-in methods in CCFAnimator that takes an array (rgb, argb, hsv).

Usage

RGB

Animates between supplied colors, but ignores alpha channel

CCFAnimator.rgb(int fromColor, int toColor);
CCFAnimator.rgb(int[] colors);

ARGB

Animates between supplied colors changing a-r-g-b channels of colors

CCFAnimator.argb(int fromColor, int toColor);
CCFAnimator.argb(int[] colors);

CCFAnimator.alpha(int color, int toAlpha); // animates alpha value of one color

HSV

Animates between supplied colors changing h-s-v channels of colors

// no alpha
CCFAnimator.hsv(int fromColor, int toColor);
CCFAnimator.hsv(int[] colors);

// with alpha channel
CCFAnimator.hsv(int fromColor, int toColor, int fromAlpha, int toAlpha);

Concat

Instances of CCFAnimator of any type could be merged into one CCFAnimator. This could be helpfull when different types of color animations are used for one cross-fade animation (RGB, ARGB, HSV)

CCFAnimator.concat(
    CCFAnimator.rgb(...),
    CCFAnimator.argb(...),
    CCFAnimator.hsv(...)
);

ValueAnimator

final CCFAnimator ccf = CCFAnimator.rgb(...);
final ValueAnimator animator = ccf.asValueAnimator(new OnNewColorListener() {
    @Override
    public void onNewColor(int color) {
        // ready to use color
        mSomeView.setBackgroundColor(color);
    }
});
animator.setDuration(1000L);
animator.setInterpolator(new AccelerateInterpolator());
animator.start();

License

  Copyright 2015 Dimitry Ivanov (mail@dimitryivanov.ru)

  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.
You can’t perform that action at this time.