Glimpse

一个用于 Android 的内容感知裁剪库。

只需一瞥，即可呈现完美的第一印象！与其盲目地居中裁剪图片，不如利用 Glimpse 的“眼睛”捕捉到正确的焦点位置。

配置

添加到顶层 build.gradle 文件

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

添加到应用模块 build.gradle 文件 TensorFlow Lite (轻量级 TensorFlow) 建议大多数开发者省略 x86、x86_64 和 arm32 ABI (应用程序二进制接口)。这可以通过以下 Gradle 配置实现，该配置仅包含 armeabi-v7a 和 arm64-v8a，应能覆盖大多数现代 Android 设备。

android {
    aaptOptions {
        noCompress "tflite"
        noCompress "lite"
    }
    defaultConfig {
        ndk {
            abiFilters 'armeabi-v7a', 'arm64-v8a'
        }
    }
}

dependencies {
    implementation 'com.github.the-super-toys.glimpse-android:glimpse-core:0.0.5'
    
    //only required for glide extensions
    implementation 'com.github.the-super-toys.glimpse-android:glimpse-glide:0.0.5'
    
    //only required for coil extensions
    implementation 'com.github.the-super-toys.glimpse-android:glimpse-coil:0.0.5'
    
    implementation 'org.tensorflow:tensorflow-lite:0.0.0-nightly'
}

使用

在您的 Android 应用中初始化 Glimpse

class YourApp : Application() {
    override fun onCreate() {
        super.onCreate()
        Glimpse.init(this)
    }
}

不使用扩展功能使用 Glimpse

首先通过调用 Bitmap.findCenter 扩展函数来计算图像的焦点。

val original = (imageView.drawable as BitmapDrawable).bitmap
val (x, y) = original.findCenter()

然后将这些焦点连同目标 ImageView 的宽度和高度值提供给 Bitmap.crop 扩展函数。

val cropped = original.crop(x, y, imageView.layoutParams.width, imageView.layoutParams.height)
imageView.setImageBitmap(cropped)

配合 Glide 扩展使用 Glimpse

如果您使用 Glide 进行图像加载，只需将 GlimpseTransformation 添加到 GlideRequest 构建器中：

GlideApp.with(context)
                .load(url)
                .diskCacheStrategy(DiskCacheStrategy.RESOURCE)
                .transform(GlimpseTransformation())
                .into(imageView)

建议设置 diskCacheStrategy(DiskCacheStrategy.RESOURCE) 以缓存由 Glimpse 裁剪后的位图，否则每次显示图像时都会重新计算焦点。

配合 Coil 扩展使用 Glimpse

如果您使用 Coil 进行图像加载，只需将 GlimpseTransformation 添加到 Coil 的 LoadRequestBuilder 构建器中：

imageView.load(url) {
    crossfade(true)
    placeholder(R.drawable.image)
    transformations(GlimpseTransformation())
}

其他图像加载库（如 Picasso 和 Fresco）怎么办？

我们曾尝试为 Glimpse 提供 Picasso 和 Fresco 的扩展，但未能找到合适的 API (应用程序编程接口)。

我们在 Picasso 仓库上提交了 issue，并在 Stack Overflow 上标记了关于 Fresco 的问题 寻求指导，但遗憾的是我们没有得到太多支持。如果您知道如何将 Glimpse 的裁剪功能集成到任一库中而不破坏其原有流程，请提交 issue 以便我们一起审查提案。我们非常希望能为所有流行的图像加载库提供支持！

Java 调用者

如果您使用 Java，可以查看此 文件，了解 Glimpse API 对 Java 调用者的样子。

示例应用

:sample-app 模块通过使用 Glide 扩展展示了 Glimpse 的使用方式。该应用也已发布在 Google Play 上。

Glimpse 是否已准备好投入生产？

实际上，这取决于具体情况。理想情况下，您不应反复使用 Glimpse 裁剪同一张图片。即使您使用了会缓存输出转换的 Glide 扩展，底层计算仍会在每个 Android 客户端执行。因此，如果可能，当用户上传内容时，请将计算出的裁剪点的 x 和 y 坐标连同图像一起发送到您的云端解决方案。

我们在 OnePlus 6 上测试了裁剪计算的时间，平均耗时 30 毫秒。根据设备和您的具体用例，Glimpse 可能适合也可能不适合投入生产。无论如何，我们鼓励您提供反馈，帮助我们使 Glimpse 成为成熟的库。

APK 体积会增加多少？

如果您的应用中已经使用了 TensorFlow Lite (轻量级 TensorFlow)，添加 Glimpse 仅需增加模型的大小，即 148 KB。但很有可能您并未使用它，因此您还需要考虑 TensorFlow Lite 本身的大小，约为 300 KB。

让我们深入探讨（深度学习模型）

如果您想以更深的层次了解 Glimpse 的工作原理，请查看 此仓库，您可以看到 Glimpse 所使用的深度学习模型的架构和实现。我们以更技术化的层面解释了所有内容及其细节，以便您可以自行复现，并视情况改进它。

但如果您这样做了，请不要犹豫向该仓库提交 Pull Request (拉取请求)，以便我们不断改进 Glimpse！！

glimpse-android 快速上手指南

glimpse-android 是一个面向 Android 的内容感知裁剪库。它利用深度学习模型智能识别图像焦点，替代传统的盲目中心裁剪，为应用提供更优质的视觉体验。

环境准备

• 开发工具: Android Studio
• 构建系统: Gradle
• 语言: Kotlin 或 Java
• NDK: 需支持 armeabi-v7a 和 arm64-v8a 架构（TensorFlow Lite 推荐配置）

安装步骤

1. 配置仓库地址

在项目的根目录 build.gradle 文件中添加 JitPack 仓库：

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

2. 配置模块依赖

在应用模块的 build.gradle 文件中添加以下配置。建议仅保留主流 ARM 架构以减小体积。

android {
    aaptOptions {
        noCompress "tflite"
        noCompress "lite"
    }
    defaultConfig {
        ndk {
            abiFilters 'armeabi-v7a', 'arm64-v8a'
        }
    }
}

dependencies {
    implementation 'com.github.the-super-toys.glimpse-android:glimpse-core:0.0.5'
    
    // 如果使用 Glide 加载图片（可选）
    implementation 'com.github.the-super-toys.glimpse-android:glimpse-glide:0.0.5'
    
    // 如果使用 Coil 加载图片（可选）
    implementation 'com.github.the-super-toys.glimpse-android:glimpse-coil:0.0.5'
    
    implementation 'org.tensorflow:tensorflow-lite:0.0.0-nightly'
}

基本使用

1. 初始化库

在您的 Application 类中调用初始化方法：

class YourApp : Application() {
    override fun onCreate() {
        super.onCreate()
        Glimpse.init(this)
    }
}

2. 基础裁剪示例

通过扩展函数计算焦点并进行裁剪：

val original = (imageView.drawable as BitmapDrawable).bitmap
val (x, y) = original.findCenter()

val cropped = original.crop(x, y, imageView.layoutParams.width, imageView.layoutParams.height)
imageView.setImageBitmap(cropped)

3. 集成 Glide 加载器

若使用 Glide 加载图片，可直接添加变换器并开启资源缓存策略：

GlideApp.with(context)
                .load(url)
                .diskCacheStrategy(DiskCacheStrategy.RESOURCE)
                .transform(GlimpseTransformation())
                .into(imageView)

提示：设置 diskCacheStrategy(DiskCacheStrategy.RESOURCE) 可避免每次显示时重复计算焦点，提升性能。