This project is inspired by ethereum/blockies.
The blockiesview
module offers a custom view for displaying blockies icons. You can adjust the icon's size and appearance based on the view's width and height, as well as the pixel size.
<!-- app:color, app:bgColor, app:spotColor are optional -->
<com.nikhiljain.blockiesview.BlockiesIconView
android:layout_width="200dp"
android:layout_height="200dp"
app:seed="0xfb6916095ca1df60bb79ce92ce3ea74c37c5d359"
app:size="10"
app:color="@android:color/holo_green_light"
app:bgColor="@android:color/holo_blue_light"
app:spotColor="@android:color/holo_orange_dark" />
The blockiesgenerator
module is responsible for generating blockies icon bitmaps. You can control the pixel size and image scale to produce custom icons.
val imageView = ImageView(this)
imageView.layoutParams = ViewGroup.LayoutParams(100, 100)
// Create a BlockiesIconGenerator instance
val iconGenerator = BlockiesIconGenerator(
seed = "0xfb6916095ca1df60bb79ce92ce3ea74c37c5d359",
size = 10,
scale = 10,
color = ContextCompat.getColor(context, android.R.color.holo_green_light), // color will be generated as per the seed if not passed
bgColor = ContextCompat.getColor(context, android.R.color.holo_blue_bright), // bgColor will be generated as per the seed if not passed
spotColor = ContextCompat.getColor(context, android.R.color.holo_orange_dark) // spotColor will be generated as per the seed if not passed
)
// Generate the blockies icon bitmap
val blockiesIconBitmap = iconGenerator.generateIconBitmap()
// Set the generated bitmap to an ImageView
imageView.setImageBitmap(blockiesIconBitmap)
The blockiesglide
module requires Glide library as dependency. BlockiesGlideModule
library Glide module is responsible for registering the necessary components and loads the bitmap image from the BlockiesIconData
object.
For this, you need to add a class which extends AppGlideModule in your application module. See more here - Glide - Configuration
@GlideModule
class YourAppModule : AppGlideModule()
val imageView = ImageView(this)
imageView.layoutParams = ViewGroup.LayoutParams(100, 100)
Glide.with(imageView)
.load(
BlockiesIconData(
seed = "0xfb6916095ca1df60bb79ce92ce3ea74c37c5d359",
size = 10,
color = android.R.color.holo_green_light, // color will be generated as per the seed if not passed
bgColor = android.R.color.holo_blue_bright, // bgColor will be generated as per the seed if not passed
spotColor = android.R.color.holo_orange_dark // spotColor will be generated as per the seed if not passed
)
)
.placeholder(R.drawable.ic_launcher_foreground)
.circleCrop()
.into(imageView)
The above code sample loads the bitmap from the BlockiesIconData object with the help of Glide library.
To use this library in your Android project, you need to include it as a dependency in your app module build.gradle
file. Make sure you have JitPack as a repository in your project's build.gradle
file.
dependencies {
// BlockiesView dependency
implementation 'com.github.nikhiljainlive.blockies_android:blockiesview:v0.2.1'
// BlockiesGenerator dependency
implementation 'com.github.nikhiljainlive.blockies_android:blockiesgenerator:v0.2.1'
// BlockiesGlide dependency
implementation 'com.github.nikhiljainlive.blockies_android:blockiesglide:v0.2.1'
}
And, in root project directory's build.gradle
file:
dependencyResolutionManagement {
repositoriesMode.set(RepositoriesMode.FAIL_ON_PROJECT_REPOS)
repositories {
mavenCentral()
maven { url 'https://jitpack.io' }
}
}
For more information and advanced usage, refer to the project's samples.
This project is licensed under the MIT License - see the LICENSE file for details.
If you have any questions or need assistance, please feel free to create an issue in this repository.