Travailler avec des images

Aspose.Words permet aux utilisateurs de travailler avec des images de manière très flexible. Dans cet article, vous ne pouvez explorer que certaines des possibilités de travail avec des images.

Insérer une image

DocumentBuilder fournit plusieurs surcharges de la méthode insert_image qui vous permettent d’insérer une image en ligne ou flottante. Si l’image est un métafichier EMF ou WMF, elle sera insérée dans le document au format métafichier. Toutes les autres images seront stockées au format PNG. La méthode Insérer une image peut utiliser des images provenant de différentes sources:

  • Depuis un fichier ou URL en passant un paramètre chaîne
  • Depuis un flux en passant un paramètre Stream
  • Depuis un tableau d’octets en passant un paramètre de tableau d’octets

Pour chacune des méthodes Insérer une image, il existe d’autres surcharges qui vous permettent d’insérer une image avec les options suivantes:

  • En ligne ou flottant à une position spécifique, par exemple, Insérer une image
  • Échelle de pourcentage ou taille personnalisée ; de plus, la méthode DocumentBuilder.insert_image renvoie un objet Shape qui vient d’être créé et inséré afin que vous puissiez modifier davantage les propriétés du Shape

Insertion d’une image en ligne

Transmettez une seule chaîne représentant un fichier contenant l’image à insert_image pour insérer l’image dans le document en tant que graphique en ligne.

L’exemple de code suivant montre comment insérer une image en ligne à la position du curseur dans un document:

doc = aw.Document()
builder = aw.DocumentBuilder(doc)

builder.insert_image(docs_base.images_dir + "Logo.jpg")

doc.save(docs_base.artifacts_dir+"WorkingWithImages.document_builder_insert_inline_image.doc")

Insertion d’une image flottante (absolument positionnée)

L’exemple de code suivant montre comment insérer une image flottante à partir d’un fichier ou d’un URL à une position et une taille spécifiées:

doc = aw.Document()
builder = aw.DocumentBuilder(doc)

builder.insert_image(docs_base.images_dir + "Logo.jpg",
    aw.drawing.RelativeHorizontalPosition.MARGIN,
    100,
    aw.drawing.RelativeVerticalPosition.MARGIN,
    100,
    200,
    100,
    aw.drawing.WrapType.SQUARE)

doc.save(docs_base.artifacts_dir+"WorkingWithImages.document_builder_insert_floating_image.doc")

Comment extraire des images d’un document

Toutes les images sont stockées dans les nœuds Shape dans un Document. Pour extraire toutes les images ou images d’un type spécifique du document, procédez comme suit:

  • Utilisez la méthode Document.get_child_nodes pour sélectionner tous les nœuds Shape.
  • Parcourez les collections de nœuds résultantes.
  • Vérifiez la propriété booléenne Shape.has_image.
  • Extrayez les données d’image à l’aide de la propriété Shape.image_data.
  • Enregistrez les données d’image dans un fichier.

L’exemple de code suivant montre comment extraire des images d’un document et les enregistrer sous forme de fichiers:

Vous pouvez télécharger le fichier modèle de cet exemple depuis ici.

Comment insérer un code-barres sur chaque page d’un document

Cet exemple vous montre comment ajouter des codes-barres identiques ou différents sur toutes les pages ou des pages spécifiques d’un document Word. Il n’existe pas de moyen direct d’ajouter des codes-barres sur toutes les pages d’un document, mais vous pouvez utiliser les méthodes move_to_section, move_to_header_footer et insert_image pour vous déplacer vers n’importe quelle section ou en-têtes/pieds de page et insérer les images de codes-barres comme vous pouvez le voir dans le code suivant.

L’exemple de code suivant insère une image de code-barres sur chaque page d’un document.

Verrouiller le rapport hauteur/largeur de l’image

Le rapport hauteur/largeur d’une forme géométrique est le rapport de ses tailles dans différentes dimensions. Vous pouvez verrouiller le rapport hauteur/largeur de l’image à l’aide de aspect_ratio_locked. La valeur par défaut du rapport hauteur/largeur de la forme dépend du ShapeType. Il s’agit de True pour ShapeType.IMAGE et False pour les autres types de formes.

L’exemple de code suivant montre comment utiliser les proportions:

doc = aw.Document()
builder = aw.DocumentBuilder(doc)

shape = builder.insert_image(docs_base.images_dir + "Logo.jpg")
shape.aspect_ratio_locked = False

doc.save(docs_base.artifacts_dir+"WorkingWithImages.set_aspect_ratio_locked.doc")

Comment obtenir les limites réelles de la forme en points

Si vous souhaitez que le cadre de délimitation réel de la forme soit rendu sur la page, vous pouvez y parvenir en utilisant la propriété bounds_in_points.

L’exemple de code suivant montre comment utiliser cette propriété:

doc = aw.Document()
builder = aw.DocumentBuilder(doc)

shape = builder.insert_image(docs_base.images_dir + "Logo.jpg")
shape.aspect_ratio_locked = False

print("\nGets the actual bounds of the shape in points.")
rect = shape.get_shape_renderer().bounds_in_points
print(f"{rect.x}, {rect.y}, {rect.width}, {rect.height}")

Recadrer les images

Le recadrage d’une image fait généralement référence à la suppression des parties extérieures indésirables d’une image pour aider à améliorer le cadrage. Il est également utilisé pour supprimer certaines parties d’une image afin d’augmenter la mise au point sur une zone particulière.

L’exemple de code suivant montre comment y parvenir à l’aide de Aspose.Words API:

# The path to the documents directory.
inputPath = docs_base.images_dir + "Logo.jpg"
outputPath = docs_base.artifacts_dir + "cropped_logo.jpg"

self.crop_image(inputPath,outputPath, 100, 90, 200, 200)
@staticmethod
def crop_image(inPath : str, outPath : str, left : int, top : int, width : int, height : int) :
    
    doc = aw.Document();
    builder = aw.DocumentBuilder(doc)
    
    croppedImage = builder.insert_image(inPath)
    
    src_width_points = croppedImage.width
    src_height_points = croppedImage.height
    
    croppedImage.width = aw.ConvertUtil.pixel_to_point(width)
    croppedImage.height = aw.ConvertUtil.pixel_to_point(height)
    
    widthRatio = croppedImage.width / src_width_points
    heightRatio = croppedImage.height / src_height_points
    
    if (widthRatio< 1) :
        croppedImage.image_data.crop_right = 1 - widthRatio
    
    if (heightRatio< 1) :
        croppedImage.image_data.crop_bottom = 1 - heightRatio
    
    leftToWidth = aw.ConvertUtil.pixel_to_point(left) / src_width_points
    topToHeight = aw.ConvertUtil.pixel_to_point(top) / src_height_points
    
    croppedImage.image_data.crop_left = leftToWidth
    croppedImage.image_data.crop_right = croppedImage.image_data.crop_right - leftToWidth
    
    croppedImage.image_data.crop_top = topToHeight
    croppedImage.image_data.crop_bottom = croppedImage.image_data.crop_bottom - topToHeight
    
    croppedImage.get_shape_renderer().save(outPath, aw.saving.ImageSaveOptions(aw.SaveFormat.JPEG))

Enregistrer des images au format WMF

Aspose.Words fournit des fonctionnalités pour enregistrer toutes les images disponibles dans un document au format WMF lors de la conversion de DOCX en RTF.

L’exemple de code suivant montre comment enregistrer des images au format WMF avec les options d’enregistrement RTF:

Comment ajouter une forme Group dans un fichier Word Travailler avec des graphiques dans Python