Android实现图片加水印（附带源码）

Android 实现图片加水印项目详解

目录

1. 项目背景与意义

2. 相关技术及基础知识
   2.1 图片格式与图像处理基础
   2.2 Android 图像处理 API 概述
   2.3 水印技术原理
   2.4 常见问题与注意事项

3. 项目整体架构与实现思路
   3.1 项目架构图
   3.2 处理流程及模块划分
   3.3 关键技术解析

4. 详细实现代码及注释
   4.1 主要代码实现（Kotlin 版）
   4.2 布局文件与资源说明
   4.3 工具类与辅助方法

5. 代码解读与方法功能说明
   5.1 核心方法解析
   5.2 图像合成与 Canvas 绘制原理

6. 项目调试、测试与常见问题
   6.1 日志输出与断点调试
   6.2 常见问题及解决方案

7. 项目总结与未来展望
   7.1 项目成果总结
   7.2 扩展功能与发展方向

8. 参考资料与学习资源

9. 附录

---

1. 项目背景与意义

在移动互联网时代，图像处理与编辑成为许多应用的常见需求。无论是社交分享、版权保护还是品牌推广，在图片上添加水印都能有效传达版权信息或宣传品牌形象。具体来说，图片加水印主要解决以下几个问题：

• 版权保护：防止图片被盗用或未经授权传播，增加版权标识。

• 品牌推广：在图片上叠加品牌 Logo 或名称，提升品牌知名度。

• 信息标注：通过加水印方式在图片上标注拍摄时间、地点或其他说明信息。

• 安全防伪：通过数字水印技术增强图片安全性，为后续图像验证提供依据。

本项目旨在利用 Android 平台提供的图像处理 API，实现一个支持文字及图片水印的应用。该项目不仅适合初学者学习 Android 图像处理和 Canvas 绘制技术，同时也是实际开发中常见需求的有效解决方案。

---

2. 相关技术及基础知识

2.1 图片格式与图像处理基础

2.1.1 图片格式

图片在存储和传输过程中常用的格式有 JPEG、PNG、BMP、WEBP 等，每种格式都有其特点：

• JPEG：压缩比高、适合存储照片，但是有损压缩。

• PNG：支持透明通道，适合存储图标、界面元素，采用无损压缩。

• BMP：无压缩格式，文件较大，使用较少。

• WEBP：Google 推出的格式，兼具高压缩比与支持透明的优点。

在本项目中，我们主要使用 JPEG 或 PNG 格式进行图片水印处理。

2.1.2 图像处理基础

图像处理通常涉及像素操作、图像合成、滤镜处理、旋转缩放、颜色调整等方面。对于图片加水印问题，关键在于如何在原始图片上叠加水印图像或绘制文字，并保持原图片的质量与风格。

• 图像叠加：将两幅图像按一定位置、透明度进行合成。常用算法包括 alpha 混合等。

• 文字绘制：利用系统 API 将指定文字绘制到画布上，可设置字体、颜色、大小等属性。

2.2 Android 图像处理 API 概述

Android 提供了丰富的图像处理类库和 API，主要包括：

• Bitmap 类：表示图像数据，是 Android 中处理图像最基本的数据结构。

• Canvas 类：提供绘制接口，可以将 Bitmap、文字、图形绘制到画布上，适用于离屏绘制。

• Paint 类：定义绘图样式、颜色、字体等属性，在绘制时提供样式支持。

• Matrix 类：实现图像的平移、缩放、旋转等变换操作。

• BitmapFactory：用于从文件、资源中解码生成 Bitmap 对象。

本项目主要依赖 Bitmap、Canvas、Paint 和 Matrix 类实现水印叠加操作，既支持文字水印，也支持图片水印。

2.3 水印技术原理

水印技术分为两大类：

1. 可见水印
   直接在图像上绘制标识性信息，如文字、Logo 等。可通过图像合成算法实现，易于实现和观察。

2. 不可见水印
   将信息嵌入图像中，不直接改变视觉效果，常用于数字版权保护，需要使用专门的算法（如频域变换）。

本项目主要实现可见水印，借助 Canvas 在 Bitmap 上进行绘制。实现时需要注意以下细节：

• 透明度处理：水印图像或文字通常需要一定透明度，保证不遮挡原图细节。

• 位置选择：根据用户设置或固定规则选择水印的位置，如右下角、左上角等。

• 字体支持：对于文字水印，需选择合适的字体与字号，避免因中文字符或特殊字符显示不正常。

2.4 常见问题与注意事项

在图片水印实现过程中，可能遇到如下问题：

• 内存溢出
  当处理高分辨率图片时，Bitmap 占用内存较大，容易引发 OOM 异常。需适当使用 Bitmap 的采样率及内存优化方案。

• 图片质量下降
  水印合成过程中，如果处理不当可能导致图片质量下降，建议使用无损合成方式或高精度 Bitmap。

• 位置与透明度配置问题
  需要合理设置水印的位置和透明度，避免遮挡重要图像信息，影响用户体验。

• 多种图片格式支持
  对于不同格式图片可能需要不同的解码方式，确保水印处理后的图片格式与原图一致。

---

3. 项目整体架构与实现思路

3.1 项目架构图

本项目采用模块化设计，主要分为如下几个模块：

• 用户界面模块
  包括图片选择、预览、参数设置（如水印文字、图片、透明度、位置等）和输出结果展示。

• 图片处理模块
  负责 Bitmap 的解码、合成与保存，包括文字水印与图片水印的实现。

• 工具与辅助模块
  包括文件操作工具类、权限管理、日志记录等，统一处理系统相关操作。

下图为项目整体架构示意图（实际开发中可使用 UML 绘制详细图）：

+-------------------------------------------------+
|                    MainActivity                 |
|  +---------+    +---------------------------+   |
|  | UI 页面 |<-->| 图片选择 & 参数设置模块   |   |
|  +---------+    +---------------------------+   |
|                    |                         |   |
|                    v                         |   |
|           +----------------------+           |   |
|           | 图片处理模块（Bitmap）|           |
|           |  - 文字水印          |           |
|           |  - 图片水印          |           |
|           +----------------------+           |
|                    |                         |
|                    v                         |
|           +----------------------+           |
|           | 文件保存 & 缓存模块   |           |
|           +----------------------+           |
+-------------------------------------------------+

3.2 处理流程及模块划分

图片加水印整体处理流程分为以下步骤：

1. 图片选择与加载
   用户通过系统文件选择器选取一张图片，程序通过 BitmapFactory 解码得到 Bitmap 对象，并在 ImageView 中展示预览效果。

2. 水印参数设置
   用户可在界面中设置水印内容（文字或选择水印图片）、透明度、位置、字号（文字水印）或缩放比例（图片水印）等参数。

3. 图像合成处理
   根据用户输入，在原始 Bitmap 上创建一个 Canvas，并依次：

   • 对原图进行绘制；

   • 利用 Paint 绘制文字水印，或利用 Canvas.drawBitmap() 叠加水印图片；

   • 通过 Matrix 对水印图片进行旋转、缩放、平移等处理，确保位置正确。

4. 保存输出图片
   将合成后的 Bitmap 保存为 JPEG 或 PNG 文件，存储在本地或分享给其他应用。

5. 显示与分享
   在界面上展示处理后图片的预览，并提供分享、删除、再次编辑等选项。

3.3 关键技术解析

• Bitmap 处理
  使用 BitmapFactory.decodeFile() 或 decodeStream() 读取图片，注意大图内存优化。

• Canvas 与 Paint 绘制
  Canvas 提供了在 Bitmap 上绘制图像与文字的方法。通过 Paint 可设置绘制参数（颜色、字体、抗锯齿等），保证水印效果美观。

• 图像合成算法
  文字水印直接调用 Canvas.drawText() 方法；图片水印则调用 Canvas.drawBitmap() 方法，同时配合 Matrix 对图片进行变换操作。

• 文件 I/O 操作
  处理完毕的 Bitmap 使用 Bitmap.compress() 方法保存为文件，注意文件路径及存储权限管理。

---

4. 详细实现代码及注释

下面提供完整代码示例（以 Kotlin 为例），整合图片加水印的所有流程，并附有详细注释说明。

4.1 主要代码实现（Kotlin 版）

package com.example.imagewatermark

import android.Manifest
import android.app.Activity
import android.content.Intent
import android.content.pm.PackageManager
import android.graphics.*
import android.net.Uri
import android.os.Bundle
import android.os.Environment
import android.provider.MediaStore
import android.util.Log
import android.widget.*
import androidx.appcompat.app.AppCompatActivity
import androidx.core.app.ActivityCompat
import java.io.File
import java.io.FileOutputStream
import java.text.SimpleDateFormat
import java.util.*

/**
 * MainActivity 作为项目入口，主要实现：
 * 1. 选择图片文件并预览
 * 2. 配置水印参数（文字或图片水印）
 * 3. 在原图上叠加水印
 * 4. 保存处理后的图片并展示输出结果
 */
class MainActivity : AppCompatActivity() {

    // 定义控件
    private lateinit var btnSelectImage: Button
    private lateinit var btnProcessImage: Button
    private lateinit var edtWatermarkText: EditText
    private lateinit var imgPreview: ImageView
    private lateinit var txtOutputPath: TextView

    // 图片 URI 与 Bitmap 对象
    private var imageUri: Uri? = null
    private var originalBitmap: Bitmap? = null

    companion object {
        private const val REQUEST_IMAGE_PICK = 1010
        private const val REQUEST_PERMISSION = 1011
        private const val TAG = "MainActivity"
    }

    override fun onCreate(savedInstanceState: Bundle?) {
        super.onCreate(savedInstanceState)
        // 加载布局文件 activity_main.xml
        setContentView(R.layout.activity_main)

        // 初始化控件
        btnSelectImage = findViewById(R.id.btnSelectImage)
        btnProcessImage = findViewById(R.id.btnProcessImage)
        edtWatermarkText = findViewById(R.id.edtWatermarkText)
        imgPreview = findViewById(R.id.imgPreview)
        txtOutputPath = findViewById(R.id.txtOutputPath)

        // 检查存储权限
        if (ActivityCompat.checkSelfPermission(this, Manifest.permission.WRITE_EXTERNAL_STORAGE)
            != PackageManager.PERMISSION_GRANTED) {
            ActivityCompat.requestPermissions(this,
                arrayOf(Manifest.permission.WRITE_EXTERNAL_STORAGE), REQUEST_PERMISSION)
        }

        // 设置点击事件：选择图片
        btnSelectImage.setOnClickListener {
            selectImageFromGallery()
        }

        // 设置点击事件：处理图片加水印
        btnProcessImage.setOnClickListener {
            val watermarkText = edtWatermarkText.text.toString().trim()
            if (originalBitmap == null) {
                Toast.makeText(this, "请先选择一张图片", Toast.LENGTH_SHORT).show()
                return@setOnClickListener
            }
            if (watermarkText.isEmpty()) {
                Toast.makeText(this, "请输入水印文字", Toast.LENGTH_SHORT).show()
                return@setOnClickListener
            }
            // 调用处理方法
            processImageWithWatermark(originalBitmap!!, watermarkText)
        }
    }

    /**
     * 通过系统文件选择器选择图片
     */
    private fun selectImageFromGallery() {
        val intent = Intent(Intent.ACTION_GET_CONTENT)
        intent.type = "image/*"
        startActivityForResult(intent, REQUEST_IMAGE_PICK)
    }

    override fun onActivityResult(requestCode: Int, resultCode: Int, data: Intent?) {
        if (requestCode == REQUEST_IMAGE_PICK && resultCode == Activity.RESULT_OK) {
            data?.data?.let { uri ->
                imageUri = uri
                try {
                    // 通过 MediaStore 获取 Bitmap
                    originalBitmap = MediaStore.Images.Media.getBitmap(contentResolver, uri)
                    imgPreview.setImageBitmap(originalBitmap)
                    Toast.makeText(this, "图片选择成功", Toast.LENGTH_SHORT).show()
                } catch (e: Exception) {
                    e.printStackTrace()
                    Toast.makeText(this, "图片加载失败", Toast.LENGTH_SHORT).show()
                }
            }
        }
        super.onActivityResult(requestCode, resultCode, data)
    }

    /**
     * 在原始 Bitmap 上添加文字水印，并保存为新图片
     *
     * @param srcBitmap 原始图片 Bitmap
     * @param watermark 水印文字内容
     */
    private fun processImageWithWatermark(srcBitmap: Bitmap, watermark: String) {
        // 获取原图宽高
        val width = srcBitmap.width
        val height = srcBitmap.height

        // 创建一个新的 Bitmap 对象，作为合成后输出图
        val outputBitmap = Bitmap.createBitmap(width, height, srcBitmap.config)
        val canvas = Canvas(outputBitmap)

        // 将原图绘制到 Canvas 上
        canvas.drawBitmap(srcBitmap, 0f, 0f, null)

        // 配置 Paint，用于绘制水印文字
        val paint = Paint()
        paint.color = Color.WHITE
        paint.textSize = (width / 20).toFloat()  // 根据图片宽度设置字号
        paint.isAntiAlias = true
        paint.alpha = 200  // 设置透明度，取值范围 0-255

        // 计算文字在图片中的位置（右下角，留出一定边距）
        val margin = 20f
        val textBounds = Rect()
        paint.getTextBounds(watermark, 0, watermark.length, textBounds)
        val x = width - textBounds.width() - margin
        val y = height - margin

        // 绘制文字水印到 Canvas 上
        canvas.drawText(watermark, x, y, paint)

        // 保存输出 Bitmap 为文件
        saveBitmapToFile(outputBitmap)
    }

    /**
     * 将 Bitmap 保存为 JPEG 文件，并更新 UI 展示输出文件路径
     *
     * @param bitmap 要保存的 Bitmap
     */
    private fun saveBitmapToFile(bitmap: Bitmap) {
        // 构造输出文件路径（存储在应用私有目录）
        val timeStamp = SimpleDateFormat("yyyyMMdd_HHmmss", Locale.getDefault()).format(Date())
        val imageFileName = "IMG_$timeStamp.jpg"
        val storageDir = getExternalFilesDir(Environment.DIRECTORY_PICTURES)
        val outputFile = File(storageDir, imageFileName)

        try {
            val fos = FileOutputStream(outputFile)
            // 以 JPEG 格式压缩保存，质量设置为 90
            bitmap.compress(Bitmap.CompressFormat.JPEG, 90, fos)
            fos.flush()
            fos.close()
            txtOutputPath.text = "输出文件路径：${outputFile.absolutePath}"
            Toast.makeText(this, "图片加水印成功！", Toast.LENGTH_LONG).show()
            Log.d(TAG, "保存图片成功：${outputFile.absolutePath}")
        } catch (e: Exception) {
            e.printStackTrace()
            Toast.makeText(this, "保存图片失败", Toast.LENGTH_SHORT).show()
        }
    }

    // 处理权限申请结果
    override fun onRequestPermissionsResult(requestCode: Int,
                                            permissions: Array<out String>,
                                            grantResults: IntArray) {
        if (requestCode == REQUEST_PERMISSION) {
            if (grantResults.isNotEmpty() && grantResults[0] == PackageManager.PERMISSION_GRANTED) {
                Toast.makeText(this, "存储权限获取成功", Toast.LENGTH_SHORT).show()
            } else {
                Toast.makeText(this, "存储权限未获取，部分功能将无法使用", Toast.LENGTH_SHORT).show()
            }
        }
        super.onRequestPermissionsResult(requestCode, permissions, grantResults)
    }
}

4.2 布局文件与资源说明

在 res/layout/activity_main.xml 中，布局设计主要包含：

• btnSelectImage：按钮，点击后选择图片文件

• edtWatermarkText：编辑框，用户输入水印文字

• btnProcessImage：按钮，点击后进行图片加水印处理

• imgPreview：ImageView，用于显示选中图片预览

• txtOutputPath：TextView，展示保存后的图片文件路径

示例布局文件如下：

<?xml version="1.0" encoding="utf-8"?>
<ScrollView xmlns:android="http://schemas.android.com/apk/res/android"
    android:layout_width="match_parent"
    android:layout_height="match_parent"
    android:fillViewport="true">
    
    <LinearLayout
        android:orientation="vertical"
        android:padding="16dp"
        android:layout_width="match_parent"
        android:layout_height="wrap_content">

        <Button
            android:id="@+id/btnSelectImage"
            android:layout_width="match_parent"
            android:layout_height="wrap_content"
            android:text="选择图片" />

        <ImageView
            android:id="@+id/imgPreview"
            android:layout_width="match_parent"
            android:layout_height="200dp"
            android:layout_marginTop="10dp"
            android:scaleType="fitCenter"
            android:background="#EEE" />

        <EditText
            android:id="@+id/edtWatermarkText"
            android:layout_width="match_parent"
            android:layout_height="wrap_content"
            android:layout_marginTop="10dp"
            android:hint="请输入水印文字" />

        <Button
            android:id="@+id/btnProcessImage"
            android:layout_width="match_parent"
            android:layout_height="wrap_content"
            android:layout_marginTop="10dp"
            android:text="开始加水印" />

        <TextView
            android:id="@+id/txtOutputPath"
            android:layout_width="match_parent"
            android:layout_height="wrap_content"
            android:layout_marginTop="10dp"
            android:text="输出文件路径将在此显示"
            android:textColor="@android:color/black" />

    </LinearLayout>
</ScrollView>

 

4.3 工具类与辅助方法

如需处理 Uri 转换或文件操作，可封装工具类（例如 FileUtils）。以下提供一个简单的示例，仅用于扩展功能时调用：

package com.example.imagewatermark

import android.content.Context
import android.database.Cursor
import android.net.Uri
import android.provider.MediaStore

object FileUtils {
    /**
     * 根据 Uri 获取文件路径（针对图片）
     */
    fun getPathFromUri(context: Context, uri: Uri): String? {
        val projection = arrayOf(MediaStore.Images.Media.DATA)
        var filePath: String? = null
        val cursor: Cursor? = context.contentResolver.query(uri, projection, null, null, null)
        cursor?.let {
            val columnIndex = it.getColumnIndexOrThrow(MediaStore.Images.Media.DATA)
            if (it.moveToFirst()) {
                filePath = it.getString(columnIndex)
            }
            it.close()
        }
        return filePath
    }
}

 

5. 代码解读与方法功能说明

5.1 核心方法解析

• selectImageFromGallery()
  调用系统的文件选择器，让用户选择一张图片。返回的 Uri 用于后续解码为 Bitmap。

• onActivityResult()
  在回调中通过 MediaStore 获取选中图片的 Bitmap，并在 ImageView 中预览。这里注意捕获异常，确保用户体验。

• processImageWithWatermark()
  这是整个项目的核心方法，负责实现图片水印：

  1. 获取原始 Bitmap 的宽度和高度，创建一个同尺寸的空 Bitmap；

  2. 通过 Canvas 在新 Bitmap 上先绘制原图，再配置 Paint 绘制水印文字；

  3. 根据图片宽度动态计算字号、确定文字绘制位置（如右下角留边距）；

  4. 最后调用 saveBitmapToFile() 将处理后的 Bitmap 保存到本地。

• saveBitmapToFile()
  利用 Bitmap.compress() 方法将 Bitmap 保存为 JPEG 文件，存储路径设在应用私有目录，并更新界面显示输出文件路径。

5.2 图像合成与 Canvas 绘制原理

在 Android 中，Canvas 类是绘制二维图形的核心工具。利用 Canvas.drawBitmap()、drawText() 等方法，可以将多种图像及文本合成在同一 Bitmap 上。通过 Paint 设置颜色、字号、透明度等参数，确保水印与原图合成后效果美观。结合 Matrix 还可以对水印图片进行旋转、缩放，达到更灵活的水印效果（本例主要展示文字水印，可扩展图片水印实现）。

---

6. 项目调试、测试与常见问题

6.1 日志输出与断点调试

• 日志记录
  使用 Log.d() 输出关键变量和错误信息，有助于在出现问题时迅速定位原因。

• 断点调试
  结合 Android Studio 的断点调试功能，逐步检查图片解码、Canvas 绘制、Bitmap 保存等流程，确保每一步均按照预期执行。

6.2 常见问题及解决方案

问题描述	可能原因	解决方案
选择图片后预览为空	图片解码失败或权限未正确申请	检查权限，使用 try-catch 捕获异常，确保图片 URI 有效
图片保存失败	存储路径无权限或磁盘空间不足	检查存储权限和设备剩余空间
内存溢出（OOM）	高分辨率图片未进行采样	使用 BitmapFactory.Options 设置 inSampleSize 降低内存消耗
水印文字显示异常	字体大小或位置计算错误	调整 Paint 属性，测试不同设备下的显示效果

---

7. 项目总结与未来展望

7.1 项目成果总结

本项目实现了 Android 平台上图片加水印的完整流程，主要成果包括：

• 系统掌握 Android 图像处理技术
  从 Bitmap、Canvas、Paint 的使用，到文件保存和权限管理，均涵盖在内，帮助开发者全面了解 Android 图像处理的底层实现。

• 模块化设计与扩展性
  项目结构清晰，UI 与图像处理逻辑分离，便于后续扩展。例如，文字水印可扩展为支持多行文字、动态字体；图片水印可增加旋转、缩放等高级功能。

• 用户体验与健壮性提升
  在处理过程中，通过异常捕获、日志记录和用户提示，确保处理失败时能够给出友好反馈，同时保障在大图处理时内存管理合理。

7.2 扩展功能与发展方向

未来可以在以下方向扩展：

1. 图片水印（Logo）支持
   除了文字水印，增加水印图片的叠加，支持用户自选 Logo，并设置位置、透明度、旋转角度等参数。

2. 动态水印
   根据用户操作或图片 EXIF 信息自动添加时间戳、地点信息，实现更智能化的水印添加功能。

3. 批量处理与分享功能
   支持一次性对多张图片添加水印，并提供直接分享、保存到云端或同步到社交平台的功能。

4. 实时预览与编辑
   利用 OpenGL 或第三方图像处理库，实现水印效果的实时预览，用户可以动态调整参数后预览效果，进一步提升体验。

5. 高效内存优化
   对于超大分辨率图片，采用分块加载与处理，避免内存溢出，并利用 RenderScript 等技术加速处理。

---

8. 参考资料与学习资源

以下为参考资料和学习资源，有助于深入理解相关技术：

• Android Developers – Bitmap、Canvas 与 Paint

• Android 内存优化技巧与 Bitmap 处理

• Android 存储权限申请指南

• 数字图像处理基础

• 知乎、掘金上的相关技术文章

• GitHub 上开源的图像处理项目