BackgroundImageUsage.md 2.3 KB

背景图片设置功能使用说明

功能概述

在MainActivity中添加了背景图片设置功能,允许用户将RVM模型的背景从默认颜色替换为自定义图片。

使用方式

1. 界面操作

  • 打开应用后,在界面上方会看到"设置背景"按钮
  • 点击"设置背景"按钮即可将当前背景替换为预设的背景图片

2. 自定义背景图片

要更换背景图片,请按照以下步骤操作:

方法一:替换默认背景图片

  1. composeApp/src/androidMain/res/drawable/ 目录下放置新的背景图片
  2. 将文件命名为 background.pngbackground.jpg
  3. 更新 MainActivity.kt 中的 setBackgroundImage() 方法,修改图片资源引用

方法二:动态设置背景图片

// 从相册选择图片后设置背景
private fun setCustomBackgroundImage(bitmap: Bitmap) {
    val success = rvmncnn.setBackgroundImage(bitmap)
    if (success) {
        Log.d("MainActivity", "自定义背景设置成功")
    }
}

3. 清除背景图片

调用 clearBackgroundImage() 方法可以清除背景图片,恢复默认颜色背景:

// 在需要的地方调用
clearBackgroundImage()

技术实现

1. 布局文件修改

main.xml 中添加了一个"设置背景"按钮:

<Button
    android:id="@+id/buttonSetBackground"
    android:layout_width="wrap_content"
    android:layout_height="wrap_content"
    android:text="设置背景" />

2. MainActivity.kt 新增功能

  • 添加了 buttonSetBackground 按钮的初始化和点击事件处理
  • 新增了 setBackgroundImage() 方法用于设置背景图片
  • 新增了 clearBackgroundImage() 方法用于清除背景图片

3. 背景图片格式支持

支持以下图片格式:

  • PNG (推荐,支持透明通道)
  • JPG/JPEG
  • 矢量图 (XML drawable)

4. 性能优化建议

  • 建议使用尺寸为1920x1080或1280x720的图片
  • 避免使用过大的图片文件,以免影响性能
  • 对于矢量图,确保设置了合适的边界大小

注意事项

  1. 确保图片文件已正确放置在 res/drawable/ 目录下
  2. 图片尺寸建议与屏幕分辨率匹配,以获得最佳效果
  3. 如果设置失败,请检查日志输出中的错误信息
  4. 背景图片会在所有后续的视频处理中持续生效,直到被清除或替换