anotar imágenes jpg usando C#

Puede anotar imágenes de formatos de imagen populares como JPEG, PNG, TIFF mediante programación. Las anotaciones en las imágenes proporcionan información adicional sobre un dato existente. Puede agregar una amplia gama de anotaciones de gráficos, texto y marcas de agua a las imágenes en sus aplicaciones .NET. En este artículo, aprenderá cómo anotar imágenes JPG usando C#.

Los siguientes temas se discuten/tratan en este artículo:

API de C# para anotar imágenes

Para anotar imágenes JPG, usaré GroupDocs.Annotation for .NET API. Permite crear mediante programación aplicaciones de anotación de documentos en C#, ASP.NET y otras tecnologías .NET relacionadas. Puede agregar tipos de anotaciones populares como área, punto, texto, elipse, enlace, subrayado, polilínea, flecha, distancia, marca de agua, imagen, etc. a sus documentos de todos los formatos populares. La API también le permite exportar documentos después de agregar anotaciones, comentarios o notas resaltadas a su formato original.

Puede descargar la DLL de la API o instalarla mediante NuGet.

Install-Package GroupDocs.Annotation

Anotar imágenes JPG usando C#

Puede agregar múltiples anotaciones para anotar sus imágenes JPG siguiendo los pasos que se detallan a continuación:.

  • Crear una instancia de la clase Annotator
  • Proporcione la ruta del archivo de entrada
  • Cree una instancia de la clase ArrowAnnotation
  • Establezca varias propiedades para ArrowAnnotation, como color, opacidad, estilo, etc.
  • Añadir ArrowAnnotation a la lista de anotaciones
  • Crea una instancia de la clase DistanceAnnotation
  • Establezca varias propiedades para Anotación de distancia, como color, opacidad, estilo, etc.
  • Añadir Anotación de Distancia a la Lista de Anotaciones
  • Cree una instancia de la clase EllipseAnnotation
  • Establezca varias propiedades para EllipseAnnotation, como color, opacidad, estilo, etc.
  • Agregar EllipseAnnotation a la lista de anotaciones
  • Crear una instancia de la clase PointAnnotation
  • Establezca varias propiedades para PointAnnotation, como el tamaño y la ubicación del cuadro
  • Añadir PointAnnotation a la lista de anotaciones
  • Llame al método Add() para agregar anotaciones al Annotator
  • Llame al método Save() y guarde el archivo resultante

El siguiente ejemplo de código muestra cómo anotar una imagen JPG usando C#.

// inicializar anotador
Annotator annotator = new Annotator("C:\\Files\\sample.jpg");

List<AnnotationBase> annotations = new List<AnnotationBase>();

// definir y agregar anotaciones de flecha
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);

// definir y agregar anotaciones de distancia
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);

// definir y agregar anotaciones de elipse
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);

// definir y agregar anotaciones de puntos
PointAnnotation point = new PointAnnotation
{
    Box = new Rectangle(75, 605, 10, 10),
    CreatedOn = DateTime.Now,
};
annotations.Add(point);

// agregar anotaciones al anotador
annotator.Add(annotations);

// guardar el archivo de salida
annotator.Save("C:\\Files\\result.jpg");
Anotar imágenes JPG usando C#

Anotar imágenes JPG usando C#

La clase Annotator es la clase principal que controla el proceso de anotación del documento. Proporciona varios métodos para agregar, actualizar o eliminar anotaciones. El método Save() de esta clase guarda el archivo anotado en la ruta dada.

La API proporciona varias clases específicas para definir varios tipos de anotaciones, como:

  • La clase ArrowAnnotation proporciona propiedades para definir la anotación de flecha
  • Las instalaciones de la clase DistanceAnnotation para definir la anotación de distancia
  • La clase EllipseAnnotation se puede utilizar para definir una anotación Ellipse
  • La clase PointAnnotation proporciona propiedades para definir una anotación de punto

Agregar anotación de área a JPG usando C#

Puede agregar anotaciones de área a sus imágenes JPG mediante programación siguiendo los pasos que se detallan a continuación:.

  • Crear una instancia de la clase Annotator
  • Proporcione la ruta del archivo de entrada
  • Crea una instancia de la clase AreaAnnotation
  • Establezca varias propiedades para AreaAnnotation, como Posición, Color, Mensaje, Opacidad, Estilo, etc.
  • Llame al método Add() para agregar AreaAnnotation al Annotator
  • Llame al método Save() y guarde el archivo resultante

El siguiente ejemplo de código muestra cómo agregar anotaciones de área a una imagen JPG usando C#.

// inicializar anotador
Annotator annotator = new Annotator("C:\\Files\\sample.jpg");

// definir anotación de área
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;

// añadir anotación de área
annotator.Add(area);

// guardar el archivo de salida
annotator.Save("C:\\Files\\result.jpg");
Agregar anotación de área a JPG usando C#

Agregar anotación de área a JPG usando C#

Agregar anotación de campo de texto a JPG usando C#

Puede agregar anotaciones de campo de texto a sus imágenes JPG siguiendo los pasos que se detallan a continuación:.

  • Crear una instancia de la clase Annotator
  • Proporcione la ruta del archivo de entrada
  • Crear una instancia de la clase TextFieldAnnotation
  • Establezca varias propiedades para TextFieldAnnotation, como Texto, Color, Opacidad, Estilo, Fuente, etc.
  • Llame al método Add() para agregar TextFieldAnnotation al Annotator
  • Llame al método Save() y guarde el archivo resultante

El siguiente ejemplo de código muestra cómo agregar una anotación de campo de texto a una imagen JPG usando C#.

// inicializar anotador
Annotator annotator = new Annotator("C:\\Files\\sample.jpg");

// definir anotación de campo de texto
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;

// añadir anotación de campo de texto
annotator.Add(textField);

// guardar el archivo de salida
annotator.Save("C:\\Files\\result.jpg");
Agregar anotación de campo de texto a JPG usando C#

Agregar anotación de campo de texto a JPG usando C#

Anotación de imágenes JPG con marca de agua usando C#

Puede anotar sus imágenes JPG con texto de marca de agua siguiendo los pasos que se detallan a continuación:.

  • Crear una instancia de la clase Annotator
  • Proporcione la ruta del archivo de entrada
  • Cree una instancia de la clase WatermarkAnnotation
  • Establezca varias propiedades para la anotación de marca de agua, como texto, color, tamaño de fuente, alineación, etc.
  • Llame al método Add() para agregar WatermarkAnnotation al Annotator
  • Llame al método Save() y guarde el archivo resultante

El siguiente ejemplo de código muestra cómo anotar una imagen JPG con texto de marca de agua usando C#.

// inicializar anotador
Annotator annotator = new Annotator("C:\\Files\\sample.jpg");

// definir anotación de marca de agua
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;

// añadir anotación de marca de agua
annotator.Add(watermark);

// guardar el archivo de salida
annotator.Save("C:\\Files\\result.jpg");
Imágenes de anotación con marca de agua

Anotación de imágenes JPG con marca de agua usando C#

Obtenga una licencia gratis

Puede probar la API sin limitaciones de evaluación solicitando una licencia temporal gratuita.

Conclusión

En este artículo, ha aprendido cómo anotar imágenes JPG usando C#. También aprendió cómo agregar múltiples anotaciones a las imágenes JPG. Además, ha aprendido cómo agregar anotaciones de área, campo de texto y marca de agua a las imágenes JPG mediante programación en C#. Puede obtener más información sobre GroupDocs.Annotation para la API de .NET mediante la documentación. En caso de cualquier ambigüedad, no dude en contactarnos en el foro.

Ver también