Capturable
Made with
💡
Introduction
In the previous View system, drawing Bitmap Image from View was very straightforward. But that's not the case with Jetpack Compose since it's different in many aspects from previous system. This library helps easy way to achieve the same results. It's built upon the ComposeView and uses View's APIs to draw the Bitmap image.
🚀
Implementation
You can check /app directory which includes example application for demonstration.
Gradle setup
In build.gradle of app module, include this dependency
dependencies {
implementation "dev.shreyaspatil:capturable:1.0.1"
}
You can find latest version and changelogs in the releases.
Usage
1. Setup the controller
To be able to capture Composable content, you need instance of CaptureController by which you can decide when to capture the content. You can get the instance as follow.
@Composable
fun TicketScreen() {
val captureController = rememberCaptureController()
}
rememberCaptureController() is a Composable function.
2. Add the content
The component which needs to be captured should be placed inside Capturable composable as follows.
@Composable
fun TicketScreen() {
val captureController = rememberCaptureController()
Capturable(
controller = captureController,
onCaptured = { bitmap, error ->
// This is captured bitmap of a content inside Capturable Composable.
if (bitmap != null) {
// Bitmap is captured successfully. Do something with it!
}
if (error != null) {
// Error occurred. Handle it!
}
}
) {
// Composable content to be captured.
// Here, `MovieTicketContent()` will be get captured
MovieTicketContent(...)
}
}
3. Capture the content
To capture the content, use CaptureController#capture() as follows.
Button(onClick = { captureController.capture() }) { ... }
On calling this method, request for capturing the content will be sent and event will be received in callback onCaptured with ImageBitmap as a parameter in the Capturable function.
By default, it captures the Bitmap using Bitmap.Config ARGB_8888. If you want to modify, you can provide config from Bitmap.Config enum.
Example:
captureController.capture(Bitmap.Config.ALPHA_8)
Make sure to call this method as a part of callback function and not as a part of the Composable function itself. Otherwise, it'll lead to capture bitmaps unnecessarily in recompositions which can degrade the performance of the application.
That's all needed!
📄
API Documentation
Visit the API documentation of this library to get more information in detail.
🙋♂️
Contribute
Read contribution guidelines for more information regarding contribution.
💬
Discuss?
Have any questions, doubts or want to present your opinions, views? You're always welcome. You can start discussions.
📝
License
MIT License
Copyright (c) 2022 Shreyas Patil
Permission is hereby granted, free of charge, to any person obtaining a copy
of this software and associated documentation files (the "Software"), to deal
in the Software without restriction, including without limitation the rights
to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
copies of the Software, and to permit persons to whom the Software is
furnished to do so, subject to the following conditions:
The above copyright notice and this permission notice shall be included in all
copies or substantial portions of the Software.
THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
SOFTWARE.
![[Update]: Bump kotlinVersion from 1.5.31 to 1.6.10](https://avatars.githubusercontent.com/in/29110?v=4)
14 Nov 29, 2022
298 Dec 23, 2022
10 Dec 29, 2022
59 Oct 19, 2022
60 Dec 27, 2022
21 Nov 15, 2022
178 Jan 4, 2023
57 Dec 23, 2022
24 Nov 18, 2022
167 Dec 5, 2022
207 Dec 26, 2022
1 Apr 13, 2022
145 Jan 3, 2023
2 Nov 1, 2022
8 Feb 9, 2022
139 Dec 26, 2022
3 Sep 2, 2022