Working with Geometry Paths

Introduction

The following API methods allow you to work with custom geometry paths. You can create any type of geometry shape using lines, arcs, and Bezier curves.

GetShapeGeometryPath

API Information

API	Type	Description	Resource
/slides/{name}/slides/{slideIndex}/shapes/{shapeIndex}/geometryPath	GET	Gets a shape geometry path.	GetShapeGeometryPath

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 a slide.
shapeIndex	integer	path	true	The 1-based index of a shape.
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.

SetShapeGeometryPath

API Information

API	Type	Description	Resource
/slides/{name}/slides/{slideIndex}/shapes/{shapeIndex}/geometryPath	POST	Sets a shape geometry path.	SetShapeGeometryPath

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 a slide.
shapeIndex	integer	path	true	The 1-based index of a shape.
dto	object	body	true	The data transfer object of the shape geometry path.
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

Set a geometry path to the second shape on the first slide in MyPresentation.pptx document.

cURL Solution

Request

Get an Access Token

curl 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"

Set the Geometry Path

curl -X POST "https://api.aspose.cloud/v3.0/slides/MyPresentation.pptx/slides/1/shapes/2/geometryPath" \
     -H "authorization: Bearer MyAccessToken" \
     -H "Content-Type: text/json" \
     -d "@geometry.json"

geometry.json example

{
    "paths": [
        {
            "pathData": [
                { "type": "MoveTo", "x": 0, "y": 0 },
                { "type": "LineTo", "x": 0, "y": 200 },
                { "type": "LineTo", "x": 200, "y": 300 },
                { "type": "LineTo", "x": 400, "y": 200 },
                { "type": "LineTo", "x": 400, "y": 0 },
                { "type": "Close" }
            ]
        }
    ]
}

Response

Response Example

{
    "type": "Shape",
    "shapeType": "Rectangle",
    "name": "ShapeObject",
    "width": 500.0,
    "height": 200.0,
    "x": 100.0,
    "y": 100.0,
    "lineFormat": {
        "alignment": "Center",
        "capStyle": "Flat",
        "dashStyle": "Solid",
        "joinStyle": "Round",
        "style": "Single",
        "miterLimit": 10.0,
        "width": 0.75
    },
    "selfUri": {
        "href": "https://api.aspose.cloud/v3.0/slides/MyPresentation.pptx/slides/1/shapes/2",
        "relation": "self"
    }
}

SDK Solutions

SlidesApi api = new SlidesApi("MyClientId", "MyClientSecret");

string fileName = "MyPresentation.pptx";
int slideIndex = 1;
int shapeIndex = 2;

GeometryPaths dto = new GeometryPaths
{
    Paths = new List<GeometryPath>
    {
        new GeometryPath
        {
            PathData = new List<PathSegment>
            {
                new MoveToPathSegment { X = 0, Y = 0 },
                new LineToPathSegment { X = 0, Y = 200 },
                new LineToPathSegment { X = 200, Y = 300 },
                new LineToPathSegment { X = 400, Y = 200 },
                new LineToPathSegment { X = 400, Y = 0 },
                new ClosePathSegment()
            }
        }
    }
};

ShapeBase shape = api.SetShapeGeometryPath(fileName, slideIndex, shapeIndex, dto);
Console.WriteLine(shape.Width);

Java

SlidesApi api = new SlidesApi("MyClientId", "MyClientSecret");

String fileName = "MyPresentation.pptx";
int slideIndex = 1;
int shapeIndex = 2;

GeometryPaths dto = new GeometryPaths();
List<GeometryPath> paths = new ArrayList<GeometryPath>();
GeometryPath path = new GeometryPath();
List<PathSegment> pathData = new ArrayList<PathSegment>();

MoveToPathSegment startSegment = new MoveToPathSegment();
startSegment.setX(0.0);
startSegment.setY(0.0);
pathData.add(startSegment);

LineToPathSegment line1Segment = new LineToPathSegment();
line1Segment.setX(0.0);
line1Segment.setY(200.0);
pathData.add(line1Segment);

LineToPathSegment line2Segment = new LineToPathSegment();
line2Segment.setX(200.0);
line2Segment.setY(300.0);
pathData.add(line2Segment);

LineToPathSegment line3Segment = new LineToPathSegment();
line3Segment.setX(400.0);
line3Segment.setY(200.0);
pathData.add(line3Segment);

LineToPathSegment line4Segment = new LineToPathSegment();
line4Segment.setX(400.0);
line4Segment.setY(0.0);
pathData.add(line4Segment);

ClosePathSegment endSegment = new ClosePathSegment();
pathData.add(endSegment);

path.setPathData(pathData);
paths.add(path);
dto.setPaths(paths);

ShapeBase shape = api.setShapeGeometryPath(fileName, slideIndex, shapeIndex, dto, null, null, null);
System.out.println(shape.getWidth());

PHP

use Aspose\Slides\Cloud\Sdk\Api\Configuration;
use Aspose\Slides\Cloud\Sdk\Api\SlidesApi;
use Aspose\Slides\Cloud\Sdk\Model\GeometryPaths;
use Aspose\Slides\Cloud\Sdk\Model\GeometryPath;
use Aspose\Slides\Cloud\Sdk\Model\MoveToPathSegment;
use Aspose\Slides\Cloud\Sdk\Model\LineToPathSegment;
use Aspose\Slides\Cloud\Sdk\Model\ClosePathSegment;

$config = new Configuration();
$config->setAppSid("MyClientId");
$config->setAppKey("MyClientSecret");
$api = new SlidesApi(null, $config);

$fileName = "MyPresentation.pptx";
$slideIndex = 1;
$shapeIndex = 2;

$dto = new GeometryPaths();
$path = new GeometryPath();

$start = new MoveToPathSegment();
$start->setX(0);
$start->setY(0);

$line1 = new LineToPathSegment();
$line1->setX(0);
$line1->setY(200);

$line2 = new LineToPathSegment();
$line2->setX(200);
$line2->setY(300);

$line3 = new LineToPathSegment();
$line3->setX(400);
$line3->setY(200);

$line4 = new LineToPathSegment();
$line4->setX(400);
$line4->setY(0);

$end = new ClosePathSegment();

$path->setPathData([ $start, $line1, $line1, $line3, $line4, $end ]);
$dto->setPaths([ $path ]);

$shape = $api->setShapeGeometryPath($fileName, $slideIndex, $shapeIndex, $dto);
print($shape->getWidth());

Ruby

require "aspose_slides_cloud"

include AsposeSlidesCloud

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

api = SlidesApi.new(configuration)

file_name = "MyPresentation.pptx"
slide_index = 1
shape_index = 2

dto = GeometryPaths.new
path = GeometryPath.new

start_segment = MoveToPathSegment.new
start_segment.x = 0
start_segment.y = 0

line1 = LineToPathSegment.new
line1.x = 0
line1.y = 200

line2 = LineToPathSegment.new
line2.x = 200
line2.y = 300

line3 = LineToPathSegment.new
line3.x = 400
line3.y = 200

line4 = LineToPathSegment.new
line4.x = 400
line4.y = 0

end_segment = ClosePathSegment.new

path.path_data = [ start_segment, line1, line2, line3, line4, end_segment ]
dto.paths = [ path ]

shape = api.set_shape_geometry_path(file_name, slide_index, shape_index, dto)
puts shape.width

Python

import asposeslidescloud

from asposeslidescloud.configuration import Configuration
from asposeslidescloud.apis.slides_api import SlidesApi
from asposeslidescloud.models.geometry_paths import GeometryPaths
from asposeslidescloud.models.geometry_path import GeometryPath
from asposeslidescloud.models.move_to_path_segment import MoveToPathSegment
from asposeslidescloud.models.line_to_path_segment import LineToPathSegment
from asposeslidescloud.models.close_path_segment import ClosePathSegment

configuration = Configuration()
configuration.app_sid = "MyClientId"
configuration.app_key = "MyClientSecret"
api = SlidesApi(configuration)

file_name = "MyPresentation.pptx"
slide_index = 1
shape_index = 2

dto = GeometryPaths()
path = GeometryPath()

start = MoveToPathSegment()
start.x = 0
start.y = 0

line1 = LineToPathSegment()
line1.x = 0
line1.y = 200

line2 = LineToPathSegment()
line2.x = 200
line2.y = 300

line3 = LineToPathSegment()
line3.x = 400
line3.y = 200

line4 = LineToPathSegment()
line4.x = 400
line4.y = 0

end = ClosePathSegment()

path.path_data = [ start, line1, line2, line3, line4, end ]
dto.paths = [ path ]

shape = api.set_shape_geometry_path(file_name, slide_index, shape_index, dto)
print(shape.width)

Node.js

const CloudSdk = require("asposeslidescloud");
const api = new CloudSdk.SlidesApi("MyClientId", "MyClientSecret");

const fileName = "MyPresentation.pptx";
const slideIndex = 1;
const shapeIndex = 2;

const dto = new CloudSdk.GeometryPaths();
const path = new CloudSdk.GeometryPath();

const start = new CloudSdk.MoveToPathSegment();
start.x = 0;
start.y = 0;

const line1 = new CloudSdk.MoveToPathSegment();
line1.x = 0;
line1.y = 200;

const line2 = new CloudSdk.MoveToPathSegment();
line2.x = 200;
line2.y = 300;

const line3 = new CloudSdk.MoveToPathSegment();
line3.x = 400;
line3.y = 200;

const line4 = new CloudSdk.MoveToPathSegment();
line4.x = 400;
line4.y = 0;

const end = new CloudSdk.ClosePathSegment();

path.pathData = [ start, line1, line2, line3, line4, end ];
dto.paths = [ path ];

return api.setShapeGeometryPath(fileName, slideIndex, shapeIndex, dto).then(result => {
    console.log(result.body.width);
});

cfg := asposeslidescloud.NewConfiguration()
cfg.AppSid = "MyClientId"
cfg.AppKey = "MyClientSecret"
api := asposeslidescloud.NewAPIClient(cfg)

fileName := "MyPresentation.pptx"
var slideIndex int32 = 1
var shapeIndex int32 = 2

dto := asposeslidescloud.NewGeometryPaths()
path := asposeslidescloud.NewGeometryPath()

startSegment := asposeslidescloud.NewMoveToPathSegment()
startSegment.X = 0
startSegment.Y = 0

line1 := asposeslidescloud.NewLineToPathSegment()
line1.X = 0
line1.Y = 200

line2 := asposeslidescloud.NewLineToPathSegment()
line2.X = 200
line2.Y = 300

line3 := asposeslidescloud.NewLineToPathSegment()
line3.X = 400
line3.Y = 200

line4 := asposeslidescloud.NewLineToPathSegment()
line4.X = 400
line4.Y = 0

endSegment := asposeslidescloud.NewClosePathSegment()

path.PathData = []asposeslidescloud.IPathSegment { startSegment, line1, line2, line3, line4, endSegment }
dto.Paths = []asposeslidescloud.IGeometryPath { path }

shape, _, e := api.SlidesApi.SetShapeGeometryPath(fileName, slideIndex, shapeIndex, dto, "", "", "")
if e != nil {
	fmt.Printf("Error: %v.", e)
}
if shape == nil {
	fmt.Printf("Error: shape should not be nil.")
}

C++

Perl

use AsposeSlidesCloud::Configuration;
use AsposeSlidesCloud::SlidesApi;
use AsposeSlidesCloud::Object::GeometryPaths;
use AsposeSlidesCloud::Object::GeometryPath;
use AsposeSlidesCloud::Object::MoveToPathSegment;
use AsposeSlidesCloud::Object::LineToPathSegment;
use AsposeSlidesCloud::Object::ClosePathSegment;

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

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

my $file_name = "MyPresentation.pptx";
my $slide_index = 1;
my $shape_index = 2;

my $dto = AsposeSlidesCloud::Object::GeometryPaths->new();
my $path = AsposeSlidesCloud::Object::GeometryPath->new();

my $start = AsposeSlidesCloud::Object::MoveToPathSegment->new();
$start->{x} = 0;
$start->{y} = 0;

my $line1 = AsposeSlidesCloud::Object::LineToPathSegment->new();
$line1->{x} = 0;
$line1->{y} = 200;

my $line2 = AsposeSlidesCloud::Object::LineToPathSegment->new();
$line2->{x} = 200;
$line2->{y} = 300;

my $line3 = AsposeSlidesCloud::Object::LineToPathSegment->new();
$line3->{x} = 400;
$line3->{y} = 200;

my $line4 = AsposeSlidesCloud::Object::LineToPathSegment->new();
$line4->{x} = 400;
$line4->{y} = 0;

my $end = AsposeSlidesCloud::Object::ClosePathSegment->new();

$path->{path_data} = [ $start, $line1, $line2, $line3, $line4, $end ];
$dto->{paths} = [ $path ];

my %parameters = (name => $file_name, slide_index => $slide_index, shape_index => $shape_index, dto => $dto);
my $shape = $api->set_shape_geometry_path(%parameters);
print(shape->{width});

Swift

SDKs

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

Working with Hyperlinks Working with Zoom Frames