TextCounter
Animation of text counter
Download
Gradle:
compile 'ru.bullyboo.animation:text_counter:1.0.2'Maven:
<dependency>
<groupId>ru.bullyboo.animation</groupId>
<artifactId>text_counter</artifactId>
<version>1.0.2</version>
<type>pom</type> </dependency>Samples
Apk of Demo version
Usage
To use text counter you need to call TextCounter.newBuilder() and set properties of animation. For example:
TextCounter.newBuilder()
.setTextView(textView)
.setType(TextCounter.LONG)
.setCustomAnimation(modeBuilder)
.from(100l)
.to(1000l)
.build()
.start();
The main method of TextCounter Builder is setTextView();
, from();
, to();
and setDuration();
. It's will not working without this.
Methods
setTextView();
You need to set TextView. which will show text animaton of counter.
from();
and to();
These methods support with:
byte, short, int, float, long, double and
Byte, Short, Integer, Float, Long, Double, String You can also set Type of numbers directly, which will be used in counter. Use setType();
method for. All of them will convert to Double type!
And you can use method setRound();
to double and float types for setting round your number after decimal separator. For example:
//... from(0d). to(100d). setRound(2) //... You will have result - 100.00
setPrefix();
and setPostfix();
These methods will add to text counter usual String parameters. For example, if you want to show:"Result: 175$". You need to add setPrefix("Result: ");
and setPostfix("$");
to your builder.
Method setDuration();
does setting duration of animation.
Method setFPS();
does setting fps of animation. If you do not use this method, the text counter will use default 60 FPS.
Method setMode();
does setting mode of animation. You can use one of next modes:
LINEAR_MODE LINEAR_ACCELERATION_MODE LINEAR_DECELERATION_MODE DECELERATION_MODE DECELERATION_LINEAR_MODE DECELERATION_ACCELERATION_MODE ACCELERATION_MODE ACCELERATION_LINEAR_MODE ACCELERATION_DECELERATION_MODE LINEAR_TO_ALPHA_MODE LINEAR_FROM_ALPHA_MODE DECELERATION_TO_ALPHA_MODE DECELERATION_FROM_ALPHA_MODE ACCELERATION_TO_ALPHA_MODE ACCELERATION_FROM_ALPHA_MODE CUSTOM_MODE I belive that you can understand the meaning of ths methods from their names.
You can make to text counter automatically change fps dynamic. Use setFromFps();
and setToFps();
methods for.
Also you can use set Fps Dynamic with method setFpsDynamic();
', but be careful you need to put int array in this method.
It's absolutely same with alpha channel. You can use setFromAlpha();
and setToAlpha();
methods for. And setAlphaDynamic();
with float array.
The main method of this library is setCustomAnimation(). You need to use it with ModeConstructor.class. With this method you can create your own animation!
For example:
AnimationBuilder modeBuilder = AnimationBuilder.newBuilder()
.addPart(1000, 60)
.addPart(1000, 60, 100)
.addPart(1000, 100, AlphaBuilder.newInstance().fromAlpha(1f).toAlpha(0f))
.addPart(1000, 100, 60, AlphaBuilder.newInstance().fromAlpha(0f).toAlpha(1f))
.build();
TextCounter animator = TextCounter.newBuilder()
.setTextView(textView)
.setCustomAnimation(modeBuilder)
.from(0d)
.to(100d)
.build()
.start();
What happened here? The first method addPart();
has the first parameter duration and the second parameter fps. The second: duration, fromFps, toFps. The third: duration, fps, and AlphaBuilder, which will create alpha dynamic change. Fourth: duration, fromFps, toFps, and AlphaBuilder, which will create alpha dynamic change.
You can create everthing you want with method setCustomAnimation();
.
License
Copyright (C) 2017 BullyBoo
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.