Android Kotlin：带透明度的Bitmap保存为PNG文件异常排查

问题原因分析 #

1. Xfermode逻辑错误：当前使用PorterDuff.Mode.SRC_IN配合透明画笔，无法正确将路径外区域设置为透明。SRC_IN会取源（透明路径填充）和目标（原Bitmap）的交集，导致透明效果未按预期生效。
2. 硬件加速兼容性问题：Android Canvas默认开启硬件加速，部分PorterDuffXfermode模式在硬件加速下无法正确处理透明通道，最终导致保存后透明区域显示为黑色。
3. 绘制流程不规范：直接在原Bitmap副本上绘制遮罩，未正确隔离原图与遮罩的合成过程，容易导致透明通道丢失。

修复方案 #

1. 修正Xfermode与遮罩逻辑

改用PorterDuff.Mode.DST_OUT替代SRC_IN，配合不透明画笔颜色，通过遮罩路径清除路径外的图像区域，确保透明通道正确生效。

2. 禁用Canvas硬件加速

在绘制遮罩前关闭硬件加速，避免Xfermode在硬件加速环境下的异常表现。

3. 优化Bitmap创建与绘制流程

创建独立的支持透明的Bitmap，先绘制原图再合成遮罩，确保透明通道全程被保留。

修改后的完整代码 #

遮罩Bitmap代码

private fun maskImage(points: List<PointF>, bitmap: Bitmap){
    // 创建支持透明的空Bitmap
    val maskedBitmap = Bitmap.createBitmap(bitmap.width, bitmap.height, Bitmap.Config.ARGB_8888)
    val canvas = Canvas(maskedBitmap)
    // 关闭硬件加速，确保Xfermode正常工作
    if (Build.VERSION.SDK_INT >= Build.VERSION_CODES.Q) {
        canvas.isHardwareAccelerated = false
    } else {
        canvas.setBitmap(maskedBitmap) // 低版本通过绑定Bitmap禁用硬件加速
    }

    // 先绘制原图到新Bitmap
    canvas.drawBitmap(bitmap, 0f, 0f, null)

    val paint = Paint(Paint.ANTI_ALIAS_FLAG)
    paint.color = Color.BLACK // 使用不透明颜色作为遮罩源
    paint.style = Paint.Style.FILL
    // DST_OUT模式：目标（原图）中被源（遮罩路径）覆盖的区域会被清除为透明
    paint.xfermode = PorterDuffXfermode(PorterDuff.Mode.DST_OUT)

    val path = Path()
    path.moveTo(points[0].x, points[0].y)
    for (point in points){
        Log.i("Point", "${point.x}, ${point.y}")
        path.lineTo(point.x, point.y)
    }
    path.close()
    path.fillType = Path.FillType.INVERSE_WINDING // 填充路径外区域，即清除路径外的图像

    canvas.drawPath(path, paint)
    // 重置Xfermode，避免影响后续绘制
    paint.xfermode = null

    imageBitmap.value = maskedBitmap
    val maskFile = fileFromBitmap(maskedBitmap)
}

保存文件代码（优化流管理与目录检查）

private fun fileFromBitmap(bitmap: Bitmap): File?{
    return try {
        val dir = File(Environment.getExternalStorageDirectory().toString() + "/Pictures/AppName")
        // 确保存储目录存在，不存在则创建
        if (!dir.exists()) dir.mkdirs()
        val maskFile = File(dir, "mask.png")
        
        // 使用use自动关闭流，避免资源泄漏
        FileOutputStream(maskFile).use { outputStream ->
            bitmap.compress(Bitmap.CompressFormat.PNG, 100, outputStream)
            outputStream.flush()
        }
        
        Log.e("Status", "Mask saved successfully")
        maskFile
    } catch (e: Exception) {
        e.printStackTrace()
        Log.e("Status", "Save file error!")
        null
    }
}

内容的提问来源于stack exchange，提问作者Decodator