Ecosyste.ms: Awesome
An open API service indexing awesome lists of open source software.
https://github.com/chillibits/drawing-activity
Android library for getting lightweight DrawingActivity into your Android app
https://github.com/chillibits/drawing-activity
android android-library chillibits draw drawing
Last synced: 3 months ago
JSON representation
Android library for getting lightweight DrawingActivity into your Android app
- Host: GitHub
- URL: https://github.com/chillibits/drawing-activity
- Owner: chillibits
- License: mit
- Archived: true
- Created: 2018-09-04T11:16:36.000Z (almost 6 years ago)
- Default Branch: master
- Last Pushed: 2021-08-23T17:17:58.000Z (almost 3 years ago)
- Last Synced: 2024-01-17T02:29:04.801Z (5 months ago)
- Topics: android, android-library, chillibits, draw, drawing
- Language: Kotlin
- Homepage:
- Size: 20.2 MB
- Stars: 68
- Watchers: 8
- Forks: 14
- Open Issues: 2
-
Metadata Files:
- Readme: README.md
- Funding: .github/FUNDING.yml
- License: LICENSE
Lists
- awesome-list - chillibits/drawing-activity - Android library for getting lightweight DrawingActivity into your Android app (Kotlin)
README
# Android DrawingActivity
[](https://app.codacy.com/gh/ChilliBits/drawing-activity?utm_source=github.com&utm_medium=referral&utm_content=ChilliBits/drawing-activity&utm_campaign=Badge_Grade_Dashboard)
[](https://jitpack.io/#ChilliBits/drawing-activity)
[](https://android-arsenal.com/details/1/7098)
[](https://android-arsenal.com/api?level=19)
[](http://makeapullrequest.com)
A lightweight android library for including a drawing experience to your Android app.
## Installation
Up to now, the library is only available on JitPack. Please add this code to your build.gradle file on project level:
```gradle
allprojects {
repositories {
...
maven { url 'https://jitpack.io' }
}
}
```
To load the library into your project use this code in the build.gradle file within the app module:
```gradle
implementation 'com.github.ChilliBits:drawing-activity:2.0.8'
```
## Usage
To use the DrawingActivity, include this code in an event function:
```kotlin
DrawingActivityBuilder.getInstance(this@MainActivity)
.draw(REQ_DRAWING)
```
Thus `REQ_DRAWING` is a constant of type integer to specify the request code of the returning intent for the `onActivityResult` method.
If you want to have a look onto a implemented example, view the [MainActivity.kt](https://github.com/ChilliBits/splash-screen/blob/master/app/src/main/java/com/chillibits/splashscreenexample/MainActivity.kt) or the [MainActivity.java](https://github.com/ChilliBits/splash-screen/blob/master/app/src/main/java/com/chillibits/splashscreenexample/MainActivityJava.java) file.
You are able to catch the event of finishing the drawing and closing the DrawingActivty by using the `onActivityResult` method like that:
```kotlin
if(requestCode == REQ_DRAWING && resultCode == RESULT_OK && data != null) {
val drawingPath = data.getStringExtra(DrawingActivity.DRAWING_PATH)
Toast.makeText(this, drawingPath, Toast.LENGTH_LONG).show()
}
```
Replace the Toast with your own code, processing the returned image (loading the image into your app, sharing it, cropping it, etc.).
You can customize the appearance of the DrawingActivity using following arguments when building the Activity with `DrawingActivityBuilder`:
| Method | Description |
|--------------------------------|----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------|
| enableToast(boolean enabled) | Enables or disables the toast on Activity startup (You can see the toast on the animated demo above). |
| setTitle(String title) | Sets the title in the toolbar at the top of the DrawingActivity. |
| setDefaultUtility(int utility) | Sets the default utility which will be selected on Activity startup. You have to pass an int argument to this method. The utility constants can be accessed by using e.g. `DrawingActivity.UTILITY_PENCIL` or `DrawingActivity.UTILITY_AIR_BRUSH`. |
## Credits
This library uses following third party libraries:
* [DrawingView](https://github.com/Raed-Mughaus/DrawingView) (Repo does not exist anymore)
* [SlidingUpPanel](https://github.com/umano/AndroidSlidingUpPanel)
* [ColorPickerPreference](https://github.com/attenzione/android-ColorPickerPreference)
* [Android FilePicker](https://github.com/DroidNinja/Android-FilePicker)
* [Glide](https://github.com/bumptech/glide)
## Contributions
If you want to contribute to this library, feel free to open a pr! We're going to merge it asap.
Thank you for using the DrawingActivity!
© ChilliBits 2018-2021 (Designed and developed by Marc Auberer)