Awesome
<h1 align="center">Cloudy</h1></br> <p align="center"> <a href="https://opensource.org/licenses/Apache-2.0"><img alt="License" src="https://img.shields.io/badge/License-Apache%202.0-blue.svg"/></a> <a href="https://android-arsenal.com/api?level=21"><img alt="API" src="https://img.shields.io/badge/API-21%2B-brightgreen.svg?style=flat"/></a> <a href="https://github.com/skydoves/cloudy/actions/workflows/android.yml"><img alt="Build Status" src="https://github.com/skydoves/cloudy/actions/workflows/android.yml/badge.svg"/></a> <a href="https://androidweekly.net/issues/issue-545"><img alt="Android Weekly" src="https://skydoves.github.io/badges/android-weekly.svg"/></a> <a href="https://github.com/skydoves"><img alt="Profile" src="https://skydoves.github.io/badges/skydoves.svg"/></a> </p><br> <p align="center"> ☁️ Compose blur effect library, which falls back on to a CPU-based implementation to support older API levels. </p><br><p align="center">The `blur` modifier supports only Android 12 and higher, and `RenderScript` APIs are deprecated starting in Android 12. Cloudy is the backport of the blur effect for Jetpack Compose.</p><p align="center"> <img src="preview/gif0.gif" width="268"/> <img src="preview/img1.png" width="270"/> <img src="preview/img2.png" width="268"/> </p>
Download
Version Catalog
If you're using Version Catalog, you can configure the dependency by adding it to your libs.versions.toml
file as follows:
[versions]
#...
cloudy = "0.2.3"
[libraries]
#...
compose-cloudy = { module = "com.github.skydoves:cloudy", version.ref = "cloudy" }
Gradle
Add the dependency below to your module's build.gradle.kts
file:
dependencies {
implementation("com.github.skydoves:cloudy:0.2.3")
// if you're using Version Catalog
implementation(libs.compose.cloudy)
}
Usage
You can implement blur effect with Modifiy.cloudy()
composable function as seen in the below:
Text(
modifier = Modifier.cloudy(),
text = "This text is blurred"
)
<img align="right" src="preview/img2.png" width="290"/>
You can change the degree of the blur effect by changing the radius
parameter of Modifier.cloudy()
composable function.
Column(
modifier = Modifier.cloudy(radius = 15)
) {
Image(..)
Text(
modifier = Modifier
.fillMaxWidth()
.padding(8.dp),
text = posterModel.name,
fontSize = 40.sp,
color = MaterialTheme.colors.onBackground,
textAlign = TextAlign.Center
)
Text(
modifier = Modifier
.fillMaxWidth()
.padding(8.dp),
text = posterModel.description,
color = MaterialTheme.colors.onBackground,
textAlign = TextAlign.Center
)
}
Observing Blurring Status
You can monitor the status of the blurring effect by using the onStateChanged
parameter, which provides CloudyState
. This allows you to observe and respond to changes in the blurring effect's state effectively.
GlideImage(
modifier = Modifier
.size(400.dp)
.cloudy(
radius = 25,
onStateChanged = {
// ..
}
),
..
Maintaining Blurring Effect on Responsive Composable
The Modifier.cloudy
captures the bitmap of the composable node under the hood. If you need to use the cloudy modifier as an item in lists or similar structures, you should provide the same graphic layer to ensure consistent rendering and performance.
val graphicsLayer = rememberGraphicsLayer()
LazyVerticalGrid(
state = rememberLazyGridState(),
columns = GridCells.Fixed(2)
) {
itemsIndexed(key = { index, item -> item.id }, items = posters) { index, item ->
HomePoster(
poster = item,
graphicsLayer = graphicsLayer
)
}
}
@Composable
private fun HomePoster(
graphicsLayer: GraphicsLayer = rememberGraphicsLayer(),
poster: Poster
) {
ConstraintLayout {
val (image, title, content) = createRefs()
GlideImage(
modifier = Modifier
.cloudy(radius = 15, graphicsLayer = graphicsLayer)
.aspectRatio(0.8f)
.constrainAs(image) {
centerHorizontallyTo(parent)
top.linkTo(parent.top)
}
..
Blur Effect with Network Images
You can easily implement blur effect with Landscapist, which is a Jetpack Compose image loading library that fetches and displays network images with Glide, Coil, and Fresco. For more information, see the Transformation section.
Find this repository useful? :heart:
Support it by joining stargazers for this repository. :star: <br> Also, follow me on GitHub for my next creations! 🤩
License
Designed and developed by 2022 skydoves (Jaewoong Eum)
Licensed under the Apache License, Version 2.0 (the "License");
you may not use this file except in compliance with the License.
You may obtain a copy of the License at
http://www.apache.org/licenses/LICENSE-2.0
Unless required by applicable law or agreed to in writing, software
distributed under the License is distributed on an "AS IS" BASIS,
WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
See the License for the specific language governing permissions and
limitations under the License.