anotar imagens jpg usando C#

Você pode anotar imagens de formatos de imagem populares como JPEG, PNG, TIFF programaticamente. As anotações nas imagens fornecem informações adicionais sobre um dado existente. Você pode adicionar uma ampla variedade de anotações de gráficos, textos e marcas d’água a imagens em seus aplicativos .NET. Neste artigo, você aprenderá a anotar imagens JPG usando C#.

Os seguintes tópicos são discutidos/abordados neste artigo:

API C# para anotar imagens

Para anotar imagens JPG, usarei a API GroupDocs.Annotation for .NET. Ele permite criar aplicativos de anotação de documentos programaticamente em C#, ASP.NET e outras tecnologias .NET relacionadas. Você pode adicionar tipos de anotação populares, como área, ponto, texto, elipse, link, sublinhado, polilinha, seta, distância, marca d’água, imagem, etc., aos seus documentos de todos os formatos populares. A API também permite exportar documentos após adicionar anotações, comentários ou notas destacadas de volta ao formato original.

Você pode baixar a DLL da API ou instalá-la usando NuGet.

Install-Package GroupDocs.Annotation

Anotar imagens JPG usando C#

Você pode adicionar várias anotações para anotar suas imagens JPG seguindo as etapas abaixo:.

  • Crie uma instância da classe Annotator
  • Forneça o caminho do arquivo de entrada
  • Crie uma instância da classe ArrowAnnotation
  • Defina várias propriedades para ArrowAnnotation, como Cor, Opacidade, Estilo etc.
  • Adicionar ArrowAnnotation à lista de anotações
  • Crie uma instância da classe DistanceAnnotation
  • Defina várias propriedades para DistanceAnnotation, como Cor, Opacidade, Estilo etc.
  • Adicionar DistanceAnnotation à lista de anotações
  • Crie uma instância da classe EllipseAnnotation
  • Defina várias propriedades para EllipseAnnotation, como Cor, Opacidade, Estilo etc.
  • Adicionar EllipseAnnotation à lista de anotações
  • Crie uma instância da classe PointAnnotation
  • Defina várias propriedades para PointAnnotation, como tamanho e localização da caixa
  • Adicionar PointAnnotation à lista de anotações
  • Chame o método Add() para adicionar anotações ao Anotador
  • Chame o método Save() e salve o arquivo resultante

O exemplo de código a seguir mostra como anotar uma imagem JPG usando C#.

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

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

// definir e adicionar anotação de seta
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 e adicionar anotação de distância
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 e adicionar anotação 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 e adicionar anotação de ponto
PointAnnotation point = new PointAnnotation
{
    Box = new Rectangle(75, 605, 10, 10),
    CreatedOn = DateTime.Now,
};
annotations.Add(point);

// adicionar anotações ao anotador
annotator.Add(annotations);

// salve o arquivo de saída
annotator.Save("C:\\Files\\result.jpg");
Anotar imagens JPG usando C#

Anotar imagens JPG usando C#

A classe Annotator é a classe principal que controla o processo de anotação do documento. Ele fornece vários métodos para adicionar, atualizar ou remover anotações. O método Save() desta classe salva o arquivo anotado no caminho fornecido.

A API fornece várias classes específicas para definir vários tipos de anotações, como:

  • A classe ArrowAnnotation fornece propriedades para definir a anotação de seta
  • As facilidades da classe DistanceAnnotation para definir a anotação de distância
  • A classe EllipseAnnotation pode ser usada para definir uma anotação Ellipse
  • A classe PointAnnotation fornece propriedades para definir uma anotação de ponto

Adicionar anotação de área ao JPG usando C

Você pode adicionar anotação de área às suas imagens JPG programaticamente seguindo as etapas abaixo:

  • Crie uma instância da classe Annotator
  • Forneça o caminho do arquivo de entrada
  • Crie uma instância da classe AreaAnnotation
  • Defina várias propriedades para AreaAnnotation, como Posição, Cor, Mensagem, Opacidade, Estilo etc.
  • Chame o método Add() para adicionar AreaAnnotation ao Anotador
  • Chame o método Save() e salve o arquivo resultante

O exemplo de código a seguir mostra como adicionar anotação de área a uma imagem JPG usando C#.

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

// definir anotação 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;

// adicionar anotação de área
annotator.Add(area);

// salve o arquivo de saída
annotator.Save("C:\\Files\\result.jpg");
Adicionar anotação de área ao JPG usando C #

Adicionar anotação de área ao JPG usando C #

Adicionar anotação de campo de texto ao JPG usando C#

Você pode adicionar anotação de campo de texto às suas imagens JPG seguindo as etapas abaixo:.

  • Crie uma instância da classe Annotator
  • Forneça o caminho do arquivo de entrada
  • Crie uma instância da classe TextFieldAnnotation
  • Defina várias propriedades para TextFieldAnnotation, como Texto, Cor, Opacidade, Estilo, Fonte, etc.
  • Chame o método Add() para adicionar TextFieldAnnotation ao Anotador
  • Chame o método Save() e salve o arquivo resultante

O exemplo de código a seguir mostra como adicionar anotação de campo de texto a uma imagem JPG usando C#.

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

// definir anotação 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;

// adicionar anotação de campo de texto
annotator.Add(textField);

// salve o arquivo de saída
annotator.Save("C:\\Files\\result.jpg");
Adicionar anotação de campo de texto ao JPG usando C#

Adicionar anotação de campo de texto ao JPG usando C#

Imagens JPG de anotação com marca d’água usando C#

Você pode anotar suas imagens JPG com texto de marca d’água seguindo as etapas abaixo:

  • Crie uma instância da classe Annotator
  • Forneça o caminho do arquivo de entrada
  • Crie uma instância da classe WatermarkAnnotation
  • Defina várias propriedades para WatermarkAnnotation, como Texto, Cor, Tamanho da Fonte, Alinhamento, etc.
  • Chame o método Add() para adicionar WatermarkAnnotation ao Anotador
  • Chame o método Save() e salve o arquivo resultante

O exemplo de código a seguir mostra como anotar uma imagem JPG com texto de marca d’água usando C#.

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

// definir anotação de marca d'água
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;

// adicionar anotação de marca d'água
annotator.Add(watermark);

// salve o arquivo de saída
annotator.Save("C:\\Files\\result.jpg");
Imagens de anotação com marca d'água

Imagens JPG de anotação com marca d’água usando C#

Obtenha uma licença gratuita

Você pode experimentar a API sem limitações de avaliação solicitando uma licença temporária gratuita.

Conclusão

Neste artigo, você aprendeu como anotar imagens JPG usando C#. Você também aprendeu como adicionar várias anotações a imagens JPG. Além disso, você aprendeu como adicionar anotações de área, campo de texto e marca d’água às imagens JPG programaticamente em C#. Você pode aprender mais sobre GroupDocs.Annotation para .NET API usando a documentação. Em caso de qualquer ambiguidade, não hesite em contactar-nos no fórum.

Veja também