À propos de l'API GroupDocs.Annotation pour Java

L’API GroupDocs.Annotation for Java est une bibliothèque qui vous permet d’ajouter des annotations aux documents PDF, Word et autres sur Mac, Windows ou Ubuntu. GroupDocs.Annotation for Java est une API Java native pour la gestion des annotations avec une prise en charge complète pour la création, l’ajout, la modification, la suppression, l’extraction et l’exportation d’annotations à partir d’images et de divers autres documents. La liste complète des formats de documents pris en charge que vous pouvez voir sur cette page. Cette bibliothèque vous permet de travailler non seulement avec le document GIF mais également avec de nombreux autres types de documents tels que Word, Excel, PowerPoint, les e-mails Outlook, Visio, Adobe, OpenDocument, OpenOffice, Photoshop, AutoCad et bien d’autres. L’API GroupDocs.Annotation pour Java vous permet de créer et d’ajouter de nouvelles notes, de modifier des annotations, d’extraire des commentaires, des annotations et de les supprimer des documents. La bibliothèque prend en charge 13 types d’annotations différents, notamment Texte, Polyligne, Zone, Souligné, Point, Filigrane, Flèche, Ellipse, Remplacement de texte, Distance, Champ de texte, Rédaction de ressources en PDF, HTML, documents Microsoft Word, feuilles de calcul, diagrammes, présentations, dessins, images et de nombreux autres formats de fichiers. L’exemple (voir ci-dessous) montre comment travailler avec le document GIF, dans cet exemple, vous pouvez voir les principales étapes de la façon de travailler avec GroupDocs.Annotation : configurer une licence, ouvrir un document avec lequel vous souhaitez travailler, créer un annotation, en ajoutant des objets de données pour définir les propriétés d’annotation en fonction de vos besoins et en enregistrant le résultat à l’endroit requis. Vous pouvez également consulter plus en détail les fonctionnalités prises en charge sur notre page github, ou dans notre produit documentation.

Étapes pour ajouter des annotations à GIF en Java

GroupDocs.Annotation permet aux développeurs Java d’ajouter facilement divers types d’annotations aux fichiers GIF dans n’importe quelle application Java en implémentant quelques étapes simples.

Créez des objets de réponse avec un commentaire et une date.
Créez un objet AreaAnnotation, définissez les options de zone et ajoutez des réponses.
Créez un objet Annotator et ajoutez une annotation de zone.
Enregistrez le fichier de sortie.

Configuration requise

Les API GroupDocs.Annotation pour Java sont prises en charge sur toutes les principales plates-formes et systèmes d’exploitation. Avant d’exécuter le code ci-dessous, assurez-vous que les prérequis suivants sont installés sur votre système.

Systèmes d’exploitation : Microsoft Windows, Linux, MacOS
Environnement de développement : NetBeans, Intellij IDEA, Eclipse, etc.
Environnement d’exécution Java : Java 7 (1.7) et supérieur
Obtenez la dernière version de GroupDocs.Annotation pour Java à partir de GroupDocs Artifact Repository

Aperçu des annotations et exemple de code

// Create an instance of Reply class and add comments
Reply firstReply = new Reply();
firstReply.setComment("First comment");
firstReply.setRepliedOn(Calendar.getInstance().getTime());

Reply secondReply = new Reply();
secondReply.setComment("Second comment");
secondReply.setRepliedOn(Calendar.getInstance().getTime());

List<Reply> replies = new ArrayList<Reply>();
replies.add(firstReply);
replies.add(secondReply);

// Create an instance of AreaAnnotation class and set options
AreaAnnotation area = new AreaAnnotation();
area.setBackgroundColor(65535);
area.setBox(new Rectangle(100, 100, 100, 100));
area.setCreatedOn(Calendar.getInstance().getTime());
area.setMessage("This is area annotation");
area.setOpacity(0.7);
area.setPageNumber(0);
area.setPenColor(65535);
area.setPenStyle(PenStyle.Dot);
area.setPenWidth((byte) 3);
area.setReplies(replies);

// Create an instance of Annotator class
Annotator annotator = new Annotator("input.bmp");

// Add annotation
annotator.add(area);

// Save to file
annotator.save("output.bmp");
annotator.dispose();

Annotation preview image

Étapes pour modifier les annotations de GIF en Java

GroupDocs.Annotation permet aux développeurs Java de mettre à jour plus facilement diverses propriétés d’annotation à partir de fichiers GIF dans n’importe quelle application Java en implémentant quelques étapes simples.

Instanciez l’objet Annotator avec le chemin d’accès au document d’entrée ou le flux avec LoadOptions instancié avec ImportAnnotations = true.
Créez une implémentation AnnotationBase et définissez l’ID de l’annotation existante (si l’annotation avec cet ID n’est pas trouvée, rien ne sera modifié) ou la liste des chemins d’annotations (toutes les annotations existantes seront supprimées).
Appelez la méthode de mise à jour de l’objet Annotator avec les annotations transmises.
Appelez la méthode save avec le chemin ou le flux de document résultant et l’objet SaveOptions.

String outputPath = "UpdateAnnotation.bmp";

// Create an instance of Annotator class
Annotator annotator = new Annotator("input.bmp");

// Create an instance of Reply class for first example and add comments
Reply reply1 = new Reply();
reply1.setComment("Original first comment");
reply1.setRepliedOn(Calendar.getInstance().getTime());

Reply reply2 = new Reply();
reply2.setComment("Original second comment");
reply2.setRepliedOn(Calendar.getInstance().getTime());

java.util.List replies = new ArrayList();
replies.add(reply1);
replies.add(reply2);

// Create an instance of AreaAnnotation class and set options
AreaAnnotation original = new AreaAnnotation();
original.setId(1);
original.setBackgroundColor(65535);
original.setBox(new Rectangle(100, 100, 100, 100));
original.setCreatedOn(Calendar.getInstance().getTime());
original.setMessage("This is original annotation");
original.setReplies(replies);

// Add original annotation
annotator.add(original);
annotator.save(outputPath);
annotator.dispose();

LoadOptions loadOptions = new LoadOptions();

// Open annotated document
Annotator annotator1 = new Annotator(outputPath, loadOptions);

// Create an instance of Reply class for update first example
Reply reply3 = new Reply();
reply3.setComment("Updated first comment");
reply3.setRepliedOn(Calendar.getInstance().getTime());

Reply reply4 = new Reply();
reply4.setComment("Updated second comment");
reply4.setRepliedOn(Calendar.getInstance().getTime());

java.util.List replies1 = new ArrayList();
replies1.add(reply3);
replies1.add(reply4);

// Suggest we want change some properties of existed annotation
AreaAnnotation updated = new AreaAnnotation();
updated.setId(1);
updated.setBackgroundColor(255);
updated.setBox(new Rectangle(0, 0, 50, 200));
updated.setCreatedOn(Calendar.getInstance().getTime());
updated.setMessage("This is updated annotation");
updated.setReplies(replies1);

// Update and save annotation
annotator1.update(updated);
annotator1.save(outputPath);
annotator1.dispose();

Étapes pour extraire les annotations de GIF en Java

GroupDocs.Annotation permet aux développeurs Java d’annoter facilement des documents et d’extraire des informations d’annotation à partir de fichiers GIF dans n’importe quelle application Java en implémentant quelques étapes simples.

Créez des objets de réponse avec un commentaire et une date.
Instanciez l’objet LoadOptions et appelez SetImportAnnotations avec l’argument true.
Définissez une variable de type Liste.
Appelez la méthode get et renvoyez le résultat à la variable ci-dessus.

À propos du format de fichier GIF

Un format GIF ou Graphical Interchange est un type d’image hautement compressée. Propriété d’Unisys, GIF utilise l’algorithme de compression LZW qui ne dégrade pas la qualité de l’image. Pour chaque image, le GIF autorise généralement jusqu’à 8 bits par pixel et jusqu’à 256 couleurs sont autorisées sur l’image. Contrairement à une image JPEG, qui peut afficher jusqu’à 16 millions de couleurs et touche assez les limites de l’œil humain. À l’époque de l’émergence d’Internet, les GIF restaient le meilleur choix car ils nécessitaient une faible bande passante et étaient compatibles avec les graphiques qui consommaient des zones de couleur unies. Un GIF animé combine de nombreuses images ou cadres dans un seul fichier et les affiche dans une séquence pour générer un clip animé ou une courte vidéo. Les limitations de couleur vont jusqu’à 256 pour chaque image et sont probablement les moins appropriées pour reproduire d’autres images et photographies avec un dégradé de couleurs.

En savoir plus À propos du format de fichier GIF

Travailler avec d'autres formats de documents courants

Mettez à jour les propriétés d’annotation de certains des formats de fichiers populaires, comme indiqué ci-dessous.

Annoter GIF à partir de Java