Add Image to Existing PDF in Python

Add Image to an Existing PDF File in Python

This example shows how to place an image at a fixed position on an existing PDF page using Aspose.PDF for Python via .NET.

Use these examples when you need to add a logo, photo, stamp, chart, or other graphic to an existing PDF layout. You can place the image with page coordinates, draw it with operators, add accessibility text, or control image compression.

  1. Load an existing PDF with ap.Document(infile).
  2. Select the target page (document.pages[1] for the first page).
  3. Call page.add_image() with:
    • The image file path.
    • A Rectangle defining placement coordinates.
  4. Save the updated PDF.
import aspose.pdf as ap


def add_image(infile, image_file, outfile):
    document = ap.Document(infile)
    page = document.pages[1]
    page.add_image(image_file, ap.Rectangle(20, 730, 120, 830, True))
    document.save(outfile)

Add an Image to PDF Using Operators

This approach adds an image with low-level PDF operators instead of the high-level add_image() helper.

  1. Create a new Document and add a page.
  2. Add the image to page resources (page.resources.images).
  3. Create transformation operators (GSave, ConcatenateMatrix, Do, GRestore).
  4. Add operators to page contents.
  5. Save the resulting PDF.
import aspose.pdf as ap
from io import FileIO


def add_image_using_operators(image_file, outfile):
    document = ap.Document()
    page = document.pages.add()
    page.set_page_size(842, 595)
    resources_images = page.resources.images

    with FileIO(image_file, "rb") as image_stream:
        image_id = resources_images.add(image_stream)

    rectangle = ap.Rectangle(0, 0, page.media_box.width, page.media_box.height, True)

    operators = [
        ap.operators.GSave(),
        ap.operators.ConcatenateMatrix(
            ap.Matrix(
                rectangle.urx - rectangle.llx,
                0,
                0,
                rectangle.ury - rectangle.lly,
                rectangle.llx,
                rectangle.lly,
            )
        ),
        ap.operators.Do(image_id),
        ap.operators.GRestore(),
    ]

    page.contents.add(operators)
    document.save(outfile)

Add Image to PDF with Alternative Text

This example adds an image and assigns alternative text for accessibility.

  1. Create a new Document and add a page.
  2. Add the image to the page with page.add_image().
  3. Get image resources from page.resources.images.
  4. Set alt text using try_set_alternative_text().
  5. Save the resulting PDF.
import aspose.pdf as ap


def add_image_set_alternative_text(image_file, outfile):
    document = ap.Document()
    page = document.pages.add()
    page.set_page_size(842, 595)

    page.add_image(image_file, ap.Rectangle(0, 0, 842, 595, True))
    resources_images = page.resources.images
    x_image = resources_images[1]
    result = x_image.try_set_alternative_text("Alternative text for image", page)

    if result:
        print("Alternative text has been added successfully")

    document.save(outfile)

Add an Image to a PDF with Flate Compression

This example embeds an image using ImageFilterType.FLATE compression.

  1. Create a new Document and add a page.
  2. Add the image to page resources with Flate compression.
  3. Use matrix operators to place and draw the image.
  4. Save the document.
import aspose.pdf as ap
from io import FileIO


def add_image_to_pdf_with_flate_compression(image_file, outfile):
    document = ap.Document()
    page = document.pages.add()
    resources_images = page.resources.images

    with FileIO(image_file, "rb") as image_stream:
        image_id = resources_images.add(image_stream, ap.ImageFilterType.FLATE)

    rectangle = ap.Rectangle(0, 0, 600, 600, True)
    matrix = ap.Matrix(
        rectangle.urx - rectangle.llx,
        0,
        0,
        rectangle.ury - rectangle.lly,
        rectangle.llx,
        rectangle.lly,
    )

    page.contents.add([ap.operators.GSave()])
    page.contents.add([ap.operators.ConcatenateMatrix(matrix)])
    page.contents.add([ap.operators.Do(image_id)])
    page.contents.add([ap.operators.GRestore()])

    document.save(outfile)
Delete Images from PDF File using Python