first commit

Author: AllanHasegawa

.gitignore

@@ -0,0 +1,8 @@
+*.iml
+.gradle
+/local.properties
+/.idea
+.DS_Store
+build
+/captures
+.externalNativeBuild

LICENSE.txt

@@ -0,0 +1,7 @@
+Copyright 2019 Allan Yoshio Hasegawa
+
+Permission is hereby granted, free of charge, to any person obtaining a copy of this software and associated documentation files (the "Software"), to deal in the Software without restriction, including without limitation the rights to use, copy, modify, merge, publish, distribute, sublicense, and/or sell copies of the Software, and to permit persons to whom the Software is furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY, FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM, OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE SOFTWARE.

README.md

@@ -0,0 +1,146 @@
+# Tomo
+
+Tomo is a collection of fast image processing effects for Android.
+Its main goal is to generate dynamic content for aesthetically pleasing apps.
+
+## Showcase
+
+In this demo app we showcase a cool adaptive background being generated using
+the content of the screen:
+
+![](/docs/tomo_showcase.gif)
+
+## Using it
+
+Add the snippet below in your root `build.gradle` at the end of repositories:
+
+```
+allprojects {
+    repositories {
+        ...
+        maven { url 'https://jitpack.io' }
+    }
+}
+```
+
+Then, add the dependency to your module:
+
+```
+dependencies {
+    compile 'com.github.AllanHasegawa.Tomo:tomo:x.y.z'
+}
+```
+
+Latest release: [![Release](https://jitpack.io/v/AllanHasegawa/Tomo.svg)]
+(https://jitpack.io/#AllanHasegawa/Tomo)
+
+Initialize the library in your `Application` class:
+
+```
+class MyApp : Application {
+    override fun onCreate() {
+        Tomo.initialize(this)
+        ...
+    }
+}
+```
+
+Now you're ready to either apply the effects over `Bitmap`s or `ImageView`s:
+
+```
+val myBitmap: Bitmap = ...
+val bitmapProcessed = Tomo.applyAdaptiveBackgroundGenerator(myBitmap, darkTheme = true)
+
+val myImageView: ImageView = ...
+Tomo.applyAdaptiveBackgroundGenerator(myImageView, darkTheme = true)
+```
+
+## Built-in effects
+
+### Adaptive Background Generator
+
+<table>
+  <tr>
+    <th rowspan="2">Source Image</th>
+    <th colspan="2">Adaptive Background Generator</th>
+  </tr>
+  <tr>
+    <th>Dark Theme</th>
+    <th>Light Theme</th>
+  </tr>
+  <tr>
+    <td><img width="100" src="/docs/tsunami_original.jpg?raw=true"></td>
+    <td><img width="100" src="/docs/tsunami_adp_bg_dark.png?raw=true"></td>
+    <td><img width="100" src="/docs/tsunami_adp_bg_light.png?raw=true"></td>
+  </tr>
+  <tr>
+    <td><img width="100" src="/docs/dali_original.jpg?raw=true"></td>
+    <td><img width="100" src="/docs/dali_adp_bg_dark.png?raw=true"></td>
+    <td><img width="100" src="/docs/dali_adp_bg_light.png?raw=true"></td>
+  </tr>
+</table>
+
+## Custom effects
+
+Tomo comes equipped with a list of image transformations that can be
+arranged in any order to build cool custom effects.
+
+To transform a `Bitmap`, call `Tomo::applyCustomTransformation()`:
+
+```kotlin
+val newBitmap = Tomo.applyCustomTransformation(oldBitmap) {
+    // Scale to 1/10 of its size
+    resize(
+        newWidth = initialSize.width / 10,
+        newHeight = initialSize.height / 10
+    )
+
+    // Blur it
+    blur(radius = 25f)
+
+    // Clamp the value (from HSV)
+    valueClamp(
+        lowValue = 0.05f,
+        highValue = 0.3f,
+        saturationMultiplier = 1.3f,
+        saturationLowValue = 0f,
+        saturationHighValue = 1f
+    )
+
+    // Apply a noise overlay
+    grayNoise()
+}
+```
+
+### `resize`
+
+`resize`, as the name implies, lets you resize the bitmap.
+
+### `blur`
+
+`blur` applies a gaussian blur. It's maximum radius is `25f`.
+
+### `valueClamp`
+
+`valueClamp` clamps the value and the saturation of an image.
+It can also scale the saturation.
+
+### `grayNoise`
+
+`grayNoise` applies a gray noise over the image.
+
+### `rgbNoise`
+
+`rgbNoise` assigns a random, close, RGB color to each pixel.
+
+# License
+
+```
+Copyright 2019 Allan Yoshio Hasegawa
+
+Permission is hereby granted, free of charge, to any person obtaining a copy of this software and associated documentation files (the "Software"), to deal in the Software without restriction, including without limitation the rights to use, copy, modify, merge, publish, distribute, sublicense, and/or sell copies of the Software, and to permit persons to whom the Software is furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY, FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM, OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE SOFTWARE.
+```

build.gradle.kts

@@ -0,0 +1,27 @@
+// Top-level build file where you can add configuration options common to all sub-projects/modules.
+
+buildscript {
+    repositories {
+        google()
+        jcenter()
+    }
+    dependencies {
+        classpath("com.android.tools.build:gradle:3.3.0")
+        classpath(kotlin("gradle-plugin", version = Versions.kotlin))
+        classpath("com.github.dcendents:android-maven-gradle-plugin:2.1")
+
+        // NOTE: Do not place your application dependencies here; they belong
+        // in the individual module build.gradle.kts files
+    }
+}
+
+allprojects {
+    repositories {
+        google()
+        jcenter()
+    }
+}
+
+tasks.register("clean", Delete::class) {
+    delete(rootProject.buildDir)
+}

buildSrc/build.gradle.kts

@@ -0,0 +1,7 @@
+plugins {
+    `kotlin-dsl`
+}
+
+repositories {
+    jcenter()
+}

buildSrc/settings.gradle.kts

@@ -0,0 +1,5 @@
+object AndroidConfig {
+    const val compileSdkVersion = 28
+    const val targetSdkVersion = compileSdkVersion
+    const val minSdkVersion = 23
+}

buildSrc/src/main/java/AndroidConfig.kt

@@ -0,0 +1,43 @@
+object Dep {
+    private val v = Versions
+
+    // Kotlin
+
+    const val kotlinStd = "org.jetbrains.kotlin:kotlin-stdlib-jdk7:${v.kotlin}"
+    const val junit = "junit:junit:${v.junit}"
+    const val retrofit = "com.squareup.retrofit2:retrofit:${v.retrofit}"
+    const val retrofitMoshi = "com.squareup.retrofit2:converter-moshi:${v.retrofit}"
+
+    // Android
+
+    const val appCompat = "androidx.appcompat:appcompat:${v.appCompat}"
+    const val testRunner = "androidx.test:runner:${v.testRunner}"
+    const val espresso = "androidx.test.espresso:espresso-core:${v.espresso}"
+    const val constraintLayout = "androidx.constraintlayout:constraintlayout:${v.constraintLayout}"
+    const val picasso = "com.squareup.picasso:picasso:${v.picasso}"
+    const val groupie = "com.xwray:groupie:${v.groupie}"
+    const val groupieKt = "com.xwray:groupie-kotlin-android-extensions:${v.groupie}"
+    const val material = "com.google.android.material:material:${v.material}"
+    const val rebound = "com.facebook.rebound:rebound:${v.rebound}"
+    const val rvAnimators = "jp.wasabeef:recyclerview-animators:${v.rvAnimators}"
+}
+
+object Versions {
+    // Kotlin
+
+    const val kotlin = "1.3.20"
+    const val junit = "4.12"
+    const val retrofit = "2.5.0"
+
+    // Android
+
+    const val appCompat = "1.0.2"
+    const val material = "1.0.0"
+    const val testRunner = "1.1.1"
+    const val espresso = "3.1.1"
+    const val constraintLayout = "2.0.0-alpha3"
+    const val picasso = "2.71828"
+    const val groupie = "2.3.0"
+    const val rebound = "0.3.8"
+    const val rvAnimators = "3.0.0"
+}

buildSrc/src/main/java/Dep.kt

@@ -0,0 +1,22 @@
+object Versioning {
+    private val semantic = Semantic(
+        major = 0,
+        minor = 0,
+        patch = 1
+    )
+
+    val version = semantic.toVersion()
+}
+
+data class Version(val code: Int, val name: String)
+
+private data class Semantic(
+    val major: Int,
+    val minor: Int,
+    val patch: Int
+) {
+    fun toVersion() = Version(
+        code = major * 10_000 + minor * 100 + patch,
+        name = "$major.$minor.$patch"
+    )
+}

buildSrc/src/main/java/versioning.kt

@@ -0,0 +1,17 @@
+# Project-wide Gradle settings.
+# IDE (e.g. Android Studio) users:
+# Gradle settings configured through the IDE *will override*
+# any settings specified in this file.
+# For more details on how to configure your build environment visit
+# http://www.gradle.org/docs/current/userguide/build_environment.html
+# Specifies the JVM arguments used for the daemon process.
+# The setting is particularly useful for tweaking memory settings.
+org.gradle.jvmargs=-Xmx1536m
+# When configured, Gradle will run in incubating parallel mode.
+# This option should only be used with decoupled projects. More details, visit
+# http://www.gradle.org/docs/current/userguide/multi_project_builds.html#sec:decoupled_projects
+# org.gradle.parallel=true
+# Kotlin code style for this project: "official" or "obsolete":
+kotlin.code.style=official
+android.useAndroidX=true
+android.enableJetifier=true

docs/dali_adp_bg_dark.png

@@ -0,0 +1,5 @@
+distributionBase=GRADLE_USER_HOME
+distributionPath=wrapper/dists
+distributionUrl=https\://services.gradle.org/distributions/gradle-4.10.3-all.zip
+zipStoreBase=GRADLE_USER_HOME
+zipStorePath=wrapper/dists