Class: Pdfcrowd::HtmlToPdfClient
- Inherits:
-
Object
- Object
- Pdfcrowd::HtmlToPdfClient
- Defined in:
- lib/pdfcrowd.rb
Overview
Conversion from HTML to PDF.
Instance Method Summary collapse
-
#convertFile(file) ⇒ Object
Convert a local file.
-
#convertFileToFile(file, file_path) ⇒ Object
Convert a local file and write the result to a local file.
-
#convertFileToStream(file, out_stream) ⇒ Object
Convert a local file and write the result to an output stream.
-
#convertStream(in_stream) ⇒ Object
Convert the contents of an input stream.
-
#convertStreamToFile(in_stream, file_path) ⇒ Object
Convert the contents of an input stream and write the result to a local file.
-
#convertStreamToStream(in_stream, out_stream) ⇒ Object
Convert the contents of an input stream and write the result to an output stream.
-
#convertString(text) ⇒ Object
Convert a string.
-
#convertStringToFile(text, file_path) ⇒ Object
Convert a string and write the output to a file.
-
#convertStringToStream(text, out_stream) ⇒ Object
Convert a string and write the output to an output stream.
-
#convertUrl(url) ⇒ Object
Convert a web page.
-
#convertUrlToFile(url, file_path) ⇒ Object
Convert a web page and write the result to a local file.
-
#convertUrlToStream(url, out_stream) ⇒ Object
Convert a web page and write the result to an output stream.
-
#getConsumedCreditCount ⇒ Object
Get the number of credits consumed by the last conversion.
-
#getDebugLogUrl ⇒ Object
Get the URL of the debug log for the last conversion.
-
#getJobId ⇒ Object
Get the job id.
-
#getOutputSize ⇒ Object
Get the size of the output in bytes.
-
#getPageCount ⇒ Object
Get the number of pages in the output document.
-
#getRemainingCreditCount ⇒ Object
Get the number of conversion credits available in your account.
-
#getTotalPageCount ⇒ Object
Get the total number of pages in the original output document, including the pages excluded by setPrintPageRange().
-
#getVersion ⇒ Object
Get the version details.
-
#initialize(user_name, api_key) ⇒ HtmlToPdfClient
constructor
Constructor for the Pdfcrowd API client.
-
#setAuthor(author) ⇒ Object
Set the author of the PDF.
-
#setAutoDetectElementToConvert(value) ⇒ Object
The main HTML element for conversion is detected automatically.
-
#setBlockAds(value) ⇒ Object
Try to block ads.
-
#setCenterWindow(value) ⇒ Object
Specify whether to position the document’s window in the center of the screen.
-
#setClientCertificate(certificate) ⇒ Object
A client certificate to authenticate Pdfcrowd converter on your web server.
-
#setClientCertificatePassword(password) ⇒ Object
A password for PKCS12 file with a client certificate if it is needed.
-
#setContentArea(x, y, width, height) ⇒ Object
Set the content area position and size.
-
#setContentAreaHeight(height) ⇒ Object
Set the height of the content area.
-
#setContentAreaWidth(width) ⇒ Object
Set the width of the content area.
-
#setContentAreaX(x) ⇒ Object
Set the top left X coordinate of the content area.
-
#setContentAreaY(y) ⇒ Object
Set the top left Y coordinate of the content area.
-
#setContentsMatrix(matrix) ⇒ Object
A 2D transformation matrix applied to the main contents on each page.
-
#setConverterVersion(version) ⇒ Object
Set the converter version.
-
#setConvertImagesToJpeg(images) ⇒ Object
Specify which image types will be converted to JPEG.
-
#setCookies(cookies) ⇒ Object
Set cookies that are sent in Pdfcrowd HTTP requests.
-
#setCssPageRuleMode(mode) ⇒ Object
Specifies behavior in presence of CSS @page rules.
-
#setCustomHttpHeader(header) ⇒ Object
Set a custom HTTP header that is sent in Pdfcrowd HTTP requests.
-
#setCustomJavascript(javascript) ⇒ Object
Run a custom JavaScript after the document is loaded and ready to print.
-
#setDataAutoEscape(value) ⇒ Object
Auto escape HTML symbols in the input data before placing them into the output.
-
#setDataEncoding(encoding) ⇒ Object
Set the encoding of the data file set by setDataFile.
-
#setDataFile(data_file) ⇒ Object
Load the input data for template rendering from the specified file.
-
#setDataFormat(data_format) ⇒ Object
Specify the input data format.
-
#setDataIgnoreUndefined(value) ⇒ Object
Ignore undefined variables in the HTML template.
-
#setDataOptions(options) ⇒ Object
Set the advanced data options:csv_delimiter - The CSV data delimiter, the default is ,.xml_remove_root - Remove the root XML element from the input data.data_root - The name of the root element inserted into the input data without a root node (e.g. CSV), the default is data.
-
#setDataString(data_string) ⇒ Object
Set the input data for template rendering.
-
#setDataTrimBlocks(value) ⇒ Object
Auto trim whitespace around each template command block.
-
#setDebugLog(value) ⇒ Object
Turn on the debug logging.
-
#setDefaultEncoding(encoding) ⇒ Object
Set the default HTML content text encoding.
-
#setDisableImageLoading(value) ⇒ Object
Do not load images.
-
#setDisableJavascript(value) ⇒ Object
Do not execute JavaScript.
-
#setDisablePageHeightOptimization(value) ⇒ Object
Disable automatic height adjustment that compensates for pixel to point rounding errors.
-
#setDisableRemoteFonts(value) ⇒ Object
Disable loading fonts from remote sources.
-
#setDisplayTitle(value) ⇒ Object
Specify whether the window’s title bar should display the document title.
-
#setElementToConvert(selectors) ⇒ Object
Convert only the specified element from the main document and its children.
-
#setElementToConvertMode(mode) ⇒ Object
Specify the DOM handling when only a part of the document is converted.
-
#setEnablePdfForms(value) ⇒ Object
Convert HTML forms to fillable PDF forms.
-
#setEncrypt(value) ⇒ Object
Encrypt the PDF.
-
#setExcludeFooterOnPages(pages) ⇒ Object
The page footer is not printed on the specified pages.
-
#setExcludeHeaderOnPages(pages) ⇒ Object
The page header is not printed on the specified pages.
-
#setExtractMetaTags(value) ⇒ Object
Extract meta tags (author, keywords and description) from the input HTML and use them in the output PDF.
-
#setFailOnAnyUrlError(fail_on_error) ⇒ Object
Abort the conversion if any of the sub-request HTTP status code is greater than or equal to 400 or if some sub-requests are still pending.
-
#setFailOnMainUrlError(fail_on_error) ⇒ Object
Abort the conversion if the main URL HTTP status code is greater than or equal to 400.
-
#setFitWindow(value) ⇒ Object
Specify whether to resize the document’s window to fit the size of the first displayed page.
-
#setFooterHeight(height) ⇒ Object
Set the footer height.
-
#setFooterHtml(html) ⇒ Object
Use the specified HTML as the page footer.
-
#setFooterMatrix(matrix) ⇒ Object
A 2D transformation matrix applied to the page footer contents.
-
#setFooterUrl(url) ⇒ Object
Load an HTML code from the specified URL and use it as the page footer.
-
#setHeaderFooterCssAnnotation(value) ⇒ Object
Add special CSS classes to the header/footer’s body element.
-
#setHeaderFooterScaleFactor(factor) ⇒ Object
Set the scaling factor (zoom) for the header and footer.
-
#setHeaderHeight(height) ⇒ Object
Set the header height.
-
#setHeaderHtml(html) ⇒ Object
Use the specified HTML code as the page header.
-
#setHeaderMatrix(matrix) ⇒ Object
A 2D transformation matrix applied to the page header contents.
-
#setHeaderUrl(url) ⇒ Object
Load an HTML code from the specified URL and use it as the page header.
-
#setHideMenubar(value) ⇒ Object
Specify whether to hide the viewer application’s menu bar when the document is active.
-
#setHideToolbar(value) ⇒ Object
Specify whether to hide the viewer application’s tool bars when the document is active.
-
#setHideWindowUi(value) ⇒ Object
Specify whether to hide user interface elements in the document’s window (such as scroll bars and navigation controls), leaving only the document’s contents displayed.
-
#setHttpAuth(user_name, password) ⇒ Object
Set credentials to access HTTP base authentication protected websites.
-
#setHttpAuthPassword(password) ⇒ Object
Set the HTTP authentication password.
-
#setHttpAuthUserName(user_name) ⇒ Object
Set the HTTP authentication user name.
-
#setHttpProxy(proxy) ⇒ Object
A proxy server used by Pdfcrowd conversion process for accessing the source URLs with HTTP scheme.
-
#setHttpsProxy(proxy) ⇒ Object
A proxy server used by Pdfcrowd conversion process for accessing the source URLs with HTTPS scheme.
-
#setImageDpi(dpi) ⇒ Object
Set the DPI of images in PDF.
-
#setInitialPage(page) ⇒ Object
Display the specified page when the document is opened.
-
#setInitialZoom(zoom) ⇒ Object
Specify the initial page zoom in percents when the document is opened.
-
#setInitialZoomType(zoom_type) ⇒ Object
Specify how the page should be displayed when opened.
-
#setJavascriptDelay(delay) ⇒ Object
Wait the specified number of milliseconds to finish all JavaScript after the document is loaded.
-
#setJpegQuality(quality) ⇒ Object
Set the quality of embedded JPEG images.
-
#setKeywords(keywords) ⇒ Object
Associate keywords with the document.
-
#setLayoutDpi(dpi) ⇒ Object
Set the internal DPI resolution used for positioning of PDF contents.
-
#setLinearize(value) ⇒ Object
Create linearized PDF.
-
#setLoadIframes(iframes) ⇒ Object
Specifies how iframes are handled.
-
#setLocale(locale) ⇒ Object
Set the locale for the conversion.
-
#setMainDocumentCssAnnotation(value) ⇒ Object
Add special CSS classes to the main document’s body element.
-
#setMarginBottom(bottom) ⇒ Object
Set the output page bottom margin.
-
#setMarginLeft(left) ⇒ Object
Set the output page left margin.
-
#setMarginRight(right) ⇒ Object
Set the output page right margin.
-
#setMarginTop(top) ⇒ Object
Set the output page top margin.
-
#setMultipageBackground(background) ⇒ Object
Apply each page of a background to the corresponding page of the output PDF.
-
#setMultipageBackgroundUrl(url) ⇒ Object
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.
-
#setMultipageWatermark(watermark) ⇒ Object
Apply each page of a watermark to the corresponding page of the output PDF.
-
#setMultipageWatermarkUrl(url) ⇒ Object
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.
-
#setNoBackground(value) ⇒ Object
Do not print the background graphics.
-
#setNoCopy(value) ⇒ Object
Disallow text and graphics extraction from the output PDF.
-
#setNoHeaderFooterHorizontalMargins(value) ⇒ Object
Disable horizontal page margins for header and footer.
-
#setNoMargins(value) ⇒ Object
Disable page margins.
-
#setNoModify(value) ⇒ Object
Disallow modification of the output PDF.
-
#setNoPrint(value) ⇒ Object
Disallow printing of the output PDF.
-
#setNoXpdfcrowdHeader(value) ⇒ Object
Do not send the X-Pdfcrowd HTTP header in Pdfcrowd HTTP requests.
-
#setOnLoadJavascript(javascript) ⇒ Object
Run a custom JavaScript right after the document is loaded.
-
#setOrientation(orientation) ⇒ Object
Set the output page orientation.
-
#setOwnerPassword(password) ⇒ Object
Protect the PDF with an owner password.
-
#setPageBackground(background) ⇒ Object
Apply a background to each page of the output PDF file.
-
#setPageBackgroundColor(color) ⇒ Object
The page background color in RGB or RGBA hexadecimal format.
-
#setPageBackgroundUrl(url) ⇒ Object
Load a file from the specified URL and apply the file as a background to each page of the output PDF.
-
#setPageDimensions(width, height) ⇒ Object
Set the output page dimensions.
-
#setPageHeight(height) ⇒ Object
Set the output page height.
-
#setPageLayout(layout) ⇒ Object
Specify the page layout to be used when the document is opened.
-
#setPageMargins(top, right, bottom, left) ⇒ Object
Set the output page margins.
-
#setPageMode(mode) ⇒ Object
Specify how the document should be displayed when opened.
-
#setPageNumberingOffset(offset) ⇒ Object
Set an offset between physical and logical page numbers.
-
#setPageSize(size) ⇒ Object
Set the output page size.
-
#setPageWatermark(watermark) ⇒ Object
Apply a watermark to each page of the output PDF file.
-
#setPageWatermarkUrl(url) ⇒ Object
Load a file from the specified URL and apply the file as a watermark to each page of the output PDF.
-
#setPageWidth(width) ⇒ Object
Set the output page width.
-
#setPrintPageRange(pages) ⇒ Object
Set the page range to print.
-
#setProxy(host, port, user_name, password) ⇒ Object
Specifies an HTTP proxy that the API client library will use to connect to the internet.
-
#setReadabilityEnhancements(enhancements) ⇒ Object
The input HTML is automatically enhanced to improve the readability.
-
#setRenderingMode(mode) ⇒ Object
Set the rendering mode.
-
#setRetryCount(count) ⇒ Object
Specifies the number of automatic retries when the 502 HTTP status code is received.
-
#setRightToLeft(value) ⇒ Object
Set the predominant reading order for text to right-to-left.
-
#setScaleFactor(factor) ⇒ Object
Set the scaling factor (zoom) for the main page area.
-
#setSmartScalingMode(mode) ⇒ Object
Specifies the scaling mode used for fitting the HTML contents to the print area.
-
#setSubject(subject) ⇒ Object
Set the subject of the PDF.
-
#setTag(tag) ⇒ Object
Tag the conversion with a custom value.
-
#setTitle(title) ⇒ Object
Set the title of the PDF.
-
#setUseHttp(value) ⇒ Object
Specifies if the client communicates over HTTP or HTTPS with Pdfcrowd API.
-
#setUseMobileUserAgent(value) ⇒ Object
Use a mobile user agent.
-
#setUsePrintMedia(value) ⇒ Object
Use the print version of the page if available (@media print).
-
#setUserAgent(agent) ⇒ Object
Set a custom user agent HTTP header.
-
#setUserPassword(password) ⇒ Object
Protect the PDF with a user password.
-
#setVerifySslCertificates(value) ⇒ Object
Do not allow insecure HTTPS connections.
-
#setViewport(width, height) ⇒ Object
Set the viewport size.
-
#setViewportHeight(height) ⇒ Object
Set the viewport height in pixels.
-
#setViewportWidth(width) ⇒ Object
Set the viewport width in pixels.
-
#setWaitForElement(selectors) ⇒ Object
Wait for the specified element in a source document.
-
#setZipFooterFilename(filename) ⇒ Object
Set the file name of the footer HTML document stored in the input archive.
-
#setZipHeaderFilename(filename) ⇒ Object
Set the file name of the header HTML document stored in the input archive.
-
#setZipMainFilename(filename) ⇒ Object
Set the file name of the main HTML document stored in the input archive.
Constructor Details
#initialize(user_name, api_key) ⇒ HtmlToPdfClient
Constructor for the Pdfcrowd API client.
-
user_name
- Your username at Pdfcrowd. -
api_key
- Your API key.
755 756 757 758 759 760 761 762 763 764 |
# File 'lib/pdfcrowd.rb', line 755 def initialize(user_name, api_key) @helper = ConnectionHelper.new(user_name, api_key) @fields = { 'input_format'=>'html', 'output_format'=>'pdf' } @file_id = 1 @files = {} @raw_data = {} end |
Instance Method Details
#convertFile(file) ⇒ Object
Convert a local file.
-
file
- The path to a local file to convert. The file can be either a single file or an archive (.tar.gz, .tar.bz2, or .zip). If the HTML document refers to local external assets (images, style sheets, javascript), zip the document together with the assets. The file must exist and not be empty. The file name must have a valid extension. -
Returns - Byte array containing the conversion output.
816 817 818 819 820 821 822 823 |
# File 'lib/pdfcrowd.rb', line 816 def convertFile(file) if (!(File.file?(file) && !File.zero?(file))) raise Error.new(Pdfcrowd.(file, "convertFile", "html-to-pdf", "The file must exist and not be empty.", "convert_file"), 470); end @files['file'] = file @helper.post(@fields, @files, @raw_data) end |
#convertFileToFile(file, file_path) ⇒ Object
Convert a local file and write the result to a local file.
-
file
- The path to a local file to convert. The file can be either a single file or an archive (.tar.gz, .tar.bz2, or .zip). If the HTML document refers to local external assets (images, style sheets, javascript), zip the document together with the assets. The file must exist and not be empty. The file name must have a valid extension. -
file_path
- The output file path. The string must not be empty.
842 843 844 845 846 847 848 849 850 851 852 853 854 855 856 |
# File 'lib/pdfcrowd.rb', line 842 def convertFileToFile(file, file_path) if (!(!file_path.nil? && !file_path.empty?)) raise Error.new(Pdfcrowd.(file_path, "convertFileToFile::file_path", "html-to-pdf", "The string must not be empty.", "convert_file_to_file"), 470); end output_file = open(file_path, "wb") begin convertFileToStream(file, output_file) output_file.close() rescue Error => why output_file.close() FileUtils.rm(file_path) raise end end |
#convertFileToStream(file, out_stream) ⇒ Object
Convert a local file and write the result to an output stream.
-
file
- The path to a local file to convert. The file can be either a single file or an archive (.tar.gz, .tar.bz2, or .zip). If the HTML document refers to local external assets (images, style sheets, javascript), zip the document together with the assets. The file must exist and not be empty. The file name must have a valid extension. -
out_stream
- The output stream that will contain the conversion output.
829 830 831 832 833 834 835 836 |
# File 'lib/pdfcrowd.rb', line 829 def convertFileToStream(file, out_stream) if (!(File.file?(file) && !File.zero?(file))) raise Error.new(Pdfcrowd.(file, "convertFileToStream::file", "html-to-pdf", "The file must exist and not be empty.", "convert_file_to_stream"), 470); end @files['file'] = file @helper.post(@fields, @files, @raw_data, out_stream) end |
#convertStream(in_stream) ⇒ Object
Convert the contents of an input stream.
-
in_stream
- The input stream with source data. The stream can contain either HTML code or an archive (.zip, .tar.gz, .tar.bz2).The archive can contain HTML code and its external assets (images, style sheets, javascript). -
Returns - Byte array containing the conversion output.
908 909 910 911 |
# File 'lib/pdfcrowd.rb', line 908 def convertStream(in_stream) @raw_data['stream'] = in_stream.read @helper.post(@fields, @files, @raw_data) end |
#convertStreamToFile(in_stream, file_path) ⇒ Object
Convert the contents of an input stream and write the result to a local file.
-
in_stream
- The input stream with source data. The stream can contain either HTML code or an archive (.zip, .tar.gz, .tar.bz2).The archive can contain HTML code and its external assets (images, style sheets, javascript). -
file_path
- The output file path. The string must not be empty.
926 927 928 929 930 931 932 933 934 935 936 937 938 939 940 |
# File 'lib/pdfcrowd.rb', line 926 def convertStreamToFile(in_stream, file_path) if (!(!file_path.nil? && !file_path.empty?)) raise Error.new(Pdfcrowd.(file_path, "convertStreamToFile::file_path", "html-to-pdf", "The string must not be empty.", "convert_stream_to_file"), 470); end output_file = open(file_path, "wb") begin convertStreamToStream(in_stream, output_file) output_file.close() rescue Error => why output_file.close() FileUtils.rm(file_path) raise end end |
#convertStreamToStream(in_stream, out_stream) ⇒ Object
Convert the contents of an input stream and write the result to an output stream.
-
in_stream
- The input stream with source data. The stream can contain either HTML code or an archive (.zip, .tar.gz, .tar.bz2).The archive can contain HTML code and its external assets (images, style sheets, javascript). -
out_stream
- The output stream that will contain the conversion output.
917 918 919 920 |
# File 'lib/pdfcrowd.rb', line 917 def convertStreamToStream(in_stream, out_stream) @raw_data['stream'] = in_stream.read @helper.post(@fields, @files, @raw_data, out_stream) end |
#convertString(text) ⇒ Object
Convert a string.
-
text
- The string content to convert. The string must not be empty. -
Returns - Byte array containing the conversion output.
862 863 864 865 866 867 868 869 |
# File 'lib/pdfcrowd.rb', line 862 def convertString(text) if (!(!text.nil? && !text.empty?)) raise Error.new(Pdfcrowd.(text, "convertString", "html-to-pdf", "The string must not be empty.", "convert_string"), 470); end @fields['text'] = text @helper.post(@fields, @files, @raw_data) end |
#convertStringToFile(text, file_path) ⇒ Object
Convert a string and write the output to a file.
-
text
- The string content to convert. The string must not be empty. -
file_path
- The output file path. The string must not be empty.
888 889 890 891 892 893 894 895 896 897 898 899 900 901 902 |
# File 'lib/pdfcrowd.rb', line 888 def convertStringToFile(text, file_path) if (!(!file_path.nil? && !file_path.empty?)) raise Error.new(Pdfcrowd.(file_path, "convertStringToFile::file_path", "html-to-pdf", "The string must not be empty.", "convert_string_to_file"), 470); end output_file = open(file_path, "wb") begin convertStringToStream(text, output_file) output_file.close() rescue Error => why output_file.close() FileUtils.rm(file_path) raise end end |
#convertStringToStream(text, out_stream) ⇒ Object
Convert a string and write the output to an output stream.
-
text
- The string content to convert. The string must not be empty. -
out_stream
- The output stream that will contain the conversion output.
875 876 877 878 879 880 881 882 |
# File 'lib/pdfcrowd.rb', line 875 def convertStringToStream(text, out_stream) if (!(!text.nil? && !text.empty?)) raise Error.new(Pdfcrowd.(text, "convertStringToStream::text", "html-to-pdf", "The string must not be empty.", "convert_string_to_stream"), 470); end @fields['text'] = text @helper.post(@fields, @files, @raw_data, out_stream) end |
#convertUrl(url) ⇒ Object
Convert a web page.
-
url
- The address of the web page to convert. The supported protocols are http:// and https://. -
Returns - Byte array containing the conversion output.
770 771 772 773 774 775 776 777 |
# File 'lib/pdfcrowd.rb', line 770 def convertUrl(url) unless /(?i)^https?:\/\/.*$/.match(url) raise Error.new(Pdfcrowd.(url, "convertUrl", "html-to-pdf", "The supported protocols are http:// and https://.", "convert_url"), 470); end @fields['url'] = url @helper.post(@fields, @files, @raw_data) end |
#convertUrlToFile(url, file_path) ⇒ Object
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://. -
file_path
- The output file path. The string must not be empty.
796 797 798 799 800 801 802 803 804 805 806 807 808 809 810 |
# File 'lib/pdfcrowd.rb', line 796 def convertUrlToFile(url, file_path) if (!(!file_path.nil? && !file_path.empty?)) raise Error.new(Pdfcrowd.(file_path, "convertUrlToFile::file_path", "html-to-pdf", "The string must not be empty.", "convert_url_to_file"), 470); end output_file = open(file_path, "wb") begin convertUrlToStream(url, output_file) output_file.close() rescue Error => why output_file.close() FileUtils.rm(file_path) raise end end |
#convertUrlToStream(url, out_stream) ⇒ Object
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://. -
out_stream
- The output stream that will contain the conversion output.
783 784 785 786 787 788 789 790 |
# File 'lib/pdfcrowd.rb', line 783 def convertUrlToStream(url, out_stream) unless /(?i)^https?:\/\/.*$/.match(url) raise Error.new(Pdfcrowd.(url, "convertUrlToStream::url", "html-to-pdf", "The supported protocols are http:// and https://.", "convert_url_to_stream"), 470); end @fields['url'] = url @helper.post(@fields, @files, @raw_data, out_stream) end |
#getConsumedCreditCount ⇒ Object
Get the number of credits consumed by the last conversion.
-
Returns - The number of credits.
2196 2197 2198 |
# File 'lib/pdfcrowd.rb', line 2196 def getConsumedCreditCount() return @helper.getConsumedCreditCount() end |
#getDebugLogUrl ⇒ Object
Get the URL of the debug log for the last conversion.
-
Returns - The link to the debug log.
2181 2182 2183 |
# File 'lib/pdfcrowd.rb', line 2181 def getDebugLogUrl() return @helper.getDebugLogUrl() end |
#getJobId ⇒ Object
Get the job id.
-
Returns - The unique job identifier.
2202 2203 2204 |
# File 'lib/pdfcrowd.rb', line 2202 def getJobId() return @helper.getJobId() end |
#getOutputSize ⇒ Object
Get the size of the output in bytes.
-
Returns - The count of bytes.
2220 2221 2222 |
# File 'lib/pdfcrowd.rb', line 2220 def getOutputSize() return @helper.getOutputSize() end |
#getPageCount ⇒ Object
Get the number of pages in the output document.
-
Returns - The page count.
2208 2209 2210 |
# File 'lib/pdfcrowd.rb', line 2208 def getPageCount() return @helper.getPageCount() end |
#getRemainingCreditCount ⇒ Object
Get the number of conversion credits available in your account. This method can only be called after a call to one of the convertXtoY methods. The returned value can differ from the actual count if you run parallel conversions. The special value 999999 is returned if the information is not available.
-
Returns - The number of credits.
2190 2191 2192 |
# File 'lib/pdfcrowd.rb', line 2190 def getRemainingCreditCount() return @helper.getRemainingCreditCount() end |
#getTotalPageCount ⇒ Object
Get the total number of pages in the original output document, including the pages excluded by setPrintPageRange().
-
Returns - The total page count.
2214 2215 2216 |
# File 'lib/pdfcrowd.rb', line 2214 def getTotalPageCount() return @helper.getTotalPageCount() end |
#getVersion ⇒ Object
Get the version details.
-
Returns - API version, converter version, and client version.
2226 2227 2228 |
# File 'lib/pdfcrowd.rb', line 2226 def getVersion() return "client " + CLIENT_VERSION + ", API v2, converter " + @helper.getConverterVersion() end |
#setAuthor(author) ⇒ Object
Set the author of the PDF.
-
author
- The author. -
Returns - The converter object.
1943 1944 1945 1946 |
# File 'lib/pdfcrowd.rb', line 1943 def setAuthor() @fields['author'] = self end |
#setAutoDetectElementToConvert(value) ⇒ Object
The main HTML element for conversion is detected automatically.
-
value
- Set to true to detect the main element. -
Returns - The converter object.
1716 1717 1718 1719 |
# File 'lib/pdfcrowd.rb', line 1716 def setAutoDetectElementToConvert(value) @fields['auto_detect_element_to_convert'] = value self end |
#setBlockAds(value) ⇒ Object
Try to block ads. Enabling this option can produce smaller output and speed up the conversion.
-
value
- Set to true to block ads in web pages. -
Returns - The converter object.
1524 1525 1526 1527 |
# File 'lib/pdfcrowd.rb', line 1524 def setBlockAds(value) @fields['block_ads'] = value self end |
#setCenterWindow(value) ⇒ Object
Specify whether to position the document’s window in the center of the screen.
-
value
- Set to true to center the window. -
Returns - The converter object.
2071 2072 2073 2074 |
# File 'lib/pdfcrowd.rb', line 2071 def setCenterWindow(value) @fields['center_window'] = value self end |
#setClientCertificate(certificate) ⇒ Object
A client certificate to authenticate Pdfcrowd converter on your web server. The certificate is used for two-way SSL/TLS authentication and adds extra security.
-
certificate
- The file must be in PKCS12 format. The file must exist and not be empty. -
Returns - The converter object.
2269 2270 2271 2272 2273 2274 2275 2276 |
# File 'lib/pdfcrowd.rb', line 2269 def setClientCertificate(certificate) if (!(File.file?(certificate) && !File.zero?(certificate))) raise Error.new(Pdfcrowd.(certificate, "setClientCertificate", "html-to-pdf", "The file must exist and not be empty.", "set_client_certificate"), 470); end @files['client_certificate'] = certificate self end |
#setClientCertificatePassword(password) ⇒ Object
A password for PKCS12 file with a client certificate if it is needed.
-
password
- -
Returns - The converter object.
2282 2283 2284 2285 |
# File 'lib/pdfcrowd.rb', line 2282 def setClientCertificatePassword(password) @fields['client_certificate_password'] = password self end |
#setContentArea(x, y, width, height) ⇒ Object
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”. -
Returns - The converter object.
1171 1172 1173 1174 1175 1176 1177 |
# File 'lib/pdfcrowd.rb', line 1171 def setContentArea(x, y, width, height) setContentAreaX(x) setContentAreaY(y) setContentAreaWidth(width) setContentAreaHeight(height) self end |
#setContentAreaHeight(height) ⇒ Object
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”. -
Returns - The converter object.
1155 1156 1157 1158 1159 1160 1161 1162 |
# File 'lib/pdfcrowd.rb', line 1155 def setContentAreaHeight(height) unless /(?i)^0$|^[0-9]*\.?[0-9]+(pt|px|mm|cm|in)$/.match(height) raise Error.new(Pdfcrowd.(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 self end |
#setContentAreaWidth(width) ⇒ Object
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”. -
Returns - The converter object.
1142 1143 1144 1145 1146 1147 1148 1149 |
# File 'lib/pdfcrowd.rb', line 1142 def setContentAreaWidth(width) unless /(?i)^0$|^[0-9]*\.?[0-9]+(pt|px|mm|cm|in)$/.match(width) raise Error.new(Pdfcrowd.(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 self end |
#setContentAreaX(x) ⇒ Object
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. -
Returns - The converter object.
1116 1117 1118 1119 1120 1121 1122 1123 |
# File 'lib/pdfcrowd.rb', line 1116 def setContentAreaX(x) unless /(?i)^0$|^\-?[0-9]*\.?[0-9]+(pt|px|mm|cm|in)$/.match(x) raise Error.new(Pdfcrowd.(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 self end |
#setContentAreaY(y) ⇒ Object
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. -
Returns - The converter object.
1129 1130 1131 1132 1133 1134 1135 1136 |
# File 'lib/pdfcrowd.rb', line 1129 def setContentAreaY(y) unless /(?i)^0$|^\-?[0-9]*\.?[0-9]+(pt|px|mm|cm|in)$/.match(y) raise Error.new(Pdfcrowd.(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 self end |
#setContentsMatrix(matrix) ⇒ Object
A 2D transformation matrix applied to the main contents on each page. The origin [0,0] is located at the top-left corner of the contents. The resolution is 72 dpi.
-
matrix
- A comma separated string of matrix elements: “scaleX,skewX,transX,skewY,scaleY,transY” -
Returns - The converter object.
2304 2305 2306 2307 |
# File 'lib/pdfcrowd.rb', line 2304 def setContentsMatrix(matrix) @fields['contents_matrix'] = matrix self end |
#setConverterVersion(version) ⇒ Object
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 latest, 20.10, 18.10. -
Returns - The converter object.
2359 2360 2361 2362 2363 2364 2365 2366 |
# File 'lib/pdfcrowd.rb', line 2359 def setConverterVersion(version) unless /(?i)^(latest|20.10|18.10)$/.match(version) raise Error.new(Pdfcrowd.(version, "setConverterVersion", "html-to-pdf", "Allowed values are latest, 20.10, 18.10.", "set_converter_version"), 470); end @helper.setConverterVersion(version) self end |
#setConvertImagesToJpeg(images) ⇒ Object
Specify which image types will be converted to JPEG. Converting lossless compression image formats (PNG, GIF, …) to JPEG may result in a smaller PDF file.
-
images
- The image category. Allowed values are none, opaque, all. -
Returns - The converter object.
1827 1828 1829 1830 1831 1832 1833 1834 |
# File 'lib/pdfcrowd.rb', line 1827 def setConvertImagesToJpeg(images) unless /(?i)^(none|opaque|all)$/.match(images) raise Error.new(Pdfcrowd.(images, "setConvertImagesToJpeg", "html-to-pdf", "Allowed values are none, opaque, all.", "set_convert_images_to_jpeg"), 470); end @fields['convert_images_to_jpeg'] = images self end |
#setCookies(cookies) ⇒ Object
Set cookies that are sent in Pdfcrowd HTTP requests.
-
cookies
- The cookie string. -
Returns - The converter object.
1580 1581 1582 1583 |
# File 'lib/pdfcrowd.rb', line 1580 def setCookies() @fields['cookies'] = self end |
#setCssPageRuleMode(mode) ⇒ Object
Specifies behavior in presence of CSS @page rules. It may affect the page size, margins and orientation.
-
mode
- The page rule mode. Allowed values are default, mode1, mode2. -
Returns - The converter object.
1183 1184 1185 1186 1187 1188 1189 1190 |
# File 'lib/pdfcrowd.rb', line 1183 def setCssPageRuleMode(mode) unless /(?i)^(default|mode1|mode2)$/.match(mode) raise Error.new(Pdfcrowd.(mode, "setCssPageRuleMode", "html-to-pdf", "Allowed values are default, mode1, mode2.", "set_css_page_rule_mode"), 470); end @fields['css_page_rule_mode'] = mode self end |
#setCustomHttpHeader(header) ⇒ Object
Set a custom HTTP header that is sent in Pdfcrowd HTTP requests.
-
header
- A string containing the header name and value separated by a colon. -
Returns - The converter object.
1651 1652 1653 1654 1655 1656 1657 1658 |
# File 'lib/pdfcrowd.rb', line 1651 def setCustomHttpHeader(header) unless /^.+:.+$/.match(header) raise Error.new(Pdfcrowd.(header, "setCustomHttpHeader", "html-to-pdf", "A string containing the header name and value separated by a colon.", "set_custom_http_header"), 470); end @fields['custom_http_header'] = header self end |
#setCustomJavascript(javascript) ⇒ Object
Run a custom JavaScript after the document is loaded and ready to print. The script is intended for post-load DOM manipulation (add/remove elements, update CSS, …). In addition to the standard browser APIs, the custom JavaScript code can use helper functions from our JavaScript library.
-
javascript
- A string containing a JavaScript code. The string must not be empty. -
Returns - The converter object.
1625 1626 1627 1628 1629 1630 1631 1632 |
# File 'lib/pdfcrowd.rb', line 1625 def setCustomJavascript(javascript) if (!(!javascript.nil? && !javascript.empty?)) raise Error.new(Pdfcrowd.(javascript, "setCustomJavascript", "html-to-pdf", "The string must not be empty.", "set_custom_javascript"), 470); end @fields['custom_javascript'] = javascript self end |
#setDataAutoEscape(value) ⇒ Object
Auto escape HTML symbols in the input data before placing them into the output.
-
value
- Set to true to turn auto escaping on. -
Returns - The converter object.
2147 2148 2149 2150 |
# File 'lib/pdfcrowd.rb', line 2147 def setDataAutoEscape(value) @fields['data_auto_escape'] = value self end |
#setDataEncoding(encoding) ⇒ Object
Set the encoding of the data file set by setDataFile.
-
encoding
- The data file encoding. -
Returns - The converter object.
2129 2130 2131 2132 |
# File 'lib/pdfcrowd.rb', line 2129 def setDataEncoding(encoding) @fields['data_encoding'] = encoding self end |
#setDataFile(data_file) ⇒ Object
Load the input data for template rendering from the specified file. The data format can be JSON, XML, YAML or CSV.
-
data_file
- The file path to a local file containing the input data. -
Returns - The converter object.
2107 2108 2109 2110 |
# File 'lib/pdfcrowd.rb', line 2107 def setDataFile(data_file) @files['data_file'] = data_file self end |
#setDataFormat(data_format) ⇒ Object
Specify the input data format.
-
data_format
- The data format. Allowed values are auto, json, xml, yaml, csv. -
Returns - The converter object.
2116 2117 2118 2119 2120 2121 2122 2123 |
# File 'lib/pdfcrowd.rb', line 2116 def setDataFormat(data_format) unless /(?i)^(auto|json|xml|yaml|csv)$/.match(data_format) raise Error.new(Pdfcrowd.(data_format, "setDataFormat", "html-to-pdf", "Allowed values are auto, json, xml, yaml, csv.", "set_data_format"), 470); end @fields['data_format'] = data_format self end |
#setDataIgnoreUndefined(value) ⇒ Object
Ignore undefined variables in the HTML template. The default mode is strict so any undefined variable causes the conversion to fail. You can use if variable is defined % to check if the variable is defined.
-
value
- Set to true to ignore undefined variables. -
Returns - The converter object.
2138 2139 2140 2141 |
# File 'lib/pdfcrowd.rb', line 2138 def setDataIgnoreUndefined(value) @fields['data_ignore_undefined'] = value self end |
#setDataOptions(options) ⇒ Object
Set the advanced data options:csv_delimiter - The CSV data delimiter, the default is ,.xml_remove_root - Remove the root XML element from the input data.data_root - The name of the root element inserted into the input data without a root node (e.g. CSV), the default is data.
-
options
- Comma separated list of options. -
Returns - The converter object.
2165 2166 2167 2168 |
# File 'lib/pdfcrowd.rb', line 2165 def setDataOptions() @fields['data_options'] = self end |
#setDataString(data_string) ⇒ Object
Set the input data for template rendering. The data format can be JSON, XML, YAML or CSV.
-
data_string
- The input data string. -
Returns - The converter object.
2098 2099 2100 2101 |
# File 'lib/pdfcrowd.rb', line 2098 def setDataString(data_string) @fields['data_string'] = data_string self end |
#setDataTrimBlocks(value) ⇒ Object
Auto trim whitespace around each template command block.
-
value
- Set to true to turn auto trimming on. -
Returns - The converter object.
2156 2157 2158 2159 |
# File 'lib/pdfcrowd.rb', line 2156 def setDataTrimBlocks(value) @fields['data_trim_blocks'] = value self end |
#setDebugLog(value) ⇒ Object
Turn on the debug logging. Details about the conversion are stored in the debug log. The URL of the log can be obtained from the getDebugLogUrl method or available in conversion statistics.
-
value
- Set to true to enable the debug logging. -
Returns - The converter object.
2174 2175 2176 2177 |
# File 'lib/pdfcrowd.rb', line 2174 def setDebugLog(value) @fields['debug_log'] = value self end |
#setDefaultEncoding(encoding) ⇒ Object
Set the default HTML content text encoding.
-
encoding
- The text encoding of the HTML content. -
Returns - The converter object.
1533 1534 1535 1536 |
# File 'lib/pdfcrowd.rb', line 1533 def setDefaultEncoding(encoding) @fields['default_encoding'] = encoding self end |
#setDisableImageLoading(value) ⇒ Object
Do not load images.
-
value
- Set to true to disable loading of images. -
Returns - The converter object.
1484 1485 1486 1487 |
# File 'lib/pdfcrowd.rb', line 1484 def setDisableImageLoading(value) @fields['disable_image_loading'] = value self end |
#setDisableJavascript(value) ⇒ Object
Do not execute JavaScript.
-
value
- Set to true to disable JavaScript in web pages. -
Returns - The converter object.
1475 1476 1477 1478 |
# File 'lib/pdfcrowd.rb', line 1475 def setDisableJavascript(value) @fields['disable_javascript'] = value self end |
#setDisablePageHeightOptimization(value) ⇒ Object
Disable automatic height adjustment that compensates for pixel to point rounding errors.
-
value
- Set to true to disable automatic height scale. -
Returns - The converter object.
2331 2332 2333 2334 |
# File 'lib/pdfcrowd.rb', line 2331 def setDisablePageHeightOptimization(value) @fields['disable_page_height_optimization'] = value self end |
#setDisableRemoteFonts(value) ⇒ Object
Disable loading fonts from remote sources.
-
value
- Set to true disable loading remote fonts. -
Returns - The converter object.
1493 1494 1495 1496 |
# File 'lib/pdfcrowd.rb', line 1493 def setDisableRemoteFonts(value) @fields['disable_remote_fonts'] = value self end |
#setDisplayTitle(value) ⇒ Object
Specify whether the window’s title bar should display the document title. If false , the title bar should instead display the name of the PDF file containing the document.
-
value
- Set to true to display the title. -
Returns - The converter object.
2080 2081 2082 2083 |
# File 'lib/pdfcrowd.rb', line 2080 def setDisplayTitle(value) @fields['display_title'] = value self end |
#setElementToConvert(selectors) ⇒ Object
Convert only the specified element from the main document and its children. The element is specified by one or more CSS selectors. If the element is not found, the conversion fails. If multiple elements are found, the first one is used.
-
selectors
- One or more CSS selectors separated by commas. The string must not be empty. -
Returns - The converter object.
1677 1678 1679 1680 1681 1682 1683 1684 |
# File 'lib/pdfcrowd.rb', line 1677 def setElementToConvert(selectors) if (!(!selectors.nil? && !selectors.empty?)) raise Error.new(Pdfcrowd.(selectors, "setElementToConvert", "html-to-pdf", "The string must not be empty.", "set_element_to_convert"), 470); end @fields['element_to_convert'] = selectors self end |
#setElementToConvertMode(mode) ⇒ Object
Specify the DOM handling when only a part of the document is converted. This can affect the CSS rules used.
-
mode
- Allowed values are cut-out, remove-siblings, hide-siblings. -
Returns - The converter object.
1690 1691 1692 1693 1694 1695 1696 1697 |
# File 'lib/pdfcrowd.rb', line 1690 def setElementToConvertMode(mode) unless /(?i)^(cut-out|remove-siblings|hide-siblings)$/.match(mode) raise Error.new(Pdfcrowd.(mode, "setElementToConvertMode", "html-to-pdf", "Allowed values are cut-out, remove-siblings, hide-siblings.", "set_element_to_convert_mode"), 470); end @fields['element_to_convert_mode'] = mode self end |
#setEnablePdfForms(value) ⇒ Object
Convert HTML forms to fillable PDF forms. Details can be found in the blog post.
-
value
- Set to true to make fillable PDF forms. -
Returns - The converter object.
1853 1854 1855 1856 |
# File 'lib/pdfcrowd.rb', line 1853 def setEnablePdfForms(value) @fields['enable_pdf_forms'] = value self end |
#setEncrypt(value) ⇒ Object
Encrypt the PDF. This prevents search engines from indexing the contents.
-
value
- Set to true to enable PDF encryption. -
Returns - The converter object.
1871 1872 1873 1874 |
# File 'lib/pdfcrowd.rb', line 1871 def setEncrypt(value) @fields['encrypt'] = value self end |
#setExcludeFooterOnPages(pages) ⇒ Object
The page footer is not printed on the specified pages.
-
pages
- List of physical page numbers. Negative numbers count backwards from the last page: -1 is the last page, -2 is the last but one page, and so on. A comma separated list of page numbers. -
Returns - The converter object.
1314 1315 1316 1317 1318 1319 1320 1321 |
# File 'lib/pdfcrowd.rb', line 1314 def (pages) unless /^(?:\s*\-?\d+\s*,)*\s*\-?\d+\s*$/.match(pages) raise Error.new(Pdfcrowd.(pages, "setExcludeFooterOnPages", "html-to-pdf", "A comma separated list of page numbers.", "set_exclude_footer_on_pages"), 470); end @fields['exclude_footer_on_pages'] = pages self end |
#setExcludeHeaderOnPages(pages) ⇒ Object
The page header is not printed on the specified pages.
-
pages
- List of physical page numbers. Negative numbers count backwards from the last page: -1 is the last page, -2 is the last but one page, and so on. A comma separated list of page numbers. -
Returns - The converter object.
1301 1302 1303 1304 1305 1306 1307 1308 |
# File 'lib/pdfcrowd.rb', line 1301 def setExcludeHeaderOnPages(pages) unless /^(?:\s*\-?\d+\s*,)*\s*\-?\d+\s*$/.match(pages) raise Error.new(Pdfcrowd.(pages, "setExcludeHeaderOnPages", "html-to-pdf", "A comma separated list of page numbers.", "set_exclude_header_on_pages"), 470); end @fields['exclude_header_on_pages'] = pages self end |
#setExtractMetaTags(value) ⇒ Object
Extract meta tags (author, keywords and description) from the input HTML and use them in the output PDF.
-
value
- Set to true to extract meta tags. -
Returns - The converter object.
1961 1962 1963 1964 |
# File 'lib/pdfcrowd.rb', line 1961 def setExtractMetaTags(value) @fields['extract_meta_tags'] = value self end |
#setFailOnAnyUrlError(fail_on_error) ⇒ Object
Abort the conversion if any of the sub-request HTTP status code is greater than or equal to 400 or if some sub-requests are still pending. See details in a debug log.
-
fail_on_error
- Set to true to abort the conversion. -
Returns - The converter object.
1607 1608 1609 1610 |
# File 'lib/pdfcrowd.rb', line 1607 def setFailOnAnyUrlError(fail_on_error) @fields['fail_on_any_url_error'] = fail_on_error self end |
#setFailOnMainUrlError(fail_on_error) ⇒ Object
Abort the conversion if the main URL HTTP status code is greater than or equal to 400.
-
fail_on_error
- Set to true to abort the conversion. -
Returns - The converter object.
1598 1599 1600 1601 |
# File 'lib/pdfcrowd.rb', line 1598 def setFailOnMainUrlError(fail_on_error) @fields['fail_on_main_url_error'] = fail_on_error self end |
#setFitWindow(value) ⇒ Object
Specify whether to resize the document’s window to fit the size of the first displayed page.
-
value
- Set to true to resize the window. -
Returns - The converter object.
2062 2063 2064 2065 |
# File 'lib/pdfcrowd.rb', line 2062 def setFitWindow(value) @fields['fit_window'] = value self end |
#setFooterHeight(height) ⇒ Object
Set the footer height.
-
height
- The value must be specified in inches “in”, millimeters “mm”, centimeters “cm”, pixels “px”, or points “pt”. -
Returns - The converter object.
1270 1271 1272 1273 1274 1275 1276 1277 |
# File 'lib/pdfcrowd.rb', line 1270 def (height) unless /(?i)^0$|^[0-9]*\.?[0-9]+(pt|px|mm|cm|in)$/.match(height) raise Error.new(Pdfcrowd.(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 self end |
#setFooterHtml(html) ⇒ Object
Use the specified HTML 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>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=‘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=‘example.com’>example.com</a>
-
html
- The string must not be empty. -
Returns - The converter object.
1257 1258 1259 1260 1261 1262 1263 1264 |
# File 'lib/pdfcrowd.rb', line 1257 def (html) if (!(!html.nil? && !html.empty?)) raise Error.new(Pdfcrowd.(html, "setFooterHtml", "html-to-pdf", "The string must not be empty.", "set_footer_html"), 470); end @fields['footer_html'] = html self end |
#setFooterMatrix(matrix) ⇒ Object
A 2D transformation matrix applied to the page footer contents. The origin [0,0] is located at the top-left corner of the footer. The resolution is 72 dpi.
-
matrix
- A comma separated string of matrix elements: “scaleX,skewX,transX,skewY,scaleY,transY” -
Returns - The converter object.
2322 2323 2324 2325 |
# File 'lib/pdfcrowd.rb', line 2322 def (matrix) @fields['footer_matrix'] = matrix self end |
#setFooterUrl(url) ⇒ Object
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>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=‘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=‘example.com’>example.com</a>
-
url
- The supported protocols are http:// and https://. -
Returns - The converter object.
1244 1245 1246 1247 1248 1249 1250 1251 |
# File 'lib/pdfcrowd.rb', line 1244 def (url) unless /(?i)^https?:\/\/.*$/.match(url) raise Error.new(Pdfcrowd.(url, "setFooterUrl", "html-to-pdf", "The supported protocols are http:// and https://.", "set_footer_url"), 470); end @fields['footer_url'] = url self end |
#setHeaderFooterCssAnnotation(value) ⇒ Object
Add special CSS classes to the header/footer’s body element. This allows applying custom styling based on these classes: pdfcrowd-page-X - where X is the current page number pdfcrowd-page-count-X - where X is the total page count pdfcrowd-page-first - the first page pdfcrowd-page-last - the last page pdfcrowd-page-odd - odd page pdfcrowd-page-even - even page
-
value
- Set to true to add the special CSS classes. -
Returns - The converter object.
2350 2351 2352 2353 |
# File 'lib/pdfcrowd.rb', line 2350 def (value) @fields['header_footer_css_annotation'] = value self end |
#setHeaderFooterScaleFactor(factor) ⇒ Object
Set the scaling factor (zoom) for the header and footer.
-
factor
- The percentage value. The value must be in the range 10-500. -
Returns - The converter object.
1327 1328 1329 1330 1331 1332 1333 1334 |
# File 'lib/pdfcrowd.rb', line 1327 def (factor) if (!(Integer(factor) >= 10 && Integer(factor) <= 500)) raise Error.new(Pdfcrowd.(factor, "setHeaderFooterScaleFactor", "html-to-pdf", "The value must be in the range 10-500.", "set_header_footer_scale_factor"), 470); end @fields['header_footer_scale_factor'] = factor self end |
#setHeaderHeight(height) ⇒ Object
Set the header height.
-
height
- The value must be specified in inches “in”, millimeters “mm”, centimeters “cm”, pixels “px”, or points “pt”. -
Returns - The converter object.
1222 1223 1224 1225 1226 1227 1228 1229 |
# File 'lib/pdfcrowd.rb', line 1222 def setHeaderHeight(height) unless /(?i)^0$|^[0-9]*\.?[0-9]+(pt|px|mm|cm|in)$/.match(height) raise Error.new(Pdfcrowd.(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 self end |
#setHeaderHtml(html) ⇒ Object
Use the specified HTML code 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>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=‘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=‘example.com’>example.com</a>
-
html
- The string must not be empty. -
Returns - The converter object.
1209 1210 1211 1212 1213 1214 1215 1216 |
# File 'lib/pdfcrowd.rb', line 1209 def setHeaderHtml(html) if (!(!html.nil? && !html.empty?)) raise Error.new(Pdfcrowd.(html, "setHeaderHtml", "html-to-pdf", "The string must not be empty.", "set_header_html"), 470); end @fields['header_html'] = html self end |
#setHeaderMatrix(matrix) ⇒ Object
A 2D transformation matrix applied to the page header contents. The origin [0,0] is located at the top-left corner of the header. The resolution is 72 dpi.
-
matrix
- A comma separated string of matrix elements: “scaleX,skewX,transX,skewY,scaleY,transY” -
Returns - The converter object.
2313 2314 2315 2316 |
# File 'lib/pdfcrowd.rb', line 2313 def setHeaderMatrix(matrix) @fields['header_matrix'] = matrix self end |
#setHeaderUrl(url) ⇒ Object
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>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=‘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=‘example.com’>example.com</a>
-
url
- The supported protocols are http:// and https://. -
Returns - The converter object.
1196 1197 1198 1199 1200 1201 1202 1203 |
# File 'lib/pdfcrowd.rb', line 1196 def setHeaderUrl(url) unless /(?i)^https?:\/\/.*$/.match(url) raise Error.new(Pdfcrowd.(url, "setHeaderUrl", "html-to-pdf", "The supported protocols are http:// and https://.", "set_header_url"), 470); end @fields['header_url'] = url self end |
#setHideMenubar(value) ⇒ Object
Specify whether to hide the viewer application’s menu bar when the document is active.
-
value
- Set to true to hide the menu bar. -
Returns - The converter object.
2044 2045 2046 2047 |
# File 'lib/pdfcrowd.rb', line 2044 def (value) @fields['hide_menubar'] = value self end |
#setHideToolbar(value) ⇒ Object
Specify whether to hide the viewer application’s tool bars when the document is active.
-
value
- Set to true to hide tool bars. -
Returns - The converter object.
2035 2036 2037 2038 |
# File 'lib/pdfcrowd.rb', line 2035 def (value) @fields['hide_toolbar'] = value self end |
#setHideWindowUi(value) ⇒ Object
Specify whether to hide user interface elements in the document’s window (such as scroll bars and navigation controls), leaving only the document’s contents displayed.
-
value
- Set to true to hide ui elements. -
Returns - The converter object.
2053 2054 2055 2056 |
# File 'lib/pdfcrowd.rb', line 2053 def setHideWindowUi(value) @fields['hide_window_ui'] = value self end |
#setHttpAuth(user_name, password) ⇒ Object
Set credentials to access HTTP base authentication protected websites.
-
user_name
- Set the HTTP authentication user name. -
password
- Set the HTTP authentication password. -
Returns - The converter object.
1570 1571 1572 1573 1574 |
# File 'lib/pdfcrowd.rb', line 1570 def setHttpAuth(user_name, password) setHttpAuthUserName(user_name) setHttpAuthPassword(password) self end |
#setHttpAuthPassword(password) ⇒ Object
Set the HTTP authentication password.
-
password
- The password. -
Returns - The converter object.
1560 1561 1562 1563 |
# File 'lib/pdfcrowd.rb', line 1560 def setHttpAuthPassword(password) @fields['http_auth_password'] = password self end |
#setHttpAuthUserName(user_name) ⇒ Object
Set the HTTP authentication user name.
-
user_name
- The user name. -
Returns - The converter object.
1551 1552 1553 1554 |
# File 'lib/pdfcrowd.rb', line 1551 def setHttpAuthUserName(user_name) @fields['http_auth_user_name'] = user_name self end |
#setHttpProxy(proxy) ⇒ Object
A proxy server used by Pdfcrowd conversion process for accessing the source URLs with HTTP scheme. It can help to circumvent regional restrictions or provide limited access to your intranet.
-
proxy
- The value must have format DOMAIN_OR_IP_ADDRESS:PORT. -
Returns - The converter object.
2243 2244 2245 2246 2247 2248 2249 2250 |
# File 'lib/pdfcrowd.rb', line 2243 def setHttpProxy(proxy) unless /(?i)^([a-z0-9]+(-[a-z0-9]+)*\.)+[a-z0-9]{1,}:\d+$/.match(proxy) raise Error.new(Pdfcrowd.(proxy, "setHttpProxy", "html-to-pdf", "The value must have format DOMAIN_OR_IP_ADDRESS:PORT.", "set_http_proxy"), 470); end @fields['http_proxy'] = proxy self end |
#setHttpsProxy(proxy) ⇒ Object
A proxy server used by Pdfcrowd conversion process for accessing the source URLs with HTTPS scheme. It can help to circumvent regional restrictions or provide limited access to your intranet.
-
proxy
- The value must have format DOMAIN_OR_IP_ADDRESS:PORT. -
Returns - The converter object.
2256 2257 2258 2259 2260 2261 2262 2263 |
# File 'lib/pdfcrowd.rb', line 2256 def setHttpsProxy(proxy) unless /(?i)^([a-z0-9]+(-[a-z0-9]+)*\.)+[a-z0-9]{1,}:\d+$/.match(proxy) raise Error.new(Pdfcrowd.(proxy, "setHttpsProxy", "html-to-pdf", "The value must have format DOMAIN_OR_IP_ADDRESS:PORT.", "set_https_proxy"), 470); end @fields['https_proxy'] = proxy self end |
#setImageDpi(dpi) ⇒ Object
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. -
Returns - The converter object.
1840 1841 1842 1843 1844 1845 1846 1847 |
# File 'lib/pdfcrowd.rb', line 1840 def setImageDpi(dpi) if (!(Integer(dpi) >= 0)) raise Error.new(Pdfcrowd.(dpi, "setImageDpi", "html-to-pdf", "Must be a positive integer number or 0.", "set_image_dpi"), 470); end @fields['image_dpi'] = dpi self end |
#setInitialPage(page) ⇒ Object
Display the specified page when the document is opened.
-
page
- Must be a positive integer number. -
Returns - The converter object.
2009 2010 2011 2012 2013 2014 2015 2016 |
# File 'lib/pdfcrowd.rb', line 2009 def setInitialPage(page) if (!(Integer(page) > 0)) raise Error.new(Pdfcrowd.(page, "setInitialPage", "html-to-pdf", "Must be a positive integer number.", "set_initial_page"), 470); end @fields['initial_page'] = page self end |
#setInitialZoom(zoom) ⇒ Object
Specify the initial page zoom in percents when the document is opened.
-
zoom
- Must be a positive integer number. -
Returns - The converter object.
2022 2023 2024 2025 2026 2027 2028 2029 |
# File 'lib/pdfcrowd.rb', line 2022 def setInitialZoom(zoom) if (!(Integer(zoom) > 0)) raise Error.new(Pdfcrowd.(zoom, "setInitialZoom", "html-to-pdf", "Must be a positive integer number.", "set_initial_zoom"), 470); end @fields['initial_zoom'] = zoom self end |
#setInitialZoomType(zoom_type) ⇒ Object
Specify how the page should be displayed when opened.
-
zoom_type
- Allowed values are fit-width, fit-height, fit-page. -
Returns - The converter object.
1996 1997 1998 1999 2000 2001 2002 2003 |
# File 'lib/pdfcrowd.rb', line 1996 def setInitialZoomType(zoom_type) unless /(?i)^(fit-width|fit-height|fit-page)$/.match(zoom_type) raise Error.new(Pdfcrowd.(zoom_type, "setInitialZoomType", "html-to-pdf", "Allowed values are fit-width, fit-height, fit-page.", "set_initial_zoom_type"), 470); end @fields['initial_zoom_type'] = zoom_type self end |
#setJavascriptDelay(delay) ⇒ Object
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. -
Returns - The converter object.
1664 1665 1666 1667 1668 1669 1670 1671 |
# File 'lib/pdfcrowd.rb', line 1664 def setJavascriptDelay(delay) if (!(Integer(delay) >= 0)) raise Error.new(Pdfcrowd.(delay, "setJavascriptDelay", "html-to-pdf", "Must be a positive integer number or 0.", "set_javascript_delay"), 470); end @fields['javascript_delay'] = delay self end |
#setJpegQuality(quality) ⇒ Object
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. -
Returns - The converter object.
1814 1815 1816 1817 1818 1819 1820 1821 |
# File 'lib/pdfcrowd.rb', line 1814 def setJpegQuality(quality) if (!(Integer(quality) >= 1 && Integer(quality) <= 100)) raise Error.new(Pdfcrowd.(quality, "setJpegQuality", "html-to-pdf", "The value must be in the range 1-100.", "set_jpeg_quality"), 470); end @fields['jpeg_quality'] = quality self end |
#setKeywords(keywords) ⇒ Object
Associate keywords with the document.
-
keywords
- The string with the keywords. -
Returns - The converter object.
1952 1953 1954 1955 |
# File 'lib/pdfcrowd.rb', line 1952 def setKeywords(keywords) @fields['keywords'] = keywords self end |
#setLayoutDpi(dpi) ⇒ Object
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. -
Returns - The converter object.
2291 2292 2293 2294 2295 2296 2297 2298 |
# File 'lib/pdfcrowd.rb', line 2291 def setLayoutDpi(dpi) if (!(Integer(dpi) >= 72 && Integer(dpi) <= 600)) raise Error.new(Pdfcrowd.(dpi, "setLayoutDpi", "html-to-pdf", "The value must be in the range of 72-600.", "set_layout_dpi"), 470); end @fields['layout_dpi'] = dpi self end |
#setLinearize(value) ⇒ Object
Create linearized PDF. This is also known as Fast Web View.
-
value
- Set to true to create linearized PDF. -
Returns - The converter object.
1862 1863 1864 1865 |
# File 'lib/pdfcrowd.rb', line 1862 def setLinearize(value) @fields['linearize'] = value self end |
#setLoadIframes(iframes) ⇒ Object
Specifies how iframes are handled.
-
iframes
- Allowed values are all, same-origin, none. -
Returns - The converter object.
1511 1512 1513 1514 1515 1516 1517 1518 |
# File 'lib/pdfcrowd.rb', line 1511 def setLoadIframes(iframes) unless /(?i)^(all|same-origin|none)$/.match(iframes) raise Error.new(Pdfcrowd.(iframes, "setLoadIframes", "html-to-pdf", "Allowed values are all, same-origin, none.", "set_load_iframes"), 470); end @fields['load_iframes'] = iframes self end |
#setLocale(locale) ⇒ Object
Set the locale for the conversion. This may affect the output format of dates, times and numbers.
-
locale
- The locale code according to ISO 639. -
Returns - The converter object.
1542 1543 1544 1545 |
# File 'lib/pdfcrowd.rb', line 1542 def setLocale(locale) @fields['locale'] = locale self end |
#setMainDocumentCssAnnotation(value) ⇒ Object
Add special CSS classes to the main document’s body element. This allows applying custom styling based on these classes: pdfcrowd-page-X - where X is the current page number pdfcrowd-page-odd - odd page pdfcrowd-page-even - even page Warning: If your custom styling affects the contents area size (e.g. by using different margins, padding, border width), the resulting PDF may contain duplicit contents or some contents may be missing.
-
value
- Set to true to add the special CSS classes. -
Returns - The converter object.
2341 2342 2343 2344 |
# File 'lib/pdfcrowd.rb', line 2341 def setMainDocumentCssAnnotation(value) @fields['main_document_css_annotation'] = value self end |
#setMarginBottom(bottom) ⇒ Object
Set the output page bottom margin.
-
bottom
- The value must be specified in inches “in”, millimeters “mm”, centimeters “cm”, pixels “px”, or points “pt”. -
Returns - The converter object.
1044 1045 1046 1047 1048 1049 1050 1051 |
# File 'lib/pdfcrowd.rb', line 1044 def setMarginBottom(bottom) unless /(?i)^0$|^[0-9]*\.?[0-9]+(pt|px|mm|cm|in)$/.match(bottom) raise Error.new(Pdfcrowd.(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 self end |
#setMarginLeft(left) ⇒ Object
Set the output page left margin.
-
left
- The value must be specified in inches “in”, millimeters “mm”, centimeters “cm”, pixels “px”, or points “pt”. -
Returns - The converter object.
1057 1058 1059 1060 1061 1062 1063 1064 |
# File 'lib/pdfcrowd.rb', line 1057 def setMarginLeft(left) unless /(?i)^0$|^[0-9]*\.?[0-9]+(pt|px|mm|cm|in)$/.match(left) raise Error.new(Pdfcrowd.(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 self end |
#setMarginRight(right) ⇒ Object
Set the output page right margin.
-
right
- The value must be specified in inches “in”, millimeters “mm”, centimeters “cm”, pixels “px”, or points “pt”. -
Returns - The converter object.
1031 1032 1033 1034 1035 1036 1037 1038 |
# File 'lib/pdfcrowd.rb', line 1031 def setMarginRight(right) unless /(?i)^0$|^[0-9]*\.?[0-9]+(pt|px|mm|cm|in)$/.match(right) raise Error.new(Pdfcrowd.(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 self end |
#setMarginTop(top) ⇒ Object
Set the output page top margin.
-
top
- The value must be specified in inches “in”, millimeters “mm”, centimeters “cm”, pixels “px”, or points “pt”. -
Returns - The converter object.
1018 1019 1020 1021 1022 1023 1024 1025 |
# File 'lib/pdfcrowd.rb', line 1018 def setMarginTop(top) unless /(?i)^0$|^[0-9]*\.?[0-9]+(pt|px|mm|cm|in)$/.match(top) raise Error.new(Pdfcrowd.(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 self end |
#setMultipageBackground(background) ⇒ Object
Apply each page of a background to the corresponding page of the output PDF. A background can be either a PDF or an image.
-
background
- The file path to a local file. The file must exist and not be empty. -
Returns - The converter object.
1418 1419 1420 1421 1422 1423 1424 1425 |
# File 'lib/pdfcrowd.rb', line 1418 def setMultipageBackground(background) if (!(File.file?(background) && !File.zero?(background))) raise Error.new(Pdfcrowd.(background, "setMultipageBackground", "html-to-pdf", "The file must exist and not be empty.", "set_multipage_background"), 470); end @files['multipage_background'] = background self end |
#setMultipageBackgroundUrl(url) ⇒ Object
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://. -
Returns - The converter object.
1431 1432 1433 1434 1435 1436 1437 1438 |
# File 'lib/pdfcrowd.rb', line 1431 def setMultipageBackgroundUrl(url) unless /(?i)^https?:\/\/.*$/.match(url) raise Error.new(Pdfcrowd.(url, "setMultipageBackgroundUrl", "html-to-pdf", "The supported protocols are http:// and https://.", "set_multipage_background_url"), 470); end @fields['multipage_background_url'] = url self end |
#setMultipageWatermark(watermark) ⇒ Object
Apply each page of a watermark to the corresponding page of the output PDF. A watermark can be either a PDF or an image.
-
watermark
- The file path to a local file. The file must exist and not be empty. -
Returns - The converter object.
1366 1367 1368 1369 1370 1371 1372 1373 |
# File 'lib/pdfcrowd.rb', line 1366 def setMultipageWatermark(watermark) if (!(File.file?(watermark) && !File.zero?(watermark))) raise Error.new(Pdfcrowd.(watermark, "setMultipageWatermark", "html-to-pdf", "The file must exist and not be empty.", "set_multipage_watermark"), 470); end @files['multipage_watermark'] = watermark self end |
#setMultipageWatermarkUrl(url) ⇒ Object
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://. -
Returns - The converter object.
1379 1380 1381 1382 1383 1384 1385 1386 |
# File 'lib/pdfcrowd.rb', line 1379 def setMultipageWatermarkUrl(url) unless /(?i)^https?:\/\/.*$/.match(url) raise Error.new(Pdfcrowd.(url, "setMultipageWatermarkUrl", "html-to-pdf", "The supported protocols are http:// and https://.", "set_multipage_watermark_url"), 470); end @fields['multipage_watermark_url'] = url self end |
#setNoBackground(value) ⇒ Object
Do not print the background graphics.
-
value
- Set to true to disable the background graphics. -
Returns - The converter object.
1466 1467 1468 1469 |
# File 'lib/pdfcrowd.rb', line 1466 def setNoBackground(value) @fields['no_background'] = value self end |
#setNoCopy(value) ⇒ Object
Disallow text and graphics extraction from the output PDF.
-
value
- Set to true to set the no-copy flag in the output PDF. -
Returns - The converter object.
1916 1917 1918 1919 |
# File 'lib/pdfcrowd.rb', line 1916 def setNoCopy(value) @fields['no_copy'] = value self end |
#setNoHeaderFooterHorizontalMargins(value) ⇒ Object
Disable horizontal page margins for header and footer. The header/footer contents width will be equal to the physical page width.
-
value
- Set to true to disable horizontal margins for header and footer. -
Returns - The converter object.
1292 1293 1294 1295 |
# File 'lib/pdfcrowd.rb', line 1292 def (value) @fields['no_header_footer_horizontal_margins'] = value self end |
#setNoMargins(value) ⇒ Object
Disable page margins.
-
value
- Set to true to disable margins. -
Returns - The converter object.
1070 1071 1072 1073 |
# File 'lib/pdfcrowd.rb', line 1070 def setNoMargins(value) @fields['no_margins'] = value self end |
#setNoModify(value) ⇒ Object
Disallow modification of the output PDF.
-
value
- Set to true to set the read-only only flag in the output PDF. -
Returns - The converter object.
1907 1908 1909 1910 |
# File 'lib/pdfcrowd.rb', line 1907 def setNoModify(value) @fields['no_modify'] = value self end |
#setNoPrint(value) ⇒ Object
Disallow printing of the output PDF.
-
value
- Set to true to set the no-print flag in the output PDF. -
Returns - The converter object.
1898 1899 1900 1901 |
# File 'lib/pdfcrowd.rb', line 1898 def setNoPrint(value) @fields['no_print'] = value self end |
#setNoXpdfcrowdHeader(value) ⇒ Object
Do not send the X-Pdfcrowd HTTP header in Pdfcrowd HTTP requests.
-
value
- Set to true to disable sending X-Pdfcrowd HTTP header. -
Returns - The converter object.
1616 1617 1618 1619 |
# File 'lib/pdfcrowd.rb', line 1616 def setNoXpdfcrowdHeader(value) @fields['no_xpdfcrowd_header'] = value self end |
#setOnLoadJavascript(javascript) ⇒ Object
Run a custom JavaScript right after the document is loaded. The script is intended for early DOM manipulation (add/remove elements, update CSS, …). In addition to the standard browser APIs, the custom JavaScript code can use helper functions from our JavaScript library.
-
javascript
- A string containing a JavaScript code. The string must not be empty. -
Returns - The converter object.
1638 1639 1640 1641 1642 1643 1644 1645 |
# File 'lib/pdfcrowd.rb', line 1638 def setOnLoadJavascript(javascript) if (!(!javascript.nil? && !javascript.empty?)) raise Error.new(Pdfcrowd.(javascript, "setOnLoadJavascript", "html-to-pdf", "The string must not be empty.", "set_on_load_javascript"), 470); end @fields['on_load_javascript'] = javascript self end |
#setOrientation(orientation) ⇒ Object
Set the output page orientation.
-
orientation
- Allowed values are landscape, portrait. -
Returns - The converter object.
1005 1006 1007 1008 1009 1010 1011 1012 |
# File 'lib/pdfcrowd.rb', line 1005 def setOrientation(orientation) unless /(?i)^(landscape|portrait)$/.match(orientation) raise Error.new(Pdfcrowd.(orientation, "setOrientation", "html-to-pdf", "Allowed values are landscape, portrait.", "set_orientation"), 470); end @fields['orientation'] = orientation self end |
#setOwnerPassword(password) ⇒ Object
Protect the PDF with an owner password. Supplying an owner password grants unlimited access to the PDF including changing the passwords and access permissions.
-
password
- The owner password. -
Returns - The converter object.
1889 1890 1891 1892 |
# File 'lib/pdfcrowd.rb', line 1889 def setOwnerPassword(password) @fields['owner_password'] = password self end |
#setPageBackground(background) ⇒ Object
Apply a background to each page of the output PDF file. 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.
-
background
- The file path to a local file. The file must exist and not be empty. -
Returns - The converter object.
1392 1393 1394 1395 1396 1397 1398 1399 |
# File 'lib/pdfcrowd.rb', line 1392 def setPageBackground(background) if (!(File.file?(background) && !File.zero?(background))) raise Error.new(Pdfcrowd.(background, "setPageBackground", "html-to-pdf", "The file must exist and not be empty.", "set_page_background"), 470); end @files['page_background'] = background self end |
#setPageBackgroundColor(color) ⇒ Object
The page background color in RGB or RGBA hexadecimal format. The color fills the entire page regardless of the margins.
-
color
- The value must be in RRGGBB or RRGGBBAA hexadecimal format. -
Returns - The converter object.
1444 1445 1446 1447 1448 1449 1450 1451 |
# File 'lib/pdfcrowd.rb', line 1444 def setPageBackgroundColor(color) unless /^[0-9a-fA-F]{6,8}$/.match(color) raise Error.new(Pdfcrowd.(color, "setPageBackgroundColor", "html-to-pdf", "The value must be in RRGGBB or RRGGBBAA hexadecimal format.", "set_page_background_color"), 470); end @fields['page_background_color'] = color self end |
#setPageBackgroundUrl(url) ⇒ Object
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://. -
Returns - The converter object.
1405 1406 1407 1408 1409 1410 1411 1412 |
# File 'lib/pdfcrowd.rb', line 1405 def setPageBackgroundUrl(url) unless /(?i)^https?:\/\/.*$/.match(url) raise Error.new(Pdfcrowd.(url, "setPageBackgroundUrl", "html-to-pdf", "The supported protocols are http:// and https://.", "set_page_background_url"), 470); end @fields['page_background_url'] = url self end |
#setPageDimensions(width, height) ⇒ Object
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”. -
Returns - The converter object.
995 996 997 998 999 |
# File 'lib/pdfcrowd.rb', line 995 def setPageDimensions(width, height) setPageWidth(width) setPageHeight(height) self end |
#setPageHeight(height) ⇒ Object
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”. -
Returns - The converter object.
981 982 983 984 985 986 987 988 |
# File 'lib/pdfcrowd.rb', line 981 def setPageHeight(height) unless /(?i)^0$|^\-1$|^[0-9]*\.?[0-9]+(pt|px|mm|cm|in)$/.match(height) raise Error.new(Pdfcrowd.(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 self end |
#setPageLayout(layout) ⇒ Object
Specify the page layout to be used when the document is opened.
-
layout
- Allowed values are single-page, one-column, two-column-left, two-column-right. -
Returns - The converter object.
1970 1971 1972 1973 1974 1975 1976 1977 |
# File 'lib/pdfcrowd.rb', line 1970 def setPageLayout(layout) unless /(?i)^(single-page|one-column|two-column-left|two-column-right)$/.match(layout) raise Error.new(Pdfcrowd.(layout, "setPageLayout", "html-to-pdf", "Allowed values are single-page, one-column, two-column-left, two-column-right.", "set_page_layout"), 470); end @fields['page_layout'] = layout self end |
#setPageMargins(top, right, bottom, left) ⇒ Object
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”. -
Returns - The converter object.
1082 1083 1084 1085 1086 1087 1088 |
# File 'lib/pdfcrowd.rb', line 1082 def setPageMargins(top, right, bottom, left) setMarginTop(top) setMarginRight(right) setMarginBottom(bottom) setMarginLeft(left) self end |
#setPageMode(mode) ⇒ Object
Specify how the document should be displayed when opened.
-
mode
- Allowed values are full-screen, thumbnails, outlines. -
Returns - The converter object.
1983 1984 1985 1986 1987 1988 1989 1990 |
# File 'lib/pdfcrowd.rb', line 1983 def setPageMode(mode) unless /(?i)^(full-screen|thumbnails|outlines)$/.match(mode) raise Error.new(Pdfcrowd.(mode, "setPageMode", "html-to-pdf", "Allowed values are full-screen, thumbnails, outlines.", "set_page_mode"), 470); end @fields['page_mode'] = mode self end |
#setPageNumberingOffset(offset) ⇒ Object
Set an offset between physical and logical page numbers.
-
offset
- Integer specifying page offset. -
Returns - The converter object.
1107 1108 1109 1110 |
# File 'lib/pdfcrowd.rb', line 1107 def setPageNumberingOffset(offset) @fields['page_numbering_offset'] = offset self end |
#setPageSize(size) ⇒ Object
Set the output page size.
-
size
- Allowed values are A0, A1, A2, A3, A4, A5, A6, Letter. -
Returns - The converter object.
955 956 957 958 959 960 961 962 |
# File 'lib/pdfcrowd.rb', line 955 def setPageSize(size) unless /(?i)^(A0|A1|A2|A3|A4|A5|A6|Letter)$/.match(size) raise Error.new(Pdfcrowd.(size, "setPageSize", "html-to-pdf", "Allowed values are A0, A1, A2, A3, A4, A5, A6, Letter.", "set_page_size"), 470); end @fields['page_size'] = size self end |
#setPageWatermark(watermark) ⇒ Object
Apply a watermark to each page of the output PDF file. 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.
-
watermark
- The file path to a local file. The file must exist and not be empty. -
Returns - The converter object.
1340 1341 1342 1343 1344 1345 1346 1347 |
# File 'lib/pdfcrowd.rb', line 1340 def setPageWatermark(watermark) if (!(File.file?(watermark) && !File.zero?(watermark))) raise Error.new(Pdfcrowd.(watermark, "setPageWatermark", "html-to-pdf", "The file must exist and not be empty.", "set_page_watermark"), 470); end @files['page_watermark'] = watermark self end |
#setPageWatermarkUrl(url) ⇒ Object
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://. -
Returns - The converter object.
1353 1354 1355 1356 1357 1358 1359 1360 |
# File 'lib/pdfcrowd.rb', line 1353 def setPageWatermarkUrl(url) unless /(?i)^https?:\/\/.*$/.match(url) raise Error.new(Pdfcrowd.(url, "setPageWatermarkUrl", "html-to-pdf", "The supported protocols are http:// and https://.", "set_page_watermark_url"), 470); end @fields['page_watermark_url'] = url self end |
#setPageWidth(width) ⇒ Object
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”. -
Returns - The converter object.
968 969 970 971 972 973 974 975 |
# File 'lib/pdfcrowd.rb', line 968 def setPageWidth(width) unless /(?i)^0$|^[0-9]*\.?[0-9]+(pt|px|mm|cm|in)$/.match(width) raise Error.new(Pdfcrowd.(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 self end |
#setPrintPageRange(pages) ⇒ Object
Set the page range to print.
-
pages
- A comma separated list of page numbers or ranges. -
Returns - The converter object.
1094 1095 1096 1097 1098 1099 1100 1101 |
# File 'lib/pdfcrowd.rb', line 1094 def setPrintPageRange(pages) unless /^(?:\s*(?:\d+|(?:\d*\s*\-\s*\d+)|(?:\d+\s*\-\s*\d*))\s*,\s*)*\s*(?:\d+|(?:\d*\s*\-\s*\d+)|(?:\d+\s*\-\s*\d*))\s*$/.match(pages) raise Error.new(Pdfcrowd.(pages, "setPrintPageRange", "html-to-pdf", "A comma separated list of page numbers or ranges.", "set_print_page_range"), 470); end @fields['print_page_range'] = pages self end |
#setProxy(host, port, user_name, password) ⇒ Object
Specifies an HTTP proxy that the API client library will use to connect to the internet.
-
host
- The proxy hostname. -
port
- The proxy port. -
user_name
- The username. -
password
- The password. -
Returns - The converter object.
2394 2395 2396 2397 |
# File 'lib/pdfcrowd.rb', line 2394 def setProxy(host, port, user_name, password) @helper.setProxy(host, port, user_name, password) self end |
#setReadabilityEnhancements(enhancements) ⇒ Object
The input HTML is automatically enhanced to improve the readability.
-
enhancements
- Allowed values are none, readability-v1, readability-v2, readability-v3, readability-v4. -
Returns - The converter object.
1725 1726 1727 1728 1729 1730 1731 1732 |
# File 'lib/pdfcrowd.rb', line 1725 def setReadabilityEnhancements(enhancements) unless /(?i)^(none|readability-v1|readability-v2|readability-v3|readability-v4)$/.match(enhancements) raise Error.new(Pdfcrowd.(enhancements, "setReadabilityEnhancements", "html-to-pdf", "Allowed values are none, readability-v1, readability-v2, readability-v3, readability-v4.", "set_readability_enhancements"), 470); end @fields['readability_enhancements'] = enhancements self end |
#setRenderingMode(mode) ⇒ Object
Set the rendering mode.
-
mode
- The rendering mode. Allowed values are default, viewport. -
Returns - The converter object.
1775 1776 1777 1778 1779 1780 1781 1782 |
# File 'lib/pdfcrowd.rb', line 1775 def setRenderingMode(mode) unless /(?i)^(default|viewport)$/.match(mode) raise Error.new(Pdfcrowd.(mode, "setRenderingMode", "html-to-pdf", "Allowed values are default, viewport.", "set_rendering_mode"), 470); end @fields['rendering_mode'] = mode self end |
#setRetryCount(count) ⇒ Object
Specifies the number of automatic retries when the 502 HTTP status code is received. The 502 status code indicates a temporary network issue. This feature can be disabled by setting to 0.
-
count
- Number of retries. -
Returns - The converter object.
2403 2404 2405 2406 |
# File 'lib/pdfcrowd.rb', line 2403 def setRetryCount(count) @helper.setRetryCount(count) self end |
#setRightToLeft(value) ⇒ Object
Set the predominant reading order for text to right-to-left. This option has no direct effect on the document’s contents or page numbering but can be used to determine the relative positioning of pages when displayed side by side or printed n-up
-
value
- Set to true to set right-to-left reading order. -
Returns - The converter object.
2089 2090 2091 2092 |
# File 'lib/pdfcrowd.rb', line 2089 def setRightToLeft(value) @fields['right_to_left'] = value self end |
#setScaleFactor(factor) ⇒ Object
Set the scaling factor (zoom) for the main page area.
-
factor
- The percentage value. The value must be in the range 10-500. -
Returns - The converter object.
1801 1802 1803 1804 1805 1806 1807 1808 |
# File 'lib/pdfcrowd.rb', line 1801 def setScaleFactor(factor) if (!(Integer(factor) >= 10 && Integer(factor) <= 500)) raise Error.new(Pdfcrowd.(factor, "setScaleFactor", "html-to-pdf", "The value must be in the range 10-500.", "set_scale_factor"), 470); end @fields['scale_factor'] = factor self end |
#setSmartScalingMode(mode) ⇒ Object
Specifies the scaling mode used for fitting the HTML contents to the print area.
-
mode
- The smart scaling mode. Allowed values are default, disabled, viewport-fit, content-fit, single-page-fit, single-page-fit-ex, mode1. -
Returns - The converter object.
1788 1789 1790 1791 1792 1793 1794 1795 |
# File 'lib/pdfcrowd.rb', line 1788 def setSmartScalingMode(mode) unless /(?i)^(default|disabled|viewport-fit|content-fit|single-page-fit|single-page-fit-ex|mode1)$/.match(mode) raise Error.new(Pdfcrowd.(mode, "setSmartScalingMode", "html-to-pdf", "Allowed values are default, disabled, viewport-fit, content-fit, single-page-fit, single-page-fit-ex, mode1.", "set_smart_scaling_mode"), 470); end @fields['smart_scaling_mode'] = mode self end |
#setSubject(subject) ⇒ Object
Set the subject of the PDF.
-
subject
- The subject. -
Returns - The converter object.
1934 1935 1936 1937 |
# File 'lib/pdfcrowd.rb', line 1934 def setSubject(subject) @fields['subject'] = subject self end |
#setTag(tag) ⇒ Object
Tag the conversion with a custom value. The tag is used in conversion statistics. A value longer than 32 characters is cut off.
-
tag
- A string with the custom tag. -
Returns - The converter object.
2234 2235 2236 2237 |
# File 'lib/pdfcrowd.rb', line 2234 def setTag(tag) @fields['tag'] = tag self end |
#setTitle(title) ⇒ Object
Set the title of the PDF.
-
title
- The title. -
Returns - The converter object.
1925 1926 1927 1928 |
# File 'lib/pdfcrowd.rb', line 1925 def setTitle(title) @fields['title'] = title self end |
#setUseHttp(value) ⇒ Object
Specifies if the client communicates over HTTP or HTTPS with Pdfcrowd API. Warning: Using HTTP is insecure as data sent over HTTP is not encrypted. Enable this option only if you know what you are doing.
-
value
- Set to true to use HTTP. -
Returns - The converter object.
2373 2374 2375 2376 |
# File 'lib/pdfcrowd.rb', line 2373 def setUseHttp(value) @helper.setUseHttp(value) self end |
#setUseMobileUserAgent(value) ⇒ Object
Use a mobile user agent.
-
value
- Set to true to use a mobile user agent. -
Returns - The converter object.
1502 1503 1504 1505 |
# File 'lib/pdfcrowd.rb', line 1502 def setUseMobileUserAgent(value) @fields['use_mobile_user_agent'] = value self end |
#setUsePrintMedia(value) ⇒ Object
Use the print version of the page if available (@media print).
-
value
- Set to true to use the print version of the page. -
Returns - The converter object.
1457 1458 1459 1460 |
# File 'lib/pdfcrowd.rb', line 1457 def setUsePrintMedia(value) @fields['use_print_media'] = value self end |
#setUserAgent(agent) ⇒ Object
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. -
Returns - The converter object.
2382 2383 2384 2385 |
# File 'lib/pdfcrowd.rb', line 2382 def setUserAgent(agent) @helper.setUserAgent(agent) self end |
#setUserPassword(password) ⇒ Object
Protect the PDF with a user password. When a PDF has a user password, it must be supplied in order to view the document and to perform operations allowed by the access permissions.
-
password
- The user password. -
Returns - The converter object.
1880 1881 1882 1883 |
# File 'lib/pdfcrowd.rb', line 1880 def setUserPassword(password) @fields['user_password'] = password self end |
#setVerifySslCertificates(value) ⇒ Object
Do not allow insecure HTTPS connections.
-
value
- Set to true to enable SSL certificate verification. -
Returns - The converter object.
1589 1590 1591 1592 |
# File 'lib/pdfcrowd.rb', line 1589 def setVerifySslCertificates(value) @fields['verify_ssl_certificates'] = value self end |
#setViewport(width, height) ⇒ Object
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. -
Returns - The converter object.
1765 1766 1767 1768 1769 |
# File 'lib/pdfcrowd.rb', line 1765 def setViewport(width, height) setViewportWidth(width) setViewportHeight(height) self end |
#setViewportHeight(height) ⇒ Object
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. -
Returns - The converter object.
1751 1752 1753 1754 1755 1756 1757 1758 |
# File 'lib/pdfcrowd.rb', line 1751 def setViewportHeight(height) if (!(Integer(height) > 0)) raise Error.new(Pdfcrowd.(height, "setViewportHeight", "html-to-pdf", "Must be a positive integer number.", "set_viewport_height"), 470); end @fields['viewport_height'] = height self end |
#setViewportWidth(width) ⇒ Object
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. -
Returns - The converter object.
1738 1739 1740 1741 1742 1743 1744 1745 |
# File 'lib/pdfcrowd.rb', line 1738 def setViewportWidth(width) if (!(Integer(width) >= 96 && Integer(width) <= 65000)) raise Error.new(Pdfcrowd.(width, "setViewportWidth", "html-to-pdf", "The value must be in the range 96-65000.", "set_viewport_width"), 470); end @fields['viewport_width'] = width self end |
#setWaitForElement(selectors) ⇒ Object
Wait for the specified element in a source document. The element is specified by one or more CSS selectors. The element is searched for in the main document and all iframes. If the element is not found, the conversion fails. Your API license defines the maximum wait time by “Max Delay” parameter.
-
selectors
- One or more CSS selectors separated by commas. The string must not be empty. -
Returns - The converter object.
1703 1704 1705 1706 1707 1708 1709 1710 |
# File 'lib/pdfcrowd.rb', line 1703 def setWaitForElement(selectors) if (!(!selectors.nil? && !selectors.empty?)) raise Error.new(Pdfcrowd.(selectors, "setWaitForElement", "html-to-pdf", "The string must not be empty.", "set_wait_for_element"), 470); end @fields['wait_for_element'] = selectors self end |
#setZipFooterFilename(filename) ⇒ Object
Set the file name of the footer HTML document stored in the input archive. Use this method if the input archive contains multiple HTML documents.
-
filename
- The file name. -
Returns - The converter object.
1283 1284 1285 1286 |
# File 'lib/pdfcrowd.rb', line 1283 def (filename) @fields['zip_footer_filename'] = filename self end |
#setZipHeaderFilename(filename) ⇒ Object
Set the file name of the header HTML document stored in the input archive. Use this method if the input archive contains multiple HTML documents.
-
filename
- The file name. -
Returns - The converter object.
1235 1236 1237 1238 |
# File 'lib/pdfcrowd.rb', line 1235 def setZipHeaderFilename(filename) @fields['zip_header_filename'] = filename self end |
#setZipMainFilename(filename) ⇒ Object
Set the file name of the main HTML document stored in the input archive. If not specified, the first HTML file in the archive is used for conversion. Use this method if the input archive contains multiple HTML documents.
-
filename
- The file name. -
Returns - The converter object.
946 947 948 949 |
# File 'lib/pdfcrowd.rb', line 946 def setZipMainFilename(filename) @fields['zip_main_filename'] = filename self end |