Extract Images from PDF File

Using page resources

The following code snippet also works with Aspose.PDF.Drawing library.

Images are held in each page’s Resources collection’s Images collection. To extract a particular page, then get the image from the Images collection using the particular index of the image.

The image’s index returns an XImage object. This object provides a Save method for saving the extracted image. The following code snippet shows how to extract images from a PDF file.

.NET Core 3.1

// For complete examples and data files, visit https://github.com/aspose-pdf/Aspose.PDF-for-.NET
private static void ExtractImageFromPDF()
{
    // The path to the documents directory
    var dataDir = RunExamples.GetDataDir_AsposePdf_WorkingDocuments();

    // Open PDF document
    using (var document = new Aspose.Pdf.Document(dataDir + "ExtractImages.pdf"))
    {
        // Extract a particular image
        var xImage = document.Pages[1].Resources.Images[1];
        using (var outputImage = new FileStream(dataDir + "ExtractedImage.jpg", FileMode.Create))
        {
            // Save PDF document image
            xImage.Save(outputImage, System.Drawing.Imaging.ImageFormat.Jpeg);
        }

        // Save PDF document
        document.Save(dataDir + "ExtractImages_out.pdf");
    }
}

.NET 8

// For complete examples and data files, visit https://github.com/aspose-pdf/Aspose.PDF-for-.NET
private static void ExtractImageFromPDF()
{
    // The path to the documents directory
    string dataDir = RunExamples.GetDataDir_AsposePdf_WorkingDocuments();

    // Open PDF document
    using var document = new Aspose.Pdf.Document(dataDir + "ExtractImages.pdf");

    // Get the first image from the first page
    var xImage = document.Pages[1].Resources.Images[1];

    using var outputImage = File.Create(dataDir + "ExtractedImage.jpg");

    // Save PDF document image
    xImage.Save(outputImage, System.Drawing.Imaging.ImageFormat.Jpeg);

    // Save PDF document
    document.Save(dataDir + "ExtractImages_out.pdf");
}

Using ImagePlacementAbsorber

With the release of Aspose.PDF for .NET 7.0.0, we introduced classes called ImagePlacement, ImagePlacementAbsorber and ImagePlacementCollection which provide similar capability as the classes described above to get an image’s resolution and position in a PDF document.

• ImagePlacementAbsorber performs image usage search as the ImagePlacement objects collection.
• ImagePlacement provides the members Resolution and Rectangle that return actual image placement values.

The next code snippet also works with Aspose.Drawing library.

.NET Core 3.1

// For complete examples and data files, visit https://github.com/aspose-pdf/Aspose.PDF-for-.NET
private static void ExtractAndScaleImagesFromPDF()
{
    // The path to the documents directory
    var dataDir = RunExamples.GetDataDir_AsposePdf_Images();

    int imageCount = 0;

    // Open PDF document
    using (var document = new Aspose.Pdf.Document(dataDir + "ImagePlacement.pdf"))
    {
        var abs = new Aspose.Pdf.ImagePlacementAbsorber();

        // Load the contents of the first page
        document.Pages[1].Accept(abs);

        // Iterate through each image placement on the first page
        foreach (var imagePlacement in abs.ImagePlacements)
        {
            // Get image properties
            Console.Out.WriteLine("image width: " + imagePlacement.Rectangle.Width);
            Console.Out.WriteLine("image height: " + imagePlacement.Rectangle.Height);
            Console.Out.WriteLine("image LLX: " + imagePlacement.Rectangle.LLX);
            Console.Out.WriteLine("image LLY: " + imagePlacement.Rectangle.LLY);
            Console.Out.WriteLine("image horizontal resolution: " + imagePlacement.Resolution.X);
            Console.Out.WriteLine("image vertical resolution: " + imagePlacement.Resolution.Y);

            // Extract a particular image
            using (var outputImage = new FileStream(dataDir + "ExtractedImage_" + imageCount.ToString() + ".jpg", FileMode.Create))
            {
                // Save PDF document image
                imagePlacement.Save(outputImage, System.Drawing.Imaging.ImageFormat.Jpeg);
            }

            ++imageCount;
        }
    }
}

.NET 8

// For complete examples and data files, visit https://github.com/aspose-pdf/Aspose.PDF-for-.NET
private static void ExtractAndScaleImagesFromPDF()
{
    // The path to the documents directory
    string dataDir = RunExamples.GetDataDir_AsposePdf_Images();
    int imageCount = 0;

    // Open PDF document
    using var document = new Aspose.Pdf.Document(dataDir + "ImagePlacement.pdf");
    var absorber = new Aspose.Pdf.ImagePlacementAbsorber();

    // Load contents of the first page
    document.Pages[1].Accept(absorber);

    // Iterate through each image placement on the first page
    foreach (var imagePlacement in absorber.ImagePlacements)
    {
        Console.WriteLine($"Image {imageCount}:");
        Console.WriteLine($"  Width: {imagePlacement.Rectangle.Width}");
        Console.WriteLine($"  Height: {imagePlacement.Rectangle.Height}");
        Console.WriteLine($"  LLX: {imagePlacement.Rectangle.LLX}");
        Console.WriteLine($"  LLY: {imagePlacement.Rectangle.LLY}");
        Console.WriteLine($"  Horizontal Resolution: {imagePlacement.Resolution.X}");
        Console.WriteLine($"  Vertical Resolution: {imagePlacement.Resolution.Y}");

        using var outputImage = File.Create(dataDir + $"ExtractedImage_{imageCount}.jpg");
        // Save PDF document image
        imagePlacement.Save(outputImage, System.Drawing.Imaging.ImageFormat.Jpeg);

        ++imageCount;
    }
}