Flexible and lightweight drawing library enables customizable screen drawing with advanced features like palm rejection and line style customization, supporting bitmap export and sharing.
A Flexible and Lightweight Drawing Library
ArtMaker is a flexible and customisable Android and iOS (through Kotlin Multiplatform - KMP) library that allows users to draw anything they want on
screen and has been built fully with Jetpack Compose. Integrated with advanced features like Palm Rejection, line style customization, exportation, blazing performance, etc, it allows drawing on screen through the Canvas, sharing the drawn Bitmap, or programmatically exposing
the Bitmap for use in the calling application.
| Android | iOS | |
|---|---|---|
 |  |
Add the following in settings.gradle.kts if it has not been included:
repositories {
mavenCentral()
}
In Kotlin Multiplatform (KMP) projects, add the following dependency in your commonMain sourceSet:
sourceSets {
commonMain.dependencies {
implementation(dependencyNotation = "io.github.fbada006:artmaker:$latest_version")
}
}
In Android projects, add the following dependency in your app-level (or module-level for modularised Android projects) build.gradle.kts file:
dependencies {
implementation(dependencyNotation = "io.github.fbada006:artmaker:$latest_version")
}
If you are using Gradle's Version Catalogs, then define the dependency as follows:
[versions]
artmaker = "$latest-version"
[libraries]
artmaker = { module = "io.github.fbada006:artmaker", version.ref = "artmaker" }
Sync your project and then add the dependency as follows:
sourceSets {
commonMain.dependencies {
implementation(dependencyNotation = libs.artmaker)
}
}
dependencies {
implementation(dependencyNotation = libs.artmaker)
}
Find latest version and release notes here
ArtMaker implements canvas, which allows you to draw points with custom properties.
You can use ArtMaker with default configuration as the following example:
ArtMaker(
modifier = Modifier.fillMaxSize(),
)
In the Android project, you also need to call ArtMakerInitializer.initialise(this) inside your activity, otherwise a runtime exception will be
thrown:
class MainActivity : ComponentActivity() {
override fun onCreate(savedInstanceState: Bundle?) {
super.onCreate(savedInstanceState)
ArtMakerInitializer.initialise(this) // Do not forget this line
setContent {
ArtMakerTheme {
ArtMaker(
modifier = Modifier.fillMaxSize(),
)
}
}
}
}
You also have full control of ArtMaker and choose how you want the control menu composable (the bar below the drawing area) to be
displayed by customizing the ArtMakerConfiguration object as shown below:
ArtMaker(
modifier = Modifier.fillMaxSize(),
configuration = ArtMakerConfiguration(
strokeSliderThumbColor = MaterialTheme.colorScheme.primary,
strokeSliderActiveTrackColor = MaterialTheme.colorScheme.onPrimary,
strokeSliderInactiveTickColor = MaterialTheme.colorScheme.inversePrimary,
strokeSliderTextColor = MaterialTheme.colorScheme.secondaryContainer,
pickerCustomColors = listOf(
Color.Red, Color.Blue, Color.Green,
),
canvasBackgroundColor = Color.Green.toArgb(),
controllerBackgroundColor = Color.Cyan,
strokeSliderBackgroundColor = Color.Magenta,
canShareArt = true
)
)
If you wish to receive the completed image as a bitmap, you can utilise the onFinishDrawing: (Bitmap) -> Unit callback exposed by ArtMaker as
follows:
ArtMaker(
modifier = Modifier.fillMaxSize(),
onFinishDrawing = { bitmap ->
// Utilise the bitmap here
}
)
NOTE: The default Jetpack Compose project created by Android Studio for Android has
enableEdgeToEdge()added in theonCreate(). To effectively use the library, please ensure that you remove this line.
In iOS, you can use the SDK as below:
UIKit
SwiftUI
artmaker
: {
(: ) -> {
.mainViewController()
}
( : , : ) {}
}
: {
body: {
()
}
}
You can then call ContentView as follows in your main entry point for iOS as follows:
import SwiftUI
@main
struct iosAppApp: App {
var body: some Scene {
WindowGroup {
ContentView()
}
}
}
Do you see any improvements or want to implement a missing feature? Contributions are very welcome!
./gradlew spotlessApply
The CI will fail if the code is not properly formatted. Please correct any failures before requesting a review.
Take into account that changes and requests can be rejected if they don't align with the purpose of the library. To ensure you do not waste any time, you can always open an issue here or talk to us before you start making any changes.
Copyright 2024 ArtMaker, Inc. All Rights Reserved.
Licensed under the Apache License, Version 2.0 (the "License");
you may not use this file except compliance the License.
You may obtain a copy of the License at
http:
Unless applicable law agreed to writing, software
distributed under the License distributed an BASIS,
WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express implied.
See the License the specific language governing permissions
limitations under the License.
Surfaced from shared tags and platforms — no rankings paid for.