pdfcrowd 6.3.0 → 6.5.0

data/lib/pdfcrowd.rb

@@ -44,24 +44,52 @@ module Pdfcrowd
   # Thrown when an error occurs.
   #
   class Error < RuntimeError
-    attr_reader :http_code, :error
+    attr_reader :http_code, :error, :message, :doc_link, :reason_code
 
     def initialize(error, http_code=nil)
       super()
-      @http_code = http_code
       @error = error
+      error_match = @error.match(/^(\d+)\.(\d+)\s+-\s+(.*?)(?:\s+Documentation link:\s+(.*))?$/) ||
+                    @error.scan(/^(\d+)\.(\d+)\s+-\s+(.*?)(?:\s+Documentation link:\s+(.*))?$/m)
+      if error_match and error_match != []
+          @http_code = error_match[1]
+          @reason_code = error_match[2]
+          @message = error_match[3]
+          @doc_link = error_match[4] || ''
+      else
+          @http_code = http_code
+          @reason_code = -1
+          @message = @error
+          if @http_code
+              @error = "#{@http_code} - #{@error}"
+          end
+          @doc_link = ''
+      end
     end
 
     def to_s()
-      @http_code ?  "#{@http_code} - #{@error}" : @error
+        @error
     end
 
     def getCode()
+        warn "[DEPRECATION] `getCode` is obsolete and will be removed in future versions. Use `getStatusCode` instead."
         @http_code
     end
 
+    def getStatusCode()
+        @http_code
+    end
+
+    def getReasonCode()
+        @reason_code
+    end
+
     def getMessage()
-        @error
+        @message
+    end
+
+    def getDocumentationLink()
+        @doc_link
     end
   end
 
@@ -530,7 +558,7 @@ end
 module Pdfcrowd
     HOST = ENV["PDFCROWD_HOST"] || 'api.pdfcrowd.com'
     MULTIPART_BOUNDARY = '----------ThIs_Is_tHe_bOUnDary_$'
-    CLIENT_VERSION = '6.3.0'
+    CLIENT_VERSION = '6.5.0'
 
     class ConnectionHelper
         def initialize(user_name, api_key)
@@ -541,7 +569,7 @@ module Pdfcrowd
 
             setProxy(nil, nil, nil, nil)
             setUseHttp(false)
-            setUserAgent('pdfcrowd_ruby_client/6.3.0 (https://pdfcrowd.com)')
+            setUserAgent('pdfcrowd_ruby_client/6.5.0 (https://pdfcrowd.com)')
 
             @retry_count = 1
             @converter_version = '24.04'
@@ -681,7 +709,7 @@ module Pdfcrowd
                 begin
                     return exec_request(request, out_stream)
                 rescue Error => err
-                    if (err.getCode() == '502' or err.getCode() == '503') and @retry_count > @retry
+                    if (err.getStatusCode() == '502' or err.getStatusCode() == '503') and @retry_count > @retry
                         @retry += 1
                         sleep(@retry * 0.1)
                     else
@@ -726,18 +754,18 @@ module Pdfcrowd
                 rescue Timeout::Error => why
                     raise Error.new("Operation timed out\n")
                 rescue OpenSSL::SSL::SSLError => why
-                    raise Error.new("There was a problem connecting to Pdfcrowd servers over HTTPS:\n#{why}" +
-                                    "\nYou can still use the API over HTTP, you just need to add the following line right after Pdfcrowd client initialization:\nself.setUseHttp(true)",
-                                    481)
+                    raise Error.new("400.356 - There was a problem connecting to PDFCrowd servers over HTTPS:\n#{why}" +
+                                    "\nYou can still use the API over HTTP, you just need to add the following line right after PDFCrowd client initialization:\nself.setUseHttp(true)",
+                                    0)
                 end
             end
         end
     end
 
     def self.create_invalid_value_message(value, field, converter, hint, id)
-        message = "Invalid value '%s' for %s." % [value, field]
+        message = "400.311 - Invalid value '%s' for the '%s' option." % [value, field]
         message += " " + hint if hint
-        return message + " " + "Details: https://www.pdfcrowd.com/api/%s-ruby/ref/#%s" % [converter, id]
+        return message + " " + "Documentation link: https://www.pdfcrowd.com/api/%s-ruby/ref/#%s" % [converter, id]
     end
 
 # generated code
@@ -761,11 +789,11 @@ module Pdfcrowd
 
         # Convert a web page.
         #
-        # * +url+ - The address of the web page to convert. The supported protocols are http:// and https://.
+        # * +url+ - The address of the web page to convert. Supported protocols are http:// and https://.
         # * *Returns* - Byte array containing the conversion output.
         def convertUrl(url)
             unless /(?i)^https?:\/\/.*$/.match(url)
-                raise Error.new(Pdfcrowd.create_invalid_value_message(url, "convertUrl", "html-to-pdf", "The supported protocols are http:// and https://.", "convert_url"), 470);
+                raise Error.new(Pdfcrowd.create_invalid_value_message(url, "convertUrl", "html-to-pdf", "Supported protocols are http:// and https://.", "convert_url"), 470);
             end
             
             @fields['url'] = url
@@ -774,11 +802,11 @@ module Pdfcrowd
 
         # Convert a web page and write the result to an output stream.
         #
-        # * +url+ - The address of the web page to convert. The supported protocols are http:// and https://.
+        # * +url+ - The address of the web page to convert. Supported protocols are http:// and https://.
         # * +out_stream+ - The output stream that will contain the conversion output.
         def convertUrlToStream(url, out_stream)
             unless /(?i)^https?:\/\/.*$/.match(url)
-                raise Error.new(Pdfcrowd.create_invalid_value_message(url, "convertUrlToStream::url", "html-to-pdf", "The supported protocols are http:// and https://.", "convert_url_to_stream"), 470);
+                raise Error.new(Pdfcrowd.create_invalid_value_message(url, "convertUrlToStream::url", "html-to-pdf", "Supported protocols are http:// and https://.", "convert_url_to_stream"), 470);
             end
             
             @fields['url'] = url
@@ -787,7 +815,7 @@ module Pdfcrowd
 
         # Convert a web page and write the result to a local file.
         #
-        # * +url+ - The address of the web page to convert. The supported protocols are http:// and https://.
+        # * +url+ - The address of the web page to convert. Supported protocols are http:// and https://.
         # * +file_path+ - The output file path. The string must not be empty.
         def convertUrlToFile(url, file_path)
             if (!(!file_path.nil? && !file_path.empty?))
@@ -959,11 +987,11 @@ module Pdfcrowd
 
         # Set the output page width. The safe maximum is 200in otherwise some PDF viewers may be unable to open the PDF.
         #
-        # * +width+ - The value must be specified in inches "in", millimeters "mm", centimeters "cm", pixels "px", or points "pt".
+        # * +width+ - The value must be specified in inches 'in', millimeters 'mm', centimeters 'cm', pixels 'px', or points 'pt'.
         # * *Returns* - The converter object.
         def setPageWidth(width)
             unless /(?i)^0$|^[0-9]*\.?[0-9]+(pt|px|mm|cm|in)$/.match(width)
-                raise Error.new(Pdfcrowd.create_invalid_value_message(width, "setPageWidth", "html-to-pdf", "The value must be specified in inches \"in\", millimeters \"mm\", centimeters \"cm\", pixels \"px\", or points \"pt\".", "set_page_width"), 470);
+                raise Error.new(Pdfcrowd.create_invalid_value_message(width, "setPageWidth", "html-to-pdf", "The value must be specified in inches 'in', millimeters 'mm', centimeters 'cm', pixels 'px', or points 'pt'.", "set_page_width"), 470);
             end
             
             @fields['page_width'] = width
@@ -972,11 +1000,11 @@ module Pdfcrowd
 
         # Set the output page height. Use -1 for a single page PDF. The safe maximum is 200in otherwise some PDF viewers may be unable to open the PDF.
         #
-        # * +height+ - The value must be -1 or specified in inches "in", millimeters "mm", centimeters "cm", pixels "px", or points "pt".
+        # * +height+ - The value must be -1 or specified in inches 'in', millimeters 'mm', centimeters 'cm', pixels 'px', or points 'pt'.
         # * *Returns* - The converter object.
         def setPageHeight(height)
             unless /(?i)^0$|^\-1$|^[0-9]*\.?[0-9]+(pt|px|mm|cm|in)$/.match(height)
-                raise Error.new(Pdfcrowd.create_invalid_value_message(height, "setPageHeight", "html-to-pdf", "The value must be -1 or specified in inches \"in\", millimeters \"mm\", centimeters \"cm\", pixels \"px\", or points \"pt\".", "set_page_height"), 470);
+                raise Error.new(Pdfcrowd.create_invalid_value_message(height, "setPageHeight", "html-to-pdf", "The value must be -1 or specified in inches 'in', millimeters 'mm', centimeters 'cm', pixels 'px', or points 'pt'.", "set_page_height"), 470);
             end
             
             @fields['page_height'] = height
@@ -985,8 +1013,8 @@ module Pdfcrowd
 
         # Set the output page dimensions.
         #
-        # * +width+ - Set the output page width. The safe maximum is 200in otherwise some PDF viewers may be unable to open the PDF. The value must be specified in inches "in", millimeters "mm", centimeters "cm", pixels "px", or points "pt".
-        # * +height+ - Set the output page height. Use -1 for a single page PDF. The safe maximum is 200in otherwise some PDF viewers may be unable to open the PDF. The value must be -1 or specified in inches "in", millimeters "mm", centimeters "cm", pixels "px", or points "pt".
+        # * +width+ - Set the output page width. The safe maximum is 200in otherwise some PDF viewers may be unable to open the PDF. The value must be specified in inches 'in', millimeters 'mm', centimeters 'cm', pixels 'px', or points 'pt'.
+        # * +height+ - Set the output page height. Use -1 for a single page PDF. The safe maximum is 200in otherwise some PDF viewers may be unable to open the PDF. The value must be -1 or specified in inches 'in', millimeters 'mm', centimeters 'cm', pixels 'px', or points 'pt'.
         # * *Returns* - The converter object.
         def setPageDimensions(width, height)
             setPageWidth(width)
@@ -1009,11 +1037,11 @@ module Pdfcrowd
 
         # Set the output page top margin.
         #
-        # * +top+ - The value must be specified in inches "in", millimeters "mm", centimeters "cm", pixels "px", or points "pt".
+        # * +top+ - The value must be specified in inches 'in', millimeters 'mm', centimeters 'cm', pixels 'px', or points 'pt'.
         # * *Returns* - The converter object.
         def setMarginTop(top)
             unless /(?i)^0$|^[0-9]*\.?[0-9]+(pt|px|mm|cm|in)$/.match(top)
-                raise Error.new(Pdfcrowd.create_invalid_value_message(top, "setMarginTop", "html-to-pdf", "The value must be specified in inches \"in\", millimeters \"mm\", centimeters \"cm\", pixels \"px\", or points \"pt\".", "set_margin_top"), 470);
+                raise Error.new(Pdfcrowd.create_invalid_value_message(top, "setMarginTop", "html-to-pdf", "The value must be specified in inches 'in', millimeters 'mm', centimeters 'cm', pixels 'px', or points 'pt'.", "set_margin_top"), 470);
             end
             
             @fields['margin_top'] = top
@@ -1022,11 +1050,11 @@ module Pdfcrowd
 
         # Set the output page right margin.
         #
-        # * +right+ - The value must be specified in inches "in", millimeters "mm", centimeters "cm", pixels "px", or points "pt".
+        # * +right+ - The value must be specified in inches 'in', millimeters 'mm', centimeters 'cm', pixels 'px', or points 'pt'.
         # * *Returns* - The converter object.
         def setMarginRight(right)
             unless /(?i)^0$|^[0-9]*\.?[0-9]+(pt|px|mm|cm|in)$/.match(right)
-                raise Error.new(Pdfcrowd.create_invalid_value_message(right, "setMarginRight", "html-to-pdf", "The value must be specified in inches \"in\", millimeters \"mm\", centimeters \"cm\", pixels \"px\", or points \"pt\".", "set_margin_right"), 470);
+                raise Error.new(Pdfcrowd.create_invalid_value_message(right, "setMarginRight", "html-to-pdf", "The value must be specified in inches 'in', millimeters 'mm', centimeters 'cm', pixels 'px', or points 'pt'.", "set_margin_right"), 470);
             end
             
             @fields['margin_right'] = right
@@ -1035,11 +1063,11 @@ module Pdfcrowd
 
         # Set the output page bottom margin.
         #
-        # * +bottom+ - The value must be specified in inches "in", millimeters "mm", centimeters "cm", pixels "px", or points "pt".
+        # * +bottom+ - The value must be specified in inches 'in', millimeters 'mm', centimeters 'cm', pixels 'px', or points 'pt'.
         # * *Returns* - The converter object.
         def setMarginBottom(bottom)
             unless /(?i)^0$|^[0-9]*\.?[0-9]+(pt|px|mm|cm|in)$/.match(bottom)
-                raise Error.new(Pdfcrowd.create_invalid_value_message(bottom, "setMarginBottom", "html-to-pdf", "The value must be specified in inches \"in\", millimeters \"mm\", centimeters \"cm\", pixels \"px\", or points \"pt\".", "set_margin_bottom"), 470);
+                raise Error.new(Pdfcrowd.create_invalid_value_message(bottom, "setMarginBottom", "html-to-pdf", "The value must be specified in inches 'in', millimeters 'mm', centimeters 'cm', pixels 'px', or points 'pt'.", "set_margin_bottom"), 470);
             end
             
             @fields['margin_bottom'] = bottom
@@ -1048,11 +1076,11 @@ module Pdfcrowd
 
         # Set the output page left margin.
         #
-        # * +left+ - The value must be specified in inches "in", millimeters "mm", centimeters "cm", pixels "px", or points "pt".
+        # * +left+ - The value must be specified in inches 'in', millimeters 'mm', centimeters 'cm', pixels 'px', or points 'pt'.
         # * *Returns* - The converter object.
         def setMarginLeft(left)
             unless /(?i)^0$|^[0-9]*\.?[0-9]+(pt|px|mm|cm|in)$/.match(left)
-                raise Error.new(Pdfcrowd.create_invalid_value_message(left, "setMarginLeft", "html-to-pdf", "The value must be specified in inches \"in\", millimeters \"mm\", centimeters \"cm\", pixels \"px\", or points \"pt\".", "set_margin_left"), 470);
+                raise Error.new(Pdfcrowd.create_invalid_value_message(left, "setMarginLeft", "html-to-pdf", "The value must be specified in inches 'in', millimeters 'mm', centimeters 'cm', pixels 'px', or points 'pt'.", "set_margin_left"), 470);
             end
             
             @fields['margin_left'] = left
@@ -1070,10 +1098,10 @@ module Pdfcrowd
 
         # Set the output page margins.
         #
-        # * +top+ - Set the output page top margin. The value must be specified in inches "in", millimeters "mm", centimeters "cm", pixels "px", or points "pt".
-        # * +right+ - Set the output page right margin. The value must be specified in inches "in", millimeters "mm", centimeters "cm", pixels "px", or points "pt".
-        # * +bottom+ - Set the output page bottom margin. The value must be specified in inches "in", millimeters "mm", centimeters "cm", pixels "px", or points "pt".
-        # * +left+ - Set the output page left margin. The value must be specified in inches "in", millimeters "mm", centimeters "cm", pixels "px", or points "pt".
+        # * +top+ - Set the output page top margin. The value must be specified in inches 'in', millimeters 'mm', centimeters 'cm', pixels 'px', or points 'pt'.
+        # * +right+ - Set the output page right margin. The value must be specified in inches 'in', millimeters 'mm', centimeters 'cm', pixels 'px', or points 'pt'.
+        # * +bottom+ - Set the output page bottom margin. The value must be specified in inches 'in', millimeters 'mm', centimeters 'cm', pixels 'px', or points 'pt'.
+        # * +left+ - Set the output page left margin. The value must be specified in inches 'in', millimeters 'mm', centimeters 'cm', pixels 'px', or points 'pt'.
         # * *Returns* - The converter object.
         def setPageMargins(top, right, bottom, left)
             setMarginTop(top)
@@ -1085,11 +1113,11 @@ module Pdfcrowd
 
         # Set the page range to print.
         #
-        # * +pages+ - A comma separated list of page numbers or ranges. Special strings may be used, such as `odd`, `even` and `last`.
+        # * +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*)|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);
+                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 +1126,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-65000px.
+        # * +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]+(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);
+                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
@@ -1111,11 +1139,11 @@ module Pdfcrowd
 
         # Set the viewport height for formatting the HTML content when generating a PDF. By specifying a viewport height, you can enforce loading of lazy-loaded images and also affect vertical positioning of absolutely positioned elements within the content.
         #
-        # * +height+ - The viewport height. The value must be "auto", "large", or a number.
+        # * +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]+(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);
+                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
             
             @fields['content_viewport_height'] = height
@@ -1150,11 +1178,11 @@ module Pdfcrowd
 
         # Load an HTML code from the specified URL and use it as the page header. The following classes can be used in the HTML. The content of the respective elements will be expanded as follows: pdfcrowd-page-count - the total page count of printed pages pdfcrowd-page-number - the current page number pdfcrowd-source-url - the source URL of the converted document pdfcrowd-source-title - the title of the converted document The following attributes can be used: data-pdfcrowd-number-format - specifies the type of the used numerals. Allowed values: arabic - Arabic numerals, they are used by default roman - Roman numerals eastern-arabic - Eastern Arabic numerals bengali - Bengali numerals devanagari - Devanagari numerals thai - Thai numerals east-asia - Chinese, Vietnamese, Japanese and Korean numerals chinese-formal - Chinese formal numerals Please contact us if you need another type of numerals. Example: <span class='pdfcrowd-page-number' data-pdfcrowd-number-format='roman'></span> data-pdfcrowd-placement - specifies where to place the source URL. Allowed values: The URL is inserted to the content Example: <span class='pdfcrowd-source-url'></span> will produce <span>http://example.com</span> href - the URL is set to the href attribute Example: <a class='pdfcrowd-source-url' data-pdfcrowd-placement='href'>Link to source</a> will produce <a href='http://example.com'>Link to source</a> href-and-content - the URL is set to the href attribute and to the content Example: <a class='pdfcrowd-source-url' data-pdfcrowd-placement='href-and-content'></a> will produce <a href='http://example.com'>http://example.com</a>
         #
-        # * +url+ - The supported protocols are http:// and https://.
+        # * +url+ - Supported protocols are http:// and https://.
         # * *Returns* - The converter object.
         def setHeaderUrl(url)
             unless /(?i)^https?:\/\/.*$/.match(url)
-                raise Error.new(Pdfcrowd.create_invalid_value_message(url, "setHeaderUrl", "html-to-pdf", "The supported protocols are http:// and https://.", "set_header_url"), 470);
+                raise Error.new(Pdfcrowd.create_invalid_value_message(url, "setHeaderUrl", "html-to-pdf", "Supported protocols are http:// and https://.", "set_header_url"), 470);
             end
             
             @fields['header_url'] = url
@@ -1176,11 +1204,11 @@ module Pdfcrowd
 
         # Set the header height.
         #
-        # * +height+ - The value must be specified in inches "in", millimeters "mm", centimeters "cm", pixels "px", or points "pt".
+        # * +height+ - The value must be specified in inches 'in', millimeters 'mm', centimeters 'cm', pixels 'px', or points 'pt'.
         # * *Returns* - The converter object.
         def setHeaderHeight(height)
             unless /(?i)^0$|^[0-9]*\.?[0-9]+(pt|px|mm|cm|in)$/.match(height)
-                raise Error.new(Pdfcrowd.create_invalid_value_message(height, "setHeaderHeight", "html-to-pdf", "The value must be specified in inches \"in\", millimeters \"mm\", centimeters \"cm\", pixels \"px\", or points \"pt\".", "set_header_height"), 470);
+                raise Error.new(Pdfcrowd.create_invalid_value_message(height, "setHeaderHeight", "html-to-pdf", "The value must be specified in inches 'in', millimeters 'mm', centimeters 'cm', pixels 'px', or points 'pt'.", "set_header_height"), 470);
             end
             
             @fields['header_height'] = height
@@ -1198,11 +1226,11 @@ module Pdfcrowd
 
         # Load an HTML code from the specified URL and use it as the page footer. The following classes can be used in the HTML. The content of the respective elements will be expanded as follows: pdfcrowd-page-count - the total page count of printed pages pdfcrowd-page-number - the current page number pdfcrowd-source-url - the source URL of the converted document pdfcrowd-source-title - the title of the converted document The following attributes can be used: data-pdfcrowd-number-format - specifies the type of the used numerals. Allowed values: arabic - Arabic numerals, they are used by default roman - Roman numerals eastern-arabic - Eastern Arabic numerals bengali - Bengali numerals devanagari - Devanagari numerals thai - Thai numerals east-asia - Chinese, Vietnamese, Japanese and Korean numerals chinese-formal - Chinese formal numerals Please contact us if you need another type of numerals. Example: <span class='pdfcrowd-page-number' data-pdfcrowd-number-format='roman'></span> data-pdfcrowd-placement - specifies where to place the source URL. Allowed values: The URL is inserted to the content Example: <span class='pdfcrowd-source-url'></span> will produce <span>http://example.com</span> href - the URL is set to the href attribute Example: <a class='pdfcrowd-source-url' data-pdfcrowd-placement='href'>Link to source</a> will produce <a href='http://example.com'>Link to source</a> href-and-content - the URL is set to the href attribute and to the content Example: <a class='pdfcrowd-source-url' data-pdfcrowd-placement='href-and-content'></a> will produce <a href='http://example.com'>http://example.com</a>
         #
-        # * +url+ - The supported protocols are http:// and https://.
+        # * +url+ - Supported protocols are http:// and https://.
         # * *Returns* - The converter object.
         def setFooterUrl(url)
             unless /(?i)^https?:\/\/.*$/.match(url)
-                raise Error.new(Pdfcrowd.create_invalid_value_message(url, "setFooterUrl", "html-to-pdf", "The supported protocols are http:// and https://.", "set_footer_url"), 470);
+                raise Error.new(Pdfcrowd.create_invalid_value_message(url, "setFooterUrl", "html-to-pdf", "Supported protocols are http:// and https://.", "set_footer_url"), 470);
             end
             
             @fields['footer_url'] = url
@@ -1224,11 +1252,11 @@ module Pdfcrowd
 
         # Set the footer height.
         #
-        # * +height+ - The value must be specified in inches "in", millimeters "mm", centimeters "cm", pixels "px", or points "pt".
+        # * +height+ - The value must be specified in inches 'in', millimeters 'mm', centimeters 'cm', pixels 'px', or points 'pt'.
         # * *Returns* - The converter object.
         def setFooterHeight(height)
             unless /(?i)^0$|^[0-9]*\.?[0-9]+(pt|px|mm|cm|in)$/.match(height)
-                raise Error.new(Pdfcrowd.create_invalid_value_message(height, "setFooterHeight", "html-to-pdf", "The value must be specified in inches \"in\", millimeters \"mm\", centimeters \"cm\", pixels \"px\", or points \"pt\".", "set_footer_height"), 470);
+                raise Error.new(Pdfcrowd.create_invalid_value_message(height, "setFooterHeight", "html-to-pdf", "The value must be specified in inches 'in', millimeters 'mm', centimeters 'cm', pixels 'px', or points 'pt'.", "set_footer_height"), 470);
             end
             
             @fields['footer_height'] = height
@@ -1281,11 +1309,11 @@ module Pdfcrowd
 
         # Set the scaling factor (zoom) for the header and footer.
         #
-        # * +factor+ - The percentage value. The value must be in the range 10-500.
+        # * +factor+ - The percentage value. The accepted range is 10-500.
         # * *Returns* - The converter object.
         def setHeaderFooterScaleFactor(factor)
             if (!(Integer(factor) >= 10 && Integer(factor) <= 500))
-                raise Error.new(Pdfcrowd.create_invalid_value_message(factor, "setHeaderFooterScaleFactor", "html-to-pdf", "The value must be in the range 10-500.", "set_header_footer_scale_factor"), 470);
+                raise Error.new(Pdfcrowd.create_invalid_value_message(factor, "setHeaderFooterScaleFactor", "html-to-pdf", "The accepted range is 10-500.", "set_header_footer_scale_factor"), 470);
             end
             
             @fields['header_footer_scale_factor'] = factor
@@ -1316,11 +1344,11 @@ module Pdfcrowd
 
         # Load a file from the specified URL and apply the file as a watermark to each page of the output PDF. A watermark can be either a PDF or an image. If a multi-page file (PDF or TIFF) is used, the first page is used as the watermark.
         #
-        # * +url+ - The supported protocols are http:// and https://.
+        # * +url+ - Supported protocols are http:// and https://.
         # * *Returns* - The converter object.
         def setPageWatermarkUrl(url)
             unless /(?i)^https?:\/\/.*$/.match(url)
-                raise Error.new(Pdfcrowd.create_invalid_value_message(url, "setPageWatermarkUrl", "html-to-pdf", "The supported protocols are http:// and https://.", "set_page_watermark_url"), 470);
+                raise Error.new(Pdfcrowd.create_invalid_value_message(url, "setPageWatermarkUrl", "html-to-pdf", "Supported protocols are http:// and https://.", "set_page_watermark_url"), 470);
             end
             
             @fields['page_watermark_url'] = url
@@ -1342,11 +1370,11 @@ module Pdfcrowd
 
         # Load a file from the specified URL and apply each page of the file as a watermark to the corresponding page of the output PDF. A watermark can be either a PDF or an image.
         #
-        # * +url+ - The supported protocols are http:// and https://.
+        # * +url+ - Supported protocols are http:// and https://.
         # * *Returns* - The converter object.
         def setMultipageWatermarkUrl(url)
             unless /(?i)^https?:\/\/.*$/.match(url)
-                raise Error.new(Pdfcrowd.create_invalid_value_message(url, "setMultipageWatermarkUrl", "html-to-pdf", "The supported protocols are http:// and https://.", "set_multipage_watermark_url"), 470);
+                raise Error.new(Pdfcrowd.create_invalid_value_message(url, "setMultipageWatermarkUrl", "html-to-pdf", "Supported protocols are http:// and https://.", "set_multipage_watermark_url"), 470);
             end
             
             @fields['multipage_watermark_url'] = url
@@ -1368,11 +1396,11 @@ module Pdfcrowd
 
         # Load a file from the specified URL and apply the file as a background to each page of the output PDF. A background can be either a PDF or an image. If a multi-page file (PDF or TIFF) is used, the first page is used as the background.
         #
-        # * +url+ - The supported protocols are http:// and https://.
+        # * +url+ - Supported protocols are http:// and https://.
         # * *Returns* - The converter object.
         def setPageBackgroundUrl(url)
             unless /(?i)^https?:\/\/.*$/.match(url)
-                raise Error.new(Pdfcrowd.create_invalid_value_message(url, "setPageBackgroundUrl", "html-to-pdf", "The supported protocols are http:// and https://.", "set_page_background_url"), 470);
+                raise Error.new(Pdfcrowd.create_invalid_value_message(url, "setPageBackgroundUrl", "html-to-pdf", "Supported protocols are http:// and https://.", "set_page_background_url"), 470);
             end
             
             @fields['page_background_url'] = url
@@ -1394,11 +1422,11 @@ module Pdfcrowd
 
         # Load a file from the specified URL and apply each page of the file as a background to the corresponding page of the output PDF. A background can be either a PDF or an image.
         #
-        # * +url+ - The supported protocols are http:// and https://.
+        # * +url+ - Supported protocols are http:// and https://.
         # * *Returns* - The converter object.
         def setMultipageBackgroundUrl(url)
             unless /(?i)^https?:\/\/.*$/.match(url)
-                raise Error.new(Pdfcrowd.create_invalid_value_message(url, "setMultipageBackgroundUrl", "html-to-pdf", "The supported protocols are http:// and https://.", "set_multipage_background_url"), 470);
+                raise Error.new(Pdfcrowd.create_invalid_value_message(url, "setMultipageBackgroundUrl", "html-to-pdf", "Supported protocols are http:// and https://.", "set_multipage_background_url"), 470);
             end
             
             @fields['multipage_background_url'] = url
@@ -1512,19 +1540,13 @@ module Pdfcrowd
             self
         end
 
-        # Set the HTTP authentication user name.
-        #
-        # * +user_name+ - The user name.
-        # * *Returns* - The converter object.
+
         def setHttpAuthUserName(user_name)
             @fields['http_auth_user_name'] = user_name
             self
         end
 
-        # Set the HTTP authentication password.
-        #
-        # * +password+ - The password.
-        # * *Returns* - The converter object.
+
         def setHttpAuthPassword(password)
             @fields['http_auth_password'] = password
             self
@@ -1653,11 +1675,11 @@ module Pdfcrowd
 
         # Wait the specified number of milliseconds to finish all JavaScript after the document is loaded. Your API license defines the maximum wait time by "Max Delay" parameter.
         #
-        # * +delay+ - The number of milliseconds to wait. Must be a positive integer number or 0.
+        # * +delay+ - The number of milliseconds to wait. Must be a positive integer or 0.
         # * *Returns* - The converter object.
         def setJavascriptDelay(delay)
             if (!(Integer(delay) >= 0))
-                raise Error.new(Pdfcrowd.create_invalid_value_message(delay, "setJavascriptDelay", "html-to-pdf", "Must be a positive integer number or 0.", "set_javascript_delay"), 470);
+                raise Error.new(Pdfcrowd.create_invalid_value_message(delay, "setJavascriptDelay", "html-to-pdf", "Must be a positive integer or 0.", "set_javascript_delay"), 470);
             end
             
             @fields['javascript_delay'] = delay
@@ -1727,11 +1749,11 @@ module Pdfcrowd
 
         # Set the viewport width in pixels. The viewport is the user's visible area of the page.
         #
-        # * +width+ - The value must be in the range 96-65000.
+        # * +width+ - The accepted range is 96-65000.
         # * *Returns* - The converter object.
         def setViewportWidth(width)
             if (!(Integer(width) >= 96 && Integer(width) <= 65000))
-                raise Error.new(Pdfcrowd.create_invalid_value_message(width, "setViewportWidth", "html-to-pdf", "The value must be in the range 96-65000.", "set_viewport_width"), 470);
+                raise Error.new(Pdfcrowd.create_invalid_value_message(width, "setViewportWidth", "html-to-pdf", "The accepted range is 96-65000.", "set_viewport_width"), 470);
             end
             
             @fields['viewport_width'] = width
@@ -1740,11 +1762,11 @@ module Pdfcrowd
 
         # Set the viewport height in pixels. The viewport is the user's visible area of the page. If the input HTML uses lazily loaded images, try using a large value that covers the entire height of the HTML, e.g. 100000.
         #
-        # * +height+ - Must be a positive integer number.
+        # * +height+ - Must be a positive integer.
         # * *Returns* - The converter object.
         def setViewportHeight(height)
             if (!(Integer(height) > 0))
-                raise Error.new(Pdfcrowd.create_invalid_value_message(height, "setViewportHeight", "html-to-pdf", "Must be a positive integer number.", "set_viewport_height"), 470);
+                raise Error.new(Pdfcrowd.create_invalid_value_message(height, "setViewportHeight", "html-to-pdf", "Must be a positive integer.", "set_viewport_height"), 470);
             end
             
             @fields['viewport_height'] = height
@@ -1753,8 +1775,8 @@ module Pdfcrowd
 
         # Set the viewport size. The viewport is the user's visible area of the page.
         #
-        # * +width+ - Set the viewport width in pixels. The viewport is the user's visible area of the page. The value must be in the range 96-65000.
-        # * +height+ - Set the viewport height in pixels. The viewport is the user's visible area of the page. If the input HTML uses lazily loaded images, try using a large value that covers the entire height of the HTML, e.g. 100000. Must be a positive integer number.
+        # * +width+ - Set the viewport width in pixels. The viewport is the user's visible area of the page. The accepted range is 96-65000.
+        # * +height+ - Set the viewport height in pixels. The viewport is the user's visible area of the page. If the input HTML uses lazily loaded images, try using a large value that covers the entire height of the HTML, e.g. 100000. Must be a positive integer.
         # * *Returns* - The converter object.
         def setViewport(width, height)
             setViewportWidth(width)
@@ -1790,11 +1812,11 @@ module Pdfcrowd
 
         # Set the scaling factor (zoom) for the main page area.
         #
-        # * +factor+ - The percentage value. The value must be in the range 10-500.
+        # * +factor+ - The percentage value. The accepted range is 10-500.
         # * *Returns* - The converter object.
         def setScaleFactor(factor)
             if (!(Integer(factor) >= 10 && Integer(factor) <= 500))
-                raise Error.new(Pdfcrowd.create_invalid_value_message(factor, "setScaleFactor", "html-to-pdf", "The value must be in the range 10-500.", "set_scale_factor"), 470);
+                raise Error.new(Pdfcrowd.create_invalid_value_message(factor, "setScaleFactor", "html-to-pdf", "The accepted range is 10-500.", "set_scale_factor"), 470);
             end
             
             @fields['scale_factor'] = factor
@@ -1803,11 +1825,11 @@ module Pdfcrowd
 
         # Set the quality of embedded JPEG images. A lower quality results in a smaller PDF file but can lead to compression artifacts.
         #
-        # * +quality+ - The percentage value. The value must be in the range 1-100.
+        # * +quality+ - The percentage value. The accepted range is 1-100.
         # * *Returns* - The converter object.
         def setJpegQuality(quality)
             if (!(Integer(quality) >= 1 && Integer(quality) <= 100))
-                raise Error.new(Pdfcrowd.create_invalid_value_message(quality, "setJpegQuality", "html-to-pdf", "The value must be in the range 1-100.", "set_jpeg_quality"), 470);
+                raise Error.new(Pdfcrowd.create_invalid_value_message(quality, "setJpegQuality", "html-to-pdf", "The accepted range is 1-100.", "set_jpeg_quality"), 470);
             end
             
             @fields['jpeg_quality'] = quality
@@ -1829,11 +1851,11 @@ module Pdfcrowd
 
         # Set the DPI of images in PDF. A lower DPI may result in a smaller PDF file. If the specified DPI is higher than the actual image DPI, the original image DPI is retained (no upscaling is performed). Use 0 to leave the images unaltered.
         #
-        # * +dpi+ - The DPI value. Must be a positive integer number or 0.
+        # * +dpi+ - The DPI value. Must be a positive integer or 0.
         # * *Returns* - The converter object.
         def setImageDpi(dpi)
             if (!(Integer(dpi) >= 0))
-                raise Error.new(Pdfcrowd.create_invalid_value_message(dpi, "setImageDpi", "html-to-pdf", "Must be a positive integer number or 0.", "set_image_dpi"), 470);
+                raise Error.new(Pdfcrowd.create_invalid_value_message(dpi, "setImageDpi", "html-to-pdf", "Must be a positive integer or 0.", "set_image_dpi"), 470);
             end
             
             @fields['image_dpi'] = dpi
@@ -1998,11 +2020,11 @@ module Pdfcrowd
 
         # Display the specified page when the document is opened.
         #
-        # * +page+ - Must be a positive integer number.
+        # * +page+ - Must be a positive integer.
         # * *Returns* - The converter object.
         def setInitialPage(page)
             if (!(Integer(page) > 0))
-                raise Error.new(Pdfcrowd.create_invalid_value_message(page, "setInitialPage", "html-to-pdf", "Must be a positive integer number.", "set_initial_page"), 470);
+                raise Error.new(Pdfcrowd.create_invalid_value_message(page, "setInitialPage", "html-to-pdf", "Must be a positive integer.", "set_initial_page"), 470);
             end
             
             @fields['initial_page'] = page
@@ -2011,11 +2033,11 @@ module Pdfcrowd
 
         # Specify the initial page zoom in percents when the document is opened.
         #
-        # * +zoom+ - Must be a positive integer number.
+        # * +zoom+ - Must be a positive integer.
         # * *Returns* - The converter object.
         def setInitialZoom(zoom)
             if (!(Integer(zoom) > 0))
-                raise Error.new(Pdfcrowd.create_invalid_value_message(zoom, "setInitialZoom", "html-to-pdf", "Must be a positive integer number.", "set_initial_zoom"), 470);
+                raise Error.new(Pdfcrowd.create_invalid_value_message(zoom, "setInitialZoom", "html-to-pdf", "Must be a positive integer.", "set_initial_zoom"), 470);
             end
             
             @fields['initial_zoom'] = zoom
@@ -2280,11 +2302,11 @@ module Pdfcrowd
 
         # Set the internal DPI resolution used for positioning of PDF contents. It can help in situations when there are small inaccuracies in the PDF. It is recommended to use values that are a multiple of 72, such as 288 or 360.
         #
-        # * +dpi+ - The DPI value. The value must be in the range of 72-600.
+        # * +dpi+ - The DPI value. The accepted range is 72-600.
         # * *Returns* - The converter object.
         def setLayoutDpi(dpi)
             if (!(Integer(dpi) >= 72 && Integer(dpi) <= 600))
-                raise Error.new(Pdfcrowd.create_invalid_value_message(dpi, "setLayoutDpi", "html-to-pdf", "The value must be in the range of 72-600.", "set_layout_dpi"), 470);
+                raise Error.new(Pdfcrowd.create_invalid_value_message(dpi, "setLayoutDpi", "html-to-pdf", "The accepted range is 72-600.", "set_layout_dpi"), 470);
             end
             
             @fields['layout_dpi'] = dpi
@@ -2293,11 +2315,11 @@ module Pdfcrowd
 
         # Set the top left X coordinate of the content area. It is relative to the top left X coordinate of the print area.
         #
-        # * +x+ - The value must be specified in inches "in", millimeters "mm", centimeters "cm", pixels "px", or points "pt". It may contain a negative value.
+        # * +x+ - The value must be specified in inches 'in', millimeters 'mm', centimeters 'cm', pixels 'px', or points 'pt'. It may contain a negative value.
         # * *Returns* - The converter object.
         def setContentAreaX(x)
             unless /(?i)^0$|^\-?[0-9]*\.?[0-9]+(pt|px|mm|cm|in)$/.match(x)
-                raise Error.new(Pdfcrowd.create_invalid_value_message(x, "setContentAreaX", "html-to-pdf", "The value must be specified in inches \"in\", millimeters \"mm\", centimeters \"cm\", pixels \"px\", or points \"pt\". It may contain a negative value.", "set_content_area_x"), 470);
+                raise Error.new(Pdfcrowd.create_invalid_value_message(x, "setContentAreaX", "html-to-pdf", "The value must be specified in inches 'in', millimeters 'mm', centimeters 'cm', pixels 'px', or points 'pt'. It may contain a negative value.", "set_content_area_x"), 470);
             end
             
             @fields['content_area_x'] = x
@@ -2306,11 +2328,11 @@ module Pdfcrowd
 
         # Set the top left Y coordinate of the content area. It is relative to the top left Y coordinate of the print area.
         #
-        # * +y+ - The value must be specified in inches "in", millimeters "mm", centimeters "cm", pixels "px", or points "pt". It may contain a negative value.
+        # * +y+ - The value must be specified in inches 'in', millimeters 'mm', centimeters 'cm', pixels 'px', or points 'pt'. It may contain a negative value.
         # * *Returns* - The converter object.
         def setContentAreaY(y)
             unless /(?i)^0$|^\-?[0-9]*\.?[0-9]+(pt|px|mm|cm|in)$/.match(y)
-                raise Error.new(Pdfcrowd.create_invalid_value_message(y, "setContentAreaY", "html-to-pdf", "The value must be specified in inches \"in\", millimeters \"mm\", centimeters \"cm\", pixels \"px\", or points \"pt\". It may contain a negative value.", "set_content_area_y"), 470);
+                raise Error.new(Pdfcrowd.create_invalid_value_message(y, "setContentAreaY", "html-to-pdf", "The value must be specified in inches 'in', millimeters 'mm', centimeters 'cm', pixels 'px', or points 'pt'. It may contain a negative value.", "set_content_area_y"), 470);
             end
             
             @fields['content_area_y'] = y
@@ -2319,11 +2341,11 @@ module Pdfcrowd
 
         # Set the width of the content area. It should be at least 1 inch.
         #
-        # * +width+ - The value must be specified in inches "in", millimeters "mm", centimeters "cm", pixels "px", or points "pt".
+        # * +width+ - The value must be specified in inches 'in', millimeters 'mm', centimeters 'cm', pixels 'px', or points 'pt'.
         # * *Returns* - The converter object.
         def setContentAreaWidth(width)
             unless /(?i)^0$|^[0-9]*\.?[0-9]+(pt|px|mm|cm|in)$/.match(width)
-                raise Error.new(Pdfcrowd.create_invalid_value_message(width, "setContentAreaWidth", "html-to-pdf", "The value must be specified in inches \"in\", millimeters \"mm\", centimeters \"cm\", pixels \"px\", or points \"pt\".", "set_content_area_width"), 470);
+                raise Error.new(Pdfcrowd.create_invalid_value_message(width, "setContentAreaWidth", "html-to-pdf", "The value must be specified in inches 'in', millimeters 'mm', centimeters 'cm', pixels 'px', or points 'pt'.", "set_content_area_width"), 470);
             end
             
             @fields['content_area_width'] = width
@@ -2332,11 +2354,11 @@ module Pdfcrowd
 
         # Set the height of the content area. It should be at least 1 inch.
         #
-        # * +height+ - The value must be specified in inches "in", millimeters "mm", centimeters "cm", pixels "px", or points "pt".
+        # * +height+ - The value must be specified in inches 'in', millimeters 'mm', centimeters 'cm', pixels 'px', or points 'pt'.
         # * *Returns* - The converter object.
         def setContentAreaHeight(height)
             unless /(?i)^0$|^[0-9]*\.?[0-9]+(pt|px|mm|cm|in)$/.match(height)
-                raise Error.new(Pdfcrowd.create_invalid_value_message(height, "setContentAreaHeight", "html-to-pdf", "The value must be specified in inches \"in\", millimeters \"mm\", centimeters \"cm\", pixels \"px\", or points \"pt\".", "set_content_area_height"), 470);
+                raise Error.new(Pdfcrowd.create_invalid_value_message(height, "setContentAreaHeight", "html-to-pdf", "The value must be specified in inches 'in', millimeters 'mm', centimeters 'cm', pixels 'px', or points 'pt'.", "set_content_area_height"), 470);
             end
             
             @fields['content_area_height'] = height
@@ -2345,10 +2367,10 @@ module Pdfcrowd
 
         # Set the content area position and size. The content area enables to specify a web page area to be converted.
         #
-        # * +x+ - Set the top left X coordinate of the content area. It is relative to the top left X coordinate of the print area. The value must be specified in inches "in", millimeters "mm", centimeters "cm", pixels "px", or points "pt". It may contain a negative value.
-        # * +y+ - Set the top left Y coordinate of the content area. It is relative to the top left Y coordinate of the print area. The value must be specified in inches "in", millimeters "mm", centimeters "cm", pixels "px", or points "pt". It may contain a negative value.
-        # * +width+ - Set the width of the content area. It should be at least 1 inch. The value must be specified in inches "in", millimeters "mm", centimeters "cm", pixels "px", or points "pt".
-        # * +height+ - Set the height of the content area. It should be at least 1 inch. The value must be specified in inches "in", millimeters "mm", centimeters "cm", pixels "px", or points "pt".
+        # * +x+ - Set the top left X coordinate of the content area. It is relative to the top left X coordinate of the print area. The value must be specified in inches 'in', millimeters 'mm', centimeters 'cm', pixels 'px', or points 'pt'. It may contain a negative value.
+        # * +y+ - Set the top left Y coordinate of the content area. It is relative to the top left Y coordinate of the print area. The value must be specified in inches 'in', millimeters 'mm', centimeters 'cm', pixels 'px', or points 'pt'. It may contain a negative value.
+        # * +width+ - Set the width of the content area. It should be at least 1 inch. The value must be specified in inches 'in', millimeters 'mm', centimeters 'cm', pixels 'px', or points 'pt'.
+        # * +height+ - Set the height of the content area. It should be at least 1 inch. The value must be specified in inches 'in', millimeters 'mm', centimeters 'cm', pixels 'px', or points 'pt'.
         # * *Returns* - The converter object.
         def setContentArea(x, y, width, height)
             setContentAreaX(x)
@@ -2415,18 +2437,18 @@ module Pdfcrowd
 
         # Set the maximum time to load the page and its resources. After this time, all requests will be considered successful. This can be useful to ensure that the conversion does not timeout. Use this method if there is no other way to fix page loading.
         #
-        # * +max_time+ - The number of seconds to wait. The value must be in the range 10-30.
+        # * +max_time+ - The number of seconds to wait. The accepted range is 10-30.
         # * *Returns* - The converter object.
         def setMaxLoadingTime(max_time)
             if (!(Integer(max_time) >= 10 && Integer(max_time) <= 30))
-                raise Error.new(Pdfcrowd.create_invalid_value_message(max_time, "setMaxLoadingTime", "html-to-pdf", "The value must be in the range 10-30.", "set_max_loading_time"), 470);
+                raise Error.new(Pdfcrowd.create_invalid_value_message(max_time, "setMaxLoadingTime", "html-to-pdf", "The accepted range is 10-30.", "set_max_loading_time"), 470);
             end
             
             @fields['max_loading_time'] = max_time
             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. 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".
+        # 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). backgroundColor: Page background color in RRGGBB or RRGGBBAA hexadecimal format (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.
@@ -2448,6 +2470,21 @@ module Pdfcrowd
             self
         end
 
+
+        def setSubprocessReferrer(referrer)
+            @fields['subprocess_referrer'] = referrer
+            self
+        end
+
+        # Specifies the User-Agent HTTP header that will be used by the converter when a request is made to the converted web page.
+        #
+        # * +agent+ - The user agent.
+        # * *Returns* - The converter object.
+        def setConverterUserAgent(agent)
+            @fields['converter_user_agent'] = agent
+            self
+        end
+
         # Set the converter version. Different versions may produce different output. Choose which one provides the best output for your case.
         #
         # * +version+ - The version identifier. Allowed values are 24.04, 20.10, 18.10, latest.
@@ -2471,6 +2508,15 @@ module Pdfcrowd
             self
         end
 
+        # Specifies the User-Agent HTTP header that the client library will use when interacting with the API.
+        #
+        # * +agent+ - The user agent string.
+        # * *Returns* - The converter object.
+        def setClientUserAgent(agent)
+            @helper.setUserAgent(agent)
+            self
+        end
+
         # Set a custom user agent HTTP header. It can be useful if you are behind a proxy or a firewall.
         #
         # * +agent+ - The user agent string.
@@ -2535,11 +2581,11 @@ module Pdfcrowd
 
         # Convert a web page.
         #
-        # * +url+ - The address of the web page to convert. The supported protocols are http:// and https://.
+        # * +url+ - The address of the web page to convert. Supported protocols are http:// and https://.
         # * *Returns* - Byte array containing the conversion output.
         def convertUrl(url)
             unless /(?i)^https?:\/\/.*$/.match(url)
-                raise Error.new(Pdfcrowd.create_invalid_value_message(url, "convertUrl", "html-to-image", "The supported protocols are http:// and https://.", "convert_url"), 470);
+                raise Error.new(Pdfcrowd.create_invalid_value_message(url, "convertUrl", "html-to-image", "Supported protocols are http:// and https://.", "convert_url"), 470);
             end
             
             @fields['url'] = url
@@ -2548,11 +2594,11 @@ module Pdfcrowd
 
         # Convert a web page and write the result to an output stream.
         #
-        # * +url+ - The address of the web page to convert. The supported protocols are http:// and https://.
+        # * +url+ - The address of the web page to convert. Supported protocols are http:// and https://.
         # * +out_stream+ - The output stream that will contain the conversion output.
         def convertUrlToStream(url, out_stream)
             unless /(?i)^https?:\/\/.*$/.match(url)
-                raise Error.new(Pdfcrowd.create_invalid_value_message(url, "convertUrlToStream::url", "html-to-image", "The supported protocols are http:// and https://.", "convert_url_to_stream"), 470);
+                raise Error.new(Pdfcrowd.create_invalid_value_message(url, "convertUrlToStream::url", "html-to-image", "Supported protocols are http:// and https://.", "convert_url_to_stream"), 470);
             end
             
             @fields['url'] = url
@@ -2561,7 +2607,7 @@ module Pdfcrowd
 
         # Convert a web page and write the result to a local file.
         #
-        # * +url+ - The address of the web page to convert. The supported protocols are http:// and https://.
+        # * +url+ - The address of the web page to convert. Supported protocols are http:// and https://.
         # * +file_path+ - The output file path. The string must not be empty.
         def convertUrlToFile(url, file_path)
             if (!(!file_path.nil? && !file_path.empty?))
@@ -2720,11 +2766,11 @@ module Pdfcrowd
 
         # Set the output image width in pixels.
         #
-        # * +width+ - The value must be in the range 96-65000.
+        # * +width+ - The accepted range is 96-65000.
         # * *Returns* - The converter object.
         def setScreenshotWidth(width)
             if (!(Integer(width) >= 96 && Integer(width) <= 65000))
-                raise Error.new(Pdfcrowd.create_invalid_value_message(width, "setScreenshotWidth", "html-to-image", "The value must be in the range 96-65000.", "set_screenshot_width"), 470);
+                raise Error.new(Pdfcrowd.create_invalid_value_message(width, "setScreenshotWidth", "html-to-image", "The accepted range is 96-65000.", "set_screenshot_width"), 470);
             end
             
             @fields['screenshot_width'] = width
@@ -2733,11 +2779,11 @@ module Pdfcrowd
 
         # Set the output image height in pixels. If it is not specified, actual document height is used.
         #
-        # * +height+ - Must be a positive integer number.
+        # * +height+ - Must be a positive integer.
         # * *Returns* - The converter object.
         def setScreenshotHeight(height)
             if (!(Integer(height) > 0))
-                raise Error.new(Pdfcrowd.create_invalid_value_message(height, "setScreenshotHeight", "html-to-image", "Must be a positive integer number.", "set_screenshot_height"), 470);
+                raise Error.new(Pdfcrowd.create_invalid_value_message(height, "setScreenshotHeight", "html-to-image", "Must be a positive integer.", "set_screenshot_height"), 470);
             end
             
             @fields['screenshot_height'] = height
@@ -2746,11 +2792,11 @@ module Pdfcrowd
 
         # Set the scaling factor (zoom) for the output image.
         #
-        # * +factor+ - The percentage value. Must be a positive integer number.
+        # * +factor+ - The percentage value. Must be a positive integer.
         # * *Returns* - The converter object.
         def setScaleFactor(factor)
             if (!(Integer(factor) > 0))
-                raise Error.new(Pdfcrowd.create_invalid_value_message(factor, "setScaleFactor", "html-to-image", "Must be a positive integer number.", "set_scale_factor"), 470);
+                raise Error.new(Pdfcrowd.create_invalid_value_message(factor, "setScaleFactor", "html-to-image", "Must be a positive integer.", "set_scale_factor"), 470);
             end
             
             @fields['scale_factor'] = factor
@@ -2864,19 +2910,13 @@ module Pdfcrowd
             self
         end
 
-        # Set the HTTP authentication user name.
-        #
-        # * +user_name+ - The user name.
-        # * *Returns* - The converter object.
+
         def setHttpAuthUserName(user_name)
             @fields['http_auth_user_name'] = user_name
             self
         end
 
-        # Set the HTTP authentication password.
-        #
-        # * +password+ - The password.
-        # * *Returns* - The converter object.
+
         def setHttpAuthPassword(password)
             @fields['http_auth_password'] = password
             self
@@ -2992,11 +3032,11 @@ module Pdfcrowd
 
         # Wait the specified number of milliseconds to finish all JavaScript after the document is loaded. Your API license defines the maximum wait time by "Max Delay" parameter.
         #
-        # * +delay+ - The number of milliseconds to wait. Must be a positive integer number or 0.
+        # * +delay+ - The number of milliseconds to wait. Must be a positive integer or 0.
         # * *Returns* - The converter object.
         def setJavascriptDelay(delay)
             if (!(Integer(delay) >= 0))
-                raise Error.new(Pdfcrowd.create_invalid_value_message(delay, "setJavascriptDelay", "html-to-image", "Must be a positive integer number or 0.", "set_javascript_delay"), 470);
+                raise Error.new(Pdfcrowd.create_invalid_value_message(delay, "setJavascriptDelay", "html-to-image", "Must be a positive integer or 0.", "set_javascript_delay"), 470);
             end
             
             @fields['javascript_delay'] = delay
@@ -3247,17 +3287,32 @@ module Pdfcrowd
 
         # Set the maximum time to load the page and its resources. After this time, all requests will be considered successful. This can be useful to ensure that the conversion does not timeout. Use this method if there is no other way to fix page loading.
         #
-        # * +max_time+ - The number of seconds to wait. The value must be in the range 10-30.
+        # * +max_time+ - The number of seconds to wait. The accepted range is 10-30.
         # * *Returns* - The converter object.
         def setMaxLoadingTime(max_time)
             if (!(Integer(max_time) >= 10 && Integer(max_time) <= 30))
-                raise Error.new(Pdfcrowd.create_invalid_value_message(max_time, "setMaxLoadingTime", "html-to-image", "The value must be in the range 10-30.", "set_max_loading_time"), 470);
+                raise Error.new(Pdfcrowd.create_invalid_value_message(max_time, "setMaxLoadingTime", "html-to-image", "The accepted range is 10-30.", "set_max_loading_time"), 470);
             end
             
             @fields['max_loading_time'] = max_time
             self
         end
 
+
+        def setSubprocessReferrer(referrer)
+            @fields['subprocess_referrer'] = referrer
+            self
+        end
+
+        # Specifies the User-Agent HTTP header that will be used by the converter when a request is made to the converted web page.
+        #
+        # * +agent+ - The user agent.
+        # * *Returns* - The converter object.
+        def setConverterUserAgent(agent)
+            @fields['converter_user_agent'] = agent
+            self
+        end
+
         # Set the converter version. Different versions may produce different output. Choose which one provides the best output for your case.
         #
         # * +version+ - The version identifier. Allowed values are 24.04, 20.10, 18.10, latest.
@@ -3281,6 +3336,15 @@ module Pdfcrowd
             self
         end
 
+        # Specifies the User-Agent HTTP header that the client library will use when interacting with the API.
+        #
+        # * +agent+ - The user agent string.
+        # * *Returns* - The converter object.
+        def setClientUserAgent(agent)
+            @helper.setUserAgent(agent)
+            self
+        end
+
         # Set a custom user agent HTTP header. It can be useful if you are behind a proxy or a firewall.
         #
         # * +agent+ - The user agent string.
@@ -3332,11 +3396,11 @@ module Pdfcrowd
 
         # Convert an image.
         #
-        # * +url+ - The address of the image to convert. The supported protocols are http:// and https://.
+        # * +url+ - The address of the image to convert. Supported protocols are http:// and https://.
         # * *Returns* - Byte array containing the conversion output.
         def convertUrl(url)
             unless /(?i)^https?:\/\/.*$/.match(url)
-                raise Error.new(Pdfcrowd.create_invalid_value_message(url, "convertUrl", "image-to-image", "The supported protocols are http:// and https://.", "convert_url"), 470);
+                raise Error.new(Pdfcrowd.create_invalid_value_message(url, "convertUrl", "image-to-image", "Supported protocols are http:// and https://.", "convert_url"), 470);
             end
             
             @fields['url'] = url
@@ -3345,11 +3409,11 @@ module Pdfcrowd
 
         # Convert an image and write the result to an output stream.
         #
-        # * +url+ - The address of the image to convert. The supported protocols are http:// and https://.
+        # * +url+ - The address of the image to convert. Supported protocols are http:// and https://.
         # * +out_stream+ - The output stream that will contain the conversion output.
         def convertUrlToStream(url, out_stream)
             unless /(?i)^https?:\/\/.*$/.match(url)
-                raise Error.new(Pdfcrowd.create_invalid_value_message(url, "convertUrlToStream::url", "image-to-image", "The supported protocols are http:// and https://.", "convert_url_to_stream"), 470);
+                raise Error.new(Pdfcrowd.create_invalid_value_message(url, "convertUrlToStream::url", "image-to-image", "Supported protocols are http:// and https://.", "convert_url_to_stream"), 470);
             end
             
             @fields['url'] = url
@@ -3358,7 +3422,7 @@ module Pdfcrowd
 
         # Convert an image and write the result to a local file.
         #
-        # * +url+ - The address of the image to convert. The supported protocols are http:// and https://.
+        # * +url+ - The address of the image to convert. Supported protocols are http:// and https://.
         # * +file_path+ - The output file path. The string must not be empty.
         def convertUrlToFile(url, file_path)
             if (!(!file_path.nil? && !file_path.empty?))
@@ -3531,11 +3595,11 @@ module Pdfcrowd
 
         # Set the top left X coordinate of the content area. It is relative to the top left X coordinate of the print area.
         #
-        # * +x+ - The value must be specified in inches "in", millimeters "mm", centimeters "cm", pixels "px", or points "pt".
+        # * +x+ - The value must be specified in inches 'in', millimeters 'mm', centimeters 'cm', pixels 'px', or points 'pt'.
         # * *Returns* - The converter object.
         def setCropAreaX(x)
             unless /(?i)^0$|^[0-9]*\.?[0-9]+(pt|px|mm|cm|in)$/.match(x)
-                raise Error.new(Pdfcrowd.create_invalid_value_message(x, "setCropAreaX", "image-to-image", "The value must be specified in inches \"in\", millimeters \"mm\", centimeters \"cm\", pixels \"px\", or points \"pt\".", "set_crop_area_x"), 470);
+                raise Error.new(Pdfcrowd.create_invalid_value_message(x, "setCropAreaX", "image-to-image", "The value must be specified in inches 'in', millimeters 'mm', centimeters 'cm', pixels 'px', or points 'pt'.", "set_crop_area_x"), 470);
             end
             
             @fields['crop_area_x'] = x
@@ -3544,11 +3608,11 @@ module Pdfcrowd
 
         # Set the top left Y coordinate of the content area. It is relative to the top left Y coordinate of the print area.
         #
-        # * +y+ - The value must be specified in inches "in", millimeters "mm", centimeters "cm", pixels "px", or points "pt".
+        # * +y+ - The value must be specified in inches 'in', millimeters 'mm', centimeters 'cm', pixels 'px', or points 'pt'.
         # * *Returns* - The converter object.
         def setCropAreaY(y)
             unless /(?i)^0$|^[0-9]*\.?[0-9]+(pt|px|mm|cm|in)$/.match(y)
-                raise Error.new(Pdfcrowd.create_invalid_value_message(y, "setCropAreaY", "image-to-image", "The value must be specified in inches \"in\", millimeters \"mm\", centimeters \"cm\", pixels \"px\", or points \"pt\".", "set_crop_area_y"), 470);
+                raise Error.new(Pdfcrowd.create_invalid_value_message(y, "setCropAreaY", "image-to-image", "The value must be specified in inches 'in', millimeters 'mm', centimeters 'cm', pixels 'px', or points 'pt'.", "set_crop_area_y"), 470);
             end
             
             @fields['crop_area_y'] = y
@@ -3557,11 +3621,11 @@ module Pdfcrowd
 
         # Set the width of the content area. It should be at least 1 inch.
         #
-        # * +width+ - The value must be specified in inches "in", millimeters "mm", centimeters "cm", pixels "px", or points "pt".
+        # * +width+ - The value must be specified in inches 'in', millimeters 'mm', centimeters 'cm', pixels 'px', or points 'pt'.
         # * *Returns* - The converter object.
         def setCropAreaWidth(width)
             unless /(?i)^0$|^[0-9]*\.?[0-9]+(pt|px|mm|cm|in)$/.match(width)
-                raise Error.new(Pdfcrowd.create_invalid_value_message(width, "setCropAreaWidth", "image-to-image", "The value must be specified in inches \"in\", millimeters \"mm\", centimeters \"cm\", pixels \"px\", or points \"pt\".", "set_crop_area_width"), 470);
+                raise Error.new(Pdfcrowd.create_invalid_value_message(width, "setCropAreaWidth", "image-to-image", "The value must be specified in inches 'in', millimeters 'mm', centimeters 'cm', pixels 'px', or points 'pt'.", "set_crop_area_width"), 470);
             end
             
             @fields['crop_area_width'] = width
@@ -3570,11 +3634,11 @@ module Pdfcrowd
 
         # Set the height of the content area. It should be at least 1 inch.
         #
-        # * +height+ - The value must be specified in inches "in", millimeters "mm", centimeters "cm", pixels "px", or points "pt".
+        # * +height+ - The value must be specified in inches 'in', millimeters 'mm', centimeters 'cm', pixels 'px', or points 'pt'.
         # * *Returns* - The converter object.
         def setCropAreaHeight(height)
             unless /(?i)^0$|^[0-9]*\.?[0-9]+(pt|px|mm|cm|in)$/.match(height)
-                raise Error.new(Pdfcrowd.create_invalid_value_message(height, "setCropAreaHeight", "image-to-image", "The value must be specified in inches \"in\", millimeters \"mm\", centimeters \"cm\", pixels \"px\", or points \"pt\".", "set_crop_area_height"), 470);
+                raise Error.new(Pdfcrowd.create_invalid_value_message(height, "setCropAreaHeight", "image-to-image", "The value must be specified in inches 'in', millimeters 'mm', centimeters 'cm', pixels 'px', or points 'pt'.", "set_crop_area_height"), 470);
             end
             
             @fields['crop_area_height'] = height
@@ -3583,10 +3647,10 @@ module Pdfcrowd
 
         # Set the content area position and size. The content area enables to specify the part to be converted.
         #
-        # * +x+ - Set the top left X coordinate of the content area. It is relative to the top left X coordinate of the print area. The value must be specified in inches "in", millimeters "mm", centimeters "cm", pixels "px", or points "pt".
-        # * +y+ - Set the top left Y coordinate of the content area. It is relative to the top left Y coordinate of the print area. The value must be specified in inches "in", millimeters "mm", centimeters "cm", pixels "px", or points "pt".
-        # * +width+ - Set the width of the content area. It should be at least 1 inch. The value must be specified in inches "in", millimeters "mm", centimeters "cm", pixels "px", or points "pt".
-        # * +height+ - Set the height of the content area. It should be at least 1 inch. The value must be specified in inches "in", millimeters "mm", centimeters "cm", pixels "px", or points "pt".
+        # * +x+ - Set the top left X coordinate of the content area. It is relative to the top left X coordinate of the print area. The value must be specified in inches 'in', millimeters 'mm', centimeters 'cm', pixels 'px', or points 'pt'.
+        # * +y+ - Set the top left Y coordinate of the content area. It is relative to the top left Y coordinate of the print area. The value must be specified in inches 'in', millimeters 'mm', centimeters 'cm', pixels 'px', or points 'pt'.
+        # * +width+ - Set the width of the content area. It should be at least 1 inch. The value must be specified in inches 'in', millimeters 'mm', centimeters 'cm', pixels 'px', or points 'pt'.
+        # * +height+ - Set the height of the content area. It should be at least 1 inch. The value must be specified in inches 'in', millimeters 'mm', centimeters 'cm', pixels 'px', or points 'pt'.
         # * *Returns* - The converter object.
         def setCropArea(x, y, width, height)
             setCropAreaX(x)
@@ -3620,11 +3684,11 @@ module Pdfcrowd
 
         # Set the output canvas width.
         #
-        # * +width+ - The value must be specified in inches "in", millimeters "mm", centimeters "cm", pixels "px", or points "pt".
+        # * +width+ - The value must be specified in inches 'in', millimeters 'mm', centimeters 'cm', pixels 'px', or points 'pt'.
         # * *Returns* - The converter object.
         def setCanvasWidth(width)
             unless /(?i)^0$|^[0-9]*\.?[0-9]+(pt|px|mm|cm|in)$/.match(width)
-                raise Error.new(Pdfcrowd.create_invalid_value_message(width, "setCanvasWidth", "image-to-image", "The value must be specified in inches \"in\", millimeters \"mm\", centimeters \"cm\", pixels \"px\", or points \"pt\".", "set_canvas_width"), 470);
+                raise Error.new(Pdfcrowd.create_invalid_value_message(width, "setCanvasWidth", "image-to-image", "The value must be specified in inches 'in', millimeters 'mm', centimeters 'cm', pixels 'px', or points 'pt'.", "set_canvas_width"), 470);
             end
             
             @fields['canvas_width'] = width
@@ -3633,11 +3697,11 @@ module Pdfcrowd
 
         # Set the output canvas height.
         #
-        # * +height+ - The value must be specified in inches "in", millimeters "mm", centimeters "cm", pixels "px", or points "pt".
+        # * +height+ - The value must be specified in inches 'in', millimeters 'mm', centimeters 'cm', pixels 'px', or points 'pt'.
         # * *Returns* - The converter object.
         def setCanvasHeight(height)
             unless /(?i)^0$|^[0-9]*\.?[0-9]+(pt|px|mm|cm|in)$/.match(height)
-                raise Error.new(Pdfcrowd.create_invalid_value_message(height, "setCanvasHeight", "image-to-image", "The value must be specified in inches \"in\", millimeters \"mm\", centimeters \"cm\", pixels \"px\", or points \"pt\".", "set_canvas_height"), 470);
+                raise Error.new(Pdfcrowd.create_invalid_value_message(height, "setCanvasHeight", "image-to-image", "The value must be specified in inches 'in', millimeters 'mm', centimeters 'cm', pixels 'px', or points 'pt'.", "set_canvas_height"), 470);
             end
             
             @fields['canvas_height'] = height
@@ -3646,8 +3710,8 @@ module Pdfcrowd
 
         # Set the output canvas dimensions. If no canvas size is specified, margins are applied as a border around the image.
         #
-        # * +width+ - Set the output canvas width. The value must be specified in inches "in", millimeters "mm", centimeters "cm", pixels "px", or points "pt".
-        # * +height+ - Set the output canvas height. The value must be specified in inches "in", millimeters "mm", centimeters "cm", pixels "px", or points "pt".
+        # * +width+ - Set the output canvas width. The value must be specified in inches 'in', millimeters 'mm', centimeters 'cm', pixels 'px', or points 'pt'.
+        # * +height+ - Set the output canvas height. The value must be specified in inches 'in', millimeters 'mm', centimeters 'cm', pixels 'px', or points 'pt'.
         # * *Returns* - The converter object.
         def setCanvasDimensions(width, height)
             setCanvasWidth(width)
@@ -3696,11 +3760,11 @@ module Pdfcrowd
 
         # Set the output canvas top margin.
         #
-        # * +top+ - The value must be specified in inches "in", millimeters "mm", centimeters "cm", pixels "px", or points "pt".
+        # * +top+ - The value must be specified in inches 'in', millimeters 'mm', centimeters 'cm', pixels 'px', or points 'pt'.
         # * *Returns* - The converter object.
         def setMarginTop(top)
             unless /(?i)^0$|^[0-9]*\.?[0-9]+(pt|px|mm|cm|in)$/.match(top)
-                raise Error.new(Pdfcrowd.create_invalid_value_message(top, "setMarginTop", "image-to-image", "The value must be specified in inches \"in\", millimeters \"mm\", centimeters \"cm\", pixels \"px\", or points \"pt\".", "set_margin_top"), 470);
+                raise Error.new(Pdfcrowd.create_invalid_value_message(top, "setMarginTop", "image-to-image", "The value must be specified in inches 'in', millimeters 'mm', centimeters 'cm', pixels 'px', or points 'pt'.", "set_margin_top"), 470);
             end
             
             @fields['margin_top'] = top
@@ -3709,11 +3773,11 @@ module Pdfcrowd
 
         # Set the output canvas right margin.
         #
-        # * +right+ - The value must be specified in inches "in", millimeters "mm", centimeters "cm", pixels "px", or points "pt".
+        # * +right+ - The value must be specified in inches 'in', millimeters 'mm', centimeters 'cm', pixels 'px', or points 'pt'.
         # * *Returns* - The converter object.
         def setMarginRight(right)
             unless /(?i)^0$|^[0-9]*\.?[0-9]+(pt|px|mm|cm|in)$/.match(right)
-                raise Error.new(Pdfcrowd.create_invalid_value_message(right, "setMarginRight", "image-to-image", "The value must be specified in inches \"in\", millimeters \"mm\", centimeters \"cm\", pixels \"px\", or points \"pt\".", "set_margin_right"), 470);
+                raise Error.new(Pdfcrowd.create_invalid_value_message(right, "setMarginRight", "image-to-image", "The value must be specified in inches 'in', millimeters 'mm', centimeters 'cm', pixels 'px', or points 'pt'.", "set_margin_right"), 470);
             end
             
             @fields['margin_right'] = right
@@ -3722,11 +3786,11 @@ module Pdfcrowd
 
         # Set the output canvas bottom margin.
         #
-        # * +bottom+ - The value must be specified in inches "in", millimeters "mm", centimeters "cm", pixels "px", or points "pt".
+        # * +bottom+ - The value must be specified in inches 'in', millimeters 'mm', centimeters 'cm', pixels 'px', or points 'pt'.
         # * *Returns* - The converter object.
         def setMarginBottom(bottom)
             unless /(?i)^0$|^[0-9]*\.?[0-9]+(pt|px|mm|cm|in)$/.match(bottom)
-                raise Error.new(Pdfcrowd.create_invalid_value_message(bottom, "setMarginBottom", "image-to-image", "The value must be specified in inches \"in\", millimeters \"mm\", centimeters \"cm\", pixels \"px\", or points \"pt\".", "set_margin_bottom"), 470);
+                raise Error.new(Pdfcrowd.create_invalid_value_message(bottom, "setMarginBottom", "image-to-image", "The value must be specified in inches 'in', millimeters 'mm', centimeters 'cm', pixels 'px', or points 'pt'.", "set_margin_bottom"), 470);
             end
             
             @fields['margin_bottom'] = bottom
@@ -3735,11 +3799,11 @@ module Pdfcrowd
 
         # Set the output canvas left margin.
         #
-        # * +left+ - The value must be specified in inches "in", millimeters "mm", centimeters "cm", pixels "px", or points "pt".
+        # * +left+ - The value must be specified in inches 'in', millimeters 'mm', centimeters 'cm', pixels 'px', or points 'pt'.
         # * *Returns* - The converter object.
         def setMarginLeft(left)
             unless /(?i)^0$|^[0-9]*\.?[0-9]+(pt|px|mm|cm|in)$/.match(left)
-                raise Error.new(Pdfcrowd.create_invalid_value_message(left, "setMarginLeft", "image-to-image", "The value must be specified in inches \"in\", millimeters \"mm\", centimeters \"cm\", pixels \"px\", or points \"pt\".", "set_margin_left"), 470);
+                raise Error.new(Pdfcrowd.create_invalid_value_message(left, "setMarginLeft", "image-to-image", "The value must be specified in inches 'in', millimeters 'mm', centimeters 'cm', pixels 'px', or points 'pt'.", "set_margin_left"), 470);
             end
             
             @fields['margin_left'] = left
@@ -3748,10 +3812,10 @@ module Pdfcrowd
 
         # Set the output canvas margins.
         #
-        # * +top+ - Set the output canvas top margin. The value must be specified in inches "in", millimeters "mm", centimeters "cm", pixels "px", or points "pt".
-        # * +right+ - Set the output canvas right margin. The value must be specified in inches "in", millimeters "mm", centimeters "cm", pixels "px", or points "pt".
-        # * +bottom+ - Set the output canvas bottom margin. The value must be specified in inches "in", millimeters "mm", centimeters "cm", pixels "px", or points "pt".
-        # * +left+ - Set the output canvas left margin. The value must be specified in inches "in", millimeters "mm", centimeters "cm", pixels "px", or points "pt".
+        # * +top+ - Set the output canvas top margin. The value must be specified in inches 'in', millimeters 'mm', centimeters 'cm', pixels 'px', or points 'pt'.
+        # * +right+ - Set the output canvas right margin. The value must be specified in inches 'in', millimeters 'mm', centimeters 'cm', pixels 'px', or points 'pt'.
+        # * +bottom+ - Set the output canvas bottom margin. The value must be specified in inches 'in', millimeters 'mm', centimeters 'cm', pixels 'px', or points 'pt'.
+        # * +left+ - Set the output canvas left margin. The value must be specified in inches 'in', millimeters 'mm', centimeters 'cm', pixels 'px', or points 'pt'.
         # * *Returns* - The converter object.
         def setMargins(top, right, bottom, left)
             setMarginTop(top)
@@ -3889,6 +3953,15 @@ module Pdfcrowd
             self
         end
 
+        # Specifies the User-Agent HTTP header that the client library will use when interacting with the API.
+        #
+        # * +agent+ - The user agent string.
+        # * *Returns* - The converter object.
+        def setClientUserAgent(agent)
+            @helper.setUserAgent(agent)
+            self
+        end
+
         # Set a custom user agent HTTP header. It can be useful if you are behind a proxy or a firewall.
         #
         # * +agent+ - The user agent string.
@@ -4042,11 +4115,11 @@ module Pdfcrowd
 
         # Load a file from the specified URL and apply the file as a watermark to each page of the output PDF. A watermark can be either a PDF or an image. If a multi-page file (PDF or TIFF) is used, the first page is used as the watermark.
         #
-        # * +url+ - The supported protocols are http:// and https://.
+        # * +url+ - Supported protocols are http:// and https://.
         # * *Returns* - The converter object.
         def setPageWatermarkUrl(url)
             unless /(?i)^https?:\/\/.*$/.match(url)
-                raise Error.new(Pdfcrowd.create_invalid_value_message(url, "setPageWatermarkUrl", "pdf-to-pdf", "The supported protocols are http:// and https://.", "set_page_watermark_url"), 470);
+                raise Error.new(Pdfcrowd.create_invalid_value_message(url, "setPageWatermarkUrl", "pdf-to-pdf", "Supported protocols are http:// and https://.", "set_page_watermark_url"), 470);
             end
             
             @fields['page_watermark_url'] = url
@@ -4068,11 +4141,11 @@ module Pdfcrowd
 
         # Load a file from the specified URL and apply each page of the file as a watermark to the corresponding page of the output PDF. A watermark can be either a PDF or an image.
         #
-        # * +url+ - The supported protocols are http:// and https://.
+        # * +url+ - Supported protocols are http:// and https://.
         # * *Returns* - The converter object.
         def setMultipageWatermarkUrl(url)
             unless /(?i)^https?:\/\/.*$/.match(url)
-                raise Error.new(Pdfcrowd.create_invalid_value_message(url, "setMultipageWatermarkUrl", "pdf-to-pdf", "The supported protocols are http:// and https://.", "set_multipage_watermark_url"), 470);
+                raise Error.new(Pdfcrowd.create_invalid_value_message(url, "setMultipageWatermarkUrl", "pdf-to-pdf", "Supported protocols are http:// and https://.", "set_multipage_watermark_url"), 470);
             end
             
             @fields['multipage_watermark_url'] = url
@@ -4094,11 +4167,11 @@ module Pdfcrowd
 
         # Load a file from the specified URL and apply the file as a background to each page of the output PDF. A background can be either a PDF or an image. If a multi-page file (PDF or TIFF) is used, the first page is used as the background.
         #
-        # * +url+ - The supported protocols are http:// and https://.
+        # * +url+ - Supported protocols are http:// and https://.
         # * *Returns* - The converter object.
         def setPageBackgroundUrl(url)
             unless /(?i)^https?:\/\/.*$/.match(url)
-                raise Error.new(Pdfcrowd.create_invalid_value_message(url, "setPageBackgroundUrl", "pdf-to-pdf", "The supported protocols are http:// and https://.", "set_page_background_url"), 470);
+                raise Error.new(Pdfcrowd.create_invalid_value_message(url, "setPageBackgroundUrl", "pdf-to-pdf", "Supported protocols are http:// and https://.", "set_page_background_url"), 470);
             end
             
             @fields['page_background_url'] = url
@@ -4120,11 +4193,11 @@ module Pdfcrowd
 
         # Load a file from the specified URL and apply each page of the file as a background to the corresponding page of the output PDF. A background can be either a PDF or an image.
         #
-        # * +url+ - The supported protocols are http:// and https://.
+        # * +url+ - Supported protocols are http:// and https://.
         # * *Returns* - The converter object.
         def setMultipageBackgroundUrl(url)
             unless /(?i)^https?:\/\/.*$/.match(url)
-                raise Error.new(Pdfcrowd.create_invalid_value_message(url, "setMultipageBackgroundUrl", "pdf-to-pdf", "The supported protocols are http:// and https://.", "set_multipage_background_url"), 470);
+                raise Error.new(Pdfcrowd.create_invalid_value_message(url, "setMultipageBackgroundUrl", "pdf-to-pdf", "Supported protocols are http:// and https://.", "set_multipage_background_url"), 470);
             end
             
             @fields['multipage_background_url'] = url
@@ -4232,11 +4305,11 @@ module Pdfcrowd
 
         # Use metadata (title, subject, author and keywords) from the n-th input PDF.
         #
-        # * +index+ - Set the index of the input PDF file from which to use the metadata. 0 means no metadata. Must be a positive integer number or 0.
+        # * +index+ - Set the index of the input PDF file from which to use the metadata. 0 means no metadata. Must be a positive integer or 0.
         # * *Returns* - The converter object.
         def setUseMetadataFrom(index)
             if (!(Integer(index) >= 0))
-                raise Error.new(Pdfcrowd.create_invalid_value_message(index, "setUseMetadataFrom", "pdf-to-pdf", "Must be a positive integer number or 0.", "set_use_metadata_from"), 470);
+                raise Error.new(Pdfcrowd.create_invalid_value_message(index, "setUseMetadataFrom", "pdf-to-pdf", "Must be a positive integer or 0.", "set_use_metadata_from"), 470);
             end
             
             @fields['use_metadata_from'] = index
@@ -4284,11 +4357,11 @@ module Pdfcrowd
 
         # Display the specified page when the document is opened.
         #
-        # * +page+ - Must be a positive integer number.
+        # * +page+ - Must be a positive integer.
         # * *Returns* - The converter object.
         def setInitialPage(page)
             if (!(Integer(page) > 0))
-                raise Error.new(Pdfcrowd.create_invalid_value_message(page, "setInitialPage", "pdf-to-pdf", "Must be a positive integer number.", "set_initial_page"), 470);
+                raise Error.new(Pdfcrowd.create_invalid_value_message(page, "setInitialPage", "pdf-to-pdf", "Must be a positive integer.", "set_initial_page"), 470);
             end
             
             @fields['initial_page'] = page
@@ -4297,11 +4370,11 @@ module Pdfcrowd
 
         # Specify the initial page zoom in percents when the document is opened.
         #
-        # * +zoom+ - Must be a positive integer number.
+        # * +zoom+ - Must be a positive integer.
         # * *Returns* - The converter object.
         def setInitialZoom(zoom)
             if (!(Integer(zoom) > 0))
-                raise Error.new(Pdfcrowd.create_invalid_value_message(zoom, "setInitialZoom", "pdf-to-pdf", "Must be a positive integer number.", "set_initial_zoom"), 470);
+                raise Error.new(Pdfcrowd.create_invalid_value_message(zoom, "setInitialZoom", "pdf-to-pdf", "Must be a positive integer.", "set_initial_zoom"), 470);
             end
             
             @fields['initial_zoom'] = zoom
@@ -4457,6 +4530,15 @@ module Pdfcrowd
             self
         end
 
+        # Specifies the User-Agent HTTP header that the client library will use when interacting with the API.
+        #
+        # * +agent+ - The user agent string.
+        # * *Returns* - The converter object.
+        def setClientUserAgent(agent)
+            @helper.setUserAgent(agent)
+            self
+        end
+
         # Set a custom user agent HTTP header. It can be useful if you are behind a proxy or a firewall.
         #
         # * +agent+ - The user agent string.
@@ -4508,11 +4590,11 @@ module Pdfcrowd
 
         # Convert an image.
         #
-        # * +url+ - The address of the image to convert. The supported protocols are http:// and https://.
+        # * +url+ - The address of the image to convert. Supported protocols are http:// and https://.
         # * *Returns* - Byte array containing the conversion output.
         def convertUrl(url)
             unless /(?i)^https?:\/\/.*$/.match(url)
-                raise Error.new(Pdfcrowd.create_invalid_value_message(url, "convertUrl", "image-to-pdf", "The supported protocols are http:// and https://.", "convert_url"), 470);
+                raise Error.new(Pdfcrowd.create_invalid_value_message(url, "convertUrl", "image-to-pdf", "Supported protocols are http:// and https://.", "convert_url"), 470);
             end
             
             @fields['url'] = url
@@ -4521,11 +4603,11 @@ module Pdfcrowd
 
         # Convert an image and write the result to an output stream.
         #
-        # * +url+ - The address of the image to convert. The supported protocols are http:// and https://.
+        # * +url+ - The address of the image to convert. Supported protocols are http:// and https://.
         # * +out_stream+ - The output stream that will contain the conversion output.
         def convertUrlToStream(url, out_stream)
             unless /(?i)^https?:\/\/.*$/.match(url)
-                raise Error.new(Pdfcrowd.create_invalid_value_message(url, "convertUrlToStream::url", "image-to-pdf", "The supported protocols are http:// and https://.", "convert_url_to_stream"), 470);
+                raise Error.new(Pdfcrowd.create_invalid_value_message(url, "convertUrlToStream::url", "image-to-pdf", "Supported protocols are http:// and https://.", "convert_url_to_stream"), 470);
             end
             
             @fields['url'] = url
@@ -4534,7 +4616,7 @@ module Pdfcrowd
 
         # Convert an image and write the result to a local file.
         #
-        # * +url+ - The address of the image to convert. The supported protocols are http:// and https://.
+        # * +url+ - The address of the image to convert. Supported protocols are http:// and https://.
         # * +file_path+ - The output file path. The string must not be empty.
         def convertUrlToFile(url, file_path)
             if (!(!file_path.nil? && !file_path.empty?))
@@ -4694,11 +4776,11 @@ module Pdfcrowd
 
         # Set the top left X coordinate of the content area. It is relative to the top left X coordinate of the print area.
         #
-        # * +x+ - The value must be specified in inches "in", millimeters "mm", centimeters "cm", pixels "px", or points "pt".
+        # * +x+ - The value must be specified in inches 'in', millimeters 'mm', centimeters 'cm', pixels 'px', or points 'pt'.
         # * *Returns* - The converter object.
         def setCropAreaX(x)
             unless /(?i)^0$|^[0-9]*\.?[0-9]+(pt|px|mm|cm|in)$/.match(x)
-                raise Error.new(Pdfcrowd.create_invalid_value_message(x, "setCropAreaX", "image-to-pdf", "The value must be specified in inches \"in\", millimeters \"mm\", centimeters \"cm\", pixels \"px\", or points \"pt\".", "set_crop_area_x"), 470);
+                raise Error.new(Pdfcrowd.create_invalid_value_message(x, "setCropAreaX", "image-to-pdf", "The value must be specified in inches 'in', millimeters 'mm', centimeters 'cm', pixels 'px', or points 'pt'.", "set_crop_area_x"), 470);
             end
             
             @fields['crop_area_x'] = x
@@ -4707,11 +4789,11 @@ module Pdfcrowd
 
         # Set the top left Y coordinate of the content area. It is relative to the top left Y coordinate of the print area.
         #
-        # * +y+ - The value must be specified in inches "in", millimeters "mm", centimeters "cm", pixels "px", or points "pt".
+        # * +y+ - The value must be specified in inches 'in', millimeters 'mm', centimeters 'cm', pixels 'px', or points 'pt'.
         # * *Returns* - The converter object.
         def setCropAreaY(y)
             unless /(?i)^0$|^[0-9]*\.?[0-9]+(pt|px|mm|cm|in)$/.match(y)
-                raise Error.new(Pdfcrowd.create_invalid_value_message(y, "setCropAreaY", "image-to-pdf", "The value must be specified in inches \"in\", millimeters \"mm\", centimeters \"cm\", pixels \"px\", or points \"pt\".", "set_crop_area_y"), 470);
+                raise Error.new(Pdfcrowd.create_invalid_value_message(y, "setCropAreaY", "image-to-pdf", "The value must be specified in inches 'in', millimeters 'mm', centimeters 'cm', pixels 'px', or points 'pt'.", "set_crop_area_y"), 470);
             end
             
             @fields['crop_area_y'] = y
@@ -4720,11 +4802,11 @@ module Pdfcrowd
 
         # Set the width of the content area. It should be at least 1 inch.
         #
-        # * +width+ - The value must be specified in inches "in", millimeters "mm", centimeters "cm", pixels "px", or points "pt".
+        # * +width+ - The value must be specified in inches 'in', millimeters 'mm', centimeters 'cm', pixels 'px', or points 'pt'.
         # * *Returns* - The converter object.
         def setCropAreaWidth(width)
             unless /(?i)^0$|^[0-9]*\.?[0-9]+(pt|px|mm|cm|in)$/.match(width)
-                raise Error.new(Pdfcrowd.create_invalid_value_message(width, "setCropAreaWidth", "image-to-pdf", "The value must be specified in inches \"in\", millimeters \"mm\", centimeters \"cm\", pixels \"px\", or points \"pt\".", "set_crop_area_width"), 470);
+                raise Error.new(Pdfcrowd.create_invalid_value_message(width, "setCropAreaWidth", "image-to-pdf", "The value must be specified in inches 'in', millimeters 'mm', centimeters 'cm', pixels 'px', or points 'pt'.", "set_crop_area_width"), 470);
             end
             
             @fields['crop_area_width'] = width
@@ -4733,11 +4815,11 @@ module Pdfcrowd
 
         # Set the height of the content area. It should be at least 1 inch.
         #
-        # * +height+ - The value must be specified in inches "in", millimeters "mm", centimeters "cm", pixels "px", or points "pt".
+        # * +height+ - The value must be specified in inches 'in', millimeters 'mm', centimeters 'cm', pixels 'px', or points 'pt'.
         # * *Returns* - The converter object.
         def setCropAreaHeight(height)
             unless /(?i)^0$|^[0-9]*\.?[0-9]+(pt|px|mm|cm|in)$/.match(height)
-                raise Error.new(Pdfcrowd.create_invalid_value_message(height, "setCropAreaHeight", "image-to-pdf", "The value must be specified in inches \"in\", millimeters \"mm\", centimeters \"cm\", pixels \"px\", or points \"pt\".", "set_crop_area_height"), 470);
+                raise Error.new(Pdfcrowd.create_invalid_value_message(height, "setCropAreaHeight", "image-to-pdf", "The value must be specified in inches 'in', millimeters 'mm', centimeters 'cm', pixels 'px', or points 'pt'.", "set_crop_area_height"), 470);
             end
             
             @fields['crop_area_height'] = height
@@ -4746,10 +4828,10 @@ module Pdfcrowd
 
         # Set the content area position and size. The content area enables to specify the part to be converted.
         #
-        # * +x+ - Set the top left X coordinate of the content area. It is relative to the top left X coordinate of the print area. The value must be specified in inches "in", millimeters "mm", centimeters "cm", pixels "px", or points "pt".
-        # * +y+ - Set the top left Y coordinate of the content area. It is relative to the top left Y coordinate of the print area. The value must be specified in inches "in", millimeters "mm", centimeters "cm", pixels "px", or points "pt".
-        # * +width+ - Set the width of the content area. It should be at least 1 inch. The value must be specified in inches "in", millimeters "mm", centimeters "cm", pixels "px", or points "pt".
-        # * +height+ - Set the height of the content area. It should be at least 1 inch. The value must be specified in inches "in", millimeters "mm", centimeters "cm", pixels "px", or points "pt".
+        # * +x+ - Set the top left X coordinate of the content area. It is relative to the top left X coordinate of the print area. The value must be specified in inches 'in', millimeters 'mm', centimeters 'cm', pixels 'px', or points 'pt'.
+        # * +y+ - Set the top left Y coordinate of the content area. It is relative to the top left Y coordinate of the print area. The value must be specified in inches 'in', millimeters 'mm', centimeters 'cm', pixels 'px', or points 'pt'.
+        # * +width+ - Set the width of the content area. It should be at least 1 inch. The value must be specified in inches 'in', millimeters 'mm', centimeters 'cm', pixels 'px', or points 'pt'.
+        # * +height+ - Set the height of the content area. It should be at least 1 inch. The value must be specified in inches 'in', millimeters 'mm', centimeters 'cm', pixels 'px', or points 'pt'.
         # * *Returns* - The converter object.
         def setCropArea(x, y, width, height)
             setCropAreaX(x)
@@ -4783,11 +4865,11 @@ module Pdfcrowd
 
         # Set the output page width.
         #
-        # * +width+ - The value must be specified in inches "in", millimeters "mm", centimeters "cm", pixels "px", or points "pt".
+        # * +width+ - The value must be specified in inches 'in', millimeters 'mm', centimeters 'cm', pixels 'px', or points 'pt'.
         # * *Returns* - The converter object.
         def setPageWidth(width)
             unless /(?i)^0$|^[0-9]*\.?[0-9]+(pt|px|mm|cm|in)$/.match(width)
-                raise Error.new(Pdfcrowd.create_invalid_value_message(width, "setPageWidth", "image-to-pdf", "The value must be specified in inches \"in\", millimeters \"mm\", centimeters \"cm\", pixels \"px\", or points \"pt\".", "set_page_width"), 470);
+                raise Error.new(Pdfcrowd.create_invalid_value_message(width, "setPageWidth", "image-to-pdf", "The value must be specified in inches 'in', millimeters 'mm', centimeters 'cm', pixels 'px', or points 'pt'.", "set_page_width"), 470);
             end
             
             @fields['page_width'] = width
@@ -4796,11 +4878,11 @@ module Pdfcrowd
 
         # Set the output page height.
         #
-        # * +height+ - The value must be specified in inches "in", millimeters "mm", centimeters "cm", pixels "px", or points "pt".
+        # * +height+ - The value must be specified in inches 'in', millimeters 'mm', centimeters 'cm', pixels 'px', or points 'pt'.
         # * *Returns* - The converter object.
         def setPageHeight(height)
             unless /(?i)^0$|^[0-9]*\.?[0-9]+(pt|px|mm|cm|in)$/.match(height)
-                raise Error.new(Pdfcrowd.create_invalid_value_message(height, "setPageHeight", "image-to-pdf", "The value must be specified in inches \"in\", millimeters \"mm\", centimeters \"cm\", pixels \"px\", or points \"pt\".", "set_page_height"), 470);
+                raise Error.new(Pdfcrowd.create_invalid_value_message(height, "setPageHeight", "image-to-pdf", "The value must be specified in inches 'in', millimeters 'mm', centimeters 'cm', pixels 'px', or points 'pt'.", "set_page_height"), 470);
             end
             
             @fields['page_height'] = height
@@ -4809,8 +4891,8 @@ module Pdfcrowd
 
         # Set the output page dimensions. If no page size is specified, margins are applied as a border around the image.
         #
-        # * +width+ - Set the output page width. The value must be specified in inches "in", millimeters "mm", centimeters "cm", pixels "px", or points "pt".
-        # * +height+ - Set the output page height. The value must be specified in inches "in", millimeters "mm", centimeters "cm", pixels "px", or points "pt".
+        # * +width+ - Set the output page width. The value must be specified in inches 'in', millimeters 'mm', centimeters 'cm', pixels 'px', or points 'pt'.
+        # * +height+ - Set the output page height. The value must be specified in inches 'in', millimeters 'mm', centimeters 'cm', pixels 'px', or points 'pt'.
         # * *Returns* - The converter object.
         def setPageDimensions(width, height)
             setPageWidth(width)
@@ -4859,11 +4941,11 @@ module Pdfcrowd
 
         # Set the output page top margin.
         #
-        # * +top+ - The value must be specified in inches "in", millimeters "mm", centimeters "cm", pixels "px", or points "pt".
+        # * +top+ - The value must be specified in inches 'in', millimeters 'mm', centimeters 'cm', pixels 'px', or points 'pt'.
         # * *Returns* - The converter object.
         def setMarginTop(top)
             unless /(?i)^0$|^[0-9]*\.?[0-9]+(pt|px|mm|cm|in)$/.match(top)
-                raise Error.new(Pdfcrowd.create_invalid_value_message(top, "setMarginTop", "image-to-pdf", "The value must be specified in inches \"in\", millimeters \"mm\", centimeters \"cm\", pixels \"px\", or points \"pt\".", "set_margin_top"), 470);
+                raise Error.new(Pdfcrowd.create_invalid_value_message(top, "setMarginTop", "image-to-pdf", "The value must be specified in inches 'in', millimeters 'mm', centimeters 'cm', pixels 'px', or points 'pt'.", "set_margin_top"), 470);
             end
             
             @fields['margin_top'] = top
@@ -4872,11 +4954,11 @@ module Pdfcrowd
 
         # Set the output page right margin.
         #
-        # * +right+ - The value must be specified in inches "in", millimeters "mm", centimeters "cm", pixels "px", or points "pt".
+        # * +right+ - The value must be specified in inches 'in', millimeters 'mm', centimeters 'cm', pixels 'px', or points 'pt'.
         # * *Returns* - The converter object.
         def setMarginRight(right)
             unless /(?i)^0$|^[0-9]*\.?[0-9]+(pt|px|mm|cm|in)$/.match(right)
-                raise Error.new(Pdfcrowd.create_invalid_value_message(right, "setMarginRight", "image-to-pdf", "The value must be specified in inches \"in\", millimeters \"mm\", centimeters \"cm\", pixels \"px\", or points \"pt\".", "set_margin_right"), 470);
+                raise Error.new(Pdfcrowd.create_invalid_value_message(right, "setMarginRight", "image-to-pdf", "The value must be specified in inches 'in', millimeters 'mm', centimeters 'cm', pixels 'px', or points 'pt'.", "set_margin_right"), 470);
             end
             
             @fields['margin_right'] = right
@@ -4885,11 +4967,11 @@ module Pdfcrowd
 
         # Set the output page bottom margin.
         #
-        # * +bottom+ - The value must be specified in inches "in", millimeters "mm", centimeters "cm", pixels "px", or points "pt".
+        # * +bottom+ - The value must be specified in inches 'in', millimeters 'mm', centimeters 'cm', pixels 'px', or points 'pt'.
         # * *Returns* - The converter object.
         def setMarginBottom(bottom)
             unless /(?i)^0$|^[0-9]*\.?[0-9]+(pt|px|mm|cm|in)$/.match(bottom)
-                raise Error.new(Pdfcrowd.create_invalid_value_message(bottom, "setMarginBottom", "image-to-pdf", "The value must be specified in inches \"in\", millimeters \"mm\", centimeters \"cm\", pixels \"px\", or points \"pt\".", "set_margin_bottom"), 470);
+                raise Error.new(Pdfcrowd.create_invalid_value_message(bottom, "setMarginBottom", "image-to-pdf", "The value must be specified in inches 'in', millimeters 'mm', centimeters 'cm', pixels 'px', or points 'pt'.", "set_margin_bottom"), 470);
             end
             
             @fields['margin_bottom'] = bottom
@@ -4898,11 +4980,11 @@ module Pdfcrowd
 
         # Set the output page left margin.
         #
-        # * +left+ - The value must be specified in inches "in", millimeters "mm", centimeters "cm", pixels "px", or points "pt".
+        # * +left+ - The value must be specified in inches 'in', millimeters 'mm', centimeters 'cm', pixels 'px', or points 'pt'.
         # * *Returns* - The converter object.
         def setMarginLeft(left)
             unless /(?i)^0$|^[0-9]*\.?[0-9]+(pt|px|mm|cm|in)$/.match(left)
-                raise Error.new(Pdfcrowd.create_invalid_value_message(left, "setMarginLeft", "image-to-pdf", "The value must be specified in inches \"in\", millimeters \"mm\", centimeters \"cm\", pixels \"px\", or points \"pt\".", "set_margin_left"), 470);
+                raise Error.new(Pdfcrowd.create_invalid_value_message(left, "setMarginLeft", "image-to-pdf", "The value must be specified in inches 'in', millimeters 'mm', centimeters 'cm', pixels 'px', or points 'pt'.", "set_margin_left"), 470);
             end
             
             @fields['margin_left'] = left
@@ -4911,10 +4993,10 @@ module Pdfcrowd
 
         # Set the output page margins.
         #
-        # * +top+ - Set the output page top margin. The value must be specified in inches "in", millimeters "mm", centimeters "cm", pixels "px", or points "pt".
-        # * +right+ - Set the output page right margin. The value must be specified in inches "in", millimeters "mm", centimeters "cm", pixels "px", or points "pt".
-        # * +bottom+ - Set the output page bottom margin. The value must be specified in inches "in", millimeters "mm", centimeters "cm", pixels "px", or points "pt".
-        # * +left+ - Set the output page left margin. The value must be specified in inches "in", millimeters "mm", centimeters "cm", pixels "px", or points "pt".
+        # * +top+ - Set the output page top margin. The value must be specified in inches 'in', millimeters 'mm', centimeters 'cm', pixels 'px', or points 'pt'.
+        # * +right+ - Set the output page right margin. The value must be specified in inches 'in', millimeters 'mm', centimeters 'cm', pixels 'px', or points 'pt'.
+        # * +bottom+ - Set the output page bottom margin. The value must be specified in inches 'in', millimeters 'mm', centimeters 'cm', pixels 'px', or points 'pt'.
+        # * +left+ - Set the output page left margin. The value must be specified in inches 'in', millimeters 'mm', centimeters 'cm', pixels 'px', or points 'pt'.
         # * *Returns* - The converter object.
         def setPageMargins(top, right, bottom, left)
             setMarginTop(top)
@@ -4961,11 +5043,11 @@ module Pdfcrowd
 
         # Load a file from the specified URL and apply the file as a watermark to each page of the output PDF. A watermark can be either a PDF or an image. If a multi-page file (PDF or TIFF) is used, the first page is used as the watermark.
         #
-        # * +url+ - The supported protocols are http:// and https://.
+        # * +url+ - Supported protocols are http:// and https://.
         # * *Returns* - The converter object.
         def setPageWatermarkUrl(url)
             unless /(?i)^https?:\/\/.*$/.match(url)
-                raise Error.new(Pdfcrowd.create_invalid_value_message(url, "setPageWatermarkUrl", "image-to-pdf", "The supported protocols are http:// and https://.", "set_page_watermark_url"), 470);
+                raise Error.new(Pdfcrowd.create_invalid_value_message(url, "setPageWatermarkUrl", "image-to-pdf", "Supported protocols are http:// and https://.", "set_page_watermark_url"), 470);
             end
             
             @fields['page_watermark_url'] = url
@@ -4987,11 +5069,11 @@ module Pdfcrowd
 
         # Load a file from the specified URL and apply each page of the file as a watermark to the corresponding page of the output PDF. A watermark can be either a PDF or an image.
         #
-        # * +url+ - The supported protocols are http:// and https://.
+        # * +url+ - Supported protocols are http:// and https://.
         # * *Returns* - The converter object.
         def setMultipageWatermarkUrl(url)
             unless /(?i)^https?:\/\/.*$/.match(url)
-                raise Error.new(Pdfcrowd.create_invalid_value_message(url, "setMultipageWatermarkUrl", "image-to-pdf", "The supported protocols are http:// and https://.", "set_multipage_watermark_url"), 470);
+                raise Error.new(Pdfcrowd.create_invalid_value_message(url, "setMultipageWatermarkUrl", "image-to-pdf", "Supported protocols are http:// and https://.", "set_multipage_watermark_url"), 470);
             end
             
             @fields['multipage_watermark_url'] = url
@@ -5013,11 +5095,11 @@ module Pdfcrowd
 
         # Load a file from the specified URL and apply the file as a background to each page of the output PDF. A background can be either a PDF or an image. If a multi-page file (PDF or TIFF) is used, the first page is used as the background.
         #
-        # * +url+ - The supported protocols are http:// and https://.
+        # * +url+ - Supported protocols are http:// and https://.
         # * *Returns* - The converter object.
         def setPageBackgroundUrl(url)
             unless /(?i)^https?:\/\/.*$/.match(url)
-                raise Error.new(Pdfcrowd.create_invalid_value_message(url, "setPageBackgroundUrl", "image-to-pdf", "The supported protocols are http:// and https://.", "set_page_background_url"), 470);
+                raise Error.new(Pdfcrowd.create_invalid_value_message(url, "setPageBackgroundUrl", "image-to-pdf", "Supported protocols are http:// and https://.", "set_page_background_url"), 470);
             end
             
             @fields['page_background_url'] = url
@@ -5039,11 +5121,11 @@ module Pdfcrowd
 
         # Load a file from the specified URL and apply each page of the file as a background to the corresponding page of the output PDF. A background can be either a PDF or an image.
         #
-        # * +url+ - The supported protocols are http:// and https://.
+        # * +url+ - Supported protocols are http:// and https://.
         # * *Returns* - The converter object.
         def setMultipageBackgroundUrl(url)
             unless /(?i)^https?:\/\/.*$/.match(url)
-                raise Error.new(Pdfcrowd.create_invalid_value_message(url, "setMultipageBackgroundUrl", "image-to-pdf", "The supported protocols are http:// and https://.", "set_multipage_background_url"), 470);
+                raise Error.new(Pdfcrowd.create_invalid_value_message(url, "setMultipageBackgroundUrl", "image-to-pdf", "Supported protocols are http:// and https://.", "set_multipage_background_url"), 470);
             end
             
             @fields['multipage_background_url'] = url
@@ -5190,11 +5272,11 @@ module Pdfcrowd
 
         # Display the specified page when the document is opened.
         #
-        # * +page+ - Must be a positive integer number.
+        # * +page+ - Must be a positive integer.
         # * *Returns* - The converter object.
         def setInitialPage(page)
             if (!(Integer(page) > 0))
-                raise Error.new(Pdfcrowd.create_invalid_value_message(page, "setInitialPage", "image-to-pdf", "Must be a positive integer number.", "set_initial_page"), 470);
+                raise Error.new(Pdfcrowd.create_invalid_value_message(page, "setInitialPage", "image-to-pdf", "Must be a positive integer.", "set_initial_page"), 470);
             end
             
             @fields['initial_page'] = page
@@ -5203,11 +5285,11 @@ module Pdfcrowd
 
         # Specify the initial page zoom in percents when the document is opened.
         #
-        # * +zoom+ - Must be a positive integer number.
+        # * +zoom+ - Must be a positive integer.
         # * *Returns* - The converter object.
         def setInitialZoom(zoom)
             if (!(Integer(zoom) > 0))
-                raise Error.new(Pdfcrowd.create_invalid_value_message(zoom, "setInitialZoom", "image-to-pdf", "Must be a positive integer number.", "set_initial_zoom"), 470);
+                raise Error.new(Pdfcrowd.create_invalid_value_message(zoom, "setInitialZoom", "image-to-pdf", "Must be a positive integer.", "set_initial_zoom"), 470);
             end
             
             @fields['initial_zoom'] = zoom
@@ -5374,6 +5456,15 @@ module Pdfcrowd
             self
         end
 
+        # Specifies the User-Agent HTTP header that the client library will use when interacting with the API.
+        #
+        # * +agent+ - The user agent string.
+        # * *Returns* - The converter object.
+        def setClientUserAgent(agent)
+            @helper.setUserAgent(agent)
+            self
+        end
+
         # Set a custom user agent HTTP header. It can be useful if you are behind a proxy or a firewall.
         #
         # * +agent+ - The user agent string.
@@ -5425,11 +5516,11 @@ module Pdfcrowd
 
         # Convert a PDF.
         #
-        # * +url+ - The address of the PDF to convert. The supported protocols are http:// and https://.
+        # * +url+ - The address of the PDF to convert. Supported protocols are http:// and https://.
         # * *Returns* - Byte array containing the conversion output.
         def convertUrl(url)
             unless /(?i)^https?:\/\/.*$/.match(url)
-                raise Error.new(Pdfcrowd.create_invalid_value_message(url, "convertUrl", "pdf-to-html", "The supported protocols are http:// and https://.", "convert_url"), 470);
+                raise Error.new(Pdfcrowd.create_invalid_value_message(url, "convertUrl", "pdf-to-html", "Supported protocols are http:// and https://.", "convert_url"), 470);
             end
             
             @fields['url'] = url
@@ -5438,11 +5529,11 @@ module Pdfcrowd
 
         # Convert a PDF and write the result to an output stream.
         #
-        # * +url+ - The address of the PDF to convert. The supported protocols are http:// and https://.
+        # * +url+ - The address of the PDF to convert. Supported protocols are http:// and https://.
         # * +out_stream+ - The output stream that will contain the conversion output.
         def convertUrlToStream(url, out_stream)
             unless /(?i)^https?:\/\/.*$/.match(url)
-                raise Error.new(Pdfcrowd.create_invalid_value_message(url, "convertUrlToStream::url", "pdf-to-html", "The supported protocols are http:// and https://.", "convert_url_to_stream"), 470);
+                raise Error.new(Pdfcrowd.create_invalid_value_message(url, "convertUrlToStream::url", "pdf-to-html", "Supported protocols are http:// and https://.", "convert_url_to_stream"), 470);
             end
             
             @fields['url'] = url
@@ -5451,7 +5542,7 @@ module Pdfcrowd
 
         # Convert a PDF and write the result to a local file.
         #
-        # * +url+ - The address of the PDF to convert. The supported protocols are http:// and https://.
+        # * +url+ - The address of the PDF to convert. Supported protocols are http:// and https://.
         # * +file_path+ - The output file path. The string must not be empty. The converter generates an HTML or ZIP file. If ZIP file is generated, the file path must have a ZIP or zip extension.
         def convertUrlToFile(url, file_path)
             if (!(!file_path.nil? && !file_path.empty?))
@@ -5618,11 +5709,11 @@ module Pdfcrowd
 
         # Set the scaling factor (zoom) for the main page area.
         #
-        # * +factor+ - The percentage value. Must be a positive integer number.
+        # * +factor+ - The percentage value. Must be a positive integer.
         # * *Returns* - The converter object.
         def setScaleFactor(factor)
             if (!(Integer(factor) > 0))
-                raise Error.new(Pdfcrowd.create_invalid_value_message(factor, "setScaleFactor", "pdf-to-html", "Must be a positive integer number.", "set_scale_factor"), 470);
+                raise Error.new(Pdfcrowd.create_invalid_value_message(factor, "setScaleFactor", "pdf-to-html", "Must be a positive integer.", "set_scale_factor"), 470);
             end
             
             @fields['scale_factor'] = factor
@@ -5738,7 +5829,7 @@ module Pdfcrowd
             self
         end
 
-        # Add a specified prefix to all id and class attributes in the HTML content, creating a namespace for safe integration into another HTML document. This process ensures unique identifiers, preventing conflicts when merging with other HTML.
+        # Add the specified prefix to all id and class attributes in the HTML content, creating a namespace for safe integration into another HTML document. This ensures unique identifiers, preventing conflicts when merging with other HTML.
         #
         # * +prefix+ - The prefix to add before each id and class attribute name. Start with a letter or underscore, and use only letters, numbers, hyphens, underscores, or colons.
         # * *Returns* - The converter object.
@@ -5914,6 +6005,15 @@ module Pdfcrowd
             self
         end
 
+        # Specifies the User-Agent HTTP header that the client library will use when interacting with the API.
+        #
+        # * +agent+ - The user agent string.
+        # * *Returns* - The converter object.
+        def setClientUserAgent(agent)
+            @helper.setUserAgent(agent)
+            self
+        end
+
         # Set a custom user agent HTTP header. It can be useful if you are behind a proxy or a firewall.
         #
         # * +agent+ - The user agent string.
@@ -5971,11 +6071,11 @@ module Pdfcrowd
 
         # Convert a PDF.
         #
-        # * +url+ - The address of the PDF to convert. The supported protocols are http:// and https://.
+        # * +url+ - The address of the PDF to convert. Supported protocols are http:// and https://.
         # * *Returns* - Byte array containing the conversion output.
         def convertUrl(url)
             unless /(?i)^https?:\/\/.*$/.match(url)
-                raise Error.new(Pdfcrowd.create_invalid_value_message(url, "convertUrl", "pdf-to-text", "The supported protocols are http:// and https://.", "convert_url"), 470);
+                raise Error.new(Pdfcrowd.create_invalid_value_message(url, "convertUrl", "pdf-to-text", "Supported protocols are http:// and https://.", "convert_url"), 470);
             end
             
             @fields['url'] = url
@@ -5984,11 +6084,11 @@ module Pdfcrowd
 
         # Convert a PDF and write the result to an output stream.
         #
-        # * +url+ - The address of the PDF to convert. The supported protocols are http:// and https://.
+        # * +url+ - The address of the PDF to convert. Supported protocols are http:// and https://.
         # * +out_stream+ - The output stream that will contain the conversion output.
         def convertUrlToStream(url, out_stream)
             unless /(?i)^https?:\/\/.*$/.match(url)
-                raise Error.new(Pdfcrowd.create_invalid_value_message(url, "convertUrlToStream::url", "pdf-to-text", "The supported protocols are http:// and https://.", "convert_url_to_stream"), 470);
+                raise Error.new(Pdfcrowd.create_invalid_value_message(url, "convertUrlToStream::url", "pdf-to-text", "Supported protocols are http:// and https://.", "convert_url_to_stream"), 470);
             end
             
             @fields['url'] = url
@@ -5997,7 +6097,7 @@ module Pdfcrowd
 
         # Convert a PDF and write the result to a local file.
         #
-        # * +url+ - The address of the PDF to convert. The supported protocols are http:// and https://.
+        # * +url+ - The address of the PDF to convert. Supported protocols are http:// and https://.
         # * +file_path+ - The output file path. The string must not be empty.
         def convertUrlToFile(url, file_path)
             if (!(!file_path.nil? && !file_path.empty?))
@@ -6249,11 +6349,11 @@ module Pdfcrowd
 
         # Set the top left X coordinate of the crop area in points.
         #
-        # * +x+ - Must be a positive integer number or 0.
+        # * +x+ - Must be a positive integer or 0.
         # * *Returns* - The converter object.
         def setCropAreaX(x)
             if (!(Integer(x) >= 0))
-                raise Error.new(Pdfcrowd.create_invalid_value_message(x, "setCropAreaX", "pdf-to-text", "Must be a positive integer number or 0.", "set_crop_area_x"), 470);
+                raise Error.new(Pdfcrowd.create_invalid_value_message(x, "setCropAreaX", "pdf-to-text", "Must be a positive integer or 0.", "set_crop_area_x"), 470);
             end
             
             @fields['crop_area_x'] = x
@@ -6262,11 +6362,11 @@ module Pdfcrowd
 
         # Set the top left Y coordinate of the crop area in points.
         #
-        # * +y+ - Must be a positive integer number or 0.
+        # * +y+ - Must be a positive integer or 0.
         # * *Returns* - The converter object.
         def setCropAreaY(y)
             if (!(Integer(y) >= 0))
-                raise Error.new(Pdfcrowd.create_invalid_value_message(y, "setCropAreaY", "pdf-to-text", "Must be a positive integer number or 0.", "set_crop_area_y"), 470);
+                raise Error.new(Pdfcrowd.create_invalid_value_message(y, "setCropAreaY", "pdf-to-text", "Must be a positive integer or 0.", "set_crop_area_y"), 470);
             end
             
             @fields['crop_area_y'] = y
@@ -6275,11 +6375,11 @@ module Pdfcrowd
 
         # Set the width of the crop area in points.
         #
-        # * +width+ - Must be a positive integer number or 0.
+        # * +width+ - Must be a positive integer or 0.
         # * *Returns* - The converter object.
         def setCropAreaWidth(width)
             if (!(Integer(width) >= 0))
-                raise Error.new(Pdfcrowd.create_invalid_value_message(width, "setCropAreaWidth", "pdf-to-text", "Must be a positive integer number or 0.", "set_crop_area_width"), 470);
+                raise Error.new(Pdfcrowd.create_invalid_value_message(width, "setCropAreaWidth", "pdf-to-text", "Must be a positive integer or 0.", "set_crop_area_width"), 470);
             end
             
             @fields['crop_area_width'] = width
@@ -6288,11 +6388,11 @@ module Pdfcrowd
 
         # Set the height of the crop area in points.
         #
-        # * +height+ - Must be a positive integer number or 0.
+        # * +height+ - Must be a positive integer or 0.
         # * *Returns* - The converter object.
         def setCropAreaHeight(height)
             if (!(Integer(height) >= 0))
-                raise Error.new(Pdfcrowd.create_invalid_value_message(height, "setCropAreaHeight", "pdf-to-text", "Must be a positive integer number or 0.", "set_crop_area_height"), 470);
+                raise Error.new(Pdfcrowd.create_invalid_value_message(height, "setCropAreaHeight", "pdf-to-text", "Must be a positive integer or 0.", "set_crop_area_height"), 470);
             end
             
             @fields['crop_area_height'] = height
@@ -6301,10 +6401,10 @@ module Pdfcrowd
 
         # Set the crop area. It allows to extract just a part of a PDF page.
         #
-        # * +x+ - Set the top left X coordinate of the crop area in points. Must be a positive integer number or 0.
-        # * +y+ - Set the top left Y coordinate of the crop area in points. Must be a positive integer number or 0.
-        # * +width+ - Set the width of the crop area in points. Must be a positive integer number or 0.
-        # * +height+ - Set the height of the crop area in points. Must be a positive integer number or 0.
+        # * +x+ - Set the top left X coordinate of the crop area in points. Must be a positive integer or 0.
+        # * +y+ - Set the top left Y coordinate of the crop area in points. Must be a positive integer or 0.
+        # * +width+ - Set the width of the crop area in points. Must be a positive integer or 0.
+        # * +height+ - Set the height of the crop area in points. Must be a positive integer or 0.
         # * *Returns* - The converter object.
         def setCropArea(x, y, width, height)
             setCropAreaX(x)
@@ -6413,6 +6513,15 @@ module Pdfcrowd
             self
         end
 
+        # Specifies the User-Agent HTTP header that the client library will use when interacting with the API.
+        #
+        # * +agent+ - The user agent string.
+        # * *Returns* - The converter object.
+        def setClientUserAgent(agent)
+            @helper.setUserAgent(agent)
+            self
+        end
+
         # Set a custom user agent HTTP header. It can be useful if you are behind a proxy or a firewall.
         #
         # * +agent+ - The user agent string.
@@ -6464,11 +6573,11 @@ module Pdfcrowd
 
         # Convert an image.
         #
-        # * +url+ - The address of the image to convert. The supported protocols are http:// and https://.
+        # * +url+ - The address of the image to convert. Supported protocols are http:// and https://.
         # * *Returns* - Byte array containing the conversion output.
         def convertUrl(url)
             unless /(?i)^https?:\/\/.*$/.match(url)
-                raise Error.new(Pdfcrowd.create_invalid_value_message(url, "convertUrl", "pdf-to-image", "The supported protocols are http:// and https://.", "convert_url"), 470);
+                raise Error.new(Pdfcrowd.create_invalid_value_message(url, "convertUrl", "pdf-to-image", "Supported protocols are http:// and https://.", "convert_url"), 470);
             end
             
             @fields['url'] = url
@@ -6477,11 +6586,11 @@ module Pdfcrowd
 
         # Convert an image and write the result to an output stream.
         #
-        # * +url+ - The address of the image to convert. The supported protocols are http:// and https://.
+        # * +url+ - The address of the image to convert. Supported protocols are http:// and https://.
         # * +out_stream+ - The output stream that will contain the conversion output.
         def convertUrlToStream(url, out_stream)
             unless /(?i)^https?:\/\/.*$/.match(url)
-                raise Error.new(Pdfcrowd.create_invalid_value_message(url, "convertUrlToStream::url", "pdf-to-image", "The supported protocols are http:// and https://.", "convert_url_to_stream"), 470);
+                raise Error.new(Pdfcrowd.create_invalid_value_message(url, "convertUrlToStream::url", "pdf-to-image", "Supported protocols are http:// and https://.", "convert_url_to_stream"), 470);
             end
             
             @fields['url'] = url
@@ -6490,7 +6599,7 @@ module Pdfcrowd
 
         # Convert an image and write the result to a local file.
         #
-        # * +url+ - The address of the image to convert. The supported protocols are http:// and https://.
+        # * +url+ - The address of the image to convert. Supported protocols are http:// and https://.
         # * +file_path+ - The output file path. The string must not be empty.
         def convertUrlToFile(url, file_path)
             if (!(!file_path.nil? && !file_path.empty?))
@@ -6700,11 +6809,11 @@ module Pdfcrowd
 
         # Set the top left X coordinate of the crop area in points.
         #
-        # * +x+ - Must be a positive integer number or 0.
+        # * +x+ - Must be a positive integer or 0.
         # * *Returns* - The converter object.
         def setCropAreaX(x)
             if (!(Integer(x) >= 0))
-                raise Error.new(Pdfcrowd.create_invalid_value_message(x, "setCropAreaX", "pdf-to-image", "Must be a positive integer number or 0.", "set_crop_area_x"), 470);
+                raise Error.new(Pdfcrowd.create_invalid_value_message(x, "setCropAreaX", "pdf-to-image", "Must be a positive integer or 0.", "set_crop_area_x"), 470);
             end
             
             @fields['crop_area_x'] = x
@@ -6713,11 +6822,11 @@ module Pdfcrowd
 
         # Set the top left Y coordinate of the crop area in points.
         #
-        # * +y+ - Must be a positive integer number or 0.
+        # * +y+ - Must be a positive integer or 0.
         # * *Returns* - The converter object.
         def setCropAreaY(y)
             if (!(Integer(y) >= 0))
-                raise Error.new(Pdfcrowd.create_invalid_value_message(y, "setCropAreaY", "pdf-to-image", "Must be a positive integer number or 0.", "set_crop_area_y"), 470);
+                raise Error.new(Pdfcrowd.create_invalid_value_message(y, "setCropAreaY", "pdf-to-image", "Must be a positive integer or 0.", "set_crop_area_y"), 470);
             end
             
             @fields['crop_area_y'] = y
@@ -6726,11 +6835,11 @@ module Pdfcrowd
 
         # Set the width of the crop area in points.
         #
-        # * +width+ - Must be a positive integer number or 0.
+        # * +width+ - Must be a positive integer or 0.
         # * *Returns* - The converter object.
         def setCropAreaWidth(width)
             if (!(Integer(width) >= 0))
-                raise Error.new(Pdfcrowd.create_invalid_value_message(width, "setCropAreaWidth", "pdf-to-image", "Must be a positive integer number or 0.", "set_crop_area_width"), 470);
+                raise Error.new(Pdfcrowd.create_invalid_value_message(width, "setCropAreaWidth", "pdf-to-image", "Must be a positive integer or 0.", "set_crop_area_width"), 470);
             end
             
             @fields['crop_area_width'] = width
@@ -6739,11 +6848,11 @@ module Pdfcrowd
 
         # Set the height of the crop area in points.
         #
-        # * +height+ - Must be a positive integer number or 0.
+        # * +height+ - Must be a positive integer or 0.
         # * *Returns* - The converter object.
         def setCropAreaHeight(height)
             if (!(Integer(height) >= 0))
-                raise Error.new(Pdfcrowd.create_invalid_value_message(height, "setCropAreaHeight", "pdf-to-image", "Must be a positive integer number or 0.", "set_crop_area_height"), 470);
+                raise Error.new(Pdfcrowd.create_invalid_value_message(height, "setCropAreaHeight", "pdf-to-image", "Must be a positive integer or 0.", "set_crop_area_height"), 470);
             end
             
             @fields['crop_area_height'] = height
@@ -6752,10 +6861,10 @@ module Pdfcrowd
 
         # Set the crop area. It allows to extract just a part of a PDF page.
         #
-        # * +x+ - Set the top left X coordinate of the crop area in points. Must be a positive integer number or 0.
-        # * +y+ - Set the top left Y coordinate of the crop area in points. Must be a positive integer number or 0.
-        # * +width+ - Set the width of the crop area in points. Must be a positive integer number or 0.
-        # * +height+ - Set the height of the crop area in points. Must be a positive integer number or 0.
+        # * +x+ - Set the top left X coordinate of the crop area in points. Must be a positive integer or 0.
+        # * +y+ - Set the top left Y coordinate of the crop area in points. Must be a positive integer or 0.
+        # * +width+ - Set the width of the crop area in points. Must be a positive integer or 0.
+        # * +height+ - Set the height of the crop area in points. Must be a positive integer or 0.
         # * *Returns* - The converter object.
         def setCropArea(x, y, width, height)
             setCropAreaX(x)
@@ -6873,6 +6982,15 @@ module Pdfcrowd
             self
         end
 
+        # Specifies the User-Agent HTTP header that the client library will use when interacting with the API.
+        #
+        # * +agent+ - The user agent string.
+        # * *Returns* - The converter object.
+        def setClientUserAgent(agent)
+            @helper.setUserAgent(agent)
+            self
+        end
+
         # Set a custom user agent HTTP header. It can be useful if you are behind a proxy or a firewall.
         #
         # * +agent+ - The user agent string.