Working with Vector Graphics

Dans ce chapitre, nous allons explorer comment utiliser la puissante classe GraphicsAbsorber pour interagir avec les graphiques vectoriels au sein des documents PDF. Que vous ayez besoin de déplacer, supprimer ou ajouter des graphiques, ce guide vous montrera comment effectuer ces tâches efficacement. Commençons !

Introduction

Les graphiques vectoriels sont un composant crucial de nombreux documents PDF, utilisés pour représenter des images, des formes et d’autres éléments graphiques. Aspose.PDF fournit la classe GraphicsAbsorber, qui permet aux développeurs d’accéder et de manipuler ces graphiques de manière programmatique. En utilisant la méthode Visit de GraphicsAbsorber, vous pouvez extraire les graphiques vectoriels d’une page spécifiée et effectuer diverses opérations, telles que les déplacer, les supprimer ou les copier vers d’autres pages.

1. Extraire les graphiques avec GraphicsAbsorber

La première étape pour travailler avec les graphiques vectoriels est de les extraire d’un document PDF. Voici comment vous pouvez le faire en utilisant la classe GraphicsAbsorber :

public static void UsingGraphicsAbsorber()
{
    // Étape 1 : Créer un objet Document.
    var document = new Document(@"C:\Samples\Sample-Document-01.pdf");

    // Étape 2 : Créer une instance de GraphicsAbsorber.
    var graphicsAbsorber = new GraphicsAbsorber();

    // Sélectionner la première page du document.
    var page = document.Pages[1];

    // Étape 3 : Utiliser la méthode `Visit` pour extraire les graphiques de la page.
    graphicsAbsorber.Visit(page);

    // Afficher des informations sur les éléments extraits.
    foreach (var element in graphicsAbsorber.Elements)
    {
        Console.WriteLine($"Numéro de page : {element.SourcePage.Number}");
        Console.WriteLine($"Position : ({element.Position.X}, {element.Position.Y})");
        Console.WriteLine($"Nombre d'opérateurs : {element.Operators.Count}");
    }
}

Explication :

  1. Créer un objet Document : Un nouvel objet Document est instancié avec le chemin vers le fichier PDF cible.
  2. Créer une instance de GraphicsAbsorber : Cette classe capture tous les éléments graphiques d’une page spécifiée.
  3. Méthode Visit : La méthode Visit est appelée sur la première page, permettant à GraphicsAbsorber d’absorber les graphiques vectoriels.
  4. Itérer à travers les éléments extraits : Le code boucle à travers chaque élément extrait, imprimant des informations telles que le numéro de page, la position et le nombre d’opérateurs de dessin impliqués.

2. Déplacer les graphiques

Une fois que vous avez extrait les graphiques, vous pouvez les déplacer à une position différente sur la même page. Voici comment vous pouvez y parvenir :

public static void MoveGraphics()
{
    var document = new Document(@"C:\Samples\Sample-Document-01.pdf");
    var graphicsAbsorber = new GraphicsAbsorber();
    var page = document.Pages[1];
    graphicsAbsorber.Visit(page);

    // Suspendre temporairement les mises à jour pour améliorer les performances.
    graphicsAbsorber.SuppressUpdate();

    foreach (var element in graphicsAbsorber.Elements)
    {
        var position = element.Position;
        // Déplacer les graphiques en décalant ses coordonnées X et Y.
        element.Position = new Point(position.X + 150, position.Y - 10);
    }

    // Reprendre les mises à jour et appliquer les changements.
    graphicsAbsorber.ResumeUpdate();
    document.Save("test.pdf");
}

Points Clés :

  • SuppressUpdate : Cette méthode suspend temporairement les mises à jour pour améliorer les performances lors de la réalisation de modifications multiples.
  • ResumeUpdate : Cette méthode reprend les mises à jour et applique les modifications apportées aux positions des graphiques.
  • Positionnement des Éléments : La position de chaque graphique est ajustée en modifiant ses coordonnées X et Y.

3. Suppression de Graphiques

Il existe des scénarios où vous pourriez vouloir supprimer des graphiques spécifiques d’une page. Aspose.PDF propose deux méthodes pour y parvenir :

Méthode 1 : Utilisation d’une Limite Rectangulaire

public static void RemoveGraphicsMethod1()
{
    var document = new Document(@"C:\Samples\Sample-Document-01.pdf");
    var graphicsAbsorber = new GraphicsAbsorber();
    var page = document.Pages[1];
    graphicsAbsorber.Visit(page);
    var rectangle = new Rectangle(70, 248, 170, 252);

    graphicsAbsorber.SuppressUpdate();
    foreach (var element in graphicsAbsorber.Elements)
    {
        // Vérifiez si la position du graphique se trouve dans le rectangle.
        if (rectangle.Contains(element.Position))
        {
            element.Remove(); // Supprimez l'élément graphique.
        }
    }
    graphicsAbsorber.ResumeUpdate();
    document.Save("test.pdf");
}

Méthode 2 : Utilisation d’une collection d’éléments supprimés

public static void RemoveGraphicsMethod2()
{
    var document = new Document(@"C:\Samples\Sample-Document-01.pdf");
    var graphicsAbsorber = new GraphicsAbsorber();
    var page = document.Pages[1];
    var rectangle = new Rectangle(70, 248, 170, 252);

    graphicsAbsorber.Visit(page);
    var removedElementsCollection = new GraphicElementCollection();
    foreach (var item in graphicsAbsorber.Elements.Where(el => rectangle.Contains(el.Position)))
    {
        removedElementsCollection.Add(item);
    }

    page.Contents.SuppressUpdate();
    page.DeleteGraphics(removedElementsCollection);
    page.Contents.ResumeUpdate();
    document.Save("test.pdf");
}

Explication :

  • Limite du Rectangle : Définir une zone rectangulaire pour spécifier quels graphiques supprimer.
  • Supprimer et reprendre les mises à jour : Assurer une suppression efficace sans rendu intermédiaire.

4. Ajout de graphiques à une autre page

Les graphiques absorbés d’une page peuvent être ajoutés à une autre page du même document. Les graphiques absorbés d’une page peuvent être ajoutés à une autre page dans le même document.

Méthode 1 : Ajout de graphiques individuellement

public static void AddToAnotherPageMethod1()
{
    var document = new Document(@"C:\Samples\Sample-Document-01.pdf");
    var graphicsAbsorber = new GraphicsAbsorber();
    var page1 = document.Pages[1];
    var page2 = document.Pages[2];

    graphicsAbsorber.Visit(page1);
    page2.Contents.SuppressUpdate();
    foreach (var element in graphicsAbsorber.Elements)
    {
        element.AddOnPage(page2); // Ajouter chaque élément graphique à la deuxième page.
    }
    page2.Contents.ResumeUpdate();
    document.Save("test.pdf");
}

Méthode 2 : Ajout de graphiques en tant que collection

public static void AddToAnotherPageMethod2()
{
    var document = new Document(@"C:\Samples\Sample-Document-01.pdf");
    var graphicsAbsorber = new GraphicsAbsorber();
    var page1 = document.Pages[1];
    var page2 = document.Pages[2];

    graphicsAbsorber.Visit(page1);
    page2.Contents.SuppressUpdate();
    page2.AddGraphics(graphicsAbsorber.Elements); // Ajouter tous les graphiques en une seule fois.
    page2.Contents.ResumeUpdate();
    document.Save("test.pdf");
}

Points Clés :

  • SuppressUpdate et ResumeUpdate : Ces méthodes aident à maintenir la performance lors de modifications en masse.
  • AddOnPage vs. AddGraphics : Utilisez AddOnPage pour les ajouts individuels et AddGraphics pour les ajouts en masse.

Conclusion

Dans ce chapitre, nous avons exploré comment utiliser la classe GraphicsAbsorber pour extraire, déplacer, supprimer et ajouter des graphiques vectoriels dans des documents PDF en utilisant Aspose.PDF. En maîtrisant ces techniques, vous pouvez améliorer significativement la présentation visuelle de vos PDFs et créer des documents dynamiques et visuellement attrayants.

N’hésitez pas à expérimenter avec les exemples de code et à les adapter à vos cas d’utilisation spécifiques. Bon codage !

Travailler avec JavaScript Travailler avec les pièces jointes dans les fichiers PDF