Extract Images in a Specified Format

Introduction

The following methods make it easy to retrieve images in a specified format from a PowerPoint document.

DownloadImage

API Information

API	Type	Description	Resource
/slides/{name}/images/{index}/{format}	GET	Retrieves an image in a specified format from a presentation saved to storage.	DownloadImage

Request Parameters

Name	Type	Location	Required	Description
name	string	path	true	The name of a presentation file.
index	integer	path	true	The 1-based index of the image to be retrieved.
format	string	path	true	The format of the image.
password	string	header	false	The password to open the presentation.
folder	string	query	false	The path to the folder containing the presentation.
storage	string	query	false	The name of the storage contaning the `folder`.

In case of Amazon S3 storage folder path starts with Amazon S3 bucket name.

Examples

Retrieve the second image in GIF format from the document MyFolder/MyPresentation.pptx saved to the default storage.

cURL Solution

Request

Get an Access Token

curl -X POST "https://api.aspose.cloud/connect/token" \
     -d "grant_type=client_credentials&client_id=MyClientId&client_secret=MyClientSecret" \
     -H "Content-Type: application/x-www-form-urlencoded"

Retrieve the Image

curl -X GET "https://api.aspose.cloud/v3.0/slides/MyPresentation.pptx/images/2/Gif?folder=MyFolder" \
     -H "authorization: Bearer MyAccessToken"

Response

Image file

SDK Solutions

// For complete examples and data files, please go to https://github.com/aspose-Slides-cloud/aspose-Slides-cloud-dotnet

using Aspose.Slides.Cloud.Sdk;
using Aspose.Slides.Cloud.Sdk.Model;
using System.IO;

class Application
{
    static void Main(string[] args)
    {
        var slidesApi = new SlidesApi("MyClientId", "MyClientSecret");
        
        // Retrieve the second image in GIF format.
        using var imageStream = slidesApi.DownloadImage("MyPresentation.pptx", 2, ImageExportFormat.Gif, null, "MyFolder");

        // Save the image to a file.
        using var fileStream = File.OpenWrite("SecondImage.gif");
        imageStream.CopyTo(fileStream);
    }
}

Java

// For complete examples and data files, please go to https://github.com/aspose-Slides-cloud/aspose-Slides-cloud-java

import com.aspose.slides.ApiException;
import com.aspose.slides.api.SlidesApi;
import com.aspose.slides.model.*;

public class Application {
    public static void main(String[] args) throws ApiException {
        SlidesApi slidesApi = new SlidesApi("MyClientId", "MyClientSecret");

        // Retrieve the second image in GIF format.
        File imageFile = slidesApi.downloadImage("MyPresentation.pptx", 2, ImageExportFormat.GIF, null, "MyFolder", null);

        System.out.println("The second image was saved to " + imageFile.getPath());
    }
}

PHP

// For complete examples and data files, please go to https://github.com/aspose-Slides-cloud/aspose-Slides-cloud-php

use Aspose\Slides\Cloud\Sdk\Api\Configuration;
use Aspose\Slides\Cloud\Sdk\Api\SlidesApi;
use Aspose\Slides\Cloud\Sdk\Model\ImageExportFormat;

$configuration = new Configuration();
$configuration->setAppSid("MyClientId");
$configuration->setAppKey("MyClientSecret");

$slidesApi = new SlidesApi(null, $configuration);

// Retrieve the second image in GIF format.
$imageFile = $slidesApi->downloadImage("MyPresentation.pptx", 2, ImageExportFormat::GIF, null, "MyFolder");

echo "The second image was saved to ", $imageFile->getRealPath();

Ruby

# For complete examples and data files, please go to https://github.com/aspose-Slides-cloud/aspose-Slides-cloud-ruby

require "aspose_slides_cloud"

include AsposeSlidesCloud

configuration = Configuration.new
configuration.app_sid = "MyClientId"
configuration.app_key = "MyClientSecret"

slides_api = SlidesApi.new(configuration)

# Retrieve the second image in GIF format.
image_data = slides_api.download_image("MyPresentation.pptx", 2, ImageExportFormat::GIF, nil, "MyFolder")

# Save the image to a file.
File.binwrite("SecondImage.gif", image_data)

Python

# For complete examples and data files, please go to https://github.com/aspose-Slides-cloud/aspose-Slides-cloud-python

import asposeslidescloud

from asposeslidescloud.apis.slides_api import SlidesApi
from asposeslidescloud.models.image_export_format import ImageExportFormat

slides_api = SlidesApi(None, "MyClientId", "MyClientSecret")

# Retrieve the second image in GIF format.
image_path = slides_api.download_image("MyPresentation.pptx", 2, ImageExportFormat.GIF, None, "MyFolder")

print("The second image was saved to " + image_path)

Node.js

// For complete examples and data files, please go to https://github.com/aspose-Slides-cloud/aspose-Slides-cloud-nodejs

const cloud = require("asposeslidescloud");
const fs = require("fs");

const slidesApi = new cloud.SlidesApi("MyClientId", "MyClientSecret");

// Retrieve the second image in GIF format.
slidesApi.downloadImage("MyPresentation.pptx", 2, "gif", null, "MyFolder").then(response => {
    // Save the image to a file.
    fs.writeFile("SecondImage.gif", response.body, error => {
        if (error) throw error;
    });
});

C++

// For complete examples and data files, please go to https://github.com/aspose-Slides-cloud/aspose-Slides-cloud-cpp

#include "asposeslidescloud/api/SlidesApi.h"

using namespace asposeslidescloud::api;

int main()
{
    auto slidesApi = new SlidesApi(L"MyClientId", L"MyClientSecret");

    // Retrieve the second image in GIF format.
    auto responseContent = slidesApi->downloadImage(L"MyPresentation.pptx", 2, L"gif", L"", L"MyFolder").get();

    // Save the image to a file.
    std::ofstream fileStream("SecondImage.gif", std::ofstream::binary);
    responseContent.writeTo(fileStream);

    std::cin.get();

    return 0;
}

Perl

# For complete examples and data files, please go to https://github.com/aspose-Slides-cloud/aspose-Slides-cloud-perl

use AsposeSlidesCloud::Configuration;
use AsposeSlidesCloud::SlidesApi;

use File::Slurp;

my $config = AsposeSlidesCloud::Configuration->new();
$config->{app_sid} = "MyClientId";
$config->{app_key} = "MyClientSecret";

my $slides_api = AsposeSlidesCloud::SlidesApi->new(config => $config);

# Retrieve the second image in GIF format.
my %parameters = (name => "MyPresentation.pptx", index => 2, format => "gif", folder => "MyFolder");
my $image_data = $slides_api->download_image(%parameters);

# Save the image to a file.
write_file("SecondImage.gif", {binmode => ":raw"}, $image_data);

Swift

DownloadImageOnline

API Information

API	Type	Description	Resource
/slides/images/{index}/{format}	POST	Retrieves an image in a specified format from a presentation saved to a local file.	DownloadImageOnline

Request Parameters

Name	Type	Location	Required	Description
document	file	formData	true	The presentation file.
index	integer	path	true	The 1-based index of the image to be retrieved.
format	string	path	true	The format of the image.
password	string	header	false	The password to open the presentation.

DownloadImages

API Information

API	Type	Description	Resource
/slides/{name}/images/download/{format}	POST	Retrieves images in a specified format from a presentation saved to storage.	DownloadImages

Request Parameters

Name	Type	Location	Required	Description
name	string	path	true	The name of a presentation file.
format	string	path	true	The format of the image.
password	string	header	false	The password to open the presentation.
folder	string	query	false	The path to the folder containing the presentation.
storage	string	query	false	The name of the storage contaning the `folder`.

In case of Amazon S3 storage folder path starts with Amazon S3 bucket name.

DownloadImagesOnline

API Information

API	Type	Description	Resource
/slides/images/download/{format}	POST	Retrieves images in a specified format from a presentation saved to a local file.	DownloadImagesOnline

Request Parameters

Name	Type	Location	Required	Description
document	file	formData	true	The presentation file.
format	string	path	true	The format of the image.
password	string	header	false	The password to open the presentation.

SDKs

Check Available SDKs to learn how to add an SDK to your project.

Extract Images Replace an Image