Split a Presentation Saved to Storage

Introduction

The article shows you how to split a PowerPoint presentation saved in storage.

API Information

API	Type	Description	Resource
/slides/{name}/split	POST	Splits a presentation file and stores the output parts on a storage.	Split

Request Parameters

Name	Type	Location	Required	Description
name	string	path	true	The file name of the presentation in a storage.
options	object	body	false	The format-specific options for the output files.
format	string	query	false	The format for output files. See the table for available formats. The default value is `jpeg`.
width	integer	query	false	The width of each slide in the output files. Does not affect the HTML format.
height	integer	query	false	The height of each slide in the output files. Does not affect the HTML format.
from	integer	query	false	The 1-based starting slide number for the splitting. If it is not specified, the splitting starts from the first slide of the presentation.
to	integer	query	false	The 1-based last slide number for the splitting. If it is not specified, the splitting ends at the last slide of the presentation.
destFolder	string	query	false	The storage folder where the output files will be uploaded. If it is not specified, the files will be uploaded to the folder where the presentation is saved.
password	string	header	false	The password to open the presentation.
folder	string	query	false	The folder path where the presentation is saved.
storage	string	query	false	The name of the storage where the presentation is saved. If it is not specified, the default storage is assumed.
fontsFolder	string	query	false	The path to the storage folder containing custom fonts that can be used in the presentation.

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

Splitting All Slides

Split MyFolder/MyPresentation.pptx file from a default storage into a set of JPEG images and save them to the same folder.

cURL Solution

Request

Get an Access Token

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

Split the Presentation

curl -X POST "https://api.aspose.cloud/v3.0/slides/MyPresentation.pptx/split?folder=MyFolder" \
     -H "authorization: Bearer <access_token>" \
     -H "Content-Length: 0"

Response

{
    "slides": [
        {
            "href": "https://api.aspose.cloud/v3.0/slides/storage/file/MyFolder/MyPresentation_1.jpeg",
            "relation": "self",
            "linkType": "image/jpeg",
            "title": "Slide 1"
        },
        {
            "href": "https://api.aspose.cloud/v3.0/slides/storage/file/MyFolder/MyPresentation_2.jpeg",
            "relation": "self",
            "linkType": "image/jpeg",
            "title": "Slide 2"
        },
        {
            "href": "https://api.aspose.cloud/v3.0/slides/storage/file/MyFolder/MyPresentation_3.jpeg",
            "relation": "self",
            "linkType": "image/jpeg",
            "title": "Slide 3"
        }
    ],
    "selfUri": {
        "href": "https://api.aspose.cloud/v3.0/slides/MyPresentation.pptx?folder=MyFolder",
        "relation": "self"
    }
}

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 System;

class Application
{
    static void Main(string[] args)
    {
        var slidesApi = new SlidesApi("my_client_id", "my_client_secret");

        // Split all slides in the presentation.
        var response = slidesApi.Split("MyPresentation.pptx", folder: "MyFolder");

        foreach (var slide in response.Slides)
        {
            // Output: https://api.aspose.cloud/v3.0/slides/storage/file/MyFolder/MyPresentation_1.jpeg, etc.
            Console.WriteLine(slide.Href); 
        }
    }
}

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;

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

        // Split all slides in the presentation.
        SplitDocumentResult response = slidesApi.split("MyPresentation.pptx", null, null, null, null, null, null, null, null, "MyFolder", null, null);

        for (ResourceUri slide : response.getSlides())
        {
            // Output: https://api.aspose.cloud/v3.0/slides/storage/file/MyFolder/MyPresentation_1.jpeg, etc.
            System.out.println(slide.getHref());
        }
    }
}

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;

$configuration = new Configuration();
$configuration->setAppSid("my_client_id");
$configuration->setAppKey("my_client_secret");

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

// Split all slides in the presentation.
$response = $slidesApi->split("MyPresentation.pptx", null, null, null, null, null, null, null, null, "MyFolder");

foreach ($response->getSlides() as $slide)
{
    // Output: https://api.aspose.cloud/v3.0/slides/storage/file/MyFolder/MyPresentation_1.jpeg, etc.
    echo $slide->getHref(), "\n";
}

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 = "my_client_id"
configuration.app_key = "my_client_secret"

slides_api = SlidesApi.new(configuration)

# Split all slides in the presentation.
response = slides_api.split("MyPresentation.pptx", nil, nil, nil, nil, nil, nil, nil, nil, "MyFolder")

for slide in response.slides
    # Output: https://api.aspose.cloud/v3.0/slides/storage/file/MyFolder/MyPresentation_1.jpeg, etc.
    puts slide.href
end

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

slides_api = SlidesApi(None, "my_client_id", "my_client_secret")

# Split all slides in the presentation.
response = slides_api.split("MyPresentation.pptx", None, None, None, None, None, None, None, None, "MyFolder")

for slide in response.slides:
    # Output: https://api.aspose.cloud/v3.0/slides/storage/file/MyFolder/MyPresentation_1.jpeg, etc.
    print(slide.href)

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 slidesApi = new cloud.SlidesApi("my_client_id", "my_client_secret");

// Split all slides in the presentation.
slidesApi.split("MyPresentation.pptx", null, null, null, null, null, null, null, null, "MyFolder").then(response => {
    response.body.slides.forEach(slide => {
        // Output: https://api.aspose.cloud/v3.0/slides/storage/file/MyFolder/MyPresentation_1.jpeg, etc.
        console.log(slide.href);
    });
});

Android

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

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

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

        // Split all slides in the presentation.
        SplitDocumentResult response = slidesApi.split("MyPresentation.pptx", null, null, null, null, null, null, null, null, "MyFolder", null, null);

        for (ResourceUri slide : response.getSlides())
        {
            // Output: https://api.aspose.cloud/v3.0/slides/storage/file/MyFolder/MyPresentation_1.jpeg, etc.
            System.out.println(slide.getHref());
        }
    }
}

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 utility;
using namespace utility::conversions;
using namespace asposeslidescloud::api;

int main()
{
    auto slidesApi = std::make_shared<SlidesApi>(to_string_t("my_client_id"), to_string_t("my_client_secret"));

    // Split all slides in the presentation.
    auto response = slidesApi->split(
        to_string_t("MyPresentation.pptx"), std::nullptr_t(), string_t(), boost::none, boost::none, boost::none, boost::none, 
        string_t(), string_t(), to_string_t("MyFolder")).get();

    for (auto slide : response->getSlides())
    {
        // Output: https://api.aspose.cloud/v3.0/slides/storage/file/MyFolder/MyPresentation_1.jpeg, etc.
        std::cout << to_utf8string(slide->getHref()) << std::endl;
    }

    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;

my $config = AsposeSlidesCloud::Configuration->new();
$config->{app_sid} = "my_client_id";
$config->{app_key} = "my_client_secret";
my $slidesApi = AsposeSlidesCloud::SlidesApi->new(config => $config);

# Split all slides in the presentation.
my %splitParams = ("name" => "MyPresentation.pptx", "folder" => "MyFolder");
my $response = $slidesApi->split(%splitParams);

for $slide (@{$response->{slides}}) {
    # Output: https://api.aspose.cloud/v3.0/slides/storage/file/MyFolder/MyPresentation_1.jpeg, etc.
    print $slide->{href}, "\n";
}

Swift

Splitting a Range of Slides

Split the 2nd and 3rd slides from MyFolder/MyPresentation.pptx file, convert the slides to PNG format, and store them to MyImages folder.