Documentation – Travailler avec les graphiques PDF en Python

Python-Net: Ajouter des formes d'arc au PDF en Python

Fri, 22 May 2026 00:00:00 +0000

Ajouter l’objet Arc

Aspose.PDF for Python via .NET vous permet d’ajouter Arc des formes aux pages PDF en utilisant le Graph classe. Vous pouvez dessiner des arcs contournés et des segments d’arc remplis pour les diagrammes et les illustrations techniques.

Suivez les étapes ci-dessous:

Créer Document instance.
Créer Objet Graph avec certaines dimensions.
Définir border pour l’objet Graph.
Créer un objet d’arc correspondant.
Ajouter cet objet à la collection Shapes dans l’objet graph.
Ajouter Graph objet à la collection paragraphs de la page.
Enregistrez notre fichier PDF.

Le fragment de code suivant montre comment ajouter un Arc objet.

import aspose.pdf as ap
import aspose.pdf.drawing as drawing

def add_arc(outfile: str):
    document = ap.Document()
    page = document.pages.add()
    graph = drawing.Graph(400, 400)
    graph.border = ap.BorderInfo(ap.BorderSide.ALL, ap.Color.green)

    arc1 = drawing.Arc(100, 100, 95, 0, 90)
    arc1.graph_info.color = ap.Color.green_yellow
    graph.shapes.add(arc1)

    arc2 = drawing.Arc(100, 100, 90, 70, 180)
    arc2.graph_info.color = ap.Color.dark_blue
    graph.shapes.add(arc2)

    arc3 = drawing.Arc(100, 100, 85, 120, 210)
    arc3.graph_info.color = ap.Color.red
    graph.shapes.add(arc3)

    page.paragraphs.add(graph)
    document.save(outfile)

Créer un objet d’arc rempli

Cet exemple montre comment ajouter un segment d’arc rempli de couleur.

import aspose.pdf as ap
import aspose.pdf.drawing as drawing

def add_arc_filled(outfile: str):
    document = ap.Document()
    page = document.pages.add()
    graph = drawing.Graph(400, 400)
    graph.border = ap.BorderInfo(ap.BorderSide.ALL, ap.Color.green)

    arc = drawing.Arc(100, 100, 95, 0, 90)

    arc.graph_info.fill_color = ap.Color.green_yellow
    graph.shapes.add(arc)

    line = drawing.Line([195, 100, 100, 100, 100, 195])
    line.graph_info.fill_color = ap.Color.green_yellow
    graph.shapes.add(line)

    page.paragraphs.add(graph)
    document.save(outfile)

Résultat de l’ajout d’un arc rempli :

Sujets liés aux graphiques

Python-Net: Ajouter des formes de cercle au PDF en Python

Fri, 22 May 2026 00:00:00 +0000

Ajouter un objet Cercle

Aspose.PDF for Python via .NET vous permet d’ajouter Circle formes vers les pages PDF via le Graph classe. Utilisez des cercles pour les diagrammes, les annotations et les éléments visuels simples.

Suivez les étapes ci-dessous:

Créer Document instance.
Créer Objet Graph avec certaines dimensions.
Définir bordure pour l’objet Graph.
Ajouter Graph objet à la collection paragraphs de la page.
Enregistrez notre fichier PDF.

import aspose.pdf as ap
import aspose.pdf.drawing as drawing

def add_circle(outfile: str):
    document = ap.Document()
    page = document.pages.add()
    graph = drawing.Graph(400, 200)
    graph.border = ap.BorderInfo(ap.BorderSide.ALL, ap.Color.green)

    circle = drawing.Circle(100, 100, 40)
    circle.graph_info.color = ap.Color.green_yellow
    graph.shapes.add(circle)

    page.paragraphs.add(graph)
    document.save(outfile)

Notre cercle dessiné aura cette apparence :

Créer un objet cercle rempli

Cet exemple montre comment ajouter un cercle et le remplir de couleur.

import aspose.pdf as ap
import aspose.pdf.drawing as drawing

def add_circle_filled(outfile: str):
    document = ap.Document()
    page = document.pages.add()
    graph = drawing.Graph(400, 200)
    graph.border = ap.BorderInfo(ap.BorderSide.ALL, ap.Color.green)

    circle = drawing.Circle(100, 100, 40)
    circle.graph_info.color = ap.Color.green_yellow
    circle.graph_info.fill_color = ap.Color.green
    circle.text = ap.text.TextFragment("Circle")
    graph.shapes.add(circle)

    page.paragraphs.add(graph)
    document.save(outfile)

Résultat de l’ajout d’un cercle rempli :

Sujets liés aux graphiques

Python-Net: Ajouter des formes de courbe au PDF en Python

Fri, 22 May 2026 00:00:00 +0000

Ajouter un objet Courbe

Aspose.PDF for Python via .NET vous permet d’ajouter Curve formes vers les pages PDF via le Graph classe.

Cet article montre comment créer des courbes à la fois tracées et remplies.

Suivez les étapes ci-dessous:

Créer Document instance.
Créer Objet Graph avec certaines dimensions.
Définir border pour l’objet Graph.
Ajouter Graph objet à la collection paragraphs de la page.
Enregistrez notre fichier PDF.

import aspose.pdf as ap
import aspose.pdf.drawing as drawing

def add_curve(outfile: str):
    document = ap.Document()
    page = document.pages.add()
    graph = drawing.Graph(400, 200)
    graph.border = ap.BorderInfo(ap.BorderSide.ALL, ap.Color.green)

    curve1 = drawing.Curve([10, 10, 50, 60, 70, 10, 100, 120])
    curve1.graph_info.color = ap.Color.green_yellow
    graph.shapes.add(curve1)

    page.paragraphs.add(graph)
    document.save(outfile)

L’image suivante montre le résultat exécuté avec notre extrait de code:

Créer un objet de courbe remplie

Cet exemple montre comment ajouter un objet Curve qui est rempli de couleur.

import aspose.pdf as ap
import aspose.pdf.drawing as drawing


def add_curve_filled(outfile: str):
    document = ap.Document()
    page = document.pages.add()
    graph = drawing.Graph(400, 200)
    graph.border = ap.BorderInfo(ap.BorderSide.ALL, ap.Color.green)

    curve1 = drawing.Curve([10, 10, 50, 60, 70, 10, 100, 120])
    curve1.graph_info.fill_color = ap.Color.green_yellow
    graph.shapes.add(curve1)

    page.paragraphs.add(graph)
    document.save(outfile)

Résultat de l’ajout d’une courbe remplie :

Sujets liés aux graphiques

Python-Net: Ajouter des formes de ligne au PDF en Python

Fri, 22 May 2026 00:00:00 +0000

Ajouter l’objet Line

Aspose.PDF for Python via .NET vous permet d’ajouter Line des formes aux pages PDF en utilisant le Graph classe. Vous pouvez contrôler la couleur de la ligne, le motif du tiret et le placement.

Suivez les étapes ci-dessous:

Créer Document instance.
Créer un objet de graphe
Ajouter Graph objet à la collection paragraphs de la page.
Créer et configurer la ligne
Ajouter le Line au graphe
Enregistrez notre fichier PDF.

import aspose.pdf as ap
import aspose.pdf.drawing as drawing


def add_line(outfile: str):
    document = ap.Document()
    page = document.pages.add()
    graph = drawing.Graph(100, 400)
    page.paragraphs.add(graph)

    line = drawing.Line([100, 100, 200, 100])
    line.graph_info.dash_array = [0, 1, 0]
    line.graph_info.dash_phase = 1
    graph.shapes.add(line)

    document.save(outfile)

Comment ajouter une ligne pointillée et tiretée à votre document PDF

import aspose.pdf as ap
import aspose.pdf.drawing as drawing

def add_dotted_dashed_line(outfile: str):
    document = ap.Document()
    page = document.pages.add()
    graph = drawing.Graph(100, 400)
    page.paragraphs.add(graph)

    line = drawing.Line([100, 100, 200, 100])
    line.graph_info.color = ap.Color.red
    line.graph_info.dash_array = [0, 1, 0]
    line.graph_info.dash_phase = 1
    graph.shapes.add(line)

    document.save(outfile)

Résultat de l’ajout d’une ligne pointillée tiretée:

Dessiner une ligne à travers la page

Vous pouvez également dessiner des lignes à travers la page pour former une croix.

import aspose.pdf as ap
import aspose.pdf.drawing as drawing

def draw_line_across_page(outfile: str):
    document = ap.Document()
    page = document.pages.add()
    page.page_info.margin.left = 0
    page.page_info.margin.right = 0
    page.page_info.margin.bottom = 0
    page.page_info.margin.top = 0

    graph = drawing.Graph(page.page_info.width, page.page_info.height)
    line = drawing.Line([page.rect.llx, 0, page.page_info.width, page.rect.ury])
    graph.shapes.add(line)
    line2 = drawing.Line([0, page.rect.ury, page.page_info.width, page.rect.llx])
    graph.shapes.add(line2)
    page.paragraphs.add(graph)

    document.save(outfile)

Sujets liés aux graphiques

Python-Net: Ajouter des formes rectangulaires à un PDF en Python

Fri, 22 May 2026 00:00:00 +0000

Ajouter l’objet Rectangle

Aspose.PDF for Python via .NET vous permet d’ajouter Rectangle formes vers les pages PDF via le Graph classe. Vous pouvez dessiner des rectangles bordés et appliquer des remplissages pleins, dégradés ou transparents.

Suivez les étapes ci-dessous:

Créer un nouveau PDF Document.
Ajouter Page à la collection de pages du fichier PDF.
Ajouter TextFragment vers la collection de paragraphes de l’instance de page.
Créer Graph instance.
Définir la bordure pour Objet Graph.
Ajouter Rectangle objet vers la collection de formes de l’objet Graph.
Ajouter l’objet graphique à la collection de paragraphes de l’instance de page.
Ajouter TextFragment vers la collection de paragraphes de l’instance de page.
Et enregistrez votre fichier PDF

import aspose.pdf as ap
import aspose.pdf.drawing as drawing

def add_rectangle(outfile: str):
    document = ap.Document()
    page = document.pages.add()
    text_fragment = ap.text.TextFragment("Rectangle")
    page.paragraphs.add(text_fragment)

    graph = drawing.Graph(400, 300)
    page.paragraphs.add(graph)
    graph.border = ap.BorderInfo(ap.BorderSide.ALL, ap.Color.red)

    rect = drawing.Rectangle(20, 20, 350, 250)
    graph.shapes.add(rect)
    page.paragraphs.add(text_fragment)

    document.save(outfile)

Créer un objet rectangle rempli

Aspose.PDF for Python via .NET offre également la fonction de remplir l’objet rectangle avec une certaine couleur.

Le fragment de code suivant montre comment ajouter un Rectangle objet rempli de couleur.

import aspose.pdf as ap
import aspose.pdf.drawing as drawing

def create_rectangle_filled(outfile: str):
    document = ap.Document()
    page = document.pages.add()
    graph = drawing.Graph(100, 400)
    page.paragraphs.add(graph)

    rect = drawing.Rectangle(100, 100, 200, 120)
    rect.graph_info.fill_color = ap.Color.red
    graph.shapes.add(rect)

    document.save(outfile)

Résultat du rectangle rempli avec une couleur unie :

Ajouter un dessin avec remplissage en dégradé

Aspose.PDF for Python via .NET prend en charge la fonctionnalité d’ajouter des objets graphiques aux documents PDF et il est parfois nécessaire de remplir ces objets graphiques avec une couleur en dégradé.

Le fragment de code suivant montre comment ajouter un Rectangle objet rempli avec une couleur en dégradé.

import aspose.pdf as ap
import aspose.pdf.drawing as drawing

def add_drawing_with_gradient_fill(outfile: str):
    document = ap.Document()
    page = document.pages.add()
    graph = drawing.Graph(400, 400)
    page.paragraphs.add(graph)

    rect = drawing.Rectangle(0, 0, 300, 300)
    gradient_color = ap.Color()
    gradient_settings = drawing.GradientAxialShading(ap.Color.red, ap.Color.blue)
    gradient_settings.start = ap.Point(0, 0)
    gradient_settings.end = ap.Point(350, 350)
    gradient_color.pattern_color_space = gradient_settings
    rect.graph_info.fill_color = gradient_color
    graph.shapes.add(rect)

    document.save(outfile)

Créer un rectangle avec un canal de couleur alpha

Aspose.PDF for Python via .NET prend également en charge la transparence via un canal de couleur alpha.

Le fragment de code suivant montre comment ajouter un Rectangle objet avec des valeurs alpha.

import aspose.pdf as ap
import aspose.pdf.drawing as drawing

def create_rectangle_with_alpha_color_channel(outfile: str):
    document = ap.Document()
    page = document.pages.add()
    graph = drawing.Graph(100, 400)
    page.paragraphs.add(graph)

    rect = drawing.Rectangle(100, 100, 200, 120)
    rect.graph_info.fill_color = ap.Color.from_argb(128, 244, 180, 0)
    graph.shapes.add(rect)

    rect1 = drawing.Rectangle(200, 150, 200, 100)
    rect1.graph_info.fill_color = ap.Color.from_argb(160, 120, 0, 120)
    graph.shapes.add(rect1)

    document.save(outfile)

Contrôler l’ordre Z des formes

Aspose.PDF for .NET prend en charge la fonctionnalité d’ajout d’objets graphiques (par exemple graphique, ligne, rectangle, etc.) aux documents PDF. Lors de l’ajout de plusieurs instances du même objet dans un fichier PDF, nous pouvons contrôler leur rendu en spécifiant l’ordre Z. L’ordre Z est également utilisé lorsque nous devons rendre les objets les uns sur les autres.

Le fragment de code suivant montre les étapes pour rendre Rectangle objets les uns sur les autres.

import aspose.pdf as ap
import aspose.pdf.drawing as drawing


def _add_rectangle_to_page(
    page: ap.Page,
    x: float,
    y: float,
    width: float,
    height: float,
    color: ap.Color,
    zindex: int,
):
    graph = drawing.Graph(width, height)
    graph.is_change_position = False
    graph.left = x
    graph.top = y
    rect = drawing.Rectangle(0, 0, width, height)
    rect.graph_info.fill_color = color
    rect.graph_info.color = color
    graph.shapes.add(rect)
    graph.z_index = zindex
    page.paragraphs.add(graph)


def control_z_order_of_rectangle(outfile: str):
    document = ap.Document()
    page = document.pages.add()
    page.set_page_size(375, 300)
    page.page_info.margin.left = 0
    page.page_info.margin.top = 0

    _add_rectangle_to_page(page, 50, 40, 60, 40, ap.Color.red, 2)
    _add_rectangle_to_page(page, 20, 20, 30, 30, ap.Color.blue, 1)
    _add_rectangle_to_page(page, 40, 40, 60, 30, ap.Color.green, 0)

    document.save(outfile)

Sujets liés aux graphiques

Python-Net: Ajouter des formes d'ellipse au PDF en Python

Fri, 22 May 2026 00:00:00 +0000

Ajouter l’objet Ellipse

Aspose.PDF for Python via .NET vous permet d’ajouter Ellipse formes aux pages PDF avec le Graph classe. Vous pouvez dessiner des contours d’ellipse, appliquer des couleurs de remplissage et placer du texte à l’intérieur des objets ellipse.

import aspose.pdf as ap
import aspose.pdf.drawing as drawing

def add_ellipse(outfile: str):
    document = ap.Document()
    page = document.pages.add()
    graph = drawing.Graph(400, 400)
    graph.border = ap.BorderInfo(ap.BorderSide.ALL, ap.Color.green)

    ellipse1 = drawing.Ellipse(150, 100, 120, 60)
    ellipse1.graph_info.color = ap.Color.green_yellow
    ellipse1.text = ap.text.TextFragment("Ellipse")
    graph.shapes.add(ellipse1)

    ellipse2 = drawing.Ellipse(50, 50, 18, 300)
    ellipse2.graph_info.color = ap.Color.dark_red
    graph.shapes.add(ellipse2)

    page.paragraphs.add(graph)
    document.save(outfile)

Créer un objet ellipse rempli

Le fragment de code suivant montre comment ajouter un Ellipse objet rempli de couleur.

import aspose.pdf as ap
import aspose.pdf.drawing as drawing

def create_ellipse_filled(outfile: str):
    document = ap.Document()
    page = document.pages.add()
    graph = drawing.Graph(400, 400)
    graph.border = ap.BorderInfo(ap.BorderSide.ALL, ap.Color.green)

    ellipse1 = drawing.Ellipse(100, 100, 120, 180)
    ellipse1.graph_info.fill_color = ap.Color.green_yellow
    graph.shapes.add(ellipse1)

    ellipse2 = drawing.Ellipse(200, 150, 180, 120)
    ellipse2.graph_info.fill_color = ap.Color.dark_red
    graph.shapes.add(ellipse2)

    page.paragraphs.add(graph)
    document.save(outfile)

Ajouter du texte à l’intérieur de l’ellipse

Aspose.PDF for Python via .NET vous permet également d’insérer du texte dans les objets de forme. L’exemple suivant ajoute du texte aux formes ellipse.

import aspose.pdf as ap
import aspose.pdf.drawing as drawing

def add_text_inside_ellipse(outfile: str):
    document = ap.Document()
    page = document.pages.add()
    graph = drawing.Graph(400, 400)
    graph.border = ap.BorderInfo(ap.BorderSide.ALL, ap.Color.green)

    text_fragment = ap.text.TextFragment("Ellipse")
    text_fragment.text_state.font = ap.text.FontRepository.find_font("Helvetica")
    text_fragment.text_state.font_size = 24

    ellipse1 = ap.drawing.Ellipse(100, 100, 120, 180)
    ellipse1.graph_info.fill_color = ap.Color.green_yellow
    ellipse1.text = text_fragment
    graph.shapes.add(ellipse1)

    ellipse2 = ap.drawing.Ellipse(200, 150, 180, 120)
    ellipse2.graph_info.fill_color = ap.Color.dark_red
    ellipse2.text = text_fragment
    graph.shapes.add(ellipse2)

    page.paragraphs.add(graph)
    document.save(outfile)

Sujets liés aux graphiques

Python-Net: Vérifier les limites de forme dans les graphiques PDF avec Python

Fri, 22 May 2026 00:00:00 +0000

Vérifier les limites de forme dans un Graph

Lorsque vous ajoutez des formes à un Graph, vous pouvez activer la validation des limites pour garantir que chaque forme s’adapte à la zone du graphique.

Utilisez BoundsCheckMode définir le comportement lorsqu’une forme est hors de portée. Dans cet exemple, THROW_EXCEPTION_IF_DOES_NOT_FIT est utilisé pour lever une exception.

Suivez les étapes ci-dessous:

Créer un nouveau PDF Document.
Ajouter un Page.
Créer un Graph et l’ajouter à la page.
Créer un Rectangle qui dépasse les limites du graphique.
Définir le mode de vérification des limites sur THROW_EXCEPTION_IF_DOES_NOT_FIT.
Ajoutez le rectangle et gérez l’exception.
Enregistrez le document.

import aspose.pdf as ap
import aspose.pdf.drawing as drawing


def check_shape_bounds(outfile: str):
    document = ap.Document()
    page = document.pages.add()

    graph = drawing.Graph(100, 100)
    graph.top = 10
    graph.left = 15
    graph.border = ap.BorderInfo(ap.BorderSide.BOX, 1, ap.Color.black)
    page.paragraphs.add(graph)

    rect = drawing.Rectangle(-1, 0, 50, 50)
    rect.graph_info.fill_color = ap.Color.tomato

    try:
        graph.shapes.update_bounds_check_mode(
            ap.BoundsCheckMode.THROW_EXCEPTION_IF_DOES_NOT_FIT
        )
        graph.shapes.add(rect)
    except Exception as e:
        print(e)

    document.save(outfile)

Remarques

Utilisez THROW_EXCEPTION_IF_DOES_NOT_FIT lorsque la validation stricte de la mise en page est requise.
Pour un comportement permissif, choisissez‑en un autre BoundsCheckMode option basée sur vos besoins de mise en page.