RandomKolor
Inspired by David Merfield's randomColor.js. You can use the library to generate attractive random colors on Android apps.
This project comes with a sample app which demonstrates some of the functionality:
Installation
The library is hosted on JitPack
- Add it in your root
build.gradle
at the end of repositories:
allprojects {
repositories {
...
maven { url 'https://jitpack.io' }
}
}
- Add the dependency
dependencies {
implementation 'com.github.brian-norman:RandomKolor:1.0'
}
Options
hue
โ Controls the hue of the generated color. You can pass in a color:Color.RED
,Color.ORANGE
,Color.YELLOW
,Color.Green
,Color.BLUE
,Color.Purple
,Color.PINK
andColor.MONOCHROME
are currently supported.luminosity
โ Controls the luminosity of the generated color. Library supports:Luminosity.RANDOM
,Luminosity.BRIGHT
,Luminosity.LIGHT
,Luminosity.DARK
count
โ An integer which specifies the number of colors to generate.
API
fun randomColor(hue: Hue = RandomHue, luminosity: Luminosity = Luminosity.RANDOM, format: Format = Format.RGB): String
fun randomColors(count: Int, hue: Hue = RandomHue, luminosity: Luminosity = Luminosity.RANDOM, format: Format = Format.RGB): List<String>
Examples
// Generate an attractive RGB randomly
val rgbString = RandomKolor().randomColor()
// Generate a light blue RGB
val rgbString = RandomKolor().randomColor(hue = ColorHue(BLUE), luminosity = Luminosity.LIGHT)
// Generate three light blue oranges
val rgbStrings = RandomKolor().randomColors(count = 3, hue = ColorHue(ORANGE), luminosity = Luminosity.LIGHT)
Acknowledgements
- David Merfield's original library
- Wei Wang's swift port RandomColorSwift
TODO
- Currently only RGB is supported, would like to support other formats
- Add alpha to RGB