pdfcrowd 6.1.0 → 6.2.1

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA256:
-  metadata.gz: cdfb803513e340c4d125a04c7af3c2bb2aa9d7ada652a9636c965eacf964d4cc
-  data.tar.gz: 3f66c527fc9db82d72e2576a240b1a435ee7a72edb60d31f4fc4c012d2457617
+  metadata.gz: f97c72508c22bb03da1413d7868420657d6e93fe0447913d93b71c1dc9bfa1fb
+  data.tar.gz: 3956525e9d2c6ee9c490684fcda82e933e98fca0bbc5d4176df112ef03c8cf1d
 SHA512:
-  metadata.gz: 9fa86e54a212cfb73b338ec55b30411c054cf58827fa619dab8b7aca68e3e7e1fb6e8bb0d451919c8d6f3020223d7d2333fdba8d7442de16fd040ee3227bae25
-  data.tar.gz: a96652ca6a25ce06aba4fad0f9643a5ce12b5825aa7af87618d5d9e0b9436436a3d7ce012d4516671164bc4bf12dd7cebf60e28c4b33cad16a4a2ca4215872e5
+  metadata.gz: f56fbea6b28e21d0f74bde3cb9e33e04cabbb20f38ee4e3a54f46c722f8dba14ed35be040f0c464b7c0649bbac33b896f7d9d4d136d8f45986c821beab727fde
+  data.tar.gz: 3a50f9412ad1f5236c0ab3d335c50aad84a9f41bf76aef3b9e381c35fd0fb57aac85d62dee9f1056ad2b19f30838d883029e63d69722a57919ecffde75860c22

data/lib/pdfcrowd.rb

@@ -530,7 +530,7 @@ end
 module Pdfcrowd
     HOST = ENV["PDFCROWD_HOST"] || 'api.pdfcrowd.com'
     MULTIPART_BOUNDARY = '----------ThIs_Is_tHe_bOUnDary_$'
-    CLIENT_VERSION = '6.1.0'
+    CLIENT_VERSION = '6.2.1'
 
     class ConnectionHelper
         def initialize(user_name, api_key)
@@ -541,7 +541,7 @@ module Pdfcrowd
 
             setProxy(nil, nil, nil, nil)
             setUseHttp(false)
-            setUserAgent('pdfcrowd_ruby_client/6.1.0 (https://pdfcrowd.com)')
+            setUserAgent('pdfcrowd_ruby_client/6.2.1 (https://pdfcrowd.com)')
 
             @retry_count = 1
             @converter_version = '24.04'
@@ -1085,11 +1085,11 @@ module Pdfcrowd
 
         # Set the page range to print.
         #
-        # * +pages+ - A comma separated list of page numbers or ranges.
+        # * +pages+ - A comma separated list of page numbers or ranges. Special strings may be used, such as `odd`, `even` and `last`.
         # * *Returns* - The converter object.
         def setPrintPageRange(pages)
-            unless /^(?:\s*(?:\d+|(?:\d*\s*\-\s*\d+)|(?:\d+\s*\-\s*\d*))\s*,\s*)*\s*(?:\d+|(?:\d*\s*\-\s*\d+)|(?:\d+\s*\-\s*\d*))\s*$/.match(pages)
-                raise Error.new(Pdfcrowd.create_invalid_value_message(pages, "setPrintPageRange", "html-to-pdf", "A comma separated list of page numbers or ranges.", "set_print_page_range"), 470);
+            unless /^(?:\s*(?:\d+|(?:\d*\s*\-\s*\d+)|(?:\d+\s*\-\s*\d*)|odd|even|last)\s*,\s*)*\s*(?:\d+|(?:\d*\s*\-\s*\d+)|(?:\d+\s*\-\s*\d*)|odd|even|last)\s*$/.match(pages)
+                raise Error.new(Pdfcrowd.create_invalid_value_message(pages, "setPrintPageRange", "html-to-pdf", "A comma separated list of page numbers or ranges. Special strings may be used, such as `odd`, `even` and `last`.", "set_print_page_range"), 470);
             end
             
             @fields['print_page_range'] = pages
@@ -1098,11 +1098,11 @@ module Pdfcrowd
 
         # Set the viewport width for formatting the HTML content when generating a PDF. By specifying a viewport width, you can control how the content is rendered, ensuring it mimics the appearance on various devices or matches specific design requirements.
         #
-        # * +width+ - The width of the viewport. The value must be "balanced", "small", "medium", "large", "extra-large", or a number in the range 96-65000.
+        # * +width+ - The width of the viewport. The value must be "balanced", "small", "medium", "large", "extra-large", or a number in the range 96-65000px.
         # * *Returns* - The converter object.
         def setContentViewportWidth(width)
-            unless /(?i)^(balanced|small|medium|large|extra-large|[0-9]+)$/.match(width)
-                raise Error.new(Pdfcrowd.create_invalid_value_message(width, "setContentViewportWidth", "html-to-pdf", "The value must be \"balanced\", \"small\", \"medium\", \"large\", \"extra-large\", or a number in the range 96-65000.", "set_content_viewport_width"), 470);
+            unless /(?i)^(balanced|small|medium|large|extra-large|[0-9]+(px)?)$/.match(width)
+                raise Error.new(Pdfcrowd.create_invalid_value_message(width, "setContentViewportWidth", "html-to-pdf", "The value must be \"balanced\", \"small\", \"medium\", \"large\", \"extra-large\", or a number in the range 96-65000px.", "set_content_viewport_width"), 470);
             end
             
             @fields['content_viewport_width'] = width
@@ -1114,7 +1114,7 @@ module Pdfcrowd
         # * +height+ - The viewport height. The value must be "auto", "large", or a number.
         # * *Returns* - The converter object.
         def setContentViewportHeight(height)
-            unless /(?i)^(auto|large|[0-9]+)$/.match(height)
+            unless /(?i)^(auto|large|[0-9]+(px)?)$/.match(height)
                 raise Error.new(Pdfcrowd.create_invalid_value_message(height, "setContentViewportHeight", "html-to-pdf", "The value must be \"auto\", \"large\", or a number.", "set_content_viewport_height"), 470);
             end
             
@@ -1253,7 +1253,7 @@ module Pdfcrowd
             self
         end
 
-        # The page header is not printed on the specified pages.
+        # The page header content is not printed on the specified pages. To remove the entire header area, use the conversion config.
         #
         # * +pages+ - List of physical page numbers. Negative numbers count backwards from the last page: -1 is the last page, -2 is the last but one page, and so on. A comma separated list of page numbers.
         # * *Returns* - The converter object.
@@ -1266,7 +1266,7 @@ module Pdfcrowd
             self
         end
 
-        # The page footer is not printed on the specified pages.
+        # The page footer content is not printed on the specified pages. To remove the entire footer area, use the conversion config.
         #
         # * +pages+ - List of physical page numbers. Negative numbers count backwards from the last page: -1 is the last page, -2 is the last but one page, and so on. A comma separated list of page numbers.
         # * *Returns* - The converter object.
@@ -2426,7 +2426,7 @@ module Pdfcrowd
             self
         end
 
-        # Allows to configure conversion via JSON. The configuration defines various page settings for individual PDF pages or ranges of pages. It provides flexibility in designing each page of the PDF, giving control over each page's size, header, footer etc. If a page or parameter is not explicitly specified, the system will use the default settings for that page or attribute. If a JSON configuration is provided, the settings in the JSON will take precedence over the global options. The structure of the JSON must be: pageSetup: An array of objects where each object defines the configuration for a specific page or range of pages. The following properties can be set for each page object: pages: A comma-separated list of page numbers or ranges. For example: 1-: from page 1 to the end of the document 2: only the 2nd page 2, 4, 6: pages 2, 4, and 6 2-5: pages 2 through 5 pageSize: The page size (optional). Possible values: A0, A1, A2, A3, A4, A5, A6, Letter. pageWidth: The width of the page (optional). pageHeight: The height of the page (optional). marginLeft: Left margin (optional). marginRight: Right margin (optional). marginTop: Top margin (optional). marginBottom: Bottom margin (optional). displayHeader: Header appearance (optional). Possible values: none: completely excluded space: only the content is excluded, the space is used content: the content is printed (default) displayFooter: Footer appearance (optional). Possible values: none: completely excluded space: only the content is excluded, the space is used content: the content is printed (default) headerHeight: Height of the header (optional). footerHeight: Height of the footer (optional). orientation: Page orientation, such as "portrait" or "landscape" (optional). Dimensions may be empty, 0 or specified in inches "in", millimeters "mm", centimeters "cm", pixels "px", or points "pt".
+        # Allows to configure conversion via JSON. The configuration defines various page settings for individual PDF pages or ranges of pages. It provides flexibility in designing each page of the PDF, giving control over each page's size, header, footer etc. If a page or parameter is not explicitly specified, the system will use the default settings for that page or attribute. If a JSON configuration is provided, the settings in the JSON will take precedence over the global options. The structure of the JSON must be: pageSetup: An array of objects where each object defines the configuration for a specific page or range of pages. The following properties can be set for each page object: pages: A comma-separated list of page numbers or ranges. Special strings may be used, such as `odd`, `even` and `last`. For example: 1-: from page 1 to the end of the document 2: only the 2nd page 2,4,6: pages 2, 4, and 6 2-5: pages 2 through 5 odd,2: the 2nd page and all odd pages pageSize: The page size (optional). Possible values: A0, A1, A2, A3, A4, A5, A6, Letter. pageWidth: The width of the page (optional). pageHeight: The height of the page (optional). marginLeft: Left margin (optional). marginRight: Right margin (optional). marginTop: Top margin (optional). marginBottom: Bottom margin (optional). displayHeader: Header appearance (optional). Possible values: none: completely excluded space: only the content is excluded, the space is used content: the content is printed (default) displayFooter: Footer appearance (optional). Possible values: none: completely excluded space: only the content is excluded, the space is used content: the content is printed (default) headerHeight: Height of the header (optional). footerHeight: Height of the footer (optional). orientation: Page orientation, such as "portrait" or "landscape" (optional). Dimensions may be empty, 0 or specified in inches "in", millimeters "mm", centimeters "cm", pixels "px", or points "pt".
         #
         # * +json_string+ - The JSON string.
         # * *Returns* - The converter object.
@@ -5703,6 +5703,19 @@ module Pdfcrowd
             self
         end
 
+        # Sets the processing mode for handling Type 3 fonts.
+        #
+        # * +mode+ - The type3 font mode. Allowed values are raster, convert.
+        # * *Returns* - The converter object.
+        def setType3Mode(mode)
+            unless /(?i)^(raster|convert)$/.match(mode)
+                raise Error.new(Pdfcrowd.create_invalid_value_message(mode, "setType3Mode", "pdf-to-html", "Allowed values are raster, convert.", "set_type3_mode"), 470);
+            end
+            
+            @fields['type3_mode'] = mode
+            self
+        end
+
         # Converts ligatures, two or more letters combined into a single glyph, back into their individual ASCII characters.
         #
         # * +value+ - Set to true to split ligatures.
@@ -5712,6 +5725,19 @@ module Pdfcrowd
             self
         end
 
+        # Apply custom CSS to the output HTML document. It allows you to modify the visual appearance and layout. Tip: Using !important in custom CSS provides a way to prioritize and override conflicting styles.
+        #
+        # * +css+ - A string containing valid CSS. The string must not be empty.
+        # * *Returns* - The converter object.
+        def setCustomCss(css)
+            if (!(!css.nil? && !css.empty?))
+                raise Error.new(Pdfcrowd.create_invalid_value_message(css, "setCustomCss", "pdf-to-html", "The string must not be empty.", "set_custom_css"), 470);
+            end
+            
+            @fields['custom_css'] = css
+            self
+        end
+
         # A helper method to determine if the output file is a zip archive. The output of the conversion may be either an HTML file or a zip file containing the HTML and its external assets.
         # * *Returns* - True if the conversion output is a zip file, otherwise False.
         def isZippedOutput()

metadata

@@ -1,14 +1,14 @@
 --- !ruby/object:Gem::Specification
 name: pdfcrowd
 version: !ruby/object:Gem::Version
-  version: 6.1.0
+  version: 6.2.1
 platform: ruby
 authors:
 - Pdfcrowd Team
 autorequire: 
 bindir: bin
 cert_chain: []
-date: 2024-09-10 00:00:00.000000000 Z
+date: 2024-10-10 00:00:00.000000000 Z
 dependencies: []
 description: The Pdfcrowd API lets you easily convert between HTML, PDF and various
   image formats.