├── sample ├── .gitignore ├── src │ └── main │ │ ├── res │ │ ├── values │ │ │ ├── strings.xml │ │ │ ├── ic_launcher_background.xml │ │ │ ├── colors.xml │ │ │ └── styles.xml │ │ ├── mipmap-hdpi │ │ │ ├── ic_launcher.png │ │ │ └── ic_launcher_round.png │ │ ├── mipmap-mdpi │ │ │ ├── ic_launcher.png │ │ │ └── ic_launcher_round.png │ │ ├── mipmap-xhdpi │ │ │ ├── ic_launcher.png │ │ │ └── ic_launcher_round.png │ │ ├── mipmap-xxhdpi │ │ │ ├── ic_launcher.png │ │ │ └── ic_launcher_round.png │ │ ├── mipmap-xxxhdpi │ │ │ ├── ic_launcher.png │ │ │ └── ic_launcher_round.png │ │ ├── mipmap-anydpi-v26 │ │ │ ├── ic_launcher.xml │ │ │ └── ic_launcher_round.xml │ │ ├── drawable-v24 │ │ │ └── ic_launcher_foreground.xml │ │ ├── drawable │ │ │ ├── ic_launcher_background.xml │ │ │ └── ic_launcher_foreground.xml │ │ └── layout │ │ │ └── activity_main.xml │ │ ├── AndroidManifest.xml │ │ └── java │ │ └── lv │ │ └── chi │ │ └── sample │ │ └── MainActivity.kt ├── proguard-rules.pro └── build.gradle ├── chilitextanimation ├── consumer-rules.pro ├── .gitignore ├── src │ └── main │ │ ├── AndroidManifest.xml │ │ └── java │ │ └── lv │ │ └── chi │ │ └── chilitextanimation │ │ ├── configuration │ │ ├── TextAnimationVerticalDirection.kt │ │ ├── TextAnimationHorizontalDirection.kt │ │ ├── CharacterChangeAnimationConfig.kt │ │ ├── DefaultAnimationConfig.kt │ │ └── CharacterChangeAnimation.kt │ │ ├── watchers │ │ ├── CustomAnimationTextWatcher.kt │ │ └── PredefinedAnimationTextWatcher.kt │ │ ├── CharacterAnimationExt.kt │ │ ├── span │ │ ├── PredefinedAnimationSpan.kt │ │ └── CustomAnimationSpan.kt │ │ ├── animation │ │ ├── VerticalCutCharacterAnimation.kt │ │ ├── VerticalSlideCharacterAnimation.kt │ │ ├── FadeCharacterAnimation.kt │ │ ├── HorizontalSlideCharacterAnimation.kt │ │ ├── HorizontalFlipCharacterAnimation.kt │ │ └── ShrinkCharacterAnimation.kt │ │ ├── AnimationSpan.kt │ │ └── BaseTextWatcher.kt ├── proguard-rules.pro └── build.gradle ├── images └── demo.gif ├── settings.gradle ├── gradle └── wrapper │ ├── gradle-wrapper.jar │ └── gradle-wrapper.properties ├── .gitignore ├── gradle.properties ├── gradlew.bat ├── README.md ├── gradlew └── LICENSE /sample/.gitignore: -------------------------------------------------------------------------------- 1 | /build 2 | -------------------------------------------------------------------------------- /chilitextanimation/consumer-rules.pro: -------------------------------------------------------------------------------- 1 | -------------------------------------------------------------------------------- /chilitextanimation/.gitignore: -------------------------------------------------------------------------------- 1 | /build 2 | -------------------------------------------------------------------------------- /images/demo.gif: -------------------------------------------------------------------------------- https://raw.githubusercontent.com/ChiliLabs/ChiliTextAnimation/HEAD/images/demo.gif -------------------------------------------------------------------------------- /settings.gradle: -------------------------------------------------------------------------------- 1 | rootProject.name='ChiliTextAnimation' 2 | include ':sample' 3 | include ':chilitextanimation' 4 | -------------------------------------------------------------------------------- /gradle/wrapper/gradle-wrapper.jar: -------------------------------------------------------------------------------- https://raw.githubusercontent.com/ChiliLabs/ChiliTextAnimation/HEAD/gradle/wrapper/gradle-wrapper.jar -------------------------------------------------------------------------------- /sample/src/main/res/values/strings.xml: -------------------------------------------------------------------------------- 1 | 2 | ChiliTextAnimation 3 | 4 | -------------------------------------------------------------------------------- /.gitignore: -------------------------------------------------------------------------------- 1 | *.iml 2 | .gradle 3 | /local.properties 4 | /.idea 5 | .DS_Store 6 | /build 7 | /captures 8 | .externalNativeBuild 9 | .cxx 10 | -------------------------------------------------------------------------------- /sample/src/main/res/mipmap-hdpi/ic_launcher.png: -------------------------------------------------------------------------------- https://raw.githubusercontent.com/ChiliLabs/ChiliTextAnimation/HEAD/sample/src/main/res/mipmap-hdpi/ic_launcher.png -------------------------------------------------------------------------------- /sample/src/main/res/mipmap-mdpi/ic_launcher.png: -------------------------------------------------------------------------------- https://raw.githubusercontent.com/ChiliLabs/ChiliTextAnimation/HEAD/sample/src/main/res/mipmap-mdpi/ic_launcher.png -------------------------------------------------------------------------------- /sample/src/main/res/mipmap-xhdpi/ic_launcher.png: -------------------------------------------------------------------------------- https://raw.githubusercontent.com/ChiliLabs/ChiliTextAnimation/HEAD/sample/src/main/res/mipmap-xhdpi/ic_launcher.png -------------------------------------------------------------------------------- /sample/src/main/res/mipmap-xxhdpi/ic_launcher.png: -------------------------------------------------------------------------------- https://raw.githubusercontent.com/ChiliLabs/ChiliTextAnimation/HEAD/sample/src/main/res/mipmap-xxhdpi/ic_launcher.png -------------------------------------------------------------------------------- /chilitextanimation/src/main/AndroidManifest.xml: -------------------------------------------------------------------------------- 1 | 3 | -------------------------------------------------------------------------------- /sample/src/main/res/mipmap-xxxhdpi/ic_launcher.png: -------------------------------------------------------------------------------- https://raw.githubusercontent.com/ChiliLabs/ChiliTextAnimation/HEAD/sample/src/main/res/mipmap-xxxhdpi/ic_launcher.png -------------------------------------------------------------------------------- /sample/src/main/res/mipmap-hdpi/ic_launcher_round.png: -------------------------------------------------------------------------------- https://raw.githubusercontent.com/ChiliLabs/ChiliTextAnimation/HEAD/sample/src/main/res/mipmap-hdpi/ic_launcher_round.png -------------------------------------------------------------------------------- /sample/src/main/res/mipmap-mdpi/ic_launcher_round.png: -------------------------------------------------------------------------------- https://raw.githubusercontent.com/ChiliLabs/ChiliTextAnimation/HEAD/sample/src/main/res/mipmap-mdpi/ic_launcher_round.png -------------------------------------------------------------------------------- /sample/src/main/res/mipmap-xhdpi/ic_launcher_round.png: -------------------------------------------------------------------------------- https://raw.githubusercontent.com/ChiliLabs/ChiliTextAnimation/HEAD/sample/src/main/res/mipmap-xhdpi/ic_launcher_round.png -------------------------------------------------------------------------------- /sample/src/main/res/mipmap-xxhdpi/ic_launcher_round.png: -------------------------------------------------------------------------------- https://raw.githubusercontent.com/ChiliLabs/ChiliTextAnimation/HEAD/sample/src/main/res/mipmap-xxhdpi/ic_launcher_round.png -------------------------------------------------------------------------------- /sample/src/main/res/mipmap-xxxhdpi/ic_launcher_round.png: -------------------------------------------------------------------------------- https://raw.githubusercontent.com/ChiliLabs/ChiliTextAnimation/HEAD/sample/src/main/res/mipmap-xxxhdpi/ic_launcher_round.png -------------------------------------------------------------------------------- /sample/src/main/res/values/ic_launcher_background.xml: -------------------------------------------------------------------------------- 1 | 2 | 3 | #FC3D4A 4 | -------------------------------------------------------------------------------- /chilitextanimation/src/main/java/lv/chi/chilitextanimation/configuration/TextAnimationVerticalDirection.kt: -------------------------------------------------------------------------------- 1 | package lv.chi.chilitextanimation.configuration 2 | 3 | enum class TextAnimationVerticalDirection { 4 | UP, DOWN 5 | } -------------------------------------------------------------------------------- /chilitextanimation/src/main/java/lv/chi/chilitextanimation/configuration/TextAnimationHorizontalDirection.kt: -------------------------------------------------------------------------------- 1 | package lv.chi.chilitextanimation.configuration 2 | 3 | enum class TextAnimationHorizontalDirection { 4 | LEFT, RIGHT 5 | } -------------------------------------------------------------------------------- /sample/src/main/res/values/colors.xml: -------------------------------------------------------------------------------- 1 | 2 | 3 | #FC3D4A 4 | #BF323B 5 | #000 6 | 7 | -------------------------------------------------------------------------------- /gradle/wrapper/gradle-wrapper.properties: -------------------------------------------------------------------------------- 1 | #Thu May 07 16:28:13 EEST 2020 2 | distributionBase=GRADLE_USER_HOME 3 | distributionPath=wrapper/dists 4 | zipStoreBase=GRADLE_USER_HOME 5 | zipStorePath=wrapper/dists 6 | distributionUrl=https\://services.gradle.org/distributions/gradle-5.6.4-all.zip 7 | -------------------------------------------------------------------------------- /sample/src/main/res/mipmap-anydpi-v26/ic_launcher.xml: -------------------------------------------------------------------------------- 1 | 2 | 3 | 4 | 5 | -------------------------------------------------------------------------------- /sample/src/main/res/mipmap-anydpi-v26/ic_launcher_round.xml: -------------------------------------------------------------------------------- 1 | 2 | 3 | 4 | 5 | -------------------------------------------------------------------------------- /sample/src/main/res/values/styles.xml: -------------------------------------------------------------------------------- 1 | 2 | 3 | 4 | 10 | 11 | 12 | -------------------------------------------------------------------------------- /chilitextanimation/src/main/java/lv/chi/chilitextanimation/configuration/CharacterChangeAnimationConfig.kt: -------------------------------------------------------------------------------- 1 | package lv.chi.chilitextanimation.configuration 2 | 3 | class CharacterChangeAnimationConfig { 4 | 5 | var alpha: Float = 1f 6 | var textSizeCoef: Float = 1f 7 | var charWidthCoef: Float = 1f 8 | var translationXCoef: Float = 0f 9 | var translationYCoef: Float = 0f 10 | var duration: Long = DefaultAnimationConfig.ANIMATION_DURATION 11 | } -------------------------------------------------------------------------------- /chilitextanimation/src/main/java/lv/chi/chilitextanimation/configuration/DefaultAnimationConfig.kt: -------------------------------------------------------------------------------- 1 | package lv.chi.chilitextanimation.configuration 2 | 3 | internal object DefaultAnimationConfig { 4 | 5 | const val ALPHA = 1f 6 | const val TEXT_SIZE_COEF = 1f 7 | const val CHAR_WIDTH_COEF = 1f 8 | const val TRANSLATION_X_COEF = 0f 9 | const val TRANSLATION_Y_COEF = 0f 10 | const val ANIMATION_DURATION = 1000L 11 | 12 | val VERTICAL_DIRECTION = TextAnimationVerticalDirection.UP 13 | 14 | val HORIZONTAL_DIRECTION = TextAnimationHorizontalDirection.RIGHT 15 | } -------------------------------------------------------------------------------- /chilitextanimation/src/main/java/lv/chi/chilitextanimation/configuration/CharacterChangeAnimation.kt: -------------------------------------------------------------------------------- 1 | package lv.chi.chilitextanimation.configuration 2 | 3 | import android.graphics.Canvas 4 | import android.graphics.Paint 5 | 6 | interface CharacterChangeAnimation { 7 | 8 | fun drawCharacter( 9 | canvas: Canvas, 10 | text: CharSequence, 11 | previousText: CharSequence, 12 | index: Int, 13 | fraction: Float, 14 | x: Float, 15 | y: Float, 16 | start: Int, 17 | end: Int, 18 | height: Int, 19 | paint: Paint 20 | ) 21 | } -------------------------------------------------------------------------------- /sample/src/main/AndroidManifest.xml: -------------------------------------------------------------------------------- 1 | 2 | 4 | 5 | 12 | 13 | 14 | 15 | 16 | 17 | 18 | 19 | 20 | 21 | -------------------------------------------------------------------------------- /sample/proguard-rules.pro: -------------------------------------------------------------------------------- 1 | # Add project specific ProGuard rules here. 2 | # You can control the set of applied configuration files using the 3 | # proguardFiles setting in build.gradle. 4 | # 5 | # For more details, see 6 | # http://developer.android.com/guide/developing/tools/proguard.html 7 | 8 | # If your project uses WebView with JS, uncomment the following 9 | # and specify the fully qualified class name to the JavaScript interface 10 | # class: 11 | #-keepclassmembers class fqcn.of.javascript.interface.for.webview { 12 | # public *; 13 | #} 14 | 15 | # Uncomment this to preserve the line number information for 16 | # debugging stack traces. 17 | #-keepattributes SourceFile,LineNumberTable 18 | 19 | # If you keep the line number information, uncomment this to 20 | # hide the original source file name. 21 | #-renamesourcefileattribute SourceFile 22 | -------------------------------------------------------------------------------- /chilitextanimation/proguard-rules.pro: -------------------------------------------------------------------------------- 1 | # Add project specific ProGuard rules here. 2 | # You can control the set of applied configuration files using the 3 | # proguardFiles setting in build.gradle. 4 | # 5 | # For more details, see 6 | # http://developer.android.com/guide/developing/tools/proguard.html 7 | 8 | # If your project uses WebView with JS, uncomment the following 9 | # and specify the fully qualified class name to the JavaScript interface 10 | # class: 11 | #-keepclassmembers class fqcn.of.javascript.interface.for.webview { 12 | # public *; 13 | #} 14 | 15 | # Uncomment this to preserve the line number information for 16 | # debugging stack traces. 17 | #-keepattributes SourceFile,LineNumberTable 18 | 19 | # If you keep the line number information, uncomment this to 20 | # hide the original source file name. 21 | #-renamesourcefileattribute SourceFile 22 | -------------------------------------------------------------------------------- /chilitextanimation/build.gradle: -------------------------------------------------------------------------------- 1 | apply plugin: 'com.android.library' 2 | apply plugin: 'kotlin-android' 3 | apply plugin: 'com.github.dcendents.android-maven' 4 | 5 | group='com.github.ChiliLabs' 6 | 7 | android { 8 | compileSdkVersion versions.sdk.compile 9 | buildToolsVersion versions.sdk.tools 10 | 11 | defaultConfig { 12 | minSdkVersion versions.sdk.min 13 | targetSdkVersion versions.sdk.compile 14 | versionCode versions.lib.code 15 | versionName versions.lib.name 16 | } 17 | 18 | buildTypes { 19 | release { 20 | consumerProguardFile "proguard-rules.pro" 21 | } 22 | } 23 | 24 | compileOptions { 25 | sourceCompatibility = JavaVersion.VERSION_1_8 26 | targetCompatibility = JavaVersion.VERSION_1_8 27 | } 28 | } 29 | 30 | dependencies { 31 | implementation "org.jetbrains.kotlin:kotlin-stdlib-jdk7:$kotlin_version" 32 | } 33 | -------------------------------------------------------------------------------- /chilitextanimation/src/main/java/lv/chi/chilitextanimation/watchers/CustomAnimationTextWatcher.kt: -------------------------------------------------------------------------------- 1 | package lv.chi.chilitextanimation.watchers 2 | 3 | import android.widget.TextView 4 | import lv.chi.chilitextanimation.AnimationSpan 5 | import lv.chi.chilitextanimation.BaseTextWatcher 6 | import lv.chi.chilitextanimation.configuration.CharacterChangeAnimationConfig 7 | import lv.chi.chilitextanimation.span.CustomAnimationSpan 8 | 9 | internal class CustomAnimationTextWatcher( 10 | private val config: CharacterChangeAnimationConfig, 11 | targetView: TextView 12 | ) : BaseTextWatcher(targetView, config.duration) { 13 | 14 | override fun getAnimationSpan( 15 | fraction: Float, 16 | changed: Set, 17 | letterSpacing: Float, 18 | oldText: CharSequence 19 | ): AnimationSpan = CustomAnimationSpan( 20 | config, 21 | fraction, 22 | changed, 23 | letterSpacing, 24 | oldText 25 | ) 26 | } -------------------------------------------------------------------------------- /chilitextanimation/src/main/java/lv/chi/chilitextanimation/CharacterAnimationExt.kt: -------------------------------------------------------------------------------- 1 | package lv.chi.chilitextanimation 2 | 3 | import android.widget.TextView 4 | import lv.chi.chilitextanimation.configuration.CharacterChangeAnimation 5 | import lv.chi.chilitextanimation.configuration.CharacterChangeAnimationConfig 6 | import lv.chi.chilitextanimation.configuration.DefaultAnimationConfig 7 | import lv.chi.chilitextanimation.watchers.CustomAnimationTextWatcher 8 | import lv.chi.chilitextanimation.watchers.PredefinedAnimationTextWatcher 9 | 10 | fun TextView.animateCharacterChange( 11 | animation: CharacterChangeAnimation, 12 | duration: Long = DefaultAnimationConfig.ANIMATION_DURATION 13 | ) { 14 | addTextChangedListener(PredefinedAnimationTextWatcher(animation, this, duration)) 15 | } 16 | 17 | fun TextView.animateCharacterChange(config: CharacterChangeAnimationConfig.() -> Unit) { 18 | val configuration = CharacterChangeAnimationConfig() 19 | configuration.config() 20 | addTextChangedListener(CustomAnimationTextWatcher(configuration, this)) 21 | } -------------------------------------------------------------------------------- /chilitextanimation/src/main/java/lv/chi/chilitextanimation/watchers/PredefinedAnimationTextWatcher.kt: -------------------------------------------------------------------------------- 1 | package lv.chi.chilitextanimation.watchers 2 | 3 | import android.widget.TextView 4 | import lv.chi.chilitextanimation.AnimationSpan 5 | import lv.chi.chilitextanimation.BaseTextWatcher 6 | import lv.chi.chilitextanimation.configuration.CharacterChangeAnimation 7 | import lv.chi.chilitextanimation.configuration.DefaultAnimationConfig 8 | import lv.chi.chilitextanimation.span.PredefinedAnimationSpan 9 | 10 | internal class PredefinedAnimationTextWatcher( 11 | private val animation: CharacterChangeAnimation, 12 | targetView: TextView, 13 | duration: Long = DefaultAnimationConfig.ANIMATION_DURATION 14 | ) : BaseTextWatcher(targetView, duration) { 15 | 16 | override fun getAnimationSpan( 17 | fraction: Float, 18 | changed: Set, 19 | letterSpacing: Float, 20 | oldText: CharSequence 21 | ): AnimationSpan = PredefinedAnimationSpan( 22 | animation, 23 | fraction, 24 | changed, 25 | letterSpacing, 26 | oldText 27 | ) 28 | } -------------------------------------------------------------------------------- /chilitextanimation/src/main/java/lv/chi/chilitextanimation/span/PredefinedAnimationSpan.kt: -------------------------------------------------------------------------------- 1 | package lv.chi.chilitextanimation.span 2 | 3 | import android.graphics.Canvas 4 | import android.graphics.Paint 5 | import lv.chi.chilitextanimation.AnimationSpan 6 | import lv.chi.chilitextanimation.configuration.CharacterChangeAnimation 7 | 8 | internal class PredefinedAnimationSpan( 9 | private val animation: CharacterChangeAnimation, 10 | fraction: Float, 11 | changedIndices: Set, 12 | letterSpacing: Float, 13 | previousText: CharSequence? 14 | ) : AnimationSpan(fraction, changedIndices, letterSpacing, previousText) { 15 | 16 | override fun drawCharacter( 17 | canvas: Canvas, 18 | text: CharSequence, 19 | previousText: CharSequence, 20 | index: Int, 21 | fraction: Float, 22 | x: Float, 23 | y: Float, 24 | start: Int, 25 | end: Int, 26 | height: Int, 27 | paint: Paint 28 | ) = animation.drawCharacter( 29 | canvas, 30 | text, 31 | previousText, 32 | index, 33 | fraction, 34 | x, 35 | y, 36 | start, 37 | end, 38 | height, 39 | paint 40 | ) 41 | } -------------------------------------------------------------------------------- /gradle.properties: -------------------------------------------------------------------------------- 1 | # Project-wide Gradle settings. 2 | # IDE (e.g. Android Studio) users: 3 | # Gradle settings configured through the IDE *will override* 4 | # any settings specified in this file. 5 | # For more details on how to configure your build environment visit 6 | # http://www.gradle.org/docs/current/userguide/build_environment.html 7 | # Specifies the JVM arguments used for the daemon process. 8 | # The setting is particularly useful for tweaking memory settings. 9 | org.gradle.jvmargs=-Xmx1536m 10 | # When configured, Gradle will run in incubating parallel mode. 11 | # This option should only be used with decoupled projects. More details, visit 12 | # http://www.gradle.org/docs/current/userguide/multi_project_builds.html#sec:decoupled_projects 13 | # org.gradle.parallel=true 14 | # AndroidX package structure to make it clearer which packages are bundled with the 15 | # Android operating system, and which are packaged with your app's APK 16 | # https://developer.android.com/topic/libraries/support-library/androidx-rn 17 | android.useAndroidX=true 18 | # Automatically convert third-party libraries to use AndroidX 19 | android.enableJetifier=true 20 | # Kotlin code style for this project: "official" or "obsolete": 21 | kotlin.code.style=official 22 | -------------------------------------------------------------------------------- /sample/build.gradle: -------------------------------------------------------------------------------- 1 | apply plugin: 'com.android.application' 2 | apply plugin: 'kotlin-android' 3 | apply plugin: 'kotlin-android-extensions' 4 | 5 | android { 6 | compileSdkVersion versions.sdk.compile 7 | buildToolsVersion versions.sdk.tools 8 | 9 | defaultConfig { 10 | applicationId "lv.chi.chilitextanimation" 11 | minSdkVersion versions.sdk.min 12 | targetSdkVersion versions.sdk.compile 13 | versionCode versions.lib.code 14 | versionName versions.lib.name 15 | } 16 | 17 | buildTypes { 18 | release { 19 | minifyEnabled false 20 | proguardFiles getDefaultProguardFile('proguard-android-optimize.txt'), 'proguard-rules.pro' 21 | } 22 | } 23 | 24 | compileOptions { 25 | sourceCompatibility = JavaVersion.VERSION_1_8 26 | targetCompatibility = JavaVersion.VERSION_1_8 27 | } 28 | kotlinOptions { 29 | jvmTarget = JavaVersion.VERSION_1_8.toString() 30 | } 31 | 32 | viewBinding { 33 | enabled = true 34 | } 35 | } 36 | 37 | dependencies { 38 | implementation project(":chilitextanimation") 39 | 40 | //implementation "com.github.ChiliLabs:ChiliTextAnimation:0.1.1" 41 | 42 | implementation "org.jetbrains.kotlin:kotlin-stdlib-jdk7:$versions.kotlin" 43 | implementation "androidx.appcompat:appcompat:1.1.0" 44 | implementation "androidx.core:core-ktx:1.2.0" 45 | implementation "androidx.constraintlayout:constraintlayout:1.1.3" 46 | } 47 | -------------------------------------------------------------------------------- /chilitextanimation/src/main/java/lv/chi/chilitextanimation/animation/VerticalCutCharacterAnimation.kt: -------------------------------------------------------------------------------- 1 | package lv.chi.chilitextanimation.animation 2 | 3 | import android.graphics.Canvas 4 | import android.graphics.Paint 5 | import lv.chi.chilitextanimation.configuration.CharacterChangeAnimation 6 | 7 | class VerticalCutCharacterAnimation : CharacterChangeAnimation { 8 | 9 | override fun drawCharacter( 10 | canvas: Canvas, 11 | text: CharSequence, 12 | previousText: CharSequence, 13 | index: Int, 14 | fraction: Float, 15 | x: Float, 16 | y: Float, 17 | start: Int, 18 | end: Int, 19 | height: Int, 20 | paint: Paint 21 | ) { 22 | val halfHeight = height / 2 23 | when { 24 | fraction <= 0.5 -> { 25 | if (previousText.lastIndex < index) return 26 | val yOffset = fraction * 2 * halfHeight 27 | val symbolWidth = paint.measureText(previousText, index, index + 1) 28 | 29 | val bottom = height - yOffset 30 | canvas.clipRect(x, yOffset, x + symbolWidth, bottom) 31 | canvas.drawText(previousText, index, index + 1, x, y, paint) 32 | } 33 | else -> { 34 | if (text.lastIndex < index) return 35 | val yOffset = (1 - (fraction - 0.5f) * 2) * halfHeight 36 | val symbolWidth = paint.measureText(text, index, index + 1) 37 | 38 | val bottom = height - yOffset 39 | canvas.clipRect(x, yOffset, x + symbolWidth, bottom) 40 | canvas.drawText(text, index, index + 1, x, y, paint) 41 | } 42 | } 43 | } 44 | } -------------------------------------------------------------------------------- /chilitextanimation/src/main/java/lv/chi/chilitextanimation/animation/VerticalSlideCharacterAnimation.kt: -------------------------------------------------------------------------------- 1 | package lv.chi.chilitextanimation.animation 2 | 3 | import android.graphics.Canvas 4 | import android.graphics.Paint 5 | import lv.chi.chilitextanimation.configuration.TextAnimationVerticalDirection 6 | import lv.chi.chilitextanimation.configuration.CharacterChangeAnimation 7 | import lv.chi.chilitextanimation.configuration.DefaultAnimationConfig 8 | 9 | class VerticalSlideCharacterAnimation( 10 | private val direction: TextAnimationVerticalDirection = DefaultAnimationConfig.VERTICAL_DIRECTION 11 | ) : CharacterChangeAnimation { 12 | 13 | override fun drawCharacter( 14 | canvas: Canvas, 15 | text: CharSequence, 16 | previousText: CharSequence, 17 | index: Int, 18 | fraction: Float, 19 | x: Float, 20 | y: Float, 21 | start: Int, 22 | end: Int, 23 | height: Int, 24 | paint: Paint 25 | ) { 26 | val directionUp = direction == TextAnimationVerticalDirection.UP 27 | val realY: Float 28 | val realY2: Float 29 | if (directionUp) { 30 | realY = y * (1 - fraction) 31 | realY2 = y + ((1 - fraction) * y) 32 | } else { 33 | realY = y + fraction * y 34 | realY2 = y + ((fraction - 1) * y) 35 | } 36 | if (previousText.lastIndex >= index) canvas.drawText( 37 | previousText, 38 | index, 39 | index + 1, 40 | x, 41 | realY, 42 | paint 43 | ) 44 | if (text.lastIndex >= index) canvas.drawText( 45 | text, 46 | index, 47 | index + 1, 48 | x, 49 | realY2, 50 | paint 51 | ) 52 | } 53 | } 54 | -------------------------------------------------------------------------------- /sample/src/main/res/drawable-v24/ic_launcher_foreground.xml: -------------------------------------------------------------------------------- 1 | 7 | 8 | 9 | 15 | 18 | 21 | 22 | 23 | 24 | 30 | -------------------------------------------------------------------------------- /chilitextanimation/src/main/java/lv/chi/chilitextanimation/animation/FadeCharacterAnimation.kt: -------------------------------------------------------------------------------- 1 | package lv.chi.chilitextanimation.animation 2 | 3 | import android.graphics.Canvas 4 | import android.graphics.Color 5 | import android.graphics.Paint 6 | import lv.chi.chilitextanimation.configuration.CharacterChangeAnimation 7 | 8 | class FadeCharacterAnimation : CharacterChangeAnimation { 9 | 10 | private val fadePaint = Paint() 11 | 12 | override fun drawCharacter( 13 | canvas: Canvas, 14 | text: CharSequence, 15 | previousText: CharSequence, 16 | index: Int, 17 | fraction: Float, 18 | x: Float, 19 | y: Float, 20 | start: Int, 21 | end: Int, 22 | height: Int, 23 | paint: Paint 24 | ) { 25 | fadePaint.set(paint) 26 | when { 27 | fraction <= 0.5f -> { 28 | if (previousText.lastIndex < index) return 29 | val alpha = (255 * (1 - fraction * 2)).toInt() 30 | fadePaint.color = Color.argb( 31 | alpha, 32 | Color.red(paint.color), 33 | Color.green(paint.color), 34 | Color.blue(paint.color) 35 | ) 36 | canvas.drawText( 37 | previousText, 38 | index, 39 | index + 1, 40 | x, 41 | y, 42 | fadePaint 43 | ) 44 | } 45 | else -> { 46 | if (text.lastIndex < index) return 47 | val alpha = (255 * ((fraction - 0.5) * 2)).toInt() 48 | fadePaint.color = Color.argb( 49 | alpha, 50 | Color.red(paint.color), 51 | Color.green(paint.color), 52 | Color.blue(paint.color) 53 | ) 54 | canvas.drawText(text, index, index + 1, x, y, fadePaint) 55 | } 56 | } 57 | } 58 | } 59 | -------------------------------------------------------------------------------- /chilitextanimation/src/main/java/lv/chi/chilitextanimation/animation/HorizontalSlideCharacterAnimation.kt: -------------------------------------------------------------------------------- 1 | package lv.chi.chilitextanimation.animation 2 | 3 | import android.graphics.Canvas 4 | import android.graphics.Paint 5 | import lv.chi.chilitextanimation.configuration.TextAnimationHorizontalDirection 6 | import lv.chi.chilitextanimation.configuration.CharacterChangeAnimation 7 | import lv.chi.chilitextanimation.configuration.DefaultAnimationConfig 8 | 9 | class HorizontalSlideCharacterAnimation( 10 | private val direction: TextAnimationHorizontalDirection = DefaultAnimationConfig.HORIZONTAL_DIRECTION 11 | ) : CharacterChangeAnimation { 12 | 13 | override fun drawCharacter( 14 | canvas: Canvas, 15 | text: CharSequence, 16 | previousText: CharSequence, 17 | index: Int, 18 | fraction: Float, 19 | x: Float, 20 | y: Float, 21 | start: Int, 22 | end: Int, 23 | height: Int, 24 | paint: Paint 25 | ) { 26 | val directionRight = direction == TextAnimationHorizontalDirection.RIGHT 27 | val symbolWidth = paint.measureText(text, index, index + 1) 28 | 29 | val xSlide1: Float 30 | val xSlide2: Float 31 | if (directionRight) { 32 | xSlide1 = x + symbolWidth * fraction 33 | xSlide2 = x - symbolWidth * (1 - fraction) 34 | } else { 35 | xSlide1 = x - symbolWidth * fraction 36 | xSlide2 = x + symbolWidth * (1 - fraction) 37 | } 38 | 39 | canvas.clipRect(x, y - paint.textSize, x + symbolWidth, y) 40 | 41 | if (previousText.lastIndex >= index) canvas.drawText( 42 | previousText, 43 | index, 44 | index + 1, 45 | xSlide1, 46 | y, 47 | paint 48 | ) 49 | 50 | if (text.lastIndex >= index) canvas.drawText( 51 | text, 52 | index, 53 | index + 1, 54 | xSlide2, 55 | y, 56 | paint 57 | ) 58 | 59 | } 60 | } -------------------------------------------------------------------------------- /chilitextanimation/src/main/java/lv/chi/chilitextanimation/animation/HorizontalFlipCharacterAnimation.kt: -------------------------------------------------------------------------------- 1 | package lv.chi.chilitextanimation.animation 2 | 3 | import android.graphics.Canvas 4 | import android.graphics.Paint 5 | import lv.chi.chilitextanimation.configuration.CharacterChangeAnimation 6 | 7 | class HorizontalFlipCharacterAnimation : CharacterChangeAnimation { 8 | 9 | private val scalePaint = Paint() 10 | 11 | override fun drawCharacter( 12 | canvas: Canvas, 13 | text: CharSequence, 14 | previousText: CharSequence, 15 | index: Int, 16 | fraction: Float, 17 | x: Float, 18 | y: Float, 19 | start: Int, 20 | end: Int, 21 | height: Int, 22 | paint: Paint 23 | ) { 24 | scalePaint.set(paint) 25 | val symbolHalfWidth: Float 26 | val scaleX: Float 27 | when { 28 | fraction <= 0.5f -> { 29 | if (previousText.lastIndex < index) return 30 | symbolHalfWidth = paint.measureText(previousText, index, index + 1) / 2 31 | scaleX = 1 - fraction * 2 32 | scalePaint.textScaleX = scaleX 33 | 34 | canvas.drawText( 35 | previousText, 36 | index, 37 | index + 1, 38 | x + symbolHalfWidth * (1 - scaleX), 39 | y, 40 | scalePaint 41 | ) 42 | } 43 | else -> { 44 | if (text.lastIndex < index) return 45 | symbolHalfWidth = paint.measureText(text, index, index + 1) / 2 46 | scaleX = (fraction - 0.5f) * 2 47 | scalePaint.textScaleX = scaleX 48 | 49 | canvas.drawText( 50 | text, 51 | index, 52 | index + 1, 53 | x + symbolHalfWidth * (1 - scaleX), 54 | y, 55 | scalePaint 56 | ) 57 | } 58 | } 59 | } 60 | } -------------------------------------------------------------------------------- /gradlew.bat: -------------------------------------------------------------------------------- 1 | @if "%DEBUG%" == "" @echo off 2 | @rem ########################################################################## 3 | @rem 4 | @rem Gradle startup script for Windows 5 | @rem 6 | @rem ########################################################################## 7 | 8 | @rem Set local scope for the variables with windows NT shell 9 | if "%OS%"=="Windows_NT" setlocal 10 | 11 | set DIRNAME=%~dp0 12 | if "%DIRNAME%" == "" set DIRNAME=. 13 | set APP_BASE_NAME=%~n0 14 | set APP_HOME=%DIRNAME% 15 | 16 | @rem Add default JVM options here. You can also use JAVA_OPTS and GRADLE_OPTS to pass JVM options to this script. 17 | set DEFAULT_JVM_OPTS= 18 | 19 | @rem Find java.exe 20 | if defined JAVA_HOME goto findJavaFromJavaHome 21 | 22 | set JAVA_EXE=java.exe 23 | %JAVA_EXE% -version >NUL 2>&1 24 | if "%ERRORLEVEL%" == "0" goto init 25 | 26 | echo. 27 | echo ERROR: JAVA_HOME is not set and no 'java' command could be found in your PATH. 28 | echo. 29 | echo Please set the JAVA_HOME variable in your environment to match the 30 | echo location of your Java installation. 31 | 32 | goto fail 33 | 34 | :findJavaFromJavaHome 35 | set JAVA_HOME=%JAVA_HOME:"=% 36 | set JAVA_EXE=%JAVA_HOME%/bin/java.exe 37 | 38 | if exist "%JAVA_EXE%" goto init 39 | 40 | echo. 41 | echo ERROR: JAVA_HOME is set to an invalid directory: %JAVA_HOME% 42 | echo. 43 | echo Please set the JAVA_HOME variable in your environment to match the 44 | echo location of your Java installation. 45 | 46 | goto fail 47 | 48 | :init 49 | @rem Get command-line arguments, handling Windows variants 50 | 51 | if not "%OS%" == "Windows_NT" goto win9xME_args 52 | 53 | :win9xME_args 54 | @rem Slurp the command line arguments. 55 | set CMD_LINE_ARGS= 56 | set _SKIP=2 57 | 58 | :win9xME_args_slurp 59 | if "x%~1" == "x" goto execute 60 | 61 | set CMD_LINE_ARGS=%* 62 | 63 | :execute 64 | @rem Setup the command line 65 | 66 | set CLASSPATH=%APP_HOME%\gradle\wrapper\gradle-wrapper.jar 67 | 68 | @rem Execute Gradle 69 | "%JAVA_EXE%" %DEFAULT_JVM_OPTS% %JAVA_OPTS% %GRADLE_OPTS% "-Dorg.gradle.appname=%APP_BASE_NAME%" -classpath "%CLASSPATH%" org.gradle.wrapper.GradleWrapperMain %CMD_LINE_ARGS% 70 | 71 | :end 72 | @rem End local scope for the variables with windows NT shell 73 | if "%ERRORLEVEL%"=="0" goto mainEnd 74 | 75 | :fail 76 | rem Set variable GRADLE_EXIT_CONSOLE if you need the _script_ return code instead of 77 | rem the _cmd.exe /c_ return code! 78 | if not "" == "%GRADLE_EXIT_CONSOLE%" exit 1 79 | exit /b 1 80 | 81 | :mainEnd 82 | if "%OS%"=="Windows_NT" endlocal 83 | 84 | :omega 85 | -------------------------------------------------------------------------------- /chilitextanimation/src/main/java/lv/chi/chilitextanimation/animation/ShrinkCharacterAnimation.kt: -------------------------------------------------------------------------------- 1 | package lv.chi.chilitextanimation.animation 2 | 3 | import android.graphics.Canvas 4 | import android.graphics.Paint 5 | import lv.chi.chilitextanimation.configuration.CharacterChangeAnimation 6 | 7 | class ShrinkCharacterAnimation : CharacterChangeAnimation { 8 | 9 | private val shrinkPaint = Paint() 10 | 11 | override fun drawCharacter( 12 | canvas: Canvas, 13 | text: CharSequence, 14 | previousText: CharSequence, 15 | index: Int, 16 | fraction: Float, 17 | x: Float, 18 | y: Float, 19 | start: Int, 20 | end: Int, 21 | height: Int, 22 | paint: Paint 23 | ) { 24 | shrinkPaint.set(paint) 25 | val halfHeight = height / 2 26 | when { 27 | fraction <= 0.5f -> { 28 | if (previousText.lastIndex < index) return 29 | val progress = fraction * 2 30 | shrinkPaint.textSize *= 1 - progress 31 | 32 | val originalSymbolWidth = paint.measureText(previousText, index, index + 1) 33 | val newSymbolWidth = shrinkPaint.measureText(previousText, index, index + 1) 34 | 35 | val additionalOffsetX = originalSymbolWidth * 0.5f - newSymbolWidth * 0.5f 36 | val realY = y * (1 - progress) + halfHeight * progress 37 | 38 | canvas.drawText( 39 | previousText, 40 | index, 41 | index + 1, 42 | x + additionalOffsetX, 43 | realY, 44 | shrinkPaint 45 | ) 46 | } 47 | else -> { 48 | if (text.lastIndex < index) return 49 | val progress = (fraction - 0.5f) * 2 50 | shrinkPaint.textSize *= progress 51 | 52 | val originalSymbolWidth = paint.measureText(text, index, index + 1) 53 | val newSymbolWidth = shrinkPaint.measureText(text, index, index + 1) 54 | 55 | val additionalOffsetX = originalSymbolWidth * 0.5f - newSymbolWidth * 0.5f 56 | val realY = y * progress + halfHeight * (1 - progress) 57 | 58 | canvas.drawText( 59 | text, 60 | index, 61 | index + 1, 62 | x + additionalOffsetX, 63 | realY, 64 | shrinkPaint 65 | ) 66 | } 67 | } 68 | } 69 | } -------------------------------------------------------------------------------- /chilitextanimation/src/main/java/lv/chi/chilitextanimation/AnimationSpan.kt: -------------------------------------------------------------------------------- 1 | package lv.chi.chilitextanimation 2 | 3 | import android.graphics.Canvas 4 | import android.graphics.Paint 5 | import android.text.style.ReplacementSpan 6 | 7 | internal abstract class AnimationSpan( 8 | private val fraction: Float, 9 | private val changedIndices: Set, 10 | private val letterSpacing: Float, 11 | private val previousText: CharSequence? 12 | ) : ReplacementSpan() { 13 | 14 | override fun getSize( 15 | paint: Paint, 16 | text: CharSequence?, 17 | start: Int, 18 | end: Int, 19 | fm: Paint.FontMetricsInt? 20 | ): Int { 21 | if (fm != null) { 22 | paint.getFontMetricsInt(fm) 23 | } 24 | return (paint.measureText(text, start, end) + paint.textSize * letterSpacing * (end - start)).toInt() 25 | } 26 | 27 | override fun draw( 28 | canvas: Canvas, 29 | text: CharSequence?, 30 | start: Int, 31 | end: Int, 32 | x: Float, 33 | top: Int, 34 | y: Int, 35 | bottom: Int, 36 | paint: Paint 37 | ) { 38 | val spacingOffset = (paint.textSize * letterSpacing) * 0.5f 39 | var xOffset = x 40 | if (text != null && previousText != null) { 41 | for (i in start until end) { 42 | xOffset += spacingOffset 43 | if (i in changedIndices) { 44 | canvas.save() 45 | drawCharacter( 46 | canvas, 47 | text, 48 | previousText, 49 | i, 50 | fraction, 51 | xOffset, 52 | y.toFloat(), 53 | start, 54 | end, 55 | bottom - top, 56 | paint 57 | ) 58 | canvas.restore() 59 | } else { 60 | canvas.drawText(text, i, i + 1, xOffset, y.toFloat(), paint) 61 | } 62 | xOffset += spacingOffset + paint.measureText(text, i, i + 1) 63 | } 64 | } 65 | } 66 | 67 | protected abstract fun drawCharacter( 68 | canvas: Canvas, 69 | text: CharSequence, 70 | previousText: CharSequence, 71 | index: Int, 72 | fraction: Float, 73 | x: Float, 74 | y: Float, 75 | start: Int, 76 | end: Int, 77 | height: Int, 78 | paint: Paint 79 | ) 80 | } -------------------------------------------------------------------------------- /chilitextanimation/src/main/java/lv/chi/chilitextanimation/BaseTextWatcher.kt: -------------------------------------------------------------------------------- 1 | package lv.chi.chilitextanimation 2 | 3 | import android.animation.ValueAnimator 4 | import android.text.Editable 5 | import android.text.Spannable 6 | import android.text.SpannableString 7 | import android.text.TextWatcher 8 | import android.widget.TextView 9 | 10 | internal abstract class BaseTextWatcher( 11 | private val targetView: TextView, 12 | private val duration: Long 13 | ) : TextWatcher { 14 | 15 | private var startIndex: Int = 0 16 | private var endIndex: Int = 0 17 | private var oldText: CharSequence = "" 18 | 19 | private var animator: ValueAnimator? = null 20 | 21 | private val animationUpdateListener = ValueAnimator.AnimatorUpdateListener { 22 | onAnimationUpdate(it.animatedValue as CharSequence) 23 | } 24 | 25 | override fun beforeTextChanged(s: CharSequence, start: Int, count: Int, after: Int) { 26 | oldText = s 27 | } 28 | 29 | override fun onTextChanged(s: CharSequence, start: Int, before: Int, count: Int) { 30 | startIndex = start 31 | endIndex = start + count 32 | } 33 | 34 | override fun afterTextChanged(s: Editable) { 35 | val newText = s.toString() 36 | val changed = findChangedIndices(oldText, newText) 37 | animator?.cancel() 38 | animator = ValueAnimator() 39 | animator?.duration = duration 40 | animator?.setObjectValues(oldText, newText) 41 | animator?.setEvaluator { fraction, _, _ -> 42 | SpannableString(newText) 43 | .apply { 44 | setSpan( 45 | getAnimationSpan( 46 | fraction, 47 | changed, 48 | targetView.letterSpacing, 49 | oldText 50 | ), 51 | startIndex, 52 | endIndex, 53 | Spannable.SPAN_EXCLUSIVE_EXCLUSIVE 54 | ) 55 | } 56 | } 57 | animator?.addUpdateListener(animationUpdateListener) 58 | animator?.start() 59 | } 60 | 61 | protected abstract fun getAnimationSpan( 62 | fraction: Float, 63 | changed: Set, 64 | letterSpacing: Float, 65 | oldText: CharSequence 66 | ): AnimationSpan 67 | 68 | private fun findChangedIndices(oldText: CharSequence, newText: CharSequence): Set { 69 | return if (oldText.length >= newText.length) { 70 | oldText.mapIndexedNotNull { i, c1 -> 71 | val c2 = newText.getOrNull(i) 72 | if (c2 == null || c1 == c2) null 73 | else i 74 | }.toSet() 75 | } else { 76 | newText.mapIndexedNotNull { i, c1 -> 77 | val c2 = oldText.getOrNull(i) 78 | if (c1 == c2) null 79 | else i 80 | }.toSet() 81 | } 82 | } 83 | 84 | private fun onAnimationUpdate(value: CharSequence) { 85 | targetView.removeTextChangedListener(this) 86 | targetView.text = value 87 | targetView.addTextChangedListener(this) 88 | } 89 | } 90 | -------------------------------------------------------------------------------- /sample/src/main/java/lv/chi/sample/MainActivity.kt: -------------------------------------------------------------------------------- 1 | package lv.chi.sample 2 | 3 | import android.os.Bundle 4 | import android.os.CountDownTimer 5 | import androidx.appcompat.app.AppCompatActivity 6 | import kotlinx.android.synthetic.main.activity_main.* 7 | import lv.chi.chilitextanimation.R 8 | import lv.chi.chilitextanimation.animateCharacterChange 9 | import lv.chi.chilitextanimation.animation.FadeCharacterAnimation 10 | import lv.chi.chilitextanimation.animation.HorizontalFlipCharacterAnimation 11 | import lv.chi.chilitextanimation.animation.HorizontalSlideCharacterAnimation 12 | import lv.chi.chilitextanimation.animation.ShrinkCharacterAnimation 13 | import lv.chi.chilitextanimation.animation.VerticalCutCharacterAnimation 14 | import lv.chi.chilitextanimation.animation.VerticalSlideCharacterAnimation 15 | import lv.chi.chilitextanimation.configuration.TextAnimationHorizontalDirection 16 | import lv.chi.chilitextanimation.configuration.TextAnimationVerticalDirection 17 | import java.text.SimpleDateFormat 18 | import java.util.* 19 | import java.util.concurrent.TimeUnit 20 | 21 | class MainActivity : AppCompatActivity() { 22 | 23 | private lateinit var timer: CountDownTimer 24 | 25 | private var c: Int = 0 26 | 27 | override fun onCreate(savedInstanceState: Bundle?) { 28 | super.onCreate(savedInstanceState) 29 | setContentView(R.layout.activity_main) 30 | 31 | container.setOnClickListener { 32 | //setText(c++.toString()) 33 | } 34 | 35 | timer = object : CountDownTimer(TimeUnit.HOURS.toMillis(1), TimeUnit.SECONDS.toMillis(1)) { 36 | 37 | override fun onFinish() { 38 | setText("") 39 | } 40 | 41 | override fun onTick(millisUntilFinished: Long) { 42 | val date = Date(millisUntilFinished) 43 | val formatter = SimpleDateFormat("HH:mm:ss", Locale.getDefault()) 44 | setText(formatter.format(date)) 45 | } 46 | } 47 | 48 | text_holder1.animateCharacterChange(FadeCharacterAnimation()) 49 | text_holder2.animateCharacterChange(VerticalSlideCharacterAnimation()) 50 | text_holder3.animateCharacterChange(VerticalSlideCharacterAnimation(direction = TextAnimationVerticalDirection.DOWN)) 51 | text_holder4.animateCharacterChange(ShrinkCharacterAnimation()) 52 | text_holder5.animateCharacterChange(HorizontalSlideCharacterAnimation()) 53 | text_holder6.animateCharacterChange(HorizontalSlideCharacterAnimation(direction = TextAnimationHorizontalDirection.LEFT)) 54 | text_holder7.animateCharacterChange(HorizontalFlipCharacterAnimation()) 55 | text_holder8.animateCharacterChange(VerticalCutCharacterAnimation()) 56 | 57 | text_holder9.animateCharacterChange { 58 | alpha = 0f 59 | //textSizeCoef = 0f 60 | charWidthCoef = 0f 61 | translationXCoef = 1f 62 | //translationYCoef = 1f 63 | //duration = 1000L 64 | } 65 | } 66 | 67 | private fun setText(text: String) { 68 | text_holder1.text = text 69 | text_holder2.text = text 70 | text_holder3.text = text 71 | text_holder4.text = text 72 | text_holder5.text = text 73 | text_holder6.text = text 74 | text_holder7.text = text 75 | text_holder8.text = text 76 | text_holder9.text = text 77 | } 78 | 79 | override fun onStop() { 80 | super.onStop() 81 | timer.cancel() 82 | } 83 | 84 | override fun onStart() { 85 | super.onStart() 86 | timer.start() 87 | } 88 | } 89 | -------------------------------------------------------------------------------- /README.md: -------------------------------------------------------------------------------- 1 | # ChiliTextAnimation 2 | 3 | Made with ❤️ by [Chili Labs](https://chililabs.io). 4 | 5 | Easy customizable animated text change library. 6 | 7 | * Implemented as extension methods for TextView so it can be easily integrated into existing projects 8 | * Bundles 6 pre-defined [animations](https://github.com/ChiliLabs/ChiliTextAnimation/tree/master/chilitextanimation/src/main/java/lv/chi/chilitextanimation/animation) 9 | * Provides easy way to use complex animations simply by [configuring properties](https://github.com/ChiliLabs/ChiliTextAnimation/blob/master/chilitextanimation/src/main/java/lv/chi/chilitextanimation/configuration/CharacterChangeAnimationConfig.kt) 10 | * Provides possibility to write you own animation by implementing [CharacterChangeAnimation](https://github.com/ChiliLabs/ChiliTextAnimation/blob/master/chilitextanimation/src/main/java/lv/chi/chilitextanimation/configuration/CharacterChangeAnimation.kt) 11 | 12 | 13 | 14 | ## Setup 15 | 16 | Gradle: 17 | 18 | Add Jitpack to your root `build.gradle` file: 19 | 20 | ``` 21 | allprojects { 22 | repositories { 23 | ... 24 | maven { url "https://jitpack.io" } 25 | ... 26 | } 27 | } 28 | ``` 29 | 30 | Add dependency to application `build.gradle` file, where `x.y.z` is the latest [release version](https://github.com/ChiliLabs/ChiliTextAnimation/releases): 31 | 32 | [![](https://jitpack.io/v/ChiliLabs/ChiliTextAnimation.svg)](https://jitpack.io/#ChiliLabs/ChiliTextAnimation) 33 | 34 | ``` 35 | implementation "com.github.ChiliLabs:ChiliTextAnimation:x.y.z" 36 | ``` 37 | 38 | ## Usage 39 | 40 | ### Pre-defined animations 41 | 42 | Call `animateCharacterChange` with preferred animation and duration in milliseconds. 43 | * `animation` - required. Pre-defined animation or your [CharacterChangeAnimation](https://github.com/ChiliLabs/ChiliTextAnimation/blob/master/chilitextanimation/src/main/java/lv/chi/chilitextanimation/configuration/CharacterChangeAnimation.kt) implementation 44 | * `duration` - not required. Animation duration, default value - 1 second 45 | 46 | ```kotlin 47 | textView.animateCharacterChange( 48 | animation = FadeCharacterAnimation(), 49 | duration = 500L 50 | ) 51 | ``` 52 | 53 | ### Custom animations 54 | 55 | Call `animateCharacterChange` overload with lambda and specify animation [configuration](https://github.com/ChiliLabs/ChiliTextAnimation/blob/master/chilitextanimation/src/main/java/lv/chi/chilitextanimation/configuration/CharacterChangeAnimationConfig.kt) 56 | 57 | | Property | Recommended value | Default value | Description | 58 | |:----------------:|:-----------------:|:---------:|:---------------------------------------------:| 59 | | `alpha` | 0f..1f | 1f | End value for character to be replaced, start value for new character | 60 | | `textSizeCoef` | 0f..1f | 1f | `newTextSize = textSize * textSizeCoef`. End value for character to be replaced, start value for new character | 61 | | `charWidthCoef` | 0f..1f | 1f | `textScaleX = charWidthCoef` End value for character to be replaced, start value for new character | 62 | |`translationXCoef`| -1f..1f | 0f | `xOffset = symbolWidth * translationXCoef`. Positive value - slide right, negative - left | 63 | |`translationYCoef`| -1f..1f | 0f | `yOffset = height * translationYCoef`. Positive value - slide up, negative - down | 64 | | `duration` | N | 1000L | Animation duration in milliseconds | 65 | 66 | But despite the recommendations, you definitely should play around with property values to get some extraordinary animations 67 | 68 | ```kotlin 69 | textView.animateCharacterChange { 70 | alpha = 0f 71 | charWidthCoef = 0f 72 | translationXCoef = 1f 73 | duration = 1000L 74 | } 75 | ``` 76 | 77 | ## License 78 | 79 | ``` 80 | Copyright 2020 Chili Labs 81 | 82 | Licensed under the Apache License, Version 2.0 (the "License"); 83 | you may not use this file except in compliance with the License. 84 | You may obtain a copy of the License at 85 | 86 | http://www.apache.org/licenses/LICENSE-2.0 87 | 88 | Unless required by applicable law or agreed to in writing, software 89 | distributed under the License is distributed on an "AS IS" BASIS, 90 | WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. 91 | See the License for the specific language governing permissions and 92 | limitations under the License. 93 | ``` 94 | -------------------------------------------------------------------------------- /gradlew: -------------------------------------------------------------------------------- 1 | #!/usr/bin/env sh 2 | 3 | ############################################################################## 4 | ## 5 | ## Gradle start up script for UN*X 6 | ## 7 | ############################################################################## 8 | 9 | # Attempt to set APP_HOME 10 | # Resolve links: $0 may be a link 11 | PRG="$0" 12 | # Need this for relative symlinks. 13 | while [ -h "$PRG" ] ; do 14 | ls=`ls -ld "$PRG"` 15 | link=`expr "$ls" : '.*-> \(.*\)$'` 16 | if expr "$link" : '/.*' > /dev/null; then 17 | PRG="$link" 18 | else 19 | PRG=`dirname "$PRG"`"/$link" 20 | fi 21 | done 22 | SAVED="`pwd`" 23 | cd "`dirname \"$PRG\"`/" >/dev/null 24 | APP_HOME="`pwd -P`" 25 | cd "$SAVED" >/dev/null 26 | 27 | APP_NAME="Gradle" 28 | APP_BASE_NAME=`basename "$0"` 29 | 30 | # Add default JVM options here. You can also use JAVA_OPTS and GRADLE_OPTS to pass JVM options to this script. 31 | DEFAULT_JVM_OPTS="" 32 | 33 | # Use the maximum available, or set MAX_FD != -1 to use that value. 34 | MAX_FD="maximum" 35 | 36 | warn () { 37 | echo "$*" 38 | } 39 | 40 | die () { 41 | echo 42 | echo "$*" 43 | echo 44 | exit 1 45 | } 46 | 47 | # OS specific support (must be 'true' or 'false'). 48 | cygwin=false 49 | msys=false 50 | darwin=false 51 | nonstop=false 52 | case "`uname`" in 53 | CYGWIN* ) 54 | cygwin=true 55 | ;; 56 | Darwin* ) 57 | darwin=true 58 | ;; 59 | MINGW* ) 60 | msys=true 61 | ;; 62 | NONSTOP* ) 63 | nonstop=true 64 | ;; 65 | esac 66 | 67 | CLASSPATH=$APP_HOME/gradle/wrapper/gradle-wrapper.jar 68 | 69 | # Determine the Java command to use to start the JVM. 70 | if [ -n "$JAVA_HOME" ] ; then 71 | if [ -x "$JAVA_HOME/jre/sh/java" ] ; then 72 | # IBM's JDK on AIX uses strange locations for the executables 73 | JAVACMD="$JAVA_HOME/jre/sh/java" 74 | else 75 | JAVACMD="$JAVA_HOME/bin/java" 76 | fi 77 | if [ ! -x "$JAVACMD" ] ; then 78 | die "ERROR: JAVA_HOME is set to an invalid directory: $JAVA_HOME 79 | 80 | Please set the JAVA_HOME variable in your environment to match the 81 | location of your Java installation." 82 | fi 83 | else 84 | JAVACMD="java" 85 | which java >/dev/null 2>&1 || die "ERROR: JAVA_HOME is not set and no 'java' command could be found in your PATH. 86 | 87 | Please set the JAVA_HOME variable in your environment to match the 88 | location of your Java installation." 89 | fi 90 | 91 | # Increase the maximum file descriptors if we can. 92 | if [ "$cygwin" = "false" -a "$darwin" = "false" -a "$nonstop" = "false" ] ; then 93 | MAX_FD_LIMIT=`ulimit -H -n` 94 | if [ $? -eq 0 ] ; then 95 | if [ "$MAX_FD" = "maximum" -o "$MAX_FD" = "max" ] ; then 96 | MAX_FD="$MAX_FD_LIMIT" 97 | fi 98 | ulimit -n $MAX_FD 99 | if [ $? -ne 0 ] ; then 100 | warn "Could not set maximum file descriptor limit: $MAX_FD" 101 | fi 102 | else 103 | warn "Could not query maximum file descriptor limit: $MAX_FD_LIMIT" 104 | fi 105 | fi 106 | 107 | # For Darwin, add options to specify how the application appears in the dock 108 | if $darwin; then 109 | GRADLE_OPTS="$GRADLE_OPTS \"-Xdock:name=$APP_NAME\" \"-Xdock:icon=$APP_HOME/media/gradle.icns\"" 110 | fi 111 | 112 | # For Cygwin, switch paths to Windows format before running java 113 | if $cygwin ; then 114 | APP_HOME=`cygpath --path --mixed "$APP_HOME"` 115 | CLASSPATH=`cygpath --path --mixed "$CLASSPATH"` 116 | JAVACMD=`cygpath --unix "$JAVACMD"` 117 | 118 | # We build the pattern for arguments to be converted via cygpath 119 | ROOTDIRSRAW=`find -L / -maxdepth 1 -mindepth 1 -type d 2>/dev/null` 120 | SEP="" 121 | for dir in $ROOTDIRSRAW ; do 122 | ROOTDIRS="$ROOTDIRS$SEP$dir" 123 | SEP="|" 124 | done 125 | OURCYGPATTERN="(^($ROOTDIRS))" 126 | # Add a user-defined pattern to the cygpath arguments 127 | if [ "$GRADLE_CYGPATTERN" != "" ] ; then 128 | OURCYGPATTERN="$OURCYGPATTERN|($GRADLE_CYGPATTERN)" 129 | fi 130 | # Now convert the arguments - kludge to limit ourselves to /bin/sh 131 | i=0 132 | for arg in "$@" ; do 133 | CHECK=`echo "$arg"|egrep -c "$OURCYGPATTERN" -` 134 | CHECK2=`echo "$arg"|egrep -c "^-"` ### Determine if an option 135 | 136 | if [ $CHECK -ne 0 ] && [ $CHECK2 -eq 0 ] ; then ### Added a condition 137 | eval `echo args$i`=`cygpath --path --ignore --mixed "$arg"` 138 | else 139 | eval `echo args$i`="\"$arg\"" 140 | fi 141 | i=$((i+1)) 142 | done 143 | case $i in 144 | (0) set -- ;; 145 | (1) set -- "$args0" ;; 146 | (2) set -- "$args0" "$args1" ;; 147 | (3) set -- "$args0" "$args1" "$args2" ;; 148 | (4) set -- "$args0" "$args1" "$args2" "$args3" ;; 149 | (5) set -- "$args0" "$args1" "$args2" "$args3" "$args4" ;; 150 | (6) set -- "$args0" "$args1" "$args2" "$args3" "$args4" "$args5" ;; 151 | (7) set -- "$args0" "$args1" "$args2" "$args3" "$args4" "$args5" "$args6" ;; 152 | (8) set -- "$args0" "$args1" "$args2" "$args3" "$args4" "$args5" "$args6" "$args7" ;; 153 | (9) set -- "$args0" "$args1" "$args2" "$args3" "$args4" "$args5" "$args6" "$args7" "$args8" ;; 154 | esac 155 | fi 156 | 157 | # Escape application args 158 | save () { 159 | for i do printf %s\\n "$i" | sed "s/'/'\\\\''/g;1s/^/'/;\$s/\$/' \\\\/" ; done 160 | echo " " 161 | } 162 | APP_ARGS=$(save "$@") 163 | 164 | # Collect all arguments for the java command, following the shell quoting and substitution rules 165 | eval set -- $DEFAULT_JVM_OPTS $JAVA_OPTS $GRADLE_OPTS "\"-Dorg.gradle.appname=$APP_BASE_NAME\"" -classpath "\"$CLASSPATH\"" org.gradle.wrapper.GradleWrapperMain "$APP_ARGS" 166 | 167 | # by default we should be in the correct project dir, but when run from Finder on Mac, the cwd is wrong 168 | if [ "$(uname)" = "Darwin" ] && [ "$HOME" = "$PWD" ]; then 169 | cd "$(dirname "$0")" 170 | fi 171 | 172 | exec "$JAVACMD" "$@" 173 | -------------------------------------------------------------------------------- /sample/src/main/res/drawable/ic_launcher_background.xml: -------------------------------------------------------------------------------- 1 | 2 | 7 | 10 | 15 | 20 | 25 | 30 | 35 | 40 | 45 | 50 | 55 | 60 | 65 | 70 | 75 | 80 | 85 | 90 | 95 | 100 | 105 | 110 | 115 | 120 | 125 | 130 | 135 | 140 | 145 | 150 | 155 | 160 | 165 | 170 | 171 | -------------------------------------------------------------------------------- /chilitextanimation/src/main/java/lv/chi/chilitextanimation/span/CustomAnimationSpan.kt: -------------------------------------------------------------------------------- 1 | package lv.chi.chilitextanimation.span 2 | 3 | import android.graphics.Canvas 4 | import android.graphics.Color 5 | import android.graphics.Paint 6 | import lv.chi.chilitextanimation.AnimationSpan 7 | import lv.chi.chilitextanimation.configuration.CharacterChangeAnimationConfig 8 | import lv.chi.chilitextanimation.configuration.DefaultAnimationConfig.ALPHA 9 | import lv.chi.chilitextanimation.configuration.DefaultAnimationConfig.CHAR_WIDTH_COEF 10 | import lv.chi.chilitextanimation.configuration.DefaultAnimationConfig.TEXT_SIZE_COEF 11 | import lv.chi.chilitextanimation.configuration.DefaultAnimationConfig.TRANSLATION_X_COEF 12 | import lv.chi.chilitextanimation.configuration.DefaultAnimationConfig.TRANSLATION_Y_COEF 13 | 14 | internal class CustomAnimationSpan( 15 | private val config: CharacterChangeAnimationConfig, 16 | fraction: Float, 17 | changedIndices: Set, 18 | letterSpacing: Float, 19 | previousText: CharSequence? 20 | ) : AnimationSpan(fraction, changedIndices, letterSpacing, previousText) { 21 | 22 | private val oldTextPaint = Paint() 23 | private val newTextPaint = Paint() 24 | 25 | private val translation = Offsets() 26 | private val textSizeOffsets = Offsets() 27 | private val scaleOffsets = Offsets() 28 | 29 | override fun drawCharacter( 30 | canvas: Canvas, 31 | text: CharSequence, 32 | previousText: CharSequence, 33 | index: Int, 34 | fraction: Float, 35 | x: Float, 36 | y: Float, 37 | start: Int, 38 | end: Int, 39 | height: Int, 40 | paint: Paint 41 | ) { 42 | oldTextPaint.set(paint) 43 | newTextPaint.set(paint) 44 | 45 | translation.clear() 46 | textSizeOffsets.clear() 47 | scaleOffsets.clear() 48 | 49 | val animateOld: Boolean = fraction <= 0.5f 50 | val progress = if (animateOld) { 51 | fraction * 2 52 | } else { 53 | (fraction - 0.5f) * 2 54 | } 55 | 56 | val symbolWidth = paint.measureText(text, index, index + 1) 57 | canvas.clipRect(x, 0f, x + symbolWidth, height.toFloat()) 58 | 59 | calculateAndSetAlpha(animateOld, progress, paint, oldTextPaint, newTextPaint) 60 | calculateAndSetTextSize( 61 | animateOld, 62 | progress, 63 | paint, 64 | oldTextPaint, 65 | newTextPaint, 66 | height, 67 | y, 68 | previousText, 69 | text, 70 | index, 71 | textSizeOffsets 72 | ) 73 | calculateAndSetScaleX( 74 | animateOld, 75 | progress, 76 | oldTextPaint, 77 | newTextPaint, 78 | previousText, 79 | text, 80 | index, 81 | scaleOffsets 82 | ) 83 | 84 | calculateAndSetTranslation(fraction, symbolWidth, y, translation) 85 | 86 | if (previousText.lastIndex >= index) canvas.drawText( 87 | previousText, 88 | index, 89 | index + 1, 90 | x + translation.oldXOffset + textSizeOffsets.oldXOffset + scaleOffsets.oldXOffset, 91 | y.toFloat() + translation.oldYOffset + textSizeOffsets.oldYOffset + scaleOffsets.oldYOffset, 92 | oldTextPaint 93 | ) 94 | 95 | if (text.lastIndex >= index) canvas.drawText( 96 | text, 97 | index, 98 | index + 1, 99 | x + translation.newXOffset + textSizeOffsets.newXOffset + scaleOffsets.newXOffset, 100 | y.toFloat() + translation.newYOffset + textSizeOffsets.newYOffset + scaleOffsets.newYOffset, 101 | newTextPaint 102 | ) 103 | } 104 | 105 | private fun calculateAndSetAlpha( 106 | animateOld: Boolean, 107 | progress: Float, 108 | sourcePaint: Paint, 109 | oldTextPaint: Paint, 110 | newTextPaint: Paint 111 | ) { 112 | if (config.alpha == ALPHA) return 113 | val oldAlpha: Float = 114 | if (!animateOld) 0f 115 | else 255 * (ALPHA - (ALPHA - config.alpha) * progress) 116 | val newAlpha: Float = 117 | if (animateOld) 0f 118 | else 255 * (ALPHA - (ALPHA - config.alpha) * (1 - progress)) 119 | 120 | val red = Color.red(sourcePaint.color) 121 | val green = Color.green(sourcePaint.color) 122 | val blue = Color.blue(sourcePaint.color) 123 | 124 | oldTextPaint.color = Color.argb( 125 | oldAlpha.toInt(), 126 | red, 127 | green, 128 | blue 129 | ) 130 | newTextPaint.color = Color.argb( 131 | newAlpha.toInt(), 132 | red, 133 | green, 134 | blue 135 | ) 136 | } 137 | 138 | private fun calculateAndSetTextSize( 139 | animateOld: Boolean, 140 | progress: Float, 141 | sourcePaint: Paint, 142 | oldTextPaint: Paint, 143 | newTextPaint: Paint, 144 | height: Int, 145 | y: Float, 146 | oldText: CharSequence, 147 | newText: CharSequence, 148 | index: Int, 149 | offsets: Offsets 150 | ) { 151 | if (config.textSizeCoef == TEXT_SIZE_COEF) return 152 | val oldTextSizeCoef: Float = 153 | if (!animateOld) 0f 154 | else TEXT_SIZE_COEF - (TEXT_SIZE_COEF - config.textSizeCoef) * progress 155 | val newTextSizeCoef: Float = 156 | if (animateOld) 0f 157 | else TEXT_SIZE_COEF - (TEXT_SIZE_COEF - config.textSizeCoef) * (1 - progress) 158 | 159 | oldTextPaint.textSize = sourcePaint.textSize * oldTextSizeCoef 160 | newTextPaint.textSize = sourcePaint.textSize * newTextSizeCoef 161 | 162 | var originalOldSymbolWidth = 0f 163 | var oldSymbolWidth = 0f 164 | if (oldText.lastIndex >= index) { 165 | originalOldSymbolWidth = sourcePaint.measureText(oldText, index, index + 1) 166 | oldSymbolWidth = oldTextPaint.measureText(oldText, index, index + 1) 167 | } 168 | 169 | var originalNewSymbolWidth = 0f 170 | var newSymbolWidth = 0f 171 | if (newText.lastIndex >= index) { 172 | originalNewSymbolWidth = sourcePaint.measureText(newText, index, index + 1) 173 | newSymbolWidth = newTextPaint.measureText(newText, index, index + 1) 174 | } 175 | 176 | val halfHeight = height / 2 177 | val oldXOffset = originalOldSymbolWidth * 0.5f - oldSymbolWidth * 0.5f 178 | val newXOffset = originalNewSymbolWidth * 0.5f - newSymbolWidth * 0.5f 179 | val oldYOffset = (y * (1 - progress) + halfHeight * progress) - y 180 | val newYOffset = (y * progress + halfHeight * (1 - progress)) - y 181 | 182 | offsets.set(oldXOffset, newXOffset, oldYOffset, newYOffset) 183 | } 184 | 185 | private fun calculateAndSetScaleX( 186 | animateOld: Boolean, 187 | progress: Float, 188 | oldTextPaint: Paint, 189 | newTextPaint: Paint, 190 | oldText: CharSequence, 191 | newText: CharSequence, 192 | index: Int, 193 | offsets: Offsets 194 | ) { 195 | if (config.charWidthCoef == CHAR_WIDTH_COEF) return 196 | val oldTextScaleX = 197 | if (!animateOld) 0f 198 | else CHAR_WIDTH_COEF - (CHAR_WIDTH_COEF - config.charWidthCoef) * progress 199 | val newTextScaleX = 200 | if (animateOld) 0f 201 | else CHAR_WIDTH_COEF - (CHAR_WIDTH_COEF - config.charWidthCoef) * (1 - progress) 202 | 203 | var oldSymbolHalfWidth = 0f 204 | var newSymbolHalfWidth = 0f 205 | if (oldText.lastIndex >= index) { 206 | oldSymbolHalfWidth = oldTextPaint.measureText(oldText, index, index + 1) / 2 207 | } 208 | if (newText.lastIndex >= index) { 209 | newSymbolHalfWidth = newTextPaint.measureText(newText, index, index + 1) / 2 210 | } 211 | 212 | oldTextPaint.textScaleX = oldTextScaleX 213 | newTextPaint.textScaleX = newTextScaleX 214 | 215 | offsets.set( 216 | oldX = oldSymbolHalfWidth * (1 - oldTextScaleX), 217 | newX = newSymbolHalfWidth * (1 - newTextScaleX) 218 | ) 219 | } 220 | 221 | private fun calculateAndSetTranslation(progress: Float, symbolWidth: Float, y: Float, offsets: Offsets) { 222 | val oldXOffsetCoef = TRANSLATION_X_COEF - (TRANSLATION_X_COEF - config.translationXCoef) * progress 223 | val newXOffsetCoef = TRANSLATION_X_COEF - (TRANSLATION_X_COEF - config.translationXCoef) * (1 - progress) 224 | val oldYOffsetCoef = TRANSLATION_Y_COEF - (TRANSLATION_Y_COEF - config.translationYCoef) * progress 225 | val newYOffsetCoef = TRANSLATION_Y_COEF - (TRANSLATION_Y_COEF - config.translationYCoef) * (1 - progress) 226 | 227 | offsets.set( 228 | symbolWidth * oldXOffsetCoef, 229 | -symbolWidth * newXOffsetCoef, 230 | -y * oldYOffsetCoef, 231 | y * newYOffsetCoef 232 | ) 233 | } 234 | 235 | private class Offsets( 236 | var oldXOffset: Float = 0f, 237 | var newXOffset: Float = 0f, 238 | 239 | var oldYOffset: Float = 0f, 240 | var newYOffset: Float = 0f 241 | ) { 242 | fun clear() { 243 | oldXOffset = 0f 244 | newXOffset = 0f 245 | oldYOffset = 0f 246 | newYOffset = 0f 247 | } 248 | 249 | fun set(oldX: Float? = null, newX: Float? = null, oldY: Float? = null, newY: Float? = null) { 250 | oldX?.let { oldXOffset = it } 251 | newX?.let { newXOffset = it } 252 | oldY?.let { oldYOffset = it } 253 | newY?.let { newYOffset = it } 254 | } 255 | } 256 | } -------------------------------------------------------------------------------- /sample/src/main/res/layout/activity_main.xml: -------------------------------------------------------------------------------- 1 | 2 | 9 | 10 | 11 | 21 | 22 | 34 | 35 | 36 | 46 | 47 | 59 | 60 | 61 | 71 | 72 | 84 | 85 | 86 | 96 | 97 | 109 | 110 | 111 | 121 | 122 | 134 | 135 | 136 | 146 | 147 | 159 | 160 | 161 | 171 | 172 | 184 | 185 | 186 | 196 | 197 | 209 | 210 | 211 | 221 | 222 | 234 | 235 | -------------------------------------------------------------------------------- /sample/src/main/res/drawable/ic_launcher_foreground.xml: -------------------------------------------------------------------------------- 1 | 6 | 8 | 11 | 15 | 16 | 17 | -------------------------------------------------------------------------------- /LICENSE: -------------------------------------------------------------------------------- 1 | Apache License 2 | Version 2.0, January 2004 3 | http://www.apache.org/licenses/ 4 | 5 | TERMS AND CONDITIONS FOR USE, REPRODUCTION, AND DISTRIBUTION 6 | 7 | 1. Definitions. 8 | 9 | "License" shall mean the terms and conditions for use, reproduction, 10 | and distribution as defined by Sections 1 through 9 of this document. 11 | 12 | "Licensor" shall mean the copyright owner or entity authorized by 13 | the copyright owner that is granting the License. 14 | 15 | "Legal Entity" shall mean the union of the acting entity and all 16 | other entities that control, are controlled by, or are under common 17 | control with that entity. For the purposes of this definition, 18 | "control" means (i) the power, direct or indirect, to cause the 19 | direction or management of such entity, whether by contract or 20 | otherwise, or (ii) ownership of fifty percent (50%) or more of the 21 | outstanding shares, or (iii) beneficial ownership of such entity. 22 | 23 | "You" (or "Your") shall mean an individual or Legal Entity 24 | exercising permissions granted by this License. 25 | 26 | "Source" form shall mean the preferred form for making modifications, 27 | including but not limited to software source code, documentation 28 | source, and configuration files. 29 | 30 | "Object" form shall mean any form resulting from mechanical 31 | transformation or translation of a Source form, including but 32 | not limited to compiled object code, generated documentation, 33 | and conversions to other media types. 34 | 35 | "Work" shall mean the work of authorship, whether in Source or 36 | Object form, made available under the License, as indicated by a 37 | copyright notice that is included in or attached to the work 38 | (an example is provided in the Appendix below). 39 | 40 | "Derivative Works" shall mean any work, whether in Source or Object 41 | form, that is based on (or derived from) the Work and for which the 42 | editorial revisions, annotations, elaborations, or other modifications 43 | represent, as a whole, an original work of authorship. For the purposes 44 | of this License, Derivative Works shall not include works that remain 45 | separable from, or merely link (or bind by name) to the interfaces of, 46 | the Work and Derivative Works thereof. 47 | 48 | "Contribution" shall mean any work of authorship, including 49 | the original version of the Work and any modifications or additions 50 | to that Work or Derivative Works thereof, that is intentionally 51 | submitted to Licensor for inclusion in the Work by the copyright owner 52 | or by an individual or Legal Entity authorized to submit on behalf of 53 | the copyright owner. For the purposes of this definition, "submitted" 54 | means any form of electronic, verbal, or written communication sent 55 | to the Licensor or its representatives, including but not limited to 56 | communication on electronic mailing lists, source code control systems, 57 | and issue tracking systems that are managed by, or on behalf of, the 58 | Licensor for the purpose of discussing and improving the Work, but 59 | excluding communication that is conspicuously marked or otherwise 60 | designated in writing by the copyright owner as "Not a Contribution." 61 | 62 | "Contributor" shall mean Licensor and any individual or Legal Entity 63 | on behalf of whom a Contribution has been received by Licensor and 64 | subsequently incorporated within the Work. 65 | 66 | 2. Grant of Copyright License. Subject to the terms and conditions of 67 | this License, each Contributor hereby grants to You a perpetual, 68 | worldwide, non-exclusive, no-charge, royalty-free, irrevocable 69 | copyright license to reproduce, prepare Derivative Works of, 70 | publicly display, publicly perform, sublicense, and distribute the 71 | Work and such Derivative Works in Source or Object form. 72 | 73 | 3. Grant of Patent License. Subject to the terms and conditions of 74 | this License, each Contributor hereby grants to You a perpetual, 75 | worldwide, non-exclusive, no-charge, royalty-free, irrevocable 76 | (except as stated in this section) patent license to make, have made, 77 | use, offer to sell, sell, import, and otherwise transfer the Work, 78 | where such license applies only to those patent claims licensable 79 | by such Contributor that are necessarily infringed by their 80 | Contribution(s) alone or by combination of their Contribution(s) 81 | with the Work to which such Contribution(s) was submitted. If You 82 | institute patent litigation against any entity (including a 83 | cross-claim or counterclaim in a lawsuit) alleging that the Work 84 | or a Contribution incorporated within the Work constitutes direct 85 | or contributory patent infringement, then any patent licenses 86 | granted to You under this License for that Work shall terminate 87 | as of the date such litigation is filed. 88 | 89 | 4. Redistribution. You may reproduce and distribute copies of the 90 | Work or Derivative Works thereof in any medium, with or without 91 | modifications, and in Source or Object form, provided that You 92 | meet the following conditions: 93 | 94 | (a) You must give any other recipients of the Work or 95 | Derivative Works a copy of this License; and 96 | 97 | (b) You must cause any modified files to carry prominent notices 98 | stating that You changed the files; and 99 | 100 | (c) You must retain, in the Source form of any Derivative Works 101 | that You distribute, all copyright, patent, trademark, and 102 | attribution notices from the Source form of the Work, 103 | excluding those notices that do not pertain to any part of 104 | the Derivative Works; and 105 | 106 | (d) If the Work includes a "NOTICE" text file as part of its 107 | distribution, then any Derivative Works that You distribute must 108 | include a readable copy of the attribution notices contained 109 | within such NOTICE file, excluding those notices that do not 110 | pertain to any part of the Derivative Works, in at least one 111 | of the following places: within a NOTICE text file distributed 112 | as part of the Derivative Works; within the Source form or 113 | documentation, if provided along with the Derivative Works; or, 114 | within a display generated by the Derivative Works, if and 115 | wherever such third-party notices normally appear. The contents 116 | of the NOTICE file are for informational purposes only and 117 | do not modify the License. You may add Your own attribution 118 | notices within Derivative Works that You distribute, alongside 119 | or as an addendum to the NOTICE text from the Work, provided 120 | that such additional attribution notices cannot be construed 121 | as modifying the License. 122 | 123 | You may add Your own copyright statement to Your modifications and 124 | may provide additional or different license terms and conditions 125 | for use, reproduction, or distribution of Your modifications, or 126 | for any such Derivative Works as a whole, provided Your use, 127 | reproduction, and distribution of the Work otherwise complies with 128 | the conditions stated in this License. 129 | 130 | 5. Submission of Contributions. Unless You explicitly state otherwise, 131 | any Contribution intentionally submitted for inclusion in the Work 132 | by You to the Licensor shall be under the terms and conditions of 133 | this License, without any additional terms or conditions. 134 | Notwithstanding the above, nothing herein shall supersede or modify 135 | the terms of any separate license agreement you may have executed 136 | with Licensor regarding such Contributions. 137 | 138 | 6. Trademarks. This License does not grant permission to use the trade 139 | names, trademarks, service marks, or product names of the Licensor, 140 | except as required for reasonable and customary use in describing the 141 | origin of the Work and reproducing the content of the NOTICE file. 142 | 143 | 7. Disclaimer of Warranty. Unless required by applicable law or 144 | agreed to in writing, Licensor provides the Work (and each 145 | Contributor provides its Contributions) on an "AS IS" BASIS, 146 | WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or 147 | implied, including, without limitation, any warranties or conditions 148 | of TITLE, NON-INFRINGEMENT, MERCHANTABILITY, or FITNESS FOR A 149 | PARTICULAR PURPOSE. You are solely responsible for determining the 150 | appropriateness of using or redistributing the Work and assume any 151 | risks associated with Your exercise of permissions under this License. 152 | 153 | 8. Limitation of Liability. In no event and under no legal theory, 154 | whether in tort (including negligence), contract, or otherwise, 155 | unless required by applicable law (such as deliberate and grossly 156 | negligent acts) or agreed to in writing, shall any Contributor be 157 | liable to You for damages, including any direct, indirect, special, 158 | incidental, or consequential damages of any character arising as a 159 | result of this License or out of the use or inability to use the 160 | Work (including but not limited to damages for loss of goodwill, 161 | work stoppage, computer failure or malfunction, or any and all 162 | other commercial damages or losses), even if such Contributor 163 | has been advised of the possibility of such damages. 164 | 165 | 9. Accepting Warranty or Additional Liability. While redistributing 166 | the Work or Derivative Works thereof, You may choose to offer, 167 | and charge a fee for, acceptance of support, warranty, indemnity, 168 | or other liability obligations and/or rights consistent with this 169 | License. However, in accepting such obligations, You may act only 170 | on Your own behalf and on Your sole responsibility, not on behalf 171 | of any other Contributor, and only if You agree to indemnify, 172 | defend, and hold each Contributor harmless for any liability 173 | incurred by, or claims asserted against, such Contributor by reason 174 | of your accepting any such warranty or additional liability. 175 | 176 | END OF TERMS AND CONDITIONS 177 | 178 | APPENDIX: How to apply the Apache License to your work. 179 | 180 | To apply the Apache License to your work, attach the following 181 | boilerplate notice, with the fields enclosed by brackets "[]" 182 | replaced with your own identifying information. (Don't include 183 | the brackets!) The text should be enclosed in the appropriate 184 | comment syntax for the file format. We also recommend that a 185 | file or class name and description of purpose be included on the 186 | same "printed page" as the copyright notice for easier 187 | identification within third-party archives. 188 | 189 | Copyright 2020 Chili Labs 190 | 191 | Licensed under the Apache License, Version 2.0 (the "License"); 192 | you may not use this file except in compliance with the License. 193 | You may obtain a copy of the License at 194 | 195 | http://www.apache.org/licenses/LICENSE-2.0 196 | 197 | Unless required by applicable law or agreed to in writing, software 198 | distributed under the License is distributed on an "AS IS" BASIS, 199 | WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. 200 | See the License for the specific language governing permissions and 201 | limitations under the License. 202 | --------------------------------------------------------------------------------