Get Image Information from a Slide Introduction The following API method allows you to easily read information about images placed on a slide in a PowerPoint document. You can find out the following image properties: width, height, type, etc.
You can optionally limit the output to images related to a specific shape, specifying its index or alternative text.
GetSlideImages
API Type Description Resource
/slides/{name}/slides/{slideIndex}/images
GET
Returns information about the images placed on a slide.
GetSlideImages
Request Parameters
Name Type Location Required Description
name
string
path
true
The name of a presentation file.
slideIndex
integer
path
true
The 1-based index of the slide.
shapeIndex
integer
query
false
The 1-based index of the shape; if specified, returns only images related to that shape.
shapeAltText
string
query
false
The alternative text of the shape; if specified, returns only images related to that shape. The property value should match shape alternative text ot alternative text title.
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 Read information about the images placed on the first slide in MyFolder/MyPresentation.pptx file saved to the default storage.
cURL Solution
Request
Get an Access Token
curl -X POST "https://api.aspose.cloud/connect/token" \
"grant_type=client_credentials&client_id=MyClientId&client_secret=MyClientSecret" \
"Content-Type: application/x-www-form-urlencoded"
Read Image Information
curl -X GET "https://api.aspose.cloud/v3.0/slides/MyPresentation.pptx/slides/1/images?folder=MyFolder" \
"authorization: Bearer <access_token>"
Response
Response Example
{
"list" : [
{
"width" : 1021 ,
"height" : 308 ,
"contentType" : "image/png" ,
"selfUri" : {
"href" : "https://api.aspose.cloud/v3.0/slides/MyPresentation.pptx/images/1?folder=MyFolder" ,
"relation" : "self"
},
"alternateLinks" : [
{
"href" : "https://api.aspose.cloud/v3.0/slides/MyPresentation.pptx/images/1/jpeg?folder=MyFolder" ,
"relation" : "alternate"
},
{
"href" : "https://api.aspose.cloud/v3.0/slides/MyPresentation.pptx/images/1/png?folder=MyFolder" ,
"relation" : "alternate"
},
{
"href" : "https://api.aspose.cloud/v3.0/slides/MyPresentation.pptx/images/1/gif?folder=MyFolder" ,
"relation" : "alternate"
}
]
},
{
"width" : 430 ,
"height" : 368 ,
"contentType" : "image/jpeg" ,
"selfUri" : {
"href" : "https://api.aspose.cloud/v3.0/slides/MyPresentation.pptx/images/2?folder=MyFolder" ,
"relation" : "self"
},
"alternateLinks" : [
{
"href" : "https://api.aspose.cloud/v3.0/slides/MyPresentation.pptx/images/2/jpeg?folder=MyFolder" ,
"relation" : "alternate"
},
{
"href" : "https://api.aspose.cloud/v3.0/slides/MyPresentation.pptx/images/2/png?folder=MyFolder" ,
"relation" : "alternate"
},
{
"href" : "https://api.aspose.cloud/v3.0/slides/MyPresentation.pptx/images/2/gif?folder=MyFolder" ,
"relation" : "alternate"
}
]
}
],
"selfUri" : {
"href" : "https://api.aspose.cloud/v3.0/slides/MyPresentation.pptx/slides/1/images?folder=MyFolder" ,
"relation" : "self" ,
"slideIndex" : 1
}
}
SDK Solutions
C#
// 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.Diagnostics ;
class Application
{
static void Main ()
{
var slidesApi = new SlidesApi ( "MyClientId" , "MyClientSecret" );
// Read information about the images placed on the first slide.
var imagesInfo = slidesApi . GetSlideImages ( "MyPresentation.pptx" , 1 , null , null , null , "MyFolder" );
// Print information about the images.
foreach ( var imageInfo in imagesInfo . List )
{
Debug . WriteLine ( $"{imageInfo.Width}x{imageInfo.Height}, {imageInfo.ContentType}" );
}
}
}
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 ( "MyClientId" , "MyClientSecret" );
// Read information about the images placed on the first slide.
Images imagesInfo = slidesApi . getSlideImages ( "MyPresentation.pptx" , 1 , null , null , null , "MyFolder" , null );
// Print information about the images.
for ( Image imageInfo : imagesInfo . getList ()) {
System . out . printf ( "%sx%s, %s\n" , imageInfo . getWidth (), imageInfo . getHeight (), imageInfo . getContentType ());
}
}
}
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 ( "MyClientId" );
$configuration -> setAppKey ( "MyClientSecret" );
$slidesApi = new SlidesApi ( null , $configuration );
// Read information about the images placed on the first slide.
$imagesInfo = $slidesApi -> getSlideImages ( "MyPresentation.pptx" , 1 , null , null , null , "MyFolder" );
// Print information about the images.
foreach ( $imagesInfo -> getList () as $imageInfo ) {
echo sprintf ( "%sx%s, %s \n " , $imageInfo -> getWidth (), $imageInfo -> getHeight (), $imageInfo -> getContentType ());
}
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 )
# Read information about the images placed on the first slide.
images_info = slides_api . get_slide_images ( "MyPresentation.pptx" , 1 , nil , nil , nil , "MyFolder" )
# Print information about the images.
for image_info in images_info . list
puts " #{ image_info . width } x #{ image_info . height } , #{ image_info . content_type } "
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 , "MyClientId" , "MyClientSecret" )
# Read information about the images placed on the first slide.
images_info = slides_api . get_slide_images ( "MyPresentation.pptx" , 1 , None , None , None , "MyFolder" )
# Print information about the images.
for image_info in images_info . list :
print ( f "{image_info.width}x{image_info.height}, {image_info.content_type}" )
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 ( "MyClientId" , "MyClientSecret" );
// Read information about the images placed on the first slide.
slidesApi . getSlideImages ( "MyPresentation.pptx" , 1 , null , null , null , "MyFolder" ). then ( imagesInfo => {
// Print information about the images.
imagesInfo . body . list . forEach ( imageInfo => {
console . log ( imageInfo . width + "x" + imageInfo . height + ", " + imageInfo . contentType );
});
});
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" );
// Read information about the images placed on the first slide.
auto imagesInfo = slidesApi -> getSlideImages ( L "MyPresentation.pptx" , 1 , boost :: none , L "" , L "" , L "MyFolder" ). get ();
// Print information about the images.
for ( auto imageInfo : imagesInfo -> getList ()) {
std :: wcout << imageInfo -> getWidth () << "x" << imageInfo -> getHeight () << ", " << imageInfo -> getContentType () << std :: endl ;
}
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 ;
my $config = AsposeSlidesCloud::Configuration -> new ();
$config -> { app_sid } = "MyClientId" ;
$config -> { app_key } = "MyClientSecret" ;
my $slides_api = AsposeSlidesCloud::SlidesApi -> new ( config => $config );
# Read information about the images placed on the first slide.
my %parameters = ( name => "MyPresentation.pptx" , slide_index => 1 , folder => "MyFolder" );
my $images_info = $slides_api -> get_slide_images ( %parameters );
# Print information about the images.
for my $image_info ( @ { $images_info -> { list }}) {
print ( "$image_info->{width}x$image_info->{height}, $image_info->{content_type}\n" );
}
Swift
Go
SDKs Using an SDK (API client) is the quickest way for a developer to speed up development. An SDK takes care of a lot of low-level details of making requests and handling responses and lets you focus on writing code specific to your particular project. Check out our GitHub repository for a complete list of Aspose.Slides Cloud SDKs along with working examples, to get you started in no time. Please check Available SDKs article to learn how to add an SDK to your project.