Add new articles in Python via .NET sections

en/python-net/advanced-operations/working-with-documents/working-with-layers/_index.md

@@ -3,7 +3,7 @@ title: Work with PDF layers using Python
 linktitle: Work with PDF layers
 type: docs
 weight: 50
-url: /net/working-with-pdf-layers/
+url: /python-net/working-with-pdf-layers/
 description: The next task explains how to lock a PDF layer, extract PDF layer elements, flatten a layered PDF, and merge all layers inside PDF into one.
 lastmod: "2025-09-17"
 sitemap:

en/python-net/advanced-operations/working-with-images/_index.md

@@ -5,7 +5,7 @@ type: docs
 weight: 40
 url: /python-net/working-with-images/
 description: This section describes the features of working with images in a PDF file using Python library.
-lastmod: "2025-02-27"
+lastmod: "2025-09-27"
 sitemap:
     changefreq: "monthly"
     priority: 0.7
@@ -23,4 +23,6 @@ You are able to do the following:
 - [Add Image to Existing PDF File](/pdf/python-net/add-image-to-existing-pdf-file/) - add images and references of a single image in PDF document, after that control quality.
 - [Delete Images from PDF File](/pdf/python-net/delete-images-from-pdf-file/) - check code snippet for deleting images from PDF file.
 - [Extract Images from PDF File](/pdf/python-net/extract-images-from-pdf-file/) - the next article shows how to extract images from PDF file using Python library.
+- [Search and Get Images from PDF Document](/pdf/python-net/search-and-get-images-from-pdf-document/) - you can get an image from an individual page and search among images on all pages with Python.
+- [Replace Image in Existing PDF File](/pdf/python-net/replace-image-in-existing-pdf-file/) - check our code snippet, it shows you how to replace an image in a PDF file.
 

en/python-net/advanced-operations/working-with-images/add-image-to-existing-pdf-file/_index.md

@@ -5,57 +5,158 @@ type: docs
 weight: 10
 url: /python-net/add-image-to-existing-pdf-file/
 description: This section describes how to add image to existing PDF file using Python library.
-lastmod: "2025-02-27"
+lastmod: "2025-09-27"
 TechArticle: true 
-AlternativeHeadline: How to add images into PDf using Python
+AlternativeHeadline: How to add images into PDF using Python
 Abstract: This article provides guidance on adding images to existing PDF files using Python with the Aspose.PDF library. Two methods are outlined for achieving this. The first method involves using the `Document` class from Aspose.PDF, where the user loads the PDF, specifies the page number, and uses the `add_image` method of the `Page` class to position the image. The document is then saved using the `save()` method. The second method utilizes the `PdfFileMend` class from the Aspose.PDF.Facades namespace, which offers a simpler interface. Here, the `add_image()` method is invoked to add the image to the specified page and coordinates, followed by saving the updated PDF and closing the `PdfFileMend` object. Code snippets are provided for both methods to demonstrate the process.
 ---
 
 ## Add Image in an Existing PDF File
 
-The following code snippet shows how to add image in the PDF file.
-
-1. Load the input PDF file. 
-1. Specify the page number on which the picture will be placed.
-1. To define the position of the image on the page call the [Page](https://reference.aspose.com/pdf/python-net/aspose.pdf/page/) class [add_image](https://reference.aspose.com/pdf/python-net/aspose.pdf/page/#methods) method.
-1. Call the [Document](https://reference.aspose.com/pdf/python-net/aspose.pdf/document/) class [save()](https://reference.aspose.com/pdf/python-net/aspose.pdf/document/#methods) method.
+This example demonstrates how to insert an image into a specific position on a PDF page using Aspose.PDF for Python via .NET.
 
+1. Load the PDF document with 'ap.Document'.
+1. Select the target page '(document.pages[1]' - the first page).
+1. Use 'page.add_image()' to place the image:
+    - File path of the image.
+    - A 'Rectangle' object defining the image’s coordinates (left=20, bottom=730, right=120, top=830).
+1. Save the updated PDF.
 
 ```python
 
     import aspose.pdf as ap
+    from io import FileIO
+    from os import path
+
+    path_infile = path.join(self.data_dir, infile)
+    path_outfile = path.join(self.data_dir, "python", outfile)
+
+    document = ap.Document(path_infile)
+    page = document.pages[1]
+    page.add_image(
+        path.join(self.data_dir, image_file),
+        ap.Rectangle(20, 730, 120, 830, True),
+    )
+    document.save(path_outfile)
+```
 
-    # Open document
-    document = ap.Document(input_file)
-
-    document.pages[1].add_image(image_file, ap.Rectangle(20, 730, 120, 830, True))
+## Add an Image Using Operators
 
-    document.save(output_pdf)
-```
+Next code snippet shows a low-level approach to adding an image to a PDF page by manually working with PDF operators rather than high-level helper methods.
 
-## Add Image in an Existing PDF File (Facades)
+Steps:
 
-There is also an alternative, easier way to add a Image to a PDF file. You can use [AddImage](https://reference.aspose.com/pdf/python-net/aspose.pdf.facades/pdffilemend/methods/addimage/index) method of the [PdfFileMend](https://reference.aspose.com/pdf/python-net/aspose.pdf.facades/pdffilemend/) class. The [add_image()](https://reference.aspose.com/pdf/python-net/aspose.pdf.facades/pdffilemend/#methods) method requires the image to be added, the page number at which the image needs to be added and the coordinate information. After that, save the updated PDF file, and close the PdfFileMend object using [close()](https://reference.aspose.com/pdf/python-net/aspose.pdf.facades/pdffilemend/#methods) method. The following code snippet shows you how to add image in an existing PDF file.
+1. Create a new blank 'Document'.
+1. Add a page and set its size (842 × 595 - landscape A4).
+1. Access the page’s image resources (page.resources.images).
+1. Load the image file into a stream and add it to the resources.
+    - The method returns an 'image_id'.
+    - The newly added image object is retrieved from the resources.
+1. Define a rectangle that maintains the aspect ratio of the image:
+1. Build an operator sequence:
+    - 'GSave()' - Save the current graphics state.
+    - 'ConcatenateMatrix(matrix)' - Apply transformation (scale and center the image vertically on the page).
+    - 'Do(image_id)' - Render the image.
+    - 'GRestore()' - Restore graphics state.
+1. Add the operator sequence to 'page.contents'.
+1. Save the resulting PDF.
 
 ```python
 
     import aspose.pdf as ap
+    from io import FileIO
+    from os import path
+
+    path_infile = path.join(self.data_dir, image_file)
+    path_outfile = path.join(self.data_dir, "python", outfile)
+
+    document = ap.Document()
+    page = document.pages.add()
+    page.set_page_size(842,595)
+
+    # Get page resources
+    resources_images = page.resources.images
+
+    # Add image to resources
+    image_stream = FileIO(path.join(self.data_dir, path_infile), "rb")
+    image_id = resources_images.add(image_stream)
 
-    # Open document
-    mender = ap.facades.PdfFileMend()
+    x_image = list(resources_images)[-1]
 
-    # Create PdfFileMend object to add text
-    mender.bind_pdf(input_file)
+    rectangle = ap.Rectangle(
+        0,
+        0,
+        page.media_box.width,
+        (page.media_box.width * x_image.height) / x_image.width,
+        True,
+    )
 
-    # Add image in the PDF file
-    mender.add_image(image_file, 1, 100.0, 600.0, 200.0, 700.0)
+    # Create operator sequence for adding image
+    operators = []
 
-    # Save changes
-    mender.save(output_pdf)
+    # Save graphics state
+    operators.append(ap.operators.GSave())
 
-    # Close PdfFileMend object
-    mender.close()
+    # Set transformation matrix (position and size)
+    matrix = ap.Matrix(
+        rectangle.urx - rectangle.llx,
+        0,
+        0,
+        rectangle.ury - rectangle.lly,
+        rectangle.llx,
+        rectangle.llx + (page.media_box.height - rectangle.height) / 2,
+    )
+    operators.append(ap.operators.ConcatenateMatrix(matrix))
 
+    # Draw the image
+    operators.append(ap.operators.Do(image_id))
+
+    # Restore graphics state
+    operators.append(ap.operators.GRestore())
+
+    # Add operators to page contents
+    page.contents.add(operators)
+
+    document.save(path_outfile)
 ```
 
+## Add Image with Alternative Text
+
+This example shows how to add an image to a PDF page and assign alternative text (alt text) for accessibility compliance (such as PDF/UA).
 
+1. Create a new 'Document' and add a page (842 × 595, landscape A4).
+1. Place the image on the page using 'page.add_image()' with a rectangle that spans the full page.
+1. Access the page’s image resources ('page.resources.images').
+1. Define an alternative text string (e.g., 'Alternative text for image').
+1. Retrieve the first image object from resources ('x_image = resources_images[1]').
+1. Use 'try_set_alternative_text(alt_text, page)' to assign alt text to the image.
+1. Save the resulting PDF.
+
+```python
+
+    import aspose.pdf as ap
+    from io import FileIO
+    from os import path
+
+    path_image_file = path.join(self.data_dir, image_file)
+    path_outfile = path.join(self.data_dir, "python", outfile)
+
+    document = ap.Document()
+    page = document.pages.add()
+    page.set_page_size(842,595)
+
+    page.add_image(
+        path_image_file,
+        ap.Rectangle(0, 0, 842, 595, True),
+    )
+
+    resources_images = page.resources.images
+    alt_text = "Alternative text for image"
+    x_image = resources_images[1]
+    result = x_image.try_set_alternative_text(alt_text, page)
+
+    # If set is successful, then get the alternative text for the image
+    if (result):
+        print ("Text has been added successfuly")
+    document.save(path_outfile)
+```

en/python-net/advanced-operations/working-with-images/delete-images-from-pdf-file/_index.md

@@ -5,18 +5,16 @@ type: docs
 weight: 20
 url: /python-net/delete-images-from-pdf-file/
 description: This section explain how to delete Images from PDF File using Aspose.PDF for Python via .NET.
-lastmod: "2025-02-27"
+lastmod: "2025-09-27"
 TechArticle: true 
 AlternativeHeadline: How to remove images from PDF using Python
 Abstract: The article discusses the various reasons for removing images from PDF files, such as protecting privacy, preventing unauthorized access to sensitive information, reducing file size for easier sharing and storage, and preparing the document for compression or text extraction. It introduces **Aspose.PDF for Python via .NET** as a tool to accomplish this task. The article provides step-by-step instructions and code snippets for deleting specific images or all images from a PDF file using Aspose.PDF. The process involves opening an existing PDF document, deleting images either individually or in bulk, and saving the updated file. The provided Python code demonstrates how to remove images by accessing the document's resources and modifying the desired pages.
 ---
 
 There are many reasons for removing all or specific images from PDFs.
-
 Sometimes a PDF file may contain important images that need to be removed to protect privacy or prevent unauthorized access to certain information.
 
 Removing unwanted or redundant images can help reduce file size, making it easier to share or store PDFs. 
-
 If necessary, you can reduce the number of pages by removing all images from the document.
 Also, deleting images from the document will help prepare the PDF for compression or extraction of text information.
 
@@ -35,33 +33,12 @@ The following code snippet shows how to delete an image from a PDF file.
 ```python
 
     import aspose.pdf as ap
+    from os import path
 
-    # Open document
-    document = ap.Document(input_file)
-
-    # Delete particular image
-    document.pages[2].resources.images.delete(1)
-
-    # Save updated PDF file
-    document.save(output_pdf)
-```
-
-## Delete all images from input PDF 
-
-```python
-
-    import aspose.pdf as ap
-
-    # Open document
-    document = ap.Document(input_file)
-
-    # Delete all images on all pages
-    for i in range(len(document.pages)):
-        while len(document.pages[i + 1].resources.images) != 0:
-            document.pages[i + 1].resources.images.delete(1)
-
-    # Save updated PDF file
-    document.save(output_file)
-```
-
+    path_infile = path.join(self.data_dir, infile)
+    path_outfile = path.join(self.data_dir, outfile)
 
+    document = ap.Document(path_infile)
+    document.pages[1].resources.images.delete(1)
+    document.save(path_outfile)
+```