mirror of
https://github.com/Geckon01/Watermark.Net.git
synced 2026-06-15 01:13:31 +03:00
134 lines
2.7 KiB
Plaintext
134 lines
2.7 KiB
Plaintext
# Watermark.Net
|
||
|
||
[](https://github.com/Geckon01/Watermark.Net/actions/workflows/dotnet.yml)
|
||
|
||
|
||
|
||
|
||
[](https://app.codacy.com/gh/Geckon01/Watermark.Net/dashboard?utm_source=gh&utm_medium=referral&utm_content=&utm_campaign=Badge_grade)
|
||
|
||
**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
|
||
|
||
---
|
||
|
||
# 安装
|
||
|
||
```bash
|
||
dotnet add package Watermark.Net
|
||
```
|
||
|
||
```powershell
|
||
Install-Package Watermark.Net
|
||
```
|
||
|
||
要求：
|
||
|
||
- .NET 8 或更高版本
|
||
|
||
---
|
||
|
||
# 快速开始
|
||
|
||
## 添加文字水印
|
||
|
||
```csharp
|
||
var watermark = new TextWatermark
|
||
{
|
||
Text = "CONFIDENTIAL",
|
||
Font = SystemFonts.CreateFont("Arial", 36)
|
||
};
|
||
```
|
||
|
||
---
|
||
|
||
## 添加图片水印
|
||
|
||
```csharp
|
||
var watermark = new ImageWatermark
|
||
{
|
||
ImagePath = "logo.png"
|
||
};
|
||
```
|
||
|
||
---
|
||
|
||
# 常见使用场景
|
||
|
||
- 图片版权保护
|
||
- 电商产品图片品牌化
|
||
- SaaS 图像处理流水线
|
||
- AI 生成图片标记
|
||
- CMS 系统
|
||
- 社交媒体自动化
|
||
- 后端图像处理服务
|
||
- ASP.NET 图片服务
|
||
- 批量图片处理
|
||
- 内部文档标记
|
||
|
||
---
|
||
|
||
# License
|
||
|
||
本项目基于 MIT License 开源。 |