pdfcrowd 4.1 → 4.2

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA1:
-  metadata.gz: b63aefeb456c70b1fa6af7a8677bd1a6fcda18b8
-  data.tar.gz: df49260b940ac7d7783a07cffa279d5c5fa01edc
+  metadata.gz: 42b14b50a94ab797b1bb2b9af2bbdb99cfb8ce23
+  data.tar.gz: 2adfda4bf7c64fd699288bd6b368d2c6c945928b
 SHA512:
-  metadata.gz: 476693c1c3ebe0dbd666868fe6afde5b8618066d9f7a2a9bfc1432a9030e6ecc58e4864636e2808386ce2c4e34264c231e516f84ce01e15d9957d46439e56184
-  data.tar.gz: 15b43c707e9739d74ef94c85710c26ed68e16f5796598107ad0dc702759809ef2051ad068d74214700047f83f362afd66d928f50d503ac14c8faae1175acd8a3
+  metadata.gz: b01a6c9fde5792d101adbf607860600a3d16f352236ae8fd0a9e24b2f62bc46499fb795cb6aa2899ddce025304836b2650823574bf378a0b74e9b33c0fce7134
+  data.tar.gz: f9464ce75e1135fa08ff9608377730540eee23e7f753a1aa48591d2a0ebe5cd0e3a70eac4e31854b79795092e80241df012009f30057f884f1e6532ef84c3885

data/lib/pdfcrowd.rb

@@ -295,7 +295,7 @@ module Pdfcrowd
     end
 
     def setWatermark(url, offset_x=0, offset_y=0)
-        @fields["watermark_url"] = value
+        @fields["watermark_url"] = url
         @fields["watermark_offset_x"] = offset_x
         @fields["watermark_offset_y"] = offset_y
     end
@@ -529,7 +529,7 @@ end
 module Pdfcrowd
     HOST = ENV["PDFCROWD_HOST"] || 'api.pdfcrowd.com'
     MULTIPART_BOUNDARY = '----------ThIs_Is_tHe_bOUnDary_$'
-    CLIENT_VERSION = '4.1'
+    CLIENT_VERSION = '4.2'
 
     def self.float_to_string(value)
         value.to_s.sub(',', '.')
@@ -544,7 +544,7 @@ module Pdfcrowd
 
             setProxy(nil, nil, nil, nil)
             setUseHttp(false)
-            setUserAgent('pdfcrowd_ruby_client/4.1 (http://pdfcrowd.com)')
+            setUserAgent('pdfcrowd_ruby_client/4.2 (http://pdfcrowd.com)')
 
             @retry_count = 1
         end
@@ -912,13 +912,13 @@ module Pdfcrowd
             self
         end
 
-        # Set the output page height.
+        # Set the output page height. Use -1 for a single page PDF.
         # 
-        # * +page_height+ - Can be specified in inches (in), millimeters (mm), centimeters (cm), or points (pt).
+        # * +page_height+ - Can be -1 or specified in inches (in), millimeters (mm), centimeters (cm), or points (pt).
         # * *Returns* - The converter object.
         def setPageHeight(page_height)
-            unless /(?i)^[0-9]*(\.[0-9]+)?(pt|px|mm|cm|in)$/.match(page_height)
-                raise Error.new(Pdfcrowd.create_invalid_value_message(page_height, "page_height", "html-to-pdf", "Can be specified in inches (in), millimeters (mm), centimeters (cm), or points (pt).", "set_page_height"), 470);
+            unless /(?i)^\-1$|^[0-9]*(\.[0-9]+)?(pt|px|mm|cm|in)$/.match(page_height)
+                raise Error.new(Pdfcrowd.create_invalid_value_message(page_height, "page_height", "html-to-pdf", "Can be -1 or specified in inches (in), millimeters (mm), centimeters (cm), or points (pt).", "set_page_height"), 470);
             end
             
             @fields['page_height'] = page_height
@@ -928,7 +928,7 @@ module Pdfcrowd
         # Set the output page dimensions.
         # 
         # * +width+ - Set the output page width. Can be specified in inches (in), millimeters (mm), centimeters (cm), or points (pt).
-        # * +height+ - Set the output page height. Can be specified in inches (in), millimeters (mm), centimeters (cm), or points (pt).
+        # * +height+ - Set the output page height. Use -1 for a single page PDF. Can be -1 or specified in inches (in), millimeters (mm), centimeters (cm), or points (pt).
         # * *Returns* - The converter object.
         def setPageDimensions(width, height)
             setPageWidth(width)
@@ -1634,7 +1634,7 @@ module Pdfcrowd
             self
         end
 
-        # Specifies number of retries after HTTP status code 502 was received. The status 502 occurs seldom due to network problems. This feature can be disabled by setting to 0.
+        # Specifies the number of retries when the 502 HTTP status code is received. The 502 status code indicates a temporary network issue. This feature can be disabled by setting to 0.
         # 
         # * +retry_count+ - Number of retries wanted.
         # * *Returns* - The converter object.
@@ -2115,7 +2115,7 @@ module Pdfcrowd
             self
         end
 
-        # Specifies number of retries after HTTP status code 502 was received. The status 502 occurs seldom due to network problems. This feature can be disabled by setting to 0.
+        # Specifies the number of retries when the 502 HTTP status code is received. The 502 status code indicates a temporary network issue. This feature can be disabled by setting to 0.
         # 
         # * +retry_count+ - Number of retries wanted.
         # * *Returns* - The converter object.
@@ -2357,7 +2357,7 @@ module Pdfcrowd
             self
         end
 
-        # Specifies number of retries after HTTP status code 502 was received. The status 502 occurs seldom due to network problems. This feature can be disabled by setting to 0.
+        # Specifies the number of retries when the 502 HTTP status code is received. The 502 status code indicates a temporary network issue. This feature can be disabled by setting to 0.
         # 
         # * +retry_count+ - Number of retries wanted.
         # * *Returns* - The converter object.
@@ -2400,27 +2400,27 @@ module Pdfcrowd
 
         # Perform an action on the input files.
         # * *Returns* - Byte array containing the output PDF.
-        def convertFiles()
+        def convert()
             @helper.post(@fields, @files, @raw_data)
         end
 
         # Perform an action on the input files and write the output PDF to an output stream.
         # 
         # * +out_stream+ - The output stream that will contain the output PDF.
-        def convertFilesToStream(out_stream)
+        def convertToStream(out_stream)
             @helper.post(@fields, @files, @raw_data, out_stream)
         end
 
         # Perform an action on the input files and write the output PDF to a file.
         # 
         # * +file_path+ - The output file path. The string must not be empty.
-        def convertFilesToFile(file_path)
+        def convertToFile(file_path)
             if (!(!file_path.nil? && !file_path.empty?))
-                raise Error.new(Pdfcrowd.create_invalid_value_message(file_path, "file_path", "pdf-to-pdf", "The string must not be empty.", "convert_files_to_file"), 470);
+                raise Error.new(Pdfcrowd.create_invalid_value_message(file_path, "file_path", "pdf-to-pdf", "The string must not be empty.", "convert_to_file"), 470);
             end
             
             output_file = open(file_path, "wb")
-            convertFilesToStream(output_file)
+            convertToStream(output_file)
             output_file.close()
         end
 
@@ -2438,7 +2438,7 @@ module Pdfcrowd
             self
         end
 
-        # Add in-memory raw PDF data to the list of the input PDFs.
+        # Add in-memory raw PDF data to the list of the input PDFs.Typical usage is for adding PDF created by another Pdfcrowd converter. Example in PHP: $clientPdf2Pdf->addPdfRawData($clientHtml2Pdf->convertUrl('http://www.example.com'));
         # 
         # * +pdf_raw_data+ - The raw PDF data. The input data must be PDF content.
         # * *Returns* - The converter object.
@@ -2529,7 +2529,7 @@ module Pdfcrowd
             self
         end
 
-        # Specifies number of retries after HTTP status code 502 was received. The status 502 occurs seldom due to network problems. This feature can be disabled by setting to 0.
+        # Specifies the number of retries when the 502 HTTP status code is received. The 502 status code indicates a temporary network issue. This feature can be disabled by setting to 0.
         # 
         # * +retry_count+ - Number of retries wanted.
         # * *Returns* - The converter object.
@@ -2758,7 +2758,7 @@ module Pdfcrowd
             self
         end
 
-        # Specifies number of retries after HTTP status code 502 was received. The status 502 occurs seldom due to network problems. This feature can be disabled by setting to 0.
+        # Specifies the number of retries when the 502 HTTP status code is received. The 502 status code indicates a temporary network issue. This feature can be disabled by setting to 0.
         # 
         # * +retry_count+ - Number of retries wanted.
         # * *Returns* - The converter object.

metadata

@@ -1,14 +1,14 @@
 --- !ruby/object:Gem::Specification
 name: pdfcrowd
 version: !ruby/object:Gem::Version
-  version: '4.1'
+  version: '4.2'
 platform: ruby
 authors:
 - Pdfcrowd Team
 autorequire: 
 bindir: bin
 cert_chain: []
-date: 2017-11-22 00:00:00.000000000 Z
+date: 2017-12-18 00:00:00.000000000 Z
 dependencies: []
 description: The Pdfcrowd API lets you easily convert between HTML, PDF and various
   image formats.