您可以以编程方式注释流行图像格式的图像,例如 JPEG、PNG、TIFF。图像上的注释提供了有关现有数据的附加信息。您可以向 .NET 应用程序中的图像添加范围广泛的图形、文本和水印注释。在本文中,您将学习如何使用 C# 注释 JPG 图像。
本文讨论/涵盖了以下主题:
用于注释图像的 C# API
为了注释 JPG 图像,我将使用 GroupDocs.Annotation for .NET API。它允许以编程方式在 C#、ASP.NET 和其他相关 .NET 技术中构建文档注释应用程序。您可以在所有流行格式的文档中添加流行的注释类型,例如区域、点、文本、椭圆、链接、下划线、折线、箭头、距离、水印、图像等。该 API 还允许您在将注释、评论或突出显示的注释添加回其原始格式后导出文档。
您可以 下载 API 的 DLL 或使用 NuGet 安装它。
Install-Package GroupDocs.Annotation
使用 C# 注释 JPG 图像
您可以按照以下步骤添加多个注释来注释您的 JPG 图像:
- 创建 Annotator 类的实例
- 提供输入文件路径
- 创建 ArrowAnnotation 类的实例
- 设置 ArrowAnnotation 的各种属性,例如颜色、不透明度、样式等。
- 将 ArrowAnnotation 添加到注释列表
- 创建 DistanceAnnotation 类的实例
- 为 DistanceAnnotation 设置各种属性,例如颜色、不透明度、样式等。
- 将 DistanceAnnotation 添加到注释列表
- 创建 EllipseAnnotation 类的实例
- 为 EllipseAnnotation 设置各种属性,例如颜色、不透明度、样式等。
- 将 EllipseAnnotation 添加到注释列表
- 创建 PointAnnotation 类的实例
- 设置 PointAnnotation 的各种属性,例如框大小和位置
- 将 PointAnnotation 添加到注释列表
- 调用Add()方法给Annotator添加注解
- 调用 Save() 方法并保存生成的文件
以下代码示例展示了如何使用 C# 注释 JPG 图像。
// 初始化注释器
Annotator annotator = new Annotator("C:\\Files\\sample.jpg");
List<AnnotationBase> annotations = new List<AnnotationBase>();
// 定义和添加箭头注释
ArrowAnnotation arrow = new ArrowAnnotation
{
Box = new Rectangle(100, 100, 100, 100),
CreatedOn = DateTime.Now,
Opacity = 0.7,
PenColor = 16777215,
PenStyle = PenStyle.DashDotDot,
PenWidth = 5
};
annotations.Add(arrow);
// 定义和添加距离注释
DistanceAnnotation distance = new DistanceAnnotation
{
Box = new Rectangle(75, 545, 315, 0),
CreatedOn = DateTime.Now,
Opacity = 0.7,
PenColor = 65535,
PenStyle = PenStyle.Solid,
PenWidth = 9
};
annotations.Add(distance);
// 定义和添加椭圆注释
EllipseAnnotation ellipse = new EllipseAnnotation
{
BackgroundColor = 65535,
Box = new Rectangle(150, 300, 100, 100),
CreatedOn = DateTime.Now,
Opacity = 0.3,
PenColor = 65535,
PenStyle = PenStyle.Dot,
PenWidth = 3
};
annotations.Add(ellipse);
// 定义和添加点注释
PointAnnotation point = new PointAnnotation
{
Box = new Rectangle(75, 605, 10, 10),
CreatedOn = DateTime.Now,
};
annotations.Add(point);
// 向注释器添加注释
annotator.Add(annotations);
// 保存输出文件
annotator.Save("C:\\Files\\result.jpg");
Annotator 类是控制文档注释过程的主要类。它提供了各种方法来添加、更新或删除注释。此类的 Save() 方法将带注释的文件保存在给定路径。
API 提供了各种特定的类来定义各种类型的注解,例如:
- ArrowAnnotation 类提供了定义箭头注释的属性
- 用于定义距离注释的 DistanceAnnotation 类工具
- EllipseAnnotation 类可用于定义 Ellipse 注释
- PointAnnotation 类提供定义点注释的属性
使用 C# 将区域注释添加到 JPG
您可以按照以下步骤以编程方式向 JPG 图像添加区域注释:
- 创建 Annotator 类的实例
- 提供输入文件路径
- 创建 AreaAnnotation 类的实例
- 设置 AreaAnnotation 的各种属性,例如位置、颜色、消息、不透明度、样式等。
- 调用 Add() 方法将 AreaAnnotation 添加到 Annotator
- 调用 Save() 方法并保存生成的文件
以下代码示例展示了如何使用 C# 向 JPG 图像添加区域注释。
// 初始化注释器
Annotator annotator = new Annotator("C:\\Files\\sample.jpg");
// 定义区域注释
AreaAnnotation area = new AreaAnnotation();
area.BackgroundColor = 65535;
area.Box = new Rectangle(80, 575, 310, 50);
area.CreatedOn = DateTime.Now;
area.Opacity = 0.7;
area.PageNumber = 0;
area.PenColor = 65535;
area.PenStyle = PenStyle.Dot;
area.PenWidth = 3;
// 添加区域注释
annotator.Add(area);
// 保存输出文件
annotator.Save("C:\\Files\\result.jpg");
使用 C# 将文本字段注释添加到 JPG
您可以按照以下步骤为您的 JPG 图像添加文本字段注释:
- 创建 Annotator 类的实例
- 提供输入文件路径
- 创建 TextFieldAnnotation 类的实例
- 设置 TextFieldAnnotation 的各种属性,例如 Text、Color、Opacity、Style、Font 等。
- 调用 Add() 方法将 TextFieldAnnotation 添加到 Annotator
- 调用 Save() 方法并保存生成的文件
以下代码示例展示了如何使用 C# 向 JPG 图像添加文本字段注释。
// 初始化注释器
Annotator annotator = new Annotator("C:\\Files\\sample.jpg");
// 定义文本字段注释
TextFieldAnnotation textField = new TextFieldAnnotation();
textField.Box = new Rectangle(130, 120, 270, 30);
textField.CreatedOn = DateTime.Now;
textField.Text = "Document Automation APIs";
textField.FontColor = 16777215;
textField.FontSize = 12;
textField.Opacity = 1;
textField.PenStyle = PenStyle.Dot;
textField.PenWidth = 3;
textField.FontFamily = "Arial";
textField.TextHorizontalAlignment = HorizontalAlignment.Center;
// 添加文本字段注释
annotator.Add(textField);
// 保存输出文件
annotator.Save("C:\\Files\\result.jpg");
使用 C# 注释带有水印的 JPG 图像
您可以按照以下步骤使用水印文本注释您的 JPG 图像:
- 创建 Annotator 类的实例
- 提供输入文件路径
- 创建 WatermarkAnnotation 类的实例
- 设置 WatermarkAnnotation 的各种属性,例如文本、颜色、字体大小、对齐方式等。
- 调用 Add() 方法将 WatermarkAnnotation 添加到 Annotator
- 调用 Save() 方法并保存生成的文件
以下代码示例展示了如何使用 C# 使用水印文本注释 JPG 图像。
// 初始化注释器
Annotator annotator = new Annotator("C:\\Files\\sample.jpg");
// 定义水印注释
WatermarkAnnotation watermark = new WatermarkAnnotation();
watermark.Text = "This is a sample Watermark";
watermark.FontColor = 16777215;
watermark.FontSize = 22;
watermark.Opacity = 0.7;
watermark.HorizontalAlignment = HorizontalAlignment.Center;
watermark.VerticalAlignment = VerticalAlignment.Center;
// 添加水印注释
annotator.Add(watermark);
// 保存输出文件
annotator.Save("C:\\Files\\result.jpg");
获得免费许可证
您可以通过请求 免费的临时许可证 来试用该 API,而不受评估限制。
结论
在本文中,您学习了如何使用 C# 注释 JPG 图像。您还学习了如何为 JPG 图像添加多个注释。此外,您还学习了如何在 C# 中以编程方式向 JPG 图像添加区域、文本字段和水印注释。您可以使用 documentation 了解有关 .NET API 的 GroupDocs.Annotation 的更多信息。如有任何歧义,请随时在 论坛 上与我们联系。