Watermark.Net/docs/README.CN.md

Watermark.Net

Watermark.Net 是一个现代化、跨平台的 .NET 图像水印库，可使用 C# 为图片和图形添加文字或图片水印。

该项目基于 SixLabors.ImageSharp 构建，并提供简洁且可扩展的 API，适用于：

• .NET 图像水印处理
• 批量图片处理
• 图片版权保护
• Logo 覆盖
• 品牌自动化
• 草稿/测试图片生成

适用于 ASP.NET 应用、媒体处理流水线、SaaS 平台、桌面工具、自动化脚本以及后端图像处理服务。

---

为什么选择 Watermark.Net？

• ✅ 基于现代 .NET 8+ 架构
• ✅ 完全跨平台（Windows / Linux / macOS）
• ✅ 基于 ImageSharp
• ✅ 简洁易用的 API
• ✅ 支持批量目录处理
• ✅ 支持文字与图片水印
• ✅ 支持平铺/重复水印模式
• ✅ 支持 Dependency Injection
• ✅ 开源 MIT 协议

---

功能特性

文字水印

支持：

• 自定义字体
• 字体大小
• 旋转
• 透明度
• 边距
• 九宫格定位系统
• 平铺模式

图片水印

支持 Logo 与 PNG 图片覆盖：

• PNG 透明度支持
• 不透明度控制
• 缩放
• 定位
• 平铺/重复模式

批量处理

使用单个方法即可处理整个目录中的图片。

支持格式：

• JPEG
• PNG
• BMP
• GIF

---

安装

dotnet add package Watermark.Net

Install-Package Watermark.Net

要求：

• .NET 8 或更高版本

---

快速开始

添加文字水印

var watermark = new TextWatermark
{
    Text = "CONFIDENTIAL",
    Font = SystemFonts.CreateFont("Arial", 36)
};

---

添加图片水印

var watermark = new ImageWatermark
{
    ImagePath = "logo.png"
};

---

常见使用场景

• 图片版权保护
• 电商产品图片品牌化
• SaaS 图像处理流水线
• AI 生成图片标记
• CMS 系统
• 社交媒体自动化
• 后端图像处理服务
• ASP.NET 图片服务
• 批量图片处理
• 内部文档标记

---

License

本项目基于 MIT License 开源。