Gaussian Blur Android 图像模糊库技术文档

Gaussian Blur Android 图像模糊库技术文档

GaussianBlur 🎩 An easy and fast library to apply gaussian blur filter on any images. 项目地址: https://gitcode.com/gh_mirrors/ga/GaussianBlur

安装指南

步骤 1: 添加 JitPack 仓库

在您的项目的 build.gradle 文件（位于项目根目录下）的 repositories 部分添加 JitPack 仓库：

allprojects {
    repositories {
        ...
        maven { url "https://jitpack.io" }
    }
}

步骤 2: 引入依赖

接着，在应用模块的 build.gradle 文件中的 dependencies 添加 Gaussian Blur 库依赖：

dependencies {
    implementation 'com.github.jrvansuita:GaussianBlur:+'
}

步骤 3: 配置 RenderScript

为了支持 Gaussian Blur 功能，同样需要在应用模块的 build.gradle 中配置 RenderScript：

defaultConfig {
    ...
    renderscriptTargetApi 19
    renderscriptSupportModeEnabled true
}

项目使用说明

Gaussian Blur 库提供了一种简单高效的方式在 Android 上实现图像高斯模糊效果。

同步使用示例

如果您希望立即获取模糊后的 Bitmap 对象，可以这样使用：

Bitmap blurredBitmap = GaussianBlur.with(this) // 传入 Context
                                  .render(R.mipmap.your_image); // 使用资源ID
imageView.setImageBitmap(blurredBitmap);

异步使用示例

若要异步执行模糊操作，并直接设置到 ImageView，使用方法如下：

GaussianBlur.with(this)
           .put(R.mipmap.your_image, imageView); // 自动处理显示

带有参数的异步使用

您还可以自定义模糊区域大小（以像素为单位）和模糊程度（半径），例如：

GaussianBlur.with(this)
           .size(300) // 设置预处理图片尺寸，减小计算量加快速度
           .radius(10) // 模糊半径，值越大，模糊程度越高
           .put(R.mipmap.your_image, imageView);

项目API使用文档

核心方法：

• with(Context context)：初始化模糊处理过程，需要传入当前上下文。

• render(int resId)：同步模式下进行模糊处理，并返回 Bitmap 结果。

• put(int resId, ImageView imageView)：异步将资源 ID 对应的图片模糊后设置到指定的 ImageView。

• size(int size) 和 radius(int radius)：在异步请求中调整模糊前图像缩放尺寸和模糊的程度。

总结

通过上述步骤和代码示例，您可以轻松集成 Gaussian Blur 库于 Android 应用中，实现快速高效的图像模糊效果。不论是同步操作立即获取结果，还是异步处理优化用户体验，Gaussian Blur 库都提供了简洁易用的解决方案。记得在应用 RenderScript 相关配置时保持版本兼容性，确保在不同设备上的良好表现。

GaussianBlur 🎩 An easy and fast library to apply gaussian blur filter on any images. 项目地址: https://gitcode.com/gh_mirrors/ga/GaussianBlur