aspose_slides_cloud 21.4.0 → 21.12.0

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA256:
-  metadata.gz: 232e46ad30de7ea4bb0792720058e7852812109fa8eeb53b9a3d0a62856f1263
-  data.tar.gz: c0591c2b6176291a7e018eb2fe7a0bc61488dd73d86b5538b60b8987473c4e7a
+  metadata.gz: dd7683c1c2ed9baf7e3b4eab3e9247f811bceedea9bb5f72fa00d7e17af660e6
+  data.tar.gz: f4d83f375f9d51c4729cc14210e16f07f4809e5a4efea37962c86a8d1a082360
 SHA512:
-  metadata.gz: 6d6564615833ba29f94622f9329f58f93d44b623731af56876c6e931ca9c695aeaba71d315eb7f0ff511c2ecc92b686bfa2e33cb10170cf44f6b20007452a756
-  data.tar.gz: a26c4a8ef46915346ffd88519ee7185aa7e5f26b3daca2c7af6f0918e5c01590e9254014e4a901604d1b63c96d3242796f4e1da292c10254274b50a69b1801f8
+  metadata.gz: c22153ad4f3c3a55e413fb3d78b77ba6739eaa3f91a61e69936d792a35cce1e175dc2b8065ec3989f5d9acfdd825b76c3c5bb5dc2b0985dabbe6f2b0d6a03bad
+  data.tar.gz: 00b53b6b0268788d0c60468526b6b2be6c59418c0531eb9d436bb822b567ca48692beae1e8068d39d276f6c729f53212f77fa67c62d84094fb2c08105a62f1ff

data/README.md

@@ -1,61 +1,105 @@
-# Aspose.Slides Cloud SDK for Ruby
-This repository contains Aspose.Slides Cloud SDK for Ruby source code. This SDK allows you to work with Aspose.Slides Cloud REST APIs in your Ruby applications.
-
-## Key Features
-* Conversion between various document-related formats (20+ formats supported), including PDF<->PowerPoint conversion
-* Download slides and shapes in various formats, including PDF and SVG
-* Merge and split PowerPoint presentations
-* Access PowerPoint presentation metadata and statistics
-* Find and replace
-* Full read & write access to Document Object Model, including slides, shapes, paragraphs, portions and many others
-* Support of Aspose.Storage API
-
-## Licensing
-All Aspose.Slides Cloud SDKs are licensed under MIT License.
-
-## How to use the SDK?
-The complete source code is available in this repository folder. You can either directly use it in your project via source code or get [Ruby gem](https://rubygems.org/gems/aspose_slides_cloud) (recommended).
-
-## Prerequisites
-To use Aspose Slides Cloud SDK for Ruby you need to register an account with [Aspose Cloud](https://www.aspose.cloud/) and lookup/create App Key and SID at [Cloud Dashboard](https://dashboard.aspose.cloud/#/apps). There is free quota available. For more details, see [Aspose Cloud Pricing](https://purchase.aspose.cloud/pricing).
-
-### Installation
-
-```sh
-gem install aspose_slides_cloud
-```
-
-### Sample usage
-
-The example code below converts a PowerPoint document to PDF format using aspose_slides_cloud library:
-```ruby
-	require 'aspose_slides_cloud'
-
-	configuration = AsposeSlidesCloud::Configuration.new
-	configuration.app_sid = "MyClientId"
-	configuration.app_key = "MyClientSecret"
-	api = AsposeSlidesCloud::SlidesApi.new(configuration)
-	requestParam = AsposeSlidesCloud::PostSlidesConvertRequest.new
-	requestParam.format = "pdf"
-	requestParam.document = File.binread("MyPresentation.pptx")
-	result = api.post_slides_convert(requestParam)
-	File.binwrite("MyPresentation.pdf", result)
-```
-
-## Contact Us
-
-Your feedback is very important to us. Please feel free to contact us using our [Support Forums](https://forum.aspose.cloud/c/slides).
-
-## Resources
- 
-[Website](https://www.aspose.cloud/)  
-[Product Home](https://products.aspose.cloud/slides/family)  
-[API Reference](https://apireference.aspose.cloud/slides/)  
-[Documentation](https://docs.aspose.cloud/slides/)  
-[Blog](https://blog.aspose.cloud/category/slides/)  
- 
-## Other languages
-
-We generate our SDKs in different languages so you may check if yours is available in our [list](https://github.com/aspose-slides-cloud).
- 
-If you don't find your language in the list, feel free to request it from us, or use raw REST API requests as you can find it [here](https://products.aspose.cloud/slides/curl).
+![](https://img.shields.io/badge/api-v3.0-lightgrey) ![Gem](https://img.shields.io/gem/v/aspose_slides_cloud) ![Gem](https://img.shields.io/gem/dt/aspose_slides_cloud) [![GitHub license](https://img.shields.io/github/license/aspose-slides-cloud/aspose-slides-cloud-ruby)](https://github.com/aspose-slides-cloud/aspose-slides-cloud-ruby/blob/master/LICENSE)
+
+# Ruby REST API to Process Presentation in Cloud
+This repository contains Aspose.Slides Cloud SDK for Ruby source code. This SDK allows you to [process & manipulate PPT, PPTX, ODP, OTP](https://products.aspose.cloud/slides/java) using Aspose.slides Cloud REST APIs in your Ruby applications.
+
+You may want to check out Aspose free [[PowerPoint to Word Converter]](https://products.aspose.app/slides/conversion/ppt-to-word) because it is a live implementation of one of the most popular conversion processes.
+
+## Presentation Processing Features
+
+- Fetch presentation images in any of the supported file formats.
+- Copy the layout side or clone the master slide from the source presentation.
+- Process slides shapes, slides notes, placeholders, colors & font theme info.
+- Programmatically create a presentation from HTML & export it to various formats.
+- Merge multiple presentations or split the single presentation into multiple ones.
+- Extract and replace text from a specific slide or an entire presentation.
+
+## Read & Write Presentation Formats
+
+**Microsoft PowerPoint:** PPT, PPTX, PPS, PPSX, PPTM, PPSM, POTX, POTM
+**OpenOffice:** ODP, OTP, FODP
+
+
+## Save Presentation As
+
+**Fixed Layout:** PDF, PDF/A, XPS
+**Images:** JPEG, PNG, BMP, TIFF, SVG
+**Web:** HTML/HTML5
+**Other:** SWF (export whole presentations)
+
+## Enhancements in Version 21.12
+* New **ThreeDFormat**, **Camera**, **LightRig** and **ShapeBevel** classes allow to get and set 3D effects for shapes. New **ThreeDFormat** property of **ShapeBase** class allows to access those objects.
+* The declaration of **GetAnimation** and  **GetSpecialSlideAnimation** methods is changed. New **paragraphIndex** parameter allows to get effects for a specific paragraph. New **ParagraphIndex** property of **Effect** class allows to set effects for a specific paragraph.
+* You can now use **Html5** value for **format** parameter in conversion methods and export presentations to HTML5 format.
+* New **Width** and **Height** parameters were added to **ExportOptions** class. You can now set custom size when convertion your documents.
+
+## Enhancements in Version 21.9
+* New **options** parameter for **Convert**, **ConvertAndSave**, **DownloadSlideOnline**, **SaveSlideOnline**, **DownloadShapeOnline** and **SaveShapeOnline** methods that allows to specify options when converting presentations from request body.
+* New methods to manage shapes and animation for special slide types: master, layout and notes slides. The new methods are **GetSpecialSlideShapes**, **GetSpecialSlideSubshapes, **GetSpecialSlideShape**, **GetSpecialSlideSubshape**, **GetSpecialSlideParagraphs**, **GetSpecialSlideSubshapeParagraphs**, **GetSpecialSlideParagraph**, **GetSpecialSlideSubshapeParagraph**, **GetSpecialSlidePortions**, **GetSpecialSlideSubshapePortions**, **GetSpecialSlidePortion**, **GetSpecialSlideSubshapePortion**, **CreateSpecialSlideShape**, **CreateSpecialSlideSubshape**, **CreateSpecialSlideParagraph**, **CreateSpecialSlideSubshapeParagraph**, **CreateSpecialSlidePortion**, **CreateSpecialSlideSubshapePortion**, **UpdateSpecialSlideShape**, **UpdateSpecialSlideSubshape**, **UpdateSpecialSlideParagraph**, **UpdateSpecialSlideSubshapeParagraph**, **UpdateSpecialSlidePortion**, **UpdateSpecialSlideSubshapePortion**, **DeleteSpecialSlideShapes**, **DeleteSpecialSlideSubshapes**, **DeleteSpecialSlideShape**, **DeleteSpecialSlideSubshape**, **DeleteSpecialSlideParagraphs**, **DeleteSpecialSlideSubshapeParagraphs**, **DeleteSpecialSlideParagraph**, **DeleteSpecialSlideSubshapeParagraph**, **DeleteSpecialSlidePortions**, **DeleteSpecialSlideSubshapePortions**, **DeleteSpecialSlidePortion**, **DeleteSpecialSlideSubshapePortion**, **DownloadSpecialSlideShape**, **DownloadSpecialSlideSubshape**, **SaveSpecialSlideShape**, **SaveSpecialSlideSubshape**, **AlignSpecialSlideShapes**, **GetSpecialSlideAnimation**, **SetSpecialSlideAnimation**, **CreateSpecialSlideAnimationInteractiveSequence**, **CreateSpecialSlideAnimationEffect**, **CreateSpecialSlideAnimationInteractiveSequenceEffect**, **UpdateSpecialSlideAnimationEffect**, **UpdateSpecialSlideAnimationInteractiveSequenceEffect**, **DeleteSpecialSlideAnimation**, **DeleteSpecialSlideAnimationMainSequence**, **DeleteSpecialSlideAnimationInteractiveSequences**, **DeleteSpecialSlideAnimationInteractiveSequence**, **DeleteSpecialSlideAnimationEffect**, **DeleteSpecialSlideAnimationInteractiveSequenceEffect**.
+
+## Enhancements in Version 21.8
+* New **slides** parameter for **Convert**, **ConvertAndSave**, **DownloadPresentation** and **SavePresentation** methods that allows to convert a specified set of slides in the presentation.
+
+## Enhancements in Version 21.6
+* New **CreateComment**, **CreateCommentOnline**, **DeleteComments**, **DeleteCommentsOnline**, **DeleteSlideComments** and **DeleteSlideCommentsOnline** methods to add or delete comments in presentations.
+
+## Enhancements in Version 21.4
+* New **CreateWatermark**, **CreateWatermarkOnline**, **CreateImageWatermark**, **CreateImageWatermarkOnline**, **DeleteWatermark** and **DeleteWatermarkOnline** methods to add or delete and remove watermark in presentations.
+* New **SetProtection**, **DeleteProtection**, **SetProtectionOnline** and **DeleteProtectionOnline** methods to set or clear presentation protection properties like read/write password, readonly flag.
+
+## Enhancements in Version 21.3
+* New **MergeOnline** and **MergeAndSaveOnline** methods to merge presentations from multipart request body.
+* New **SplitOnline** and **SplitAndSaveOnline** methods to split presentation from request body.
+* New **DownloadSlideOnline**, **DownloadShapeOnline**, **DownloadImageDefaultFormatOnline**, **DownloadImageOnline**, **SaveSlideOnline** and **SaveShapeOnline** methods to convert slides, shapes and images to spefified format using presentation from request body.
+* New **DownloadImagesDefaultFormat**, **DownloadImages**, **DownloadImagesDefaultFormatOnline** and **DownloadImagesDefaultFormatOnline** methods to download all images from presentation as a ZIP archive.
+* New **ReplacePresentationTextOnline** and **ReplaceSlideTextOnline** methods to replace text in presentation from request body.
+* New **AlignShapes** method to align shapes in a slide.
+* Simplified method declarations. See the [Release notes](https://docs.aspose.cloud/slides/aspose-slides-cloud-21-3-release-notes/) for details. Old method declarations are deprecated and will be deleted in 21.6 release.
+
+## Enhancements in Version 21.2
+* New **Map** value of **ChartTypeEnum** type to manage map charts.
+* New **SketchFromat** property of **LineFormat** class.
+
+## Enhancements in Version 21.1
+* New **PostSlidesDocumentFromPdf** method allows creating presentations or adding slides to it using a PDF file as a source.
+* New **GetSlidesSlideProperties**, **GetSlidesProtectionProperties**, **PutSlidesSlideProperties**, **PutSlidesProtectionProperties** allow to get/set presentaion properties like slide size, orientaion, read-only etc.
+* **PutSlidesDocumentFromHtml** method is deprecated and will be deleted in 21.4 release. Use **PostSlidesDocumentFromHtml** method instead.
+* **PutSlidesSlideSize** method is deprecated and will be deleted in 21.4 release. Use **PutSlidesProtectionProperties** method instead.
+
+## Licensing
+All Aspose.Slides Cloud SDKs are licensed under MIT License.
+
+## How to use the SDK?
+The complete source code is available in this repository folder. You can either directly use it in your project via source code or get [Ruby gem](https://rubygems.org/gems/aspose_slides_cloud) (recommended).
+
+## Prerequisites
+To use Aspose Slides Cloud SDK for Ruby you need to register an account with [Aspose Cloud](https://www.aspose.cloud/) and lookup/create App Key and SID at [Cloud Dashboard](https://dashboard.aspose.cloud/#/apps). There is free quota available. For more details, see [Aspose Cloud Pricing](https://purchase.aspose.cloud/pricing).
+
+### Installation
+
+```sh
+gem install aspose_slides_cloud
+```
+
+### Sample usage
+
+The example code below converts a PowerPoint document to PDF format using aspose_slides_cloud library:
+```ruby
+	require 'aspose_slides_cloud'
+
+	configuration = AsposeSlidesCloud::Configuration.new
+	configuration.app_sid = "MyClientId"
+	configuration.app_key = "MyClientSecret"
+	api = AsposeSlidesCloud::SlidesApi.new(configuration)
+	result = api.convert(File.binread("MyPresentation.pptx"), "pdf")
+	File.binwrite("MyPresentation.pdf", result)
+```
+
+## Aspose.Slides Cloud SDKs in Popular Languages
+
+| .NET | Java | PHP | Python | Ruby | Node.js | Android | Swift|Perl|Go|
+|---|---|---|---|---|---|---|--|--|--|
+| [GitHub](https://github.com/aspose-slides-cloud/aspose-slides-cloud-dotnet) | [GitHub](https://github.com/aspose-slides-cloud/aspose-slides-cloud-java) | [GitHub](https://github.com/aspose-slides-cloud/aspose-slides-cloud-php) | [GitHub](https://github.com/aspose-slides-cloud/aspose-slides-cloud-python) | [GitHub](https://github.com/aspose-slides-cloud/aspose-slides-cloud-ruby)  | [GitHub](https://github.com/aspose-slides-cloud/aspose-slides-cloud-nodejs) | [GitHub](https://github.com/aspose-slides-cloud/aspose-slides-cloud-android) | [GitHub](https://github.com/aspose-slides-cloud/aspose-slides-cloud-swift)|[GitHub](https://github.com/aspose-slides-cloud/aspose-slides-cloud-perl) |[GitHub](https://github.com/aspose-slides-cloud/aspose-slides-cloud-go) |
+| [NuGet](https://www.nuget.org/packages/Aspose.slides-Cloud/) | [Maven](https://repository.aspose.cloud/webapp/#/artifacts/browse/tree/General/repo/com/aspose/aspose-slides-cloud) | [Composer](https://packagist.org/packages/aspose/slides-sdk-php) | [PIP](https://pypi.org/project/asposeslidescloud/) | [GEM](https://rubygems.org/gems/aspose_slides_cloud)  | [NPM](https://www.npmjs.com/package/asposeslidescloud) | [Maven](https://repository.aspose.cloud/webapp/#/artifacts/browse/tree/General/repo/com/aspose/aspose-slides-cloud) | [Cocoapods](https://cocoapods.org/pods/AsposeslidesCloud)|[Meta Cpan](https://metacpan.org/release/AsposeSlidesCloud-SlidesApi) | [Go.Dev](https://pkg.go.dev/github.com/aspose-slides-cloud/aspose-slides-cloud-go/) |
+
+[Product Page](https://products.aspose.cloud/slides/ruby) | [Documentation](https://docs.aspose.cloud/display/slidescloud/Home) | [API Reference](https://apireference.aspose.cloud/slides/) | [Code Samples](https://github.com/aspose-slides-cloud/aspose-slides-cloud-ruby) | [Blog](https://blog.aspose.cloud/category/slides/) | [Free Support](https://forum.aspose.cloud/c/slides) | [Free Trial](https://dashboard.aspose.cloud/#/apps)