identikon
1.0.0indexedGenerates recognizable identicons from hash values, serving as privacy-protecting avatars or placeholders. Supports saving as SVG, rendering on Android Bitmaps.
10
Stars
—
Used by
dependents
—
Health
/ 100
identikon
identikon is a Kotlin multiplatform library for generating highly recognizable identicons. It is a Kotlin port of Jdenticon.
Purpose
An Identicon is a visual representation of a hash value, usually of an IP address, that serves to identify a user of a computer system as a form of avatar while protecting the users' privacy.
You may also use these icons in any other context, for example as a placeholder image.
Project status
identikon has just released it's first version. More features may be added at a later time. The following features are currently available:
- save icons as SVG,
- draw icons on an Android
Bitmap
This library is currently supporting the following platforms:
- JVM 11+
- Android API 21+
Setup
The library is available through MavenCentral. Add the following dependency to your Gradle build script :
dependencies {
implementation("io.github.thibseisel:identikon:1.0.0")
}
How to use
Create an instance of the Identicon class. You have to provide an object whose text representation
will be used to generate the icon.
Writing icon to an SVG file
// Create a new instance of the Identicon class with an hash string and the given size
val icon = Identicon.fromValue("Hello World!", iconSize = 300)
// Writes the icon to a SVG file
Path("my-icon.svg").outputStream().use {
icon.saveAsSvg(it)
}
Drawing the icon onto an Android Bitmap
// Create a new instance of the Identicon class with an hash string and the given size
val icon = Identicon.fromValue("Hello World!", iconSize = 300)
// Start the rendering
val targetBitmap = Bitmap.createBitmap(128, 128, Bitmap.Config.ARGB_8888)
icon.drawToBitmap(targetBitmap)