aspose_pdf_cloud 24.7.0 → 24.8.0

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA256:
-  metadata.gz: c35455aae949bb7d45b636c96aec219f5d71fb5a5e9c6b9dcbb721cd444a28ac
-  data.tar.gz: 1605a812c8f158fbd45ae0fc5b6ed63e0fbfd183a9a11ccfeae3b378647c3c45
+  metadata.gz: ac5c97cfac0ff947f54e9f380ad0b66d156a49384f5a08ab53d0d89344820a84
+  data.tar.gz: 2fd03bfbf30f838d8dd21514dfe28bcbda7283a1f282beac3b182fa2a49bb131
 SHA512:
-  metadata.gz: c503d040d47744ed242c81be7cceac96062823a7cce955c31e99194eab3a0e7a56751ec8dc91b0a809ab7c0d9597925129281fbb68ae081955cbcf8064738e5f
-  data.tar.gz: 8a7e70600e2bc88610a4597b939447714dc839715d66db9abb164c2b0fef4c4f23d66b59fb7beff51a8070bb9e98383ad074c68e6235122a4e30c17ec5a0eb50
+  metadata.gz: 780280be54bd6774f28931fbefdf06cf558d08c0bcddb1b7c63d001c84c950fb21fae19ccafb8d7229e4f82f971f9dfebc1d350c45cecb24c1702eb4f0c2b84a
+  data.tar.gz: 13e418921547b8fb7af995fc0b1a4e0b82bfe6f19a3abe2cf1634499cb358fa815ea57c59fee4fe76a2f551dca526b4d02b913564f0f7baaf813214420d03d86

data/README.md

@@ -29,13 +29,11 @@ XLS, XLSX, PPTX, DOC, DOCX, MobiXML, JPEG, EMF, PNG, BMP, GIF, TIFF, Text
 ## Read PDF Formats
 MHT, PCL, PS, XSLFO, MD
 
-## Enhancements in Version 24.7
+## Enhancements in Version 24.8
+- Adding Text stamps to multiple pages.
+- Adding Image stamps to multiple pages.
 - A new version of Aspose.PDF Cloud was prepared using the latest version of Aspose.PDF for .NET.
 
-## Bugs fixed in Version 24.7
-- PutPsInStorageToPdf throws: Cannot find resource ‘Aspose.PDF.dependencies.ZapfDingbats.ttf.
-- Ocr method is not working.
-
 ## Installation
 
 ### Build a gem
@@ -49,15 +47,15 @@ gem build aspose_pdf_cloud.gemspec
 Then either install the gem locally:
 
 ```shell
-gem install ./aspose_pdf_cloud-24.5.0.gem
+gem install ./aspose_pdf_cloud-24.8.0.gem
 ```
-(for development, run `gem install --dev ./aspose_pdf_cloud-24.5.0.gem` to install the development dependencies)
+(for development, run `gem install --dev ./aspose_pdf_cloud-24.8.0.gem` to install the development dependencies)
 
 or publish the gem to a gem hosting service, e.g. [RubyGems](https://rubygems.org/).
 
 Finally add this to the Gemfile:
 
-    gem 'aspose_pdf_cloud', '~> 24.5.0'
+    gem 'aspose_pdf_cloud', '~> 24.8.0'
 
 ### Install from Git
 

data/docs/OptimizeOptions.md

@@ -5,16 +5,16 @@ Represents Pdf optimize options.
 Name | Type | Description | Notes
 ------------ | ------------- | ------------- | -------------
 **password** | **String** | Specifies document password (if any) encoded with base-64. | [optional] 
-**allow_reuse_page_content** | **BOOLEAN** | If true page contents will be reused when document is optimized for equal pages. | [optional] 
+**allow_reuse_page_content** | **BOOLEAN** | If true page contents will be reused when document is optimized for equal pages. LinkDuplcateStreams option must be set to true. | [optional] 
 **compress_images** | **BOOLEAN** | If this flag is set to true images will be compressed in the document. Compression level is specified with ImageQuality property. | [optional] 
 **image_quality** | **Integer** | Specifies level of image compression when CompressImages flag is used. | [optional] 
 **link_duplcate_streams** | **BOOLEAN** | If this flag is set to true, Resource streams will be analyzed. If duplicate streams are found (i.e. if stream contents is equal), then thees streams will be stored as one object.  This allows to decrease document size in some cases (for example, when same document was concatenated multiple times). | [optional] 
 **remove_unused_objects** | **BOOLEAN** | If this flag is set to true, all document objects will be checked and unused objects (i.e. objects which does not have any reference) are removed from document. | [optional] 
 **remove_unused_streams** | **BOOLEAN** | If this flag set to true, every resource is checked on it's usage. If resource is never used, then resources is removed. This may decrease document size for example when pages were extracted from document.  | [optional] 
-**unembed_fonts** | **BOOLEAN** | Make fonts not embedded if set to true.  | [optional] 
+**unembed_fonts** | **BOOLEAN** | Make fonts not embedded if set to true. Unembedding a font means removing the embedded byte stream data of the font included in a PDF document. | [optional] 
 **resize_images** | **BOOLEAN** | If this flag set to true and CompressImages is true images will be resized if image resolution is greater then specified MaxResolution parameter. | [optional] 
 **max_resolution** | **Integer** | Specifies maximum resolution of images. If image has higher resolution it will be scaled. | [optional] 
-**subset_fonts** | **BOOLEAN** | Fonts will be converted into subsets if set to true. | [optional] 
+**subset_fonts** | **BOOLEAN** | Fonts will be converted into subsets if set to true. Only those characters that are actually used in the layout are stored in the PDF.  | [optional] 
 **remove_private_info** | **BOOLEAN** | Remove private information (page piece info). | [optional] 
 **image_encoding** | [**ImageEncoding**](ImageEncoding.md) | Image encode which will be used. | [optional] 
 **image_compression_version** | [**ImageCompressionVersion**](ImageCompressionVersion.md) | Version of compression algorithm. Possible values are: "Standard" - standard compression, "Fast" - fast (improved compression which is faster then standard but may be applicable not for all images), "Mixed" - mixed (standard compression is applied to images which can not be compressed by  faster algorithm, this may give best compression but more slow then "Fast" algorithm. Version "Fast" is not applicable for resizing images (standard method will be used). Default is "Standard". | [optional] 

data/docs/PdfApi.md

@@ -203,10 +203,12 @@ Method | HTTP request | Description
 [**post_decrypt_document_in_storage**](PdfApi.md#post_decrypt_document_in_storage) | **POST** /pdf/\{name}/decrypt | Decrypt document in storage.
 [**post_document_image_footer**](PdfApi.md#post_document_image_footer) | **POST** /pdf/\{name}/footer/image | Add document image footer.
 [**post_document_image_header**](PdfApi.md#post_document_image_header) | **POST** /pdf/\{name}/header/image | Add document image header.
+[**post_document_image_stamps**](PdfApi.md#post_document_image_stamps) | **POST** /pdf/\{name}/stamps/image | Add document pages image stamps.
 [**post_document_page_number_stamps**](PdfApi.md#post_document_page_number_stamps) | **POST** /pdf/\{name}/stamps/pagenumber | Add document page number stamps.
 [**post_document_text_footer**](PdfApi.md#post_document_text_footer) | **POST** /pdf/\{name}/footer/text | Add document text footer.
 [**post_document_text_header**](PdfApi.md#post_document_text_header) | **POST** /pdf/\{name}/header/text | Add document text header.
 [**post_document_text_replace**](PdfApi.md#post_document_text_replace) | **POST** /pdf/\{name}/text/replace | Document's replace text method.
+[**post_document_text_stamps**](PdfApi.md#post_document_text_stamps) | **POST** /pdf/\{name}/stamps/text | Add document pages text stamps.
 [**post_encrypt_document_in_storage**](PdfApi.md#post_encrypt_document_in_storage) | **POST** /pdf/\{name}/encrypt | Encrypt document in storage.
 [**post_flatten_document**](PdfApi.md#post_flatten_document) | **POST** /pdf/\{name}/flatten | Flatten the document.
 [**post_html_to_pdf**](PdfApi.md#post_html_to_pdf) | **POST** /pdf/create/html | Convert HTML file (zip archive in request content) to PDF format and return resulting file in response. 
@@ -5409,6 +5411,32 @@ Name | Type | Description  | Notes
 
 
 
+# **post_document_image_stamps**
+> AsposeResponse post_document_image_stamps(name, stamps, opts)
+
+Add document pages image stamps.
+
+### Parameters
+
+Name | Type | Description  | Notes
+------------- | ------------- | ------------- | -------------
+ **name** | **String**| The document name. | 
+ **stamps** | [**Array<ImageStamp>**](ImageStamp.md)| The array of stamp. | 
+ **storage** | **String**| The document storage. | [optional] 
+ **folder** | **String**| The document folder. | [optional] 
+ **password** | **String**| Base64 encoded password. | [optional] 
+
+### Return type
+
+[**AsposeResponse**](AsposeResponse.md)
+
+### HTTP request headers
+
+ - **Content-Type**: application/json
+ - **Accept**: application/json
+
+
+
 # **post_document_page_number_stamps**
 > AsposeResponse post_document_page_number_stamps(name, stamp, opts)
 
@@ -5516,6 +5544,32 @@ Name | Type | Description  | Notes
 
 
 
+# **post_document_text_stamps**
+> AsposeResponse post_document_text_stamps(name, stamps, opts)
+
+Add document pages text stamps.
+
+### Parameters
+
+Name | Type | Description  | Notes
+------------- | ------------- | ------------- | -------------
+ **name** | **String**| The document name. | 
+ **stamps** | [**Array<TextStamp>**](TextStamp.md)| The array of stamp. | 
+ **storage** | **String**| The document storage. | [optional] 
+ **folder** | **String**| The document folder. | [optional] 
+ **password** | **String**| Base64 encoded password. | [optional] 
+
+### Return type
+
+[**AsposeResponse**](AsposeResponse.md)
+
+### HTTP request headers
+
+ - **Content-Type**: application/json
+ - **Accept**: application/json
+
+
+
 # **post_encrypt_document_in_storage**
 > AsposeResponse post_encrypt_document_in_storage(name, user_password, owner_password, crypto_algorithm, opts)
 

data/lib/aspose_pdf_cloud/api/pdf_api.rb

@@ -15608,6 +15608,86 @@ module AsposePdfCloud
       return data, status_code, headers
     end
 
+    # Add document pages image stamps.
+    # 
+    # @param name The document name.
+    # @param stamps The array of stamp.
+    # @param [Hash] opts the optional parameters
+    # @option opts [String] :storage The document storage.
+    # @option opts [String] :folder The document folder.
+    # @option opts [String] :password Base64 encoded password.
+    # @return [AsposeResponse]
+    def post_document_image_stamps(name, stamps, opts = {})
+      @api_client.request_token_if_needed
+      data, _status_code, _headers = post_document_image_stamps_with_http_info(name, stamps, opts)
+      rescue ApiError => error
+        if error.code == 401
+          @api_client.request_token_if_needed
+          data, _status_code, _headers = post_document_image_stamps_with_http_info(name, stamps, opts)
+        else
+          raise
+        end
+      return data
+    end
+
+    # Add document pages image stamps.
+    # 
+    # @param name The document name.
+    # @param stamps The array of stamp.
+    # @param [Hash] opts the optional parameters
+    # @option opts [String] :storage The document storage.
+    # @option opts [String] :folder The document folder.
+    # @option opts [String] :password Base64 encoded password.
+    # @return [Array<(AsposeResponse, Fixnum, Hash)>] AsposeResponse data, response status code and response headers
+    def post_document_image_stamps_with_http_info(name, stamps, opts = {})
+      if @api_client.config.debugging
+        @api_client.config.logger.debug "Calling API: PdfApi.post_document_image_stamps ..."
+      end
+      # verify the required parameter 'name' is set
+      if @api_client.config.client_side_validation && name.nil?
+        fail ArgumentError, "Missing the required parameter 'name' when calling PdfApi.post_document_image_stamps"
+      end
+      # verify the required parameter 'stamps' is set
+      if @api_client.config.client_side_validation && stamps.nil?
+        fail ArgumentError, "Missing the required parameter 'stamps' when calling PdfApi.post_document_image_stamps"
+      end
+      # resource path
+      local_var_path = "/pdf/{name}/stamps/image".sub('{' + 'name' + '}', name.to_s)
+
+      # query parameters
+      query_params = {}
+      query_params[:'storage'] = opts[:'storage'] if !opts[:'storage'].nil?
+      query_params[:'folder'] = opts[:'folder'] if !opts[:'folder'].nil?
+      query_params[:'password'] = opts[:'password'] if !opts[:'password'].nil?
+
+      # header parameters
+      header_params = {}
+      # HTTP header 'Accept' (if needed)
+      header_params['Accept'] = @api_client.select_header_accept(['application/json'])
+      # HTTP header 'Content-Type'
+      header_params['Content-Type'] = @api_client.select_header_content_type(['application/json'])
+
+      # form parameters
+      form_params = {}
+      # Fix header in file
+      post_body = nil
+
+      # http body (model)
+      post_body = @api_client.object_to_http_body(stamps)
+      auth_names = ['JWT']
+      data, status_code, headers = @api_client.call_api(:POST, local_var_path,
+        :header_params => header_params,
+        :query_params => query_params,
+        :form_params => form_params,
+        :body => post_body,
+        :auth_names => auth_names,
+        :return_type => 'AsposeResponse')
+      if @api_client.config.debugging
+        @api_client.config.logger.debug "API called: PdfApi#post_document_image_stamps\nData: #{data.inspect}\nStatus code: #{status_code}\nHeaders: #{headers}"
+      end
+      return data, status_code, headers
+    end
+
     # Add document page number stamps.
     # 
     # @param name The document name.
@@ -15937,6 +16017,86 @@ module AsposePdfCloud
       return data, status_code, headers
     end
 
+    # Add document pages text stamps.
+    # 
+    # @param name The document name.
+    # @param stamps The array of stamp.
+    # @param [Hash] opts the optional parameters
+    # @option opts [String] :storage The document storage.
+    # @option opts [String] :folder The document folder.
+    # @option opts [String] :password Base64 encoded password.
+    # @return [AsposeResponse]
+    def post_document_text_stamps(name, stamps, opts = {})
+      @api_client.request_token_if_needed
+      data, _status_code, _headers = post_document_text_stamps_with_http_info(name, stamps, opts)
+      rescue ApiError => error
+        if error.code == 401
+          @api_client.request_token_if_needed
+          data, _status_code, _headers = post_document_text_stamps_with_http_info(name, stamps, opts)
+        else
+          raise
+        end
+      return data
+    end
+
+    # Add document pages text stamps.
+    # 
+    # @param name The document name.
+    # @param stamps The array of stamp.
+    # @param [Hash] opts the optional parameters
+    # @option opts [String] :storage The document storage.
+    # @option opts [String] :folder The document folder.
+    # @option opts [String] :password Base64 encoded password.
+    # @return [Array<(AsposeResponse, Fixnum, Hash)>] AsposeResponse data, response status code and response headers
+    def post_document_text_stamps_with_http_info(name, stamps, opts = {})
+      if @api_client.config.debugging
+        @api_client.config.logger.debug "Calling API: PdfApi.post_document_text_stamps ..."
+      end
+      # verify the required parameter 'name' is set
+      if @api_client.config.client_side_validation && name.nil?
+        fail ArgumentError, "Missing the required parameter 'name' when calling PdfApi.post_document_text_stamps"
+      end
+      # verify the required parameter 'stamps' is set
+      if @api_client.config.client_side_validation && stamps.nil?
+        fail ArgumentError, "Missing the required parameter 'stamps' when calling PdfApi.post_document_text_stamps"
+      end
+      # resource path
+      local_var_path = "/pdf/{name}/stamps/text".sub('{' + 'name' + '}', name.to_s)
+
+      # query parameters
+      query_params = {}
+      query_params[:'storage'] = opts[:'storage'] if !opts[:'storage'].nil?
+      query_params[:'folder'] = opts[:'folder'] if !opts[:'folder'].nil?
+      query_params[:'password'] = opts[:'password'] if !opts[:'password'].nil?
+
+      # header parameters
+      header_params = {}
+      # HTTP header 'Accept' (if needed)
+      header_params['Accept'] = @api_client.select_header_accept(['application/json'])
+      # HTTP header 'Content-Type'
+      header_params['Content-Type'] = @api_client.select_header_content_type(['application/json'])
+
+      # form parameters
+      form_params = {}
+      # Fix header in file
+      post_body = nil
+
+      # http body (model)
+      post_body = @api_client.object_to_http_body(stamps)
+      auth_names = ['JWT']
+      data, status_code, headers = @api_client.call_api(:POST, local_var_path,
+        :header_params => header_params,
+        :query_params => query_params,
+        :form_params => form_params,
+        :body => post_body,
+        :auth_names => auth_names,
+        :return_type => 'AsposeResponse')
+      if @api_client.config.debugging
+        @api_client.config.logger.debug "API called: PdfApi#post_document_text_stamps\nData: #{data.inspect}\nStatus code: #{status_code}\nHeaders: #{headers}"
+      end
+      return data, status_code, headers
+    end
+
     # Encrypt document in storage.
     # 
     # @param name Document name.

data/lib/aspose_pdf_cloud/api_client.rb

@@ -464,8 +464,16 @@ module AsposePdfCloud
       end
 
       response = conn.post tokenUrl, form_params, req_opts[:body]
-      data = JSON.parse("[#{response.body}]", :symbolize_names => true)[0]
+      
+      begin
+        data = JSON.parse("[#{response.body}]", :symbolize_names => true)[0]
+      rescue Exception => exception
+        raise ApiError.new(response.body)
+      end
 
+      if data.nil? || data[:access_token].nil? || data[:access_token] == ""
+        raise("empty token (#{response.body})")
+      end
       @config.access_token = data[:access_token]
     end
 

data/lib/aspose_pdf_cloud/models/optimize_options.rb

@@ -28,7 +28,7 @@ module AsposePdfCloud
     # Specifies document password (if any) encoded with base-64.
     attr_accessor :password
 
-    # If true page contents will be reused when document is optimized for equal pages.
+    # If true page contents will be reused when document is optimized for equal pages. LinkDuplcateStreams option must be set to true.
     attr_accessor :allow_reuse_page_content
 
     # If this flag is set to true images will be compressed in the document. Compression level is specified with ImageQuality property.
@@ -46,7 +46,7 @@ module AsposePdfCloud
     # If this flag set to true, every resource is checked on it's usage. If resource is never used, then resources is removed. This may decrease document size for example when pages were extracted from document. 
     attr_accessor :remove_unused_streams
 
-    # Make fonts not embedded if set to true. 
+    # Make fonts not embedded if set to true. Unembedding a font means removing the embedded byte stream data of the font included in a PDF document.
     attr_accessor :unembed_fonts
 
     # If this flag set to true and CompressImages is true images will be resized if image resolution is greater then specified MaxResolution parameter.
@@ -55,7 +55,7 @@ module AsposePdfCloud
     # Specifies maximum resolution of images. If image has higher resolution it will be scaled.
     attr_accessor :max_resolution
 
-    # Fonts will be converted into subsets if set to true.
+    # Fonts will be converted into subsets if set to true. Only those characters that are actually used in the layout are stored in the PDF. 
     attr_accessor :subset_fonts
 
     # Remove private information (page piece info).

data/lib/aspose_pdf_cloud/version.rb

@@ -20,5 +20,5 @@ SOFTWARE.
 =end
 
 module AsposePdfCloud
-  VERSION = "24.7.0"
+  VERSION = "24.8.0"
 end

data/test/pdf_tests.rb

@@ -4702,6 +4702,39 @@ class PdfTests < Minitest::Test
     assert(response, 'Failed to add Text Stamp into page.')
   end
 
+  def test_post_document_text_stamps
+    file_name = 'PageNumberStamp.pdf'
+    upload_file(file_name)
+
+    opts = {
+        :folder => @temp_folder
+    }
+
+    text_state = TextState.new
+    text_state.font_size = 14
+
+    stamp = TextStamp.new
+    stamp.background = true
+    stamp.left_margin = 1
+    stamp.right_margin = 2
+    stamp.top_margin = 3
+    stamp.bottom_margin = 4
+    stamp.horizontal_alignment = HorizontalAlignment::CENTER
+    stamp.vertical_alignment = VerticalAlignment::CENTER
+    stamp.opacity = 1
+    stamp.rotate = Rotation::NONE
+    stamp.rotate_angle = 0
+    stamp.x_indent = 0
+    stamp.y_indent = 0
+    stamp.zoom = 1
+    stamp.text_alignment = HorizontalAlignment::CENTER
+    stamp.value = 'Text Stamp'
+    stamp.text_state = text_state
+
+    response = @pdf_api.post_document_text_stamps(file_name, [stamp], opts)
+    assert(response, 'Failed to add Text Stamp into document.')
+  end
+
   def test_post_page_image_stamps
     file_name = 'PageNumberStamp.pdf'
     upload_file(file_name)
@@ -4735,6 +4768,37 @@ class PdfTests < Minitest::Test
     assert(response, 'Failed to add Image Stamp into page.')
   end
 
+  def test_post_document_image_stamps
+    file_name = 'PageNumberStamp.pdf'
+    upload_file(file_name)
+
+    image_name = 'Koala.jpg'
+    upload_file(image_name)
+
+    opts = {
+        :folder => @temp_folder
+    }
+
+    stamp = ImageStamp.new
+    stamp.background = true
+    stamp.left_margin = 1
+    stamp.right_margin = 2
+    stamp.top_margin = 3
+    stamp.bottom_margin = 4
+    stamp.horizontal_alignment = HorizontalAlignment::CENTER
+    stamp.vertical_alignment = VerticalAlignment::CENTER
+    stamp.opacity = 1
+    stamp.rotate = Rotation::NONE
+    stamp.rotate_angle = 0
+    stamp.x_indent = 0
+    stamp.y_indent = 0
+    stamp.zoom = 1
+    stamp.file_name = @temp_folder + '/' + image_name
+
+    response = @pdf_api.post_document_image_stamps(file_name, [stamp], opts)
+    assert(response, 'Failed to add Image Stamp into document.')
+  end
+
   def test_post_page_pdf_page_stamps
     file_name = 'PageNumberStamp.pdf'
     upload_file(file_name)

metadata

@@ -1,14 +1,14 @@
 --- !ruby/object:Gem::Specification
 name: aspose_pdf_cloud
 version: !ruby/object:Gem::Version
-  version: 24.7.0
+  version: 24.8.0
 platform: ruby
 authors:
 - Aspose PDF Cloud
 autorequire:
 bindir: bin
 cert_chain: []
-date: 2024-07-23 00:00:00.000000000 Z
+date: 2024-08-23 00:00:00.000000000 Z
 dependencies:
 - !ruby/object:Gem::Dependency
   name: json