PDFreactor .NET API Documentation

Java | .NET | JavaScript | Node.js | PHP | Python | Ruby | Perl | Web Service Client | SOAP Client

Server Parameters

PDFreactor Namespace: RealObjects.PDFreactor.Webservice.Client

The PDFreactor object handles all interaction with the PDFreactor Web Service. Only one instance per web service is required and the instance is reusable for subsequent conversions. The following describes the methods that can be called on the PDFreactor instance.

PDFreactor()

Creates a new PDFreactor client instance. The PDFreactor Web Service URL http://localhost:9423/service/rest will be used.

PDFreactor(string serviceUrl)

Creates a new PDFreactor client instance. The specified URL will be used as PDFreactor Web Service URL.

Parameters

serviceUrl
The URL to the PDFreactor Web Service.

Convert(Configuration configuration, ConnectionSettings connectionSettings) → Result

Converts the specified configuration into PDF or image.

Parameters

configuration
The configuration.
connectionSettings
An object containing optional settings for the communication between client and PDFreactor Web Service.

Exceptions

ClientTimeoutException
The request to the PDFreactor Web Service timed out. This usually occurs during synchronous conversions. Increasing the timeout or switching to asynchronous conversions might resolve this.
ConversionAbortedException
The supplied configuration is valid, however the conversion could not be completed for some reason. See the error message for details.
ConversionFailureException
The configuration could not be processed and should be re-checked.
InvalidClientException
The version of the client that was used is outdated and no longer supported. This is only available for the PDFreactor REST clients.
InvalidConfigurationException
The supplied configuration was not valid for some reason. See the error message for details.
InvalidServiceException
A response was received but it could not be identified as a response from the PDFreactor Web Service.
NoConfigurationException
No configuration was supplied to the operation.
NoInputDocumentException
No input document was specified in the configuration.
ServerException
The actual exception type could not be recognized.
ServiceUnavailableException
The PDFreactor Web Service is running and reachable, but not in a state to perform the requested task.
UnauthorizedException
The client failed an authorization check, e.g. because a supplied API key was invalid.
UnprocessableConfigurationException
The supplied configuration was accepted by PDFreactor but could not be converted for some reason. See the error message for details.
UnreachableServiceException
The PDFreactor Web Service could not be reached.

ConvertAsBinary(Configuration configuration, ConnectionSettings connectionSettings) → byte[]

Converts the specified configuration into PDF or image and returns the generated PDF or image.

Parameters

configuration
The configuration.
connectionSettings
An object containing optional settings for the communication between client and PDFreactor Web Service.

Exceptions

ClientTimeoutException
The request to the PDFreactor Web Service timed out. This usually occurs during synchronous conversions. Increasing the timeout or switching to asynchronous conversions might resolve this.
ConversionAbortedException
The supplied configuration is valid, however the conversion could not be completed for some reason. See the error message for details.
ConversionFailureException
The configuration could not be processed and should be re-checked.
InvalidClientException
The version of the client that was used is outdated and no longer supported. This is only available for the PDFreactor REST clients.
InvalidConfigurationException
The supplied configuration was not valid for some reason. See the error message for details.
InvalidServiceException
A response was received but it could not be identified as a response from the PDFreactor Web Service.
NoConfigurationException
No configuration was supplied to the operation.
NoInputDocumentException
No input document was specified in the configuration.
ServerException
The actual exception type could not be recognized.
ServiceUnavailableException
The PDFreactor Web Service is running and reachable, but not in a state to perform the requested task.
UnauthorizedException
The client failed an authorization check, e.g. because a supplied API key was invalid.
UnprocessableConfigurationException
The supplied configuration was accepted by PDFreactor but could not be converted for some reason. See the error message for details.
UnreachableServiceException
The PDFreactor Web Service could not be reached.

ConvertAsBinary(Configuration configuration, OutputStream stream, ConnectionSettings connectionSettings)

Converts the specified configuration into PDF or image and returns the generated PDF or image and writes the result in the specified stream.

Parameters

configuration
The configuration.
stream
The stream to write to.
connectionSettings
An object containing optional settings for the communication between client and PDFreactor Web Service.

Exceptions

ClientTimeoutException
The request to the PDFreactor Web Service timed out. This usually occurs during synchronous conversions. Increasing the timeout or switching to asynchronous conversions might resolve this.
ConversionAbortedException
The supplied configuration is valid, however the conversion could not be completed for some reason. See the error message for details.
ConversionFailureException
The configuration could not be processed and should be re-checked.
InvalidClientException
The version of the client that was used is outdated and no longer supported. This is only available for the PDFreactor REST clients.
InvalidConfigurationException
The supplied configuration was not valid for some reason. See the error message for details.
InvalidServiceException
A response was received but it could not be identified as a response from the PDFreactor Web Service.
NoConfigurationException
No configuration was supplied to the operation.
NoInputDocumentException
No input document was specified in the configuration.
ServerException
The actual exception type could not be recognized.
ServiceUnavailableException
The PDFreactor Web Service is running and reachable, but not in a state to perform the requested task.
UnauthorizedException
The client failed an authorization check, e.g. because a supplied API key was invalid.
UnprocessableConfigurationException
The supplied configuration was accepted by PDFreactor but could not be converted for some reason. See the error message for details.
UnreachableServiceException
The PDFreactor Web Service could not be reached.

ConvertAsync(Configuration configuration, ConnectionSettings connectionSettings) → string

Converts the specified configuration into PDF or image. This operation responds immediately and does not wait for the conversion to finish. This is especially useful for very large or complex documents where the conversion will take some time.

Parameters

configuration
The configuration.
connectionSettings
An object containing optional settings for the communication between client and PDFreactor Web Service.

Exceptions

AsyncUnavailableException
Asynchronous conversions are not available in this PDFreactor Web Service.
ClientTimeoutException
The request to the PDFreactor Web Service timed out. This usually occurs during synchronous conversions. Increasing the timeout or switching to asynchronous conversions might resolve this.
InvalidClientException
The version of the client that was used is outdated and no longer supported. This is only available for the PDFreactor REST clients.
InvalidConfigurationException
The supplied configuration was not valid for some reason. See the error message for details.
InvalidServiceException
A response was received but it could not be identified as a response from the PDFreactor Web Service.
NoConfigurationException
No configuration was supplied to the operation.
NoInputDocumentException
No input document was specified in the configuration.
ServerException
The actual exception type could not be recognized.
ServiceUnavailableException
The PDFreactor Web Service is running and reachable, but not in a state to perform the requested task.
UnauthorizedException
The client failed an authorization check, e.g. because a supplied API key was invalid.
UnprocessableConfigurationException
The supplied configuration was accepted by PDFreactor but could not be converted for some reason. See the error message for details.
UnreachableServiceException
The PDFreactor Web Service could not be reached.

GetProgress(string documentId, ConnectionSettings connectionSettings) → Progress

Retrieves progress information about the asynchronous conversion with the given ID.

Parameters

documentId
The documentId.
connectionSettings
An object containing optional settings for the communication between client and PDFreactor Web Service.

Exceptions

ClientTimeoutException
The request to the PDFreactor Web Service timed out. This usually occurs during synchronous conversions. Increasing the timeout or switching to asynchronous conversions might resolve this.
DocumentNotFoundException
Conversion does not exist.
InvalidServiceException
A response was received but it could not be identified as a response from the PDFreactor Web Service.
ServerException
The actual exception type could not be recognized.
ServiceUnavailableException
The PDFreactor Web Service is running and reachable, but not in a state to perform the requested task.
UnauthorizedException
The client failed an authorization check, e.g. because a supplied API key was invalid.
UnreachableServiceException
The PDFreactor Web Service could not be reached.

GetDocument(string documentId, ConnectionSettings connectionSettings) → Result

Retrieves the asynchronously converted document with the given ID.

Parameters

documentId
The document ID.
connectionSettings
An object containing optional settings for the communication between client and PDFreactor Web Service.

Exceptions

ClientTimeoutException
The request to the PDFreactor Web Service timed out. This usually occurs during synchronous conversions. Increasing the timeout or switching to asynchronous conversions might resolve this.
ConversionAbortedException
The supplied configuration is valid, however the conversion could not be completed for some reason. See the error message for details.
DocumentNotFoundException
Conversion does not exist.
InvalidServiceException
A response was received but it could not be identified as a response from the PDFreactor Web Service.
ServerException
The actual exception type could not be recognized.
ServiceUnavailableException
The PDFreactor Web Service is running and reachable, but not in a state to perform the requested task.
UnauthorizedException
The client failed an authorization check, e.g. because a supplied API key was invalid.
UnprocessableConfigurationException
The supplied configuration was accepted by PDFreactor but could not be converted for some reason. See the error message for details.
UnreachableServiceException
The PDFreactor Web Service could not be reached.

GetDocumentMetadata(string documentId, ConnectionSettings connectionSettings) → Result

Retrieves the metadata of the asynchronously converted document with the given ID.

Parameters

documentId
The document ID.
connectionSettings
An object containing optional settings for the communication between client and PDFreactor Web Service.

Exceptions

ClientTimeoutException
The request to the PDFreactor Web Service timed out. This usually occurs during synchronous conversions. Increasing the timeout or switching to asynchronous conversions might resolve this.
ConversionAbortedException
The supplied configuration is valid, however the conversion could not be completed for some reason. See the error message for details.
DocumentNotFoundException
Conversion does not exist.
InvalidServiceException
A response was received but it could not be identified as a response from the PDFreactor Web Service.
ServerException
The actual exception type could not be recognized.
ServiceUnavailableException
The PDFreactor Web Service is running and reachable, but not in a state to perform the requested task.
UnauthorizedException
The client failed an authorization check, e.g. because a supplied API key was invalid.
UnprocessableConfigurationException
The supplied configuration was accepted by PDFreactor but could not be converted for some reason. See the error message for details.
UnreachableServiceException
The PDFreactor Web Service could not be reached.

GetDocumentAsBinary(string documentId, ConnectionSettings connectionSettings) → byte[]

Retrieves the asynchronously converted document with the given ID.

Parameters

documentId
The document ID.
connectionSettings
An object containing optional settings for the communication between client and PDFreactor Web Service.

Exceptions

ClientTimeoutException
The request to the PDFreactor Web Service timed out. This usually occurs during synchronous conversions. Increasing the timeout or switching to asynchronous conversions might resolve this.
ConversionAbortedException
The supplied configuration is valid, however the conversion could not be completed for some reason. See the error message for details.
DocumentNotFoundException
Conversion does not exist.
InvalidServiceException
A response was received but it could not be identified as a response from the PDFreactor Web Service.
ServerException
The actual exception type could not be recognized.
ServiceUnavailableException
The PDFreactor Web Service is running and reachable, but not in a state to perform the requested task.
UnauthorizedException
The client failed an authorization check, e.g. because a supplied API key was invalid.
UnprocessableConfigurationException
The supplied configuration was accepted by PDFreactor but could not be converted for some reason. See the error message for details.
UnreachableServiceException
The PDFreactor Web Service could not be reached.

GetDocumentAsBinary(string documentId, OutputStream stream, ConnectionSettings connectionSettings)

Retrieves the asynchronously converted document with the given ID and writes the result in the specified stream.

Parameters

documentId
The document ID.
stream
The stream to write to.
connectionSettings
An object containing optional settings for the communication between client and PDFreactor Web Service.

Exceptions

ClientTimeoutException
The request to the PDFreactor Web Service timed out. This usually occurs during synchronous conversions. Increasing the timeout or switching to asynchronous conversions might resolve this.
ConversionAbortedException
The supplied configuration is valid, however the conversion could not be completed for some reason. See the error message for details.
DocumentNotFoundException
Conversion does not exist.
InvalidServiceException
A response was received but it could not be identified as a response from the PDFreactor Web Service.
ServerException
The actual exception type could not be recognized.
ServiceUnavailableException
The PDFreactor Web Service is running and reachable, but not in a state to perform the requested task.
UnauthorizedException
The client failed an authorization check, e.g. because a supplied API key was invalid.
UnprocessableConfigurationException
The supplied configuration was accepted by PDFreactor but could not be converted for some reason. See the error message for details.
UnreachableServiceException
The PDFreactor Web Service could not be reached.

DeleteDocument(string documentId, ConnectionSettings connectionSettings)

Deletes the asynchronously converted document with the given ID. If the conversion is still running, it gets terminated.

Parameters

documentId
The document ID.
connectionSettings
An object containing optional settings for the communication between client and PDFreactor Web Service.

Exceptions

ClientTimeoutException
The request to the PDFreactor Web Service timed out. This usually occurs during synchronous conversions. Increasing the timeout or switching to asynchronous conversions might resolve this.
DocumentNotFoundException
Conversion does not exist.
InvalidServiceException
A response was received but it could not be identified as a response from the PDFreactor Web Service.
ServerException
The actual exception type could not be recognized.
ServiceUnavailableException
The PDFreactor Web Service is running and reachable, but not in a state to perform the requested task.
UnauthorizedException
The client failed an authorization check, e.g. because a supplied API key was invalid.
UnreachableServiceException
The PDFreactor Web Service could not be reached.

GetStatus(ConnectionSettings connectionSettings)

Checks if the PDFreactor Web Service is available and functional.

Parameters

connectionSettings
An object containing optional settings for the communication between client and PDFreactor Web Service.

Exceptions

ClientTimeoutException
The request to the PDFreactor Web Service timed out. This usually occurs during synchronous conversions. Increasing the timeout or switching to asynchronous conversions might resolve this.
InvalidServiceException
A response was received but it could not be identified as a response from the PDFreactor Web Service.
ServerException
The actual exception type could not be recognized.
ServiceUnavailableException
The PDFreactor Web Service is running and reachable, but not in a state to perform the requested task.
UnauthorizedException
The client failed an authorization check, e.g. because a supplied API key was invalid.
UnreachableServiceException
The PDFreactor Web Service could not be reached.

GetVersion(ConnectionSettings connectionSettings) → Version

Returns the version of the PDFreactor Web Service that is currently running.

Parameters

connectionSettings
An object containing optional settings for the communication between client and PDFreactor Web Service.

Exceptions

ClientTimeoutException
The request to the PDFreactor Web Service timed out. This usually occurs during synchronous conversions. Increasing the timeout or switching to asynchronous conversions might resolve this.
InvalidServiceException
A response was received but it could not be identified as a response from the PDFreactor Web Service.
ServerException
The actual exception type could not be recognized.
ServiceUnavailableException
The PDFreactor Web Service is running and reachable, but not in a state to perform the requested task.
UnauthorizedException
The client failed an authorization check, e.g. because a supplied API key was invalid.
UnreachableServiceException
The PDFreactor Web Service could not be reached.

GetDocumentUrl(string documentId) → string

Returns the URL where the document with the given ID can be accessed.

Parameters

documentId
The document ID.

GetProgressUrl(string documentId) → string

Returns the URL where the progress of the document with the given ID can be accessed.

Parameters

documentId
The document ID.

ApiKey → string

The API key. Only required if the PDFreactor Web Service is so configured that only clients with a valid API key can access it.

Timeout → int

Indicates the time the client waits for the reply to a request made to the PDFreactor Web Service to arrive (in milliseconds). The default value is 60000ms (10 minutes). A value of zero or negative values are interpreted as an infinite timeout.

Models

Configuration Namespace: RealObjects.PDFreactor.Webservice.Client

This class contains all options related to the PDF or image conversion. Only Configuration.Document or Configuration.Document is required, all other configuration settings are optional.

AddAttachments → bool

Enables or disables attachments specified in style sheets.

The default value is false.

AddBookmarks → bool

Deprecated

Deprecated as of PDFreactor 11. Use Configuration.DisableBookmarks instead.

AddComments → bool

Enables or disables comments in the PDF document.

The default value is false.

Deprecated

Deprecated as of PDFreactor 11. Use Configuration.DisableLinks instead.

AddOverprint → bool

Enables or disables overprinting.

The default value is false.

AddPreviewImages → bool

Enables or disables embedding of image previews per page in the PDF document.

The default value is false.

AddTags → bool

Enables or disables tagging of the PDF document.

The default value is false.

AllowAnnotations → bool

Enables or disables the 'annotations' restriction in the PDF document.

The default value is false.

AllowAssembly → bool

Enables or disables the 'assembly' restriction in the PDF document.

The default value is false.

AllowCopy → bool

Enables or disables the 'copy' restriction in the PDF document.

The default value is false.

AllowDegradedPrinting → bool

Enables or disables the 'degraded printing' restriction in the PDF document.

The default value is false.

AllowFillIn → bool

Enables or disables the 'fill in' restriction in the PDF document.

The default value is false.

AllowModifyContents → bool

Enables or disables the 'modify contents' restriction in the PDF document.

The default value is false.

AllowPrinting → bool

Enables or disables the 'printing' restriction in the PDF document.

The default value is false.

AllowScreenReaders → bool

Enables or disables the 'screen readers' restriction in the PDF document.

The default value is false.

AppendLog → bool

Specifies whether or not the log data should be added to the PDF document.

The default value is false.

Attachments → List<Attachment>

Adds a file attachment to PDF document.

AuthenticationCredentials → KeyValuePair

Enables access to resources that are secured via Basic or Digest authentication.

Author → string

Sets the value of the author field of the PDF document.

BaseURL → string

Deprecated

Deprecated as of PDFreactor 11. Use Configuration.BaseUrl instead.

BaseUrl → string

Sets the base URL of the document.

To resolve relative URLs to absolute URLs a reference (base) URL is required. This reference URL is usually the system id of the document.

This method can be used to specify another reference URL. If this URL is not null then it will be used instead of the system id.

The default value is null.

BookletMode → BookletMode

Convenience method to set pages-per-sheet properties and page order in one step to create a booklet.

Callbacks → List<Callback>

Adds callbacks to the conversion which will be called at specific times. All callbacks perform a POST request to the specified URL with the specified content type and a certain model which depends on the callback event.

For each callback, you can specify a timeout. If no timeout is specified, the server's default timeout for callbacks is used. A value of zero or negative values indicate an infinite timeout, however the PDFreactor server may have a maximum timeout configured, in which case that will be the used value.

Some callbacks might be called regularly during the course of a conversion. For these callbacks you can specify an interval to control how frequently they are called.

CleanupTool → Cleanup

Sets the cleanup tool to use for documents with unparsable content.

The Cleanup constants can be used as value. The default value specified is Cleanup.CYBERNEKO.

The cleanup tool is only used for Configuration.DocumentType Doctype.XHTML. HTML5 utilizes an internal cleanup.

ColorSpaceSettings → ColorSpaceSettings

Specifies color space related settings.

Conformance → Conformance

Sets the conformance of the PDF.

The Conformance constants can be used as value. The default value specified is Conformance.PDF.

ContentObserver → ContentObserver

Specifies parts of the document's content that should be observed and logged in greater detail. Data logged this way can be programmatically retrieved after the conversion has finished. The following can be observed:

ContinuousOutput → ContinuousOutput

Enables the conversion of the input document into one image.

ConversionName → string

Sets a name for the conversion. If a name is set, it will be logged at level "info". The name can be an arbitrary string but should be unique for every conversion or application so that the log output can be matched to a specific conversion or application later.

ConversionTimeout → int

Sets a timeout in seconds for the whole document conversion. If the timeout is exceeded, the conversion will be aborted.

A timeout of 0 or negative values mean that the conversion will never time out. This is also the default behavior if no timeout is specified.

Cookies → List<KeyValuePair>

Adds a cookie to all outgoing HTTP connections. The parameters are URL encoded (see Configuration.RawCookies). If the key already exists, the pair is overwritten.

Creator → string

Sets the value of creator field of the PDF document.

CssSettings → CssSettings

Specifies the behavior of PDFreactor regarding the support and validation of CSS properties and their declaration. The following modes can be set:

  • Do not validate at all, consider all declared style as valid. See CssPropertySupport.ALL
  • Validate all declared styles for properties only supported by PDFreactor. Properties only supported by third party products are not supported/taken as invalid. See CssPropertySupport.HTML
  • Validate all declared styles for properties supported by PDFreactor. Properties only supported by third party products are supported/taken as valid. See CssPropertySupport.HTML_THIRD_PARTY
  • All properties supported by third party products are supported/taken as valid. All declared styles for properties not supported by third party products but supported by PDFreactor will be validated. See CssPropertySupport.HTML_THIRD_PARTY_LENIENT
CustomDocumentProperties → List<KeyValuePair>

Adds a custom property to the PDF document. An existing property of the same name will be replaced.

DebugSettings → DebugSettings

Enables and configures debug settings, which add additional information to the output.

If enabled, exceptions during the conversion will not be thrown. In such a case, instead of a document a string containing the log and exception will be returned.

DefaultColorSpace → ColorSpace

Deprecated

Deprecated as of PDFreactor 10. Use Configuration.ColorSpaceSettings and ColorSpaceSettings.targetColorSpace instead.

DisableBookmarks → bool

Disables bookmarks in the PDF document.

The default value is false.

DisableFontEmbedding → bool

Sets whether fonts will not be embedded into the resulting PDF. Setting this to true will reduce the file size of the output document. However, the resulting PDF documents are no longer guaranteed to look identical on all systems.

The default value is false.

Disables links in the PDF document.

The default value is false.

Document → byte[] | string

The input document. This can either be a URL string, XML or HTML source code string.

Alternatively, the input document can be specified directly as byte[].
DocumentDefaultLanguage → string

Sets the language used for documents having no explicit language attribute set.

The language code is used to resolve the lang() selector correct and to determine the correct language used for hyphenation.

DocumentType → Doctype

Sets the document type.

The Doctype constants can be used to specify the document type. The default value specified is Doctype.AUTODETECT.

EnableDebugMode → bool

Deprecated

Deprecated as of PDFreactor 10. Use Configuration.DebugSettings instead.

Encoding → string

Sets the encoding of the document.

If this value is set to null or it is empty then the encoding will be detected automatically.

The default value is null.

Encryption → Encryption

Sets the encryption.

Use one of the Encryption constants to specify the encryption. The default value is Encryption.NONE.

ErrorPolicies → List<ErrorPolicy>

Specifies error policies that will be used for the conversion. Depending on the policy, the conversion will fail if the appropriate criteria are not met.

FontAliases → List<Font>

Registers an alias font family for an existing font.

This function is limited to fonts loaded automatically from system folders.

FontFallback → List<string>

Sets a list of fallback font families used for character substitution. This list is iterated for characters that can not be displayed with any of the fonts specified via the CSS property font-family.

Fonts → List<Font>

Loads a font from a URL which can be used via the CSS property font-family.

ForceGrayscaleImage → bool

If the output format is an image format, this setting controls whether a grayscale image should be returned. This can not be combined with transparency.

FullCompression → bool

Enables or disables full compression of the PDF document.

The default value is false.

HttpsMode → HttpsMode

Sets the HTTPS mode. In closed environment lenient can be the preferred setting to avoid HTTPS issues that are not security critical

The default value specified is HttpsMode.STRICT.

IgnoreAlpha → bool

Sets whether the alpha value of CSS RGBA colors is ignored. This can be used to avoid conformance issues in PDF/A-1.

InspectableSettings → InspectableSettings

When enabled, makes the converted document inspectable with the PDFreactor Development Tools.

Only works with OutputType.PDF output and requires a license key.

IntegrationStyleSheets → List<Resource>

Adds an integration style sheet to the document.

There are two ways to specify the style sheet:

  1. Specifying the style sheet only using an URI.
  2. Specifying the style sheet by the content of the style sheet and alternatively setting a URI to resolve relative elements. If no URI is specified then the system id/base URL of the document will be used.
JavaScriptMode → JavaScriptMode

Deprecated

Deprecated as of PDFreactor 10. Use Configuration.JavaScriptSettings instead.

JavaScriptSettings → JavaScriptSettings

Specifies JavaScript related settings.

KeepDocument → bool

If set to true prevents the document from being deleted from the PDFreactor Web Service after it has been accessed. This only works for asynchronous conversions.

Keywords → string

Sets the value of the keywords field of the PDF document.

LicenseKey → string

Sets the license key either as content or URL. If the license key is set to null then PDFreactor looks for a license key file file in the same directory where the 'pdfreactor.jar' file is located. If no license key could be found then PDFreactor runs in evaluation mode.

The default value is null.

LogExceedingContent → LogExceedingContent

Deprecated

Deprecated as of PDFreactor 9. Use Configuration.ContentObserver instead.

LogLevel → LogLevel

Sets the log level for the conversion log.

Use one of the LogLevel constants to specify the log level.

The default value is LogLevel.INFO.

LogMaxLines → int

Sets the maximum amount of log entries that will be retained by the PDFreactor logs.

The default value is 100000.

A capacity of 0 is equivalent to the default value. A negative value means that the capacity will be unlimited.

MediaFeatureValues → List<MediaFeatureValue>

Defines the value of a Media Feature which is used to resolve CSS3 media queries.

MediaTypes → List<string>

Sets the media types that are used to resolve CSS3 media queries.

Please note that this overrides the default media types of PDFreactor, which are:

"print", "paged", "visual", "bitmap", "static", "-ro-pdfreactor"

MergeByteArray → byte[]

Deprecated

Deprecated as of PDFreactor 9. Use Configuration.MergeDocuments instead.

MergeByteArrays → List<byte[]>

Deprecated

Deprecated as of PDFreactor 9. Use Configuration.MergeDocuments instead.

MergeDocuments → List<Resource>

This method sets external PDF documents which will be merged with the PDF document generated by the HTML source.

MergeMode → MergeMode

Sets the merge mode.

The following merge methods can be used:

The default value is MergeMode.APPEND.

MergeURL → string

Deprecated

Deprecated as of PDFreactor 9. Use Configuration.MergeDocuments instead.

MergeURLs → List<string>

Deprecated

Deprecated as of PDFreactor 9. Use Configuration.MergeDocuments instead.

OutputFormat → OutputFormat

Sets the OutputFormat. If not specified, a PDF output format will be used.

For image formats the width or height in pixels must be specified.

When either dimension is <1 it is computed based on the other dimension and the aspect ratio of the input document.

OutputIntent → OutputIntent

Sets the output intent including the identifier and the ICC profile to be embedded into the PDF.

Set either the profile URL or the profile data, not both. Certain PDF/X formats require neither, just a known identifier.

OverlayRepeat → OverlayRepeat

If one of the documents of an overlay process is shorter than the other, this method allows repeating either its last page or all of its pages in order to overlay all pages of the longer document.

Use one of the OverlayRepeat constants to specify the overlay repeat. The default value is OverlayRepeat.NONE.

OwnerPassword → string

Sets the owner password of the PDF document.

The default value is null.

PageOrder → PageOrder | string

Sets the page order of the direct result of the conversion.

If Configuration.MergeMode is set to MergeMode.ARRANGE, this method is also used to specify the position of inserted pages from an existing PDF.

A description of the syntax can be found in the manual.

PagesPerSheetProperties → PagesPerSheetProperties

Sets the properties of a sheet on which multiple pages are being arranged.

If PagesPerSheetProperties.cols or PagesPerSheetProperties.rows is less than 1, no pages-per-sheet processing is done. This is the case by default.

Use one of the PagesPerSheetDirection constants to specify the the direction. The default value is PagesPerSheetDirection.RIGHT_DOWN.

PdfScriptAction → List<PdfScriptAction>

Sets a pair of trigger event and PDF script. The script is triggered on the specified event.

A PDF script is JavaScript that is executed by a PDF viewer (e.g. Adobe Reader). Note that most viewers do not support this feature.

PDF Scripts can also be set by using the proprietary CSS property pdf-script-action. More information on this property can be found in the manual.

Please note, that scripts set via CSS have a higher priority. If two scripts are registered on the same event, but one via API and the other via the CSS property, the script set in the CSS will override the other one.

PixelsPerInch → int

Sets the pixels per inch.

Changing this value changes the physical length of sizes specified in px (including those specified via HTML attributes).

The default value is 96 ppi.

PixelsPerInchShrinkToFit → bool

Whether the pixels per inch should be adapted automatically to avoid content exceeding pages.

PostTransformationDocumentType → Doctype

Sets the document type after the XSL-Transformations have been applied.

The Doctype constants can be used to specify the document type. The default value specified is Doctype.AUTODETECT.

PrintDialogPrompt → bool

Enables or disables a print dialog to be shown upon opening the generated PDF document by a PDF viewer.

The default value is false.

ProcessingPreferences → List<ProcessingPreferences>

Preferences that influence the conversion process without changing the output.

Use the ProcessingPreferences constants to specify the processing preferences. By default no processing preference is set.

QuirksSettings → QuirksSettings

Allows to enable or disable behaviors that are otherwise depend on the doctype of the input document.

RawCookies → List<KeyValuePair>

Adds a cookie to all outgoing HTTP connections. The parameters are not URL encoded (see Configuration.Cookies). If the key already exists, the pair is overwritten.

RequestHeaders → List<KeyValuePair>

Adds a request header to all outgoing HTTP connections. If the key already exists, the pair is overwritten.

RequestPriority → int

Specifies the priority of the conversion request. A higher priority means that the web service will adjust the conversion's position in the queue appropriately, so that it is converted before others with lower priority.

By default, asynchronous conversions have a priority of 0, synchronous conversions have a priority of 10.

ResourceConnectTimeout → int

Sets a timeout in milliseconds for connecting to resources, such as HTTP requests to style sheets, images etc. If the connection could not be established until the timeout expires, the request will be aborted and the resource will not be loaded.

A timeout of 0 means that the connection will not time out. A negative value means that no timeout will be set. The default value is 60000 (1min).

ResourceReadTimeout → int

Sets a timeout in milliseconds for reading resources, such as HTTP requests to style sheets, images etc. If the download does not start until the timeout expires, the request will be aborted and the resource will not be loaded.

A timeout of 0 means that the download will not time out. A negative value means that no timeout will be set. The default value is 60000 (1min).

ResourceRequestTimeout → int

Deprecated

Deprecated as of PDFreactor 10. Use Configuration.ResourceConnectTimeout and Configuration.ResourceReadTimeout instead.

SegmentationSettings → SegmentationSettings

This property configures segmentation of the conversion, which helps with very large documents.

SignPDF → SignPDF

Sets a digital certificate to sign the newly created PDF.

Requires a keystore file. The included certificate may be self-signed.

Use the KeystoreType constants to specify the keystore type.

Use the SigningMode constants to specify the cryptographic filter that is used for signing.

Subject → string

Sets the value of the subject field of the PDF document.

ThrowLicenseExceptions → bool

Deprecated

Deprecated as of PDFreactor 9. Use Configuration.ErrorPolicies instead.

Title → string

Sets the value of the title field of the PDF document.

UrlRewriteSettings → UrlRewriteSettings

Specifies settings for URL rewrites, which will transform URLs into others according to certain rules.

UserPassword → string

Sets the user password of the PDF document.

The default value is null.

UserScripts → List<Resource>

Adds an user script to the document.

There are two ways to specify the script:

  1. Specifying the script only by an URI.
  2. Specifying the script by the content of the script and alternatively setting a URI to resolve relative elements. If no URI is specified then the system id/base URL of the document will be used.
UserStyleSheets → List<Resource>

Adds a user style sheet to the document.

There are two ways to specify the style sheet:

  1. Specifying the style sheet only using an URI.
  2. Specifying the style sheet by the content of the style sheet and alternatively setting a URI to resolve relative elements. If no URI is specified then the system id/base URL of the document will be used.
ValidateConformance → bool

Enables PDFreactor to validate the generated PDF against the Conformance specified via Configuration.Conformance.

Currently only PDF/A and PDF/UA validation is supported.

Please note that validation might take several minutes for larger documents.

ViewerPreferences → List<ViewerPreferences>

Sets the page layout and page mode preferences of the PDF.

Use the ViewerPreferences constants to specify the viewer preferences. By default no viewer preference is set.

Xmp → Xmp

Sets custom XMP to be embedded into the PDF document.

If both Xmp.content and Xmp.uri are not set or null no custom XMP is embedded. If XmpPriority is also set to XmpPriority.HIGH automatic generation of required XMP is also suppressed. This may cause output PDFs to not achieve a specified conformance.

XsltMode → bool

Enables or disables XSLT transformations.

Set this value to true to enable XSLT transformations or to false to disable XSLT transformations.

The default value is false.

XsltStyleSheets → List<Resource>

Adds an XSLT style sheet to the document.

There are two ways to specify the style sheet:

  1. Specifying the style sheet only by an URI.
  2. Specifying the style sheet by the content of the style sheet and alternatively setting a URI to resolve relative elements. If no URI is specified then the system id/base URL of the document will be used.

Attachment Namespace: RealObjects.PDFreactor.Webservice.Client

A type containing attachment data.

Data → byte[]

The binary content of the attachment. May be null.

Description → string

The description of the attachment. If this is not set or null the value of Attachment.name is used.

Name → string

The file name associated with the attachment. It is recommended to specify the correct file extension. If this is not set or null the name is derived from Attachment.url.

Url → string

If Attachment.data is not set or set to null, the attachment will be retrieved from this URL.

If this is "#" the input document URL is used instead.

BookletMode Namespace: RealObjects.PDFreactor.Webservice.Client

A type containing booklet mode data.

Rtl → bool

Whether or not the reading order of the booklet should be right-to-left.

SheetMargin → string

The sheet margin as CSS margin value, for example "1in", "1cm 1.5cm" or "10mm 20mm 10mm 30mm". null is interpreted as "0mm".

SheetSize → string

The size of the sheet as CSS value, for example "A3", "letter landscape", "15in 20in" or "20cm 30cm".

Bundle Namespace: RealObjects.PDFreactor.Webservice.Client

A type representing a bundle of documents.
Documents → List<Document>
An array of documents requests.

Callback Namespace: RealObjects.PDFreactor.Webservice.Client

A type containing callback data.

ContentType → ContentType

The content type of the payload that is posted.

Interval → int

The interval in seconds at which to trigger repeating callbacks.

Only applies CallbackType.PROGRESS.

Timeout → int

An optional timeout for the callback in milliseconds. A value of zero or negative values are treated as an infinite timeout.

Type → CallbackType

The event to trigger the callback.

Url → string

The URL to call back.

ColorSpaceSettings Namespace: RealObjects.PDFreactor.Webservice.Client

A type containing settings for the potential conversion of CSS colors and images into the target color space.

CmykIccProfile → Resource

Specifies the ICC profile which defines the CMYK color space into or from which CSS colors and images are converted, if ColorSpaceSettings.conversionEnabled.

ConversionEnabled → bool

Enables the conversion of CSS colors and images to the ColorSpaceSettings.targetColorSpace using the ColorSpaceSettings.cmykIccProfileUrl or naively if there is none.

TargetColorSpace → ColorSpace

Specifies the target color-space of the PDF.

This is the color space, CSS keyword based colors are converted to, as well as, if ColorSpaceSettings.conversionEnabled, other CSS colors and images.

It also is the color space for PDF/A and PDF/X documents.

Defaults to ColorSpace.RGB RGB.

Connection Namespace: RealObjects.PDFreactor.Webservice.Client

A type that describes a URL connection attempt of PDFreactor during a conversion.

Cached → bool

Whether the response was retrieved from a cache.

Connected → bool

Whether a URL connection could be established by PDFreactor. If this is false, see Connection.error for details.

ContentSize → int

The amount of content bytes downloaded or read from this connection.

Duration → int

The duration in milliseconds how long this connection remained open.

Error → string

The error message if the connection could not be established.

Method → string

The request method used by the underlying HTTP request (like "GET", "POST", etc.) or null if this is not an HTTP connection or the connection could not be established.

Protocol → string

The protocol of the URL connection.

RequestContentSize → int

The amount of content bytes uploaded or written to this connection.

RequestHeaders → List<KeyValuePair>

The request headers.

Note: If a header has multiple values, there will be one KeyValuePair for each value with the header name as key.

ResourceType → ResourceType

The type of resource (style sheet, image, etc.) transferred over this connection.

ResponseHeaders → List<KeyValuePair>

The response headers.

Note: If a header has multiple values, there will be one KeyValuePair for each value with the header name as key.

StatusCode → int

The response code for HTTP connections or 0 for all other connections.

StatusMessage → string

The response message for the response code or null if the response code is 0 or the message could not be determined.

Timestamp → int

The time stamp of this connection.

Url → string

The URL.

ConnectionSettings Namespace: RealObjects.PDFreactor.Webservice.Client

A type that contains optional settings for the communication between client and PDFreactor Web Service.
Cookies → NameValueCollection
A collection of name-value-pairs representing the cookies that will be added to the HTTP request to the PDFreactor Web Service. This property is empty by default and additional cookies can be added as required. Cookies should only be added in special environments where it is necessary, e.g. when using a load balancer. If the PDFreactor Web Service's response contains any cookies, they will be added to this property, potentially overwriting cookies with the same name.
Headers → NameValueCollection
A collection of name-value-pairs representing the request headers that will be added to the HTTP request to the PDFreactor Web Service. This property is empty by default and additional headers can be added as required. Headers should only be added in special environments where it is necessary.

ContentObserver Namespace: RealObjects.PDFreactor.Webservice.Client

A type containing specifications on which content should be observed.

Connections → bool

Enables observation of URL connections done by PDFreactor.

ExceedingContentAgainst → ExceedingContentAgainst

Enables observation of exceeding content either against the page edges, page content areas or containers.

ExceedingContentAnalyze → ExceedingContentAnalyze

Enables observation of exceeding content and optionally of boxes.

MissingResources → bool

Enables observation of resources that could not be loaded.

ContinuousOutput Namespace: RealObjects.PDFreactor.Webservice.Client

A type containing continuous output data.

Height → int

Equivalent to the height of a browser window (view port). For values <1 the entire height of the document is used.

Width → int

Equivalent to the width of a browser window (view port). Values <1 enable paginated output.

CssSettings Namespace: RealObjects.PDFreactor.Webservice.Client

A type containing settings of how CSS properties are supported.

SupportQueryMode → CssPropertySupport

Adjusts the CSS property support behavior.

ValidationMode → CssPropertySupport

Adjusts the CSS property validation behavior.

DebugSettings Namespace: RealObjects.PDFreactor.Webservice.Client

A type containing various options for debugging.

All → bool

This is a convenience property that enables the following DebugSettings:

AppendLogs → bool

Specifies whether the logs will be appended to the resulting PDF.

AttachConfiguration → bool

Specifies whether the configuration will be attached to the generated PDF.

AttachDocuments → bool

Specifies whether all debug files belonging to the group "documents" will be attached to the generated PDF. Please see the manual for more information.

AttachLogs → bool

Specifies whether all debug files belonging to the group "logs" will be attached to the generated PDF. Please see the manual for more information.

AttachResources → bool

Specifies whether all debug files belonging to the group "resources" will be attached to the generated PDF. Please see the manual for more information.

ForceResult → bool

Forces PDFreactor to return a result, regardless of any exceptions or errors that may have occurred during the conversion.

If an exception or error occurred during the conversion, its stack trace and the PDFreactor log is written as-is into the result data stream. This means that the resulting document will not be a valid PDF but can be opened with an appropriate text editor to view the log and errors.

Document Namespace: RealObjects.PDFreactor.Webservice.Client

A type representing a document request
Id → string
The document ID.
Name → string
The file name representing the document in the ZIP. If the document is a multi-image, you can use the '#' character in the file name as a placeholder for the page number.

ExceedingContent Namespace: RealObjects.PDFreactor.Webservice.Client

A type that describes one instance of content exceeding its page or parent.

Bottom → bool

Returns whether the content exceeds the page at the bottom.

Box → bool

Returns whether the exceeding content is a box instead of text or image content.

ContainerBottom → int

Returns the bottom coordinate of the the container box in the page in pixels. Depending on the settings this box may be the page.

ContainerLeft → int

Returns the left coordinate of the the container box in the page in pixels. Depending on the settings this box may be the page.

ContainerRight → int

Returns the right coordinate of the the container box in the page in pixels. Depending on the settings this box may be the page.

ContainerTop → int

Returns the top coordinate of the the container box in the page in pixels. Depending on the settings this box may be the page.

Description → string

Returns a description of the content. In case of text content, the text is returned. In case of images the URL is returned if available.

ExceedingBoxBottom → int

Returns the bottom coordinate of the the exceeding box in the page in pixels.

ExceedingBoxLeft → int

Returns the left coordinate of the the exceeding box in the page in pixels.

ExceedingBoxRight → int

Returns the right coordinate of the the exceeding box in the page in pixels.

ExceedingBoxTop → int

Returns the top coordinate of the the exceeding box in the page in pixels.

Html → string

Returns the HTML of the box that contains the exceeding content.

Left → bool

Returns whether the content exceeds the page to the left.

PageBottom → int

Returns the bottom coordinate of the the page in pixels.

PageLeft → int

Returns the left coordinate of the the page in pixels.

PageNumber → int

Returns the number of the page that contains the exceeding content.

PageRight → int

Returns the right coordinate of the the page in pixels.

PageTop → int

Returns the top coordinate of the the page in pixels.

Path → List<int>

Returns an array of integers denoting the indexes of the ancestors of the DOM node corresponding to the box containing the exceeding content, starting from below the root node down to the element itself.

Right → bool

Returns whether the content exceeds the page to the right.

Summary → string

Returns a summary of this exceeding content object.

Top → bool

Returns whether the content exceeds the page at the top.

Font Namespace: RealObjects.PDFreactor.Webservice.Client

A type containing font data.

Bold → bool

Whether the alias will be labeled bold.

Family → string

The alias name for that font.

Italic → bool

Whether the alias will be labeled italic.

Source → string

The source URL of the font (when adding new fonts) or the name of an existing font family (when creating an alias).

InspectableSettings Namespace: RealObjects.PDFreactor.Webservice.Client

A type containing settings related to inspectable documents.

Enabled → bool

Specifies whether to make the document inspectable.

EndPage → int

Specifies an optional page number below which the DOM is not inspected.

Page numbers start at 1. The default 0 goes up the last page. Other values are inclusive.

StartPage → int

Specifies an optional page number below which the DOM is not inspected.

Page numbers start at 1. The default 0 starts at the first page.

JavaScriptSettings Namespace: RealObjects.PDFreactor.Webservice.Client

A type containing settings related to JavaScript.

DebugIndentation → int

Specifies the amount of spaces per indentation level when using JavaScript debugging.

The default value is 0.

DebugMode → JavaScriptDebugMode

Specifies the debug mode.

Any other value than the default JavaScriptDebugMode.NONE impacts performance significantly and should not be used in production.

Enabled → bool

Specifies whether to process JavaScript.

IgnoreScriptElements → bool

Specifies whether to ignore <script> elements in the document, only executing user scripts.

MaxQueuedTasks → int

Specifies the maximum amount of tasks to be queued before ending JavaScript processing.

Values smaller than 1 default to 1,000,000.

MaxScriptElements → int

Specifies the maximum amount of script elements in the document to process.

Values smaller than 1 default to 1,000,000.

MaxTasksWithoutDomChange → int

Specifies the maximum amount of tasks to be allowed to be queued, while the DOM does not change, before ending JavaScript processing.

Values smaller than 1 default to 1,000.

MaxVirtualTimeOffset → int

Specifies the maximum amount of virtual time in seconds to let pass before ending JavaScript processing.

Values smaller than 1 default to 3600 (1h).

NoLayout → bool

Specifies whether to process JavaScript without causing document layouts or updates.

This can speed up conversions, but will break a significant amount of functionality and libraries.

NoVirtualTime → bool

Specifies whether not to use virtual time for JavaScript.

Only use if required for a specific library.

TimeLapse → bool

Specifies whether to fast-forward the virtual time of JavaScript every time it is retrieved.

Only use if required for a specific library.

Timeout → int

Sets a timeout in seconds for JavaScript processing If the timeout is exceeded, the conversion will be aborted.

A timeout of 0 or negative values mean that the conversion will never time out. This is also the default behavior if no timeout is specified.

KeyValuePair Namespace: RealObjects.PDFreactor.Webservice.Client

A type containing a key-value-pair.

Key → string

The key.

Value → string

The value.

Log Namespace: RealObjects.PDFreactor.Webservice.Client

A type representing the log of a conversion.
Records → List<Record>
The log records of the main PDFreactor log.
RecordsCss → List<Record>
The log records of the PDFreactor CSS log.
RecordsJavaScript → List<Record>
The log records of the PDFreactor JavaScript log.

LogExceedingContent Namespace: RealObjects.PDFreactor.Webservice.Client

A type containing data for logging exceeding content.

LogExceedingContentAgainst → ExceedingContentAgainst

Enables logging of exceeding content either against the page edges, page content areas or containers.

LogExceedingContentAnalyze → ExceedingContentAnalyze

Enables logging of exceeding content and optionally of boxes.

MediaFeatureValue Namespace: RealObjects.PDFreactor.Webservice.Client

A type containing media feature data.

MediaFeature → MediaFeature

The media feature.

Value → string

The value that is associated with the given media feature.

MissingResource Namespace: RealObjects.PDFreactor.Webservice.Client

A type that describes a missing resource.

Message → string

The message indicating why the resource could not be found.

Resource → string

The resource identifier. Usually a URL string.

Type → ResourceType

The type of resource (style sheet, image, etc.).

OutputFormat Namespace: RealObjects.PDFreactor.Webservice.Client

A type containing output data.

Height → int

The height of the output in pixels (image formats only). Values <1 will be computed based on the specified width and the aspect ratio of the input document.

MultiImage → bool

Indicates whether the image output will be paginated into multiple images.

PixelDensity → int

The pixel density of the output (image formats only). When neither 'width' nor 'height' is specified this is used to determine the dimensions of the image from the page size. Values <1 default to 96dpi.

PixelDensityUnit → ResolutionUnit

The unit of the pixel density. Defaults to dpi.

Type → OutputType

The output format. See OutputType constants. Defaults to OutputType.PDF.

Width → int

The with of the output in pixels (image formats only). Values <1 will be computed based on the specified height and the aspect ratio of the input document.

OutputIntent Namespace: RealObjects.PDFreactor.Webservice.Client

A type containing data for an output intents.

Data → byte[]

The profile data.

Identifier → OutputIntentDefaultProfile | string

The identifier.

Url → string

The profile URL.

PagesPerSheetProperties Namespace: RealObjects.PDFreactor.Webservice.Client

A type containing data for pages per sheet properties.

Cols → int

The number of columns per sheet.

Direction → PagesPerSheetDirection

The direction in which the pages are ordered on a sheet.

Rows → int

The number of rows per sheet.

SheetMargin → string

The sheet margin as CSS margin, for example "1in", "1cm 1.5cm" or "10mm 20mm 10mm 30mm". null is interpreted as "0mm".

SheetSize → string

The sheet size as CSS size, for example "A4", "letter landscape", "15in 20in" or "20cm 30cm".

Spacing → string

The horizontal and vertical space between pages on a sheet as CSS value, for example "0.1in" or "5mm 2mm". null is interpreted as "0mm".

PdfScriptAction Namespace: RealObjects.PDFreactor.Webservice.Client

A type containing PDF script data.

Script → string

The script source that should be executed.

TriggerEvent → PdfScriptTriggerEvent

The event on which the script is executed. Value is a PdfScriptTriggerEvent constant.

Progress Namespace: RealObjects.PDFreactor.Webservice.Client

A type representing the progress of an asynchronous conversion.
CallbackUrl → string
If this object was created for a callback, this property indicates the callback's URL.
ContentType → string
The content type of the resulting document as a MIME type string. Depends on what OutputType was set in the Configuration. If none was set, the content type defaults to "application/pdf".
ConversionName → string
Returns the name of the conversion if it was specified via Configuration.ConversionName.
DocumentId → string
The document ID of the conversion. This ID can be used to poll the progress or retrieve the result.
DocumentUrl → string
The relative URL to the location where you can download the generated document once it is finished.
DocumentUrls → List<string>
The relative URLs to the locations where you can download the generated documents once they are finished.
Finished → bool
Indicates whether the conversion is finished yet.
Log → Log
The log of the conversion.
ProgressValue → int
The current progress of the conversion. The value is between 0 and 100.
StartDate → DateTime
The date and time when the conversion was started on the server.

QuirksSettings Namespace: RealObjects.PDFreactor.Webservice.Client

A type containing quirks settings.

CaseSensitiveClassSelectors → QuirksMode

By default in HTML CSS class selectors are case sensitive.

In the default QuirksMode.DETECT mode this behavior is disabled for old HTML doctypes or when there is no doctype.

To enable or disable it independently of the document this property can be set to QuirksMode.STANDARDS or QuirksMode.QUIRKS respectively.

MinLineHeightFromContainer → QuirksMode

By default the line-height of text containers, e.g. paragraph elements, is used as the minimum line-height of their lines.

In the default QuirksMode.DETECT mode this behavior is disabled for old HTML doctypes or when there is no doctype.

To enable or disable it independently of the document this property can be set to QuirksMode.STANDARDS or QuirksMode.QUIRKS respectively.

Record Namespace: RealObjects.PDFreactor.Webservice.Client

A log record.
Level → int
The level of the record.
LevelName → string
The textual representation of the level.
Message → string
The logged message.
Timestamp → int
The timestamp.

Resource Namespace: RealObjects.PDFreactor.Webservice.Client

A type containing data for external resources such as style sheets.

BeforeDocumentScripts → bool

Use true to cause PDFreactor to run the script before all scripts inside the document and false to run it after.

Only supported for JavaScript-type resources.

Content → string

The content of the resource. Only supported for Style Sheet- and Script-type resources.

Data → byte[]

The binary data of the resource.

Uri → string

The URI of the resource.

Result Namespace: RealObjects.PDFreactor.Webservice.Client

A type representing the result of a conversion.
CallbackUrl → string
If this object was created for a callback, this property indicates the callback's URL.
Connections → List<Connection>

Provides a log about all URL connections attempted by PDFreactor, including information about HTTP request and result, should the connection be an HTTP or HTTPS connection. Depends on the mode set via Configuration.ContentObserver.

ContentType → string
The content type of the resulting document as a MIME type string. Depends on what OutputType was set in the Configuration. If none was set, the content type defaults to "application/pdf".
ConversionName → string
Returns the name of the conversion if it was specified via Configuration.ConversionName.
Document → byte[]

The resulting PDF or image.

This is not present if only the document's metadata was retrieved.

Alternatively, the input document can be specified directly as byte[].
DocumentArray → List<byte[]>

The resulting image as a collection of separate images, each representing a single page. This property is only present if the configuration option "multiImage" was set to true.

This is also not present if only the document's metadata was retrieved.

DocumentId → string
The document ID of the conversion. This ID can be used to poll the progress or retrieve the result.
DocumentUrl → string
The relative URL to the location where you can download the generated document once it is finished.
DocumentUrls → List<string>
The relative URLs to the locations where you can download the generated documents once they are finished.
EndDate → DateTime

The date and time when the conversion was finished on the server.

Error → string

Returns the error messages that might have been generated during rendering.

ExceedingContents → List<ExceedingContent>

Provides information about content exceeding its page or parent. Depends on the mode set via "logExceedingContents".

JavaScriptExports → string

Returns data that has been exported from document JavaScript via ro.exports if set, null otherwise. If the JavaScript data is not a string, it will be converted to JSON. If the data can't be converted, a generic string representation is used or null if none is available.

KeepDocument → bool

Indicates whether or not the keepDocument property was set in the Configuration of this conversion. If true, additional requests can be made to retrieve this document.

Log → Log

Returns the log messages generated during rendering based on the log level.

MissingResources → List<MissingResource>

Provides information about resources that could not be loaded during the conversion. Depends on the mode set via Configuration.ContentObserver.

NumberOfPages → int

Returns the number of pages of the document after conversion.

NumberOfPagesLiteral → int

Returns the number of pages of the resulting PDF (including, e.g., merge operations), otherwise it will return the number pages of the laid out input document.

StartDate → DateTime
The date and time when the conversion was started on the server.

ScriptResource Namespace: RealObjects.PDFreactor.Webservice.Client

Deprecated as of PDFreactor 9. Use Resource instead.

BeforeDocumentScripts → bool

Use true to cause PDFreactor to run the script before all scripts inside the document and false to run it after.

Only supported for JavaScript-type resources.

Content → string

The content of the resource. Only supported for Style Sheet- and Script-type resources.

Data → byte[]

The binary data of the resource.

Uri → string

The URI of the resource.

SegmentationSettings Namespace: RealObjects.PDFreactor.Webservice.Client

A type containing settings for segmenting input documents.

Enabled → bool

Enables or disables segmentation.

SegmentSize → int

The preferred size (in number of pages) of the segments into which the conversion will be split.

Valid values range from 10 to 1000. Values smaller than 1 default to 1000.

SignPDF Namespace: RealObjects.PDFreactor.Webservice.Client

A type containing data for signing the PDF.

KeyAlias → string

The alias of the certificate included in the keystore to be used to sign the PDF.

KeyPassword → string

The password for the certificate included in the keystore to be used to sign the PDF.

If none is provided, the keystore password will be used for the certificate.

KeystorePassword → string

The password of the keystore.

KeystoreType → KeystoreType

The format of the keystore, for example PKCS #12 or JKS. Use one of the KeystoreType constants as value.

KeystoreURL → string

The URL to the keystore file.

SigningMode → SigningMode

The cryptographic filter mode that is used to sign the PDF, like SELF_SIGNED, VERISIGN_SIGNED or WINCER_SIGNED.

Use one of the SigningMode constants as value.

UrlRewriteRule Namespace: RealObjects.PDFreactor.Webservice.Client

A type containing various options for debugging.

Pattern → string

The regular expression pattern which is matched against each URL.

Note that the URLs are always absolute. If they are initially relative in the document or other resources, they are resolved.

Substitution → string

If a URL matches the UrlRewriteRule.pattern, it is replaced by this substitution. Since the pattern is a regular expression, the substitution can include group identifiers or back references.

UrlRewriteSettings Namespace: RealObjects.PDFreactor.Webservice.Client

A type containing various options for URL rewrites.

Rules → List<UrlRewriteRule>

The rules according to which URLs are rewritten.

Version Namespace: RealObjects.PDFreactor.Webservice.Client

A type representing the version of PDFreactor.
Build → int
The build number.
Label → string
The label of the version.
Major → int
The major version.
Micro → int
The micro version.
Minor → int
The minor version.
Revision → string
The revision number.
Text → string
The version as text.

Xmp Namespace: RealObjects.PDFreactor.Webservice.Client

A type containing XMP data.

Content → string

XMP, as an XML string, to be embedded into the PDF document.

Priority → XmpPriority

Priority of this XMP over XMP generated automatically for the conformance requirements of certain output formats.

Uri → string

URI to XMP to be embedded into the PDF document, if Xmp.content is not set or null.

Constants

AddressType Namespace: RealObjects.PDFreactor.Webservice.Client.Configuration

An enum containing IP address types.

Link-local addresses or auto-IPs.

LOCAL

Localhost addresses, including "localhost" or "0.0.0.0".

PRIVATE

Private network addresses.

PUBLIC

Public internet addresses.

CallbackType Namespace: RealObjects.PDFreactor.Webservice.Client.Configuration

An enum containing callback type constants.

FINISH

This callback is called when the conversion is finished.

PROGRESS

This callback is called regularly to inform on the progress of the conversion.

START

This callback is called when the conversion is started.

Cleanup Namespace: RealObjects.PDFreactor.Webservice.Client.Configuration

An enum containing cleanup constants.

CYBERNEKO

Indicates that the CyberNeko HTML parser will be used to perform a cleanup when loading a non-well-formed document.

JTIDY

Indicates that JTidy will be used to perform a cleanup when loading a non-well-formed document.

NONE

Indicates that no cleanup will be performed when loading a document. If the loaded document is not well-formed, an exception will be thrown.

TAGSOUP

Indicates that tagsoup will be used to perform a cleanup when loading a non-well-formed document.

ColorSpace Namespace: RealObjects.PDFreactor.Webservice.Client.Configuration

An enum containing color space constants.

CMYK

The color space CMYK.

RGB

The color space RGB.

Conformance Namespace: RealObjects.PDFreactor.Webservice.Client.Configuration

An enum containing conformance constants.

PDF

PDF with no additional restrictions (default)

PDFA1A

PDF/A-1a (ISO 19005-1:2005 Level A)

PDFA1A_PDFUA1

PDF/A-1a + PDF/UA-1 (ISO 19005-1:2005 Level A + ISO 14289-1:2014)

PDFA1B

PDF/A-1b (ISO 19005-1:2005 Level B)

PDFA2A

PDF/A-2a (ISO 19005-2:2011 Level A)

PDFA2A_PDFUA1

PDF/A-2a + PDF/UA-1 (ISO 19005-2:2011 Level A + ISO 14289-1:2014)

PDFA2B

PDF/A-2b (ISO 19005-2:2011 Level B)

PDFA2U

PDF/A-2u (ISO 19005-2:2011 Level U)

PDFA3A

PDF/A-3a (ISO 19005-3:2012 Level A)

PDFA3A_PDFUA1

PDF/A-3a + PDF/UA-1 (ISO 19005-3:2012 Level A + ISO 14289-1:2014)

PDFA3B

PDF/A-3b (ISO 19005-3:2012 Level B)

PDFA3U

PDF/A-3u (ISO 19005-3:2012 Level U)

PDFUA1

PDF/UA-1 (ISO 14289-1:2014)

PDFX1A_2001

PDF/X-1a:2001 (ISO 15930-1:2001)

PDFX1A_2003

PDF/X-1a:2003 (ISO 15930-4:2003)

PDFX3_2002

PDF/X-3:2002 (ISO 15930-3:2002)

PDFX3_2003

PDF/X-3:2003 (ISO 15930-6:2003)

PDFX4

PDF/X-4 (ISO 15930-7:2008)

PDFX4P

PDF/X-4p (ISO 15930-7:2008)

ConnectionRuleAction Namespace: RealObjects.PDFreactor.Webservice.Client.Configuration

An enum containing security rule action constants.

ALLOW

Allows connections to resources matching the rule.

DENY

Denies connections to resources matching the rule.

ContentType Namespace: RealObjects.PDFreactor.Webservice.Client.Configuration

An enum containing content type constants.

BINARY

Content type BINARY, corresponds with "application/octet-stream" MIME type.

BMP

Content type BMP, corresponds with "image/bmp" MIME type.

GIF

Content type GIF, corresponds with "image/gif" MIME type.

HTML

Content type HTML, corresponds with "text/html" MIME type.

JPEG

Content type JPEG, corresponds with "image/jpeg" MIME type.

JSON

Content type JSON, corresponds with "application/json" MIME type.

NONE

Content type NONE, i.e. no content.

PDF

Content type PDF, corresponds with "application/pdf" MIME type.

PNG

Content type PNG, corresponds with "image/png" MIME type.

TEXT

Content type TEXT, corresponds with "text/plain" MIME type.

TIFF

Content type TIFF, corresponds with "image/tiff" MIME type.

XML

Content type XML, corresponds with "application/xml" MIME type.

CssPropertySupport Namespace: RealObjects.PDFreactor.Webservice.Client.Configuration

An enum containing CSS property support mode constants.

ALL

Indicates that all style declarations are considered valid disregarding the possibility of improper rendering.

Valid values may be overwritten by invalid style declarations.

HTML

Indicates that all values set in style declarations will be validated as long as PDFreactor supports the corresponding property.

Style declarations for properties not supported by PDFreactor are taken as invalid.

HTML_THIRD_PARTY

Indicates that all values set in style declarations will be validated as long as PDFreactor supports the corresponding property.

Style declarations for properties not supported by PDFreactor but by third party products are taken as valid.

HTML_THIRD_PARTY_LENIENT

Indicates that all values set in style declarations will be taken as valid if a third party product supports the corresponding property.

Style declarations for properties not supported by any third party product but supported by PDFreactor will be validated.

Doctype Namespace: RealObjects.PDFreactor.Webservice.Client.Configuration

An enum containing document type constants.

AUTODETECT

Indicates that the document type will be detected automatically. A document has the type Doctype.HTML5 if the name of the root element is "html" (ignoring case considerations). In all other cases the document type is Doctype.XML.

HTML5

Indicates that the document type will be set to HTML5. The HTML default style sheet is used and the document is loaded regarding style elements, style attributes and link stylesheets.

XHTML

Indicates that the document type will be set to XHTML. The HTML default style sheet is used and the document is loaded regarding style elements, style attributes and link stylesheets.

XML

Indicates that the document type will be set to generic XML. No default style sheet is used and the document is loaded as is without regards to style elements or attributes.

Encryption Namespace: RealObjects.PDFreactor.Webservice.Client.Configuration

An enum containing encryption constants.

NONE

Indicates that the document will not be encrypted. If encryption is disabled then no user password and no owner password can be used.

TYPE_128

Indicates that the document will be encrypted using RC4 128 bit encryption. For normal purposes this value should be used.

TYPE_40

Indicates that the document will be encrypted using RC4 40 bit encryption.

ErrorPolicy Namespace: RealObjects.PDFreactor.Webservice.Client.Configuration

An enum containing error policies.

CONFORMANCE_VALIDATION_UNAVAILABLE

Whether an exception should be thrown when the PDF's conformance was not validated even though Configuration.ValidateConformance was enabled. Now exceptions will be thrown if the validation module is not available or the conformance format is not fully supported for validation.

Use this policy only if you exclusively convert documents where validation is supported and strictly required.

LICENSE

Whether an exception should be thrown when no legal full license key is set. This allows to programmatically ensure that documents are not altered due to license issues.

MISSING_RESOURCE

Whether an exception should be thrown when resources could not be loaded.

UNCAUGHT_JAVASCRIPT_EXCEPTION

Whether an exception should be thrown when there are uncaught exceptions in the input document JavaScript, including syntax error.

ExceedingContentAgainst Namespace: RealObjects.PDFreactor.Webservice.Client.Configuration

An enum containing constants for logging exceeding content against.

NONE

Do not log exceeding content.

PAGE_BORDERS

Log content exceeding the edges of its page.

PAGE_CONTENT

Log content exceeding its page content area (overlaps the page margin).

PARENT

Log content exceeding its container.

ExceedingContentAnalyze Namespace: RealObjects.PDFreactor.Webservice.Client.Configuration

An enum containing constants for analyzing exceeding content.

CONTENT

Log exceeding content.

CONTENT_AND_BOXES

Log exceeding content and all boxes.

CONTENT_AND_STATIC_BOXES

Log exceeding content and boxes without absolute positioning.

NONE

Do not log exceeding content.

HttpsMode Namespace: RealObjects.PDFreactor.Webservice.Client.Configuration

An enum containing HTTPS mode constants.

LENIENT

Indicates lenient HTTPS behavior. This means that many certificate issues are ignored.

STRICT

Indicates strict HTTPS behavior. This matches the default behavior of Java.

JavaScriptDebugMode Namespace: RealObjects.PDFreactor.Webservice.Client.Configuration

An enum containing JavaScript debug mode constants.

EXCEPTIONS

Indicates that all exceptions thrown during JavaScript processing are logged in addition to the effects of POSITIONS.

FUNCTIONS

Indicates that all JavaScript functions entered or exited are logged in addition to the effects of POSITIONS and EXCEPTIONS.

LINES

Indicates that every line of executed JavaScript is logged in addition to the effects of POSITIONS, EXCEPTIONS and FUNCTIONS.

NONE

Indicates that debugging is disabled.

POSITIONS

Indicates that the filenames and line numbers that caused output (e.g. via console.log) are logged.

JavaScriptMode Namespace: RealObjects.PDFreactor.Webservice.Client.Configuration

Deprecated as of PDFreactor 10. Use JavaScriptSettings instead.

DISABLED

Indicates that JavaScript is disabled.

ENABLED

Indicates that JavaScript is enabled.

ENABLED_NO_LAYOUT

Indicates that JavaScript is enabled, without access to layout data.

ENABLED_REAL_TIME

Indicates that JavaScript is enabled, without converter-specific optimizations to timeouts and intervals.

This mode is significantly more time consuming and should only be used when no other mode provides the expected results.

ENABLED_TIME_LAPSE

Indicates that JavaScript is enabled, with time stamps increasing more quickly.

This makes some kinds of JS based animations (e.g. when using jQuery) finish immediately, which has the same effect as JavaScriptMode.ENABLED_REAL_TIME, but is significantly faster.

Only Date.getTime() is affected by this.

KeystoreType Namespace: RealObjects.PDFreactor.Webservice.Client.Configuration

An enum containing keystore type constants.

JKS

Keystore type "jks".

PKCS12

Keystore type "pkcs12".

LogLevel Namespace: RealObjects.PDFreactor.Webservice.Client.Configuration

An enum containing log level constants.

DEBUG

Indicates that debug, info, warn and fatal log events will be logged.

FATAL

Indicates that only fatal log events will be logged.

INFO

Indicates that info, warn and fatal log events will be logged.

NONE

Indicates that no log events will be logged.

PERFORMANCE

Indicates that all log events will be logged.

WARN

Indicates that warn and fatal log events will be logged.

MediaFeature Namespace: RealObjects.PDFreactor.Webservice.Client.Configuration

An enum containing media feature constants.

ASPECT_RATIO

CSS 3 Media Feature describing the aspect ratio of the page content.

By default, this value is computed using the values of MediaFeature.WIDTH and MediaFeature.HEIGHT. Setting a specific value does override the computed value.

COLOR

CSS 3 Media Feature describing the number of bits per color component.

Default value is 8.

COLOR_INDEX

CSS 3 Media Feature describing the number of entries in the color lookup table.

Default value is 0, as there is no color lookup table.

DEVICE_ASPECT_RATIO

CSS 3 Media Feature describing the aspect ratio of the page.

By default, this value is computed using the values of MediaFeature.DEVICE_WIDTH and MediaFeature.DEVICE_HEIGHT. Setting a specific value does override the computed value.

DEVICE_HEIGHT

CSS 3 Media Feature describing the height of the page.

The default height is that of a DIN A4 page (297mm).

DEVICE_WIDTH

CSS 3 Media Feature describing the width of the page.

The default width is that of a DIN A4 page (210mm).

GRID

CSS 3 Media Feature defining whether the output is grid-based.

Default value 0, as PDFs are not grid-based.

HEIGHT

CSS 3 Media Feature height of page content.

The default height is that of a DIN A4 page with 1cm margin (277mm).

MONOCHROME

CSS 3 Media Feature describing the number of bits per pixel in a monochrome frame buffer.

Default value is 0, as the device is not monochrome.

ORIENTATION

CSS 3 Media Feature describing the page orientation.

By default, this value is computed using the values of MediaFeature.WIDTH and MediaFeature.HEIGHT. Setting a specific value does override the computed value.

Valid values are "portrait" or "landscape".

RESOLUTION

CSS 3 Media Feature describing the resolution of the output device.

This also defines the value of the window.devicePixelRatio property available from JavaScript.

Default value is 2dppx.

WIDTH

CSS 3 Media Feature width of page content.

The default width is that of a DIN A4 page with 1cm margin (190mm).

MergeMode Namespace: RealObjects.PDFreactor.Webservice.Client.Configuration

An enum containing merge mode constants.

APPEND

Default merge mode: Append converted document to existing PDF.

ARRANGE

Advanced merge mode: Allows to insert specific pages from existing PDFs into the converted document.

This is done via a special syntax of Configuration.PageOrder.

OVERLAY

Alternate merge mode (overlay): Adding converted document above the existing PDF.

OVERLAY_BELOW

Alternate merge mode (overlay): Adding converted document below the existing PDF.

PREPEND

Alternate merge mode: Prepend converted document to existing PDF.

OutputIntentDefaultProfile Namespace: RealObjects.PDFreactor.Webservice.Client.Configuration

An enum containing default profiles for output intents.

FOGRA39

"Coated FOGRA39" output intent default profile.

GRACOL

"Coated GRACoL 2006" output intent default profile.

IFRA

"ISO News print 26% (IFRA)" output intent default profile.

JAPAN

"Japan Color 2001 Coated" output intent default profile.

JAPAN_NEWSPAPER

"Japan Color 2001 Newspaper" output intent default profile.

JAPAN_UNCOATED

"Japan Color 2001 Uncoated" output intent default profile.

JAPAN_WEB

"Japan Web Coated (Ad)" output intent default profile.

SWOP

"US Web Coated (SWOP) v2" output intent default profile.

SWOP_3

"Web Coated SWOP 2006 Grade 3 Paper" output intent default profile.

OutputType Namespace: RealObjects.PDFreactor.Webservice.Client.Configuration

An enum containing output format constants.

BMP

BMP output format.

GIF

GIF output format.

GIF_DITHERED

JPEG output format, with dithering applied.

JPEG

JPEG output format.

PDF

PDF output format.

PNG

PNG output format.

PNG_AI

Deprecated

PNG output format (deprecated alternative name).

PNG_TRANSPARENT

Transparent PNG output format.

PNG_TRANSPARENT_AI

Deprecated

Transparent PNG output format (deprecated alternative name).

TIFF_CCITT_1D

Monochrome CCITT 1D/RLE compressed TIFF output format.

TIFF_CCITT_1D_DITHERED

Monochrome CCITT 1D/RLE compressed TIFF output format, with dithering applied.

TIFF_CCITT_GROUP_3

Monochrome CCITT Group 3/T.4 compressed TIFF output format.

TIFF_CCITT_GROUP_3_DITHERED

Monochrome CCITT Group 3/T.4 compressed TIFF output format, with dithering applied.

TIFF_CCITT_GROUP_4

Monochrome CCITT Group 4/T.6 compressed TIFF output format.

TIFF_CCITT_GROUP_4_DITHERED

Monochrome CCITT Group 4/T.6 compressed TIFF output format, with dithering applied.

TIFF_LZW

LZW compressed TIFF output format.

TIFF_PACKBITS

PackBits compressed TIFF output format.

TIFF_UNCOMPRESSED

Uncompressed TIFF output format.

OverlayRepeat Namespace: RealObjects.PDFreactor.Webservice.Client.Configuration

An enum containing data for repeating overlays.

ALL_PAGES

All pages of the shorter document are repeated, to overlay all pages of the longer document.

LAST_PAGE

Last page of the shorter document is repeated, to overlay all pages of the longer document.

NONE

No pages of the shorter document are repeated, leaving some pages of the longer document without overlay.

TRIM

The resulting PDF is trimmed to the number of pages of the shorter document.

PageOrder Namespace: RealObjects.PDFreactor.Webservice.Client.Configuration

An enum containing pre-defined page orders.

BOOKLET

Page order mode to arrange all pages in booklet order.

BOOKLET_RTL

Page order mode to arrange all pages in right-to-left booklet order.

EVEN

Page order mode to keep even pages only.

ODD

Page order mode to keep odd pages only.

REVERSE

Page order mode to reverse the page order.

PagesPerSheetDirection Namespace: RealObjects.PDFreactor.Webservice.Client.Configuration

An enum containing constants for pages per sheet directions.

DOWN_LEFT

Arranges the pages on a sheet from top to bottom and right to left.

DOWN_RIGHT

Arranges the pages on a sheet from top to bottom and left to right.

LEFT_DOWN

Arranges the pages on a sheet from right to left and top to bottom.

LEFT_UP

Arranges the pages on a sheet from right to left and bottom to top.

RIGHT_DOWN

Arranges the pages on a sheet from left to right and top to bottom.

RIGHT_UP

Arranges the pages on a sheet from left to right and bottom to top.

UP_LEFT

Arranges the pages on a sheet from bottom to top and right to left.

UP_RIGHT

Arranges the pages on a sheet from bottom to top and left to right.

PdfScriptTriggerEvent Namespace: RealObjects.PDFreactor.Webservice.Client.Configuration

An enum containing trigger events for PDF scripts.

AFTER_PRINT

This event is triggered after the PDF has been printed by the viewer application.

AFTER_SAVE

This event is triggered after the PDF has been saved by the viewer application.

BEFORE_PRINT

This event is triggered before the PDF is printed by the viewer application.

BEFORE_SAVE

This event is triggered before the PDF is saved by the viewer application.

CLOSE

This event is triggered when the PDF is closed by the viewer application.

OPEN

This event is triggered when the PDF is opened in the viewer application.

ProcessingPreferences Namespace: RealObjects.PDFreactor.Webservice.Client.Configuration

An enum containing constants for processing preferences.

SAVE_MEMORY_IMAGES

Processing preferences flag for the memory saving mode for images.

QuirksMode Namespace: RealObjects.PDFreactor.Webservice.Client.Configuration

An enum containing modes for Quirks.

DETECT

Doctype dependent behavior.

QUIRKS

Forced quirks behavior.

STANDARDS

Forced no-quirks behavior.

ResolutionUnit Namespace: RealObjects.PDFreactor.Webservice.Client.Configuration

An enum containing resolution units.

DPCM

Dots per inch. The default 1dppx/96dpi in this unit is about 38.

DPI

Dots per Inch. The default 1dppx/96dpi in this unit is 96.

DPPX

Dots per 'px' unit. The default 1dppx/96dpi in this unit is 1.

TDPCM

Thousand dots per centimeter. The default 1dppx/96dpi in this unit is about 37795.

TDPI

Thousand dots per inch. The default 1dppx/96dpi in this unit is 96000.

TDPPX

Thousand dots per 'px' unit. The default 1dppx/96dpi in this unit is 1000.

ResourceType Namespace: RealObjects.PDFreactor.Webservice.Client.Configuration

Indicates the type of resource.

ATTACHMENT

An attachment.

DOCUMENT
The main HTML or XML document.
FONT

A font.

ICC_PROFILE

An ICC profile.

IFRAME

An iframe.

IMAGE

An image.

LICENSEKEY

The license key.

MERGE_DOCUMENT

A merge document.

OBJECT

An embedded object.

RUNNING_DOCUMENT

A running document.

SCRIPT

A script.

STYLESHEET

A style sheet.

UNKNOWN

An unknown resource type.

XHR
An XMLHttpRequest.

SigningMode Namespace: RealObjects.PDFreactor.Webservice.Client.Configuration

An enum containing the cryptographic filter type that is used for signing.

SELF_SIGNED

The self signed filter: PDFreactor creates a signature with the adbe.x509.rsa_sha1 (PKCS#1) filter type.

VERISIGN_SIGNED

The VeriSign filter. PDFreactor creates a signature with VeriSign filter type.

WINCER_SIGNED

The Windows Certificate Security: PDFreactor creates a signature with the adbe.pkcs7.sha1 (PKCS#7) filter type.

ViewerPreferences Namespace: RealObjects.PDFreactor.Webservice.Client.Configuration

An enum containing constants for viewer preferences.

CENTER_WINDOW

Position the document's window in the center of the screen.

DIRECTION_L2R

Position pages in ascending order from left to right.

DIRECTION_R2L

Position pages in ascending order from right to left.

DISPLAY_DOC_TITLE

Display the document's title in the top bar.

DUPLEX_FLIP_LONG_EDGE

Print dialog default setting: duplex (long edge).

DUPLEX_FLIP_SHORT_EDGE

Print dialog default setting: duplex (short edge).

DUPLEX_SIMPLEX

Print dialog default setting: simplex.

FIT_WINDOW

Resize the document's window to fit the size of the first displayed page.

HIDE_MENUBAR

Hide the viewer application's menu bar when the document is active.

HIDE_TOOLBAR

Hide the viewer application's tool bars when the document is active.

HIDE_WINDOW_UI

Hide user interface elements in the document's window.

NON_FULLSCREEN_PAGE_MODE_USE_NONE

Show no panel on exiting full-screen mode. Has to be combined with ViewerPreferences.PAGE_MODE_FULLSCREEN.

NON_FULLSCREEN_PAGE_MODE_USE_OC

Show optional content group panel on exiting full-screen mode. Has to be combined with ViewerPreferences.PAGE_MODE_FULLSCREEN.

NON_FULLSCREEN_PAGE_MODE_USE_OUTLINES

Show bookmarks panel on exiting full-screen mode. Has to be combined with ViewerPreferences.PAGE_MODE_FULLSCREEN.

NON_FULLSCREEN_PAGE_MODE_USE_THUMBS

Show thumbnail images panel on exiting full-screen mode. Has to be combined with ViewerPreferences.PAGE_MODE_FULLSCREEN.

PAGE_LAYOUT_ONE_COLUMN

Display the pages in one column.

PAGE_LAYOUT_SINGLE_PAGE

Display one page at a time (default).

PAGE_LAYOUT_TWO_COLUMN_LEFT

Display the pages in two columns, with odd numbered pages on the left.

PAGE_LAYOUT_TWO_COLUMN_RIGHT

Display the pages in two columns, with odd numbered pages on the right.

PAGE_LAYOUT_TWO_PAGE_LEFT

Display two pages at a time, with odd numbered pages on the left.

PAGE_LAYOUT_TWO_PAGE_RIGHT

Display two pages at a time, with odd numbered pages on the right.

PAGE_MODE_FULLSCREEN

Switch to fullscreen mode on startup.

PAGE_MODE_USE_ATTACHMENTS

Show attachments panel on startup.

PAGE_MODE_USE_NONE

Show no panel on startup.

PAGE_MODE_USE_OC

Show optional content group panel on startup.

PAGE_MODE_USE_OUTLINES

Show bookmarks panel on startup.

PAGE_MODE_USE_THUMBS

Show thumbnail images panel on startup.

PICKTRAYBYPDFSIZE_FALSE

Print dialog default setting: do not pick tray by PDF size.

PICKTRAYBYPDFSIZE_TRUE

Print dialog default setting: pick tray by PDF size.

PRINTSCALING_APPDEFAULT

Print dialog default setting: set scaling to application default value.

PRINTSCALING_NONE

Print dialog default setting: disabled scaling.

XmpPriority Namespace: RealObjects.PDFreactor.Webservice.Client.Configuration

An enum containing the priority for XMP.

HIGH

Embed XMP ignoring requirements of the output format.

This may cause output PDFs to not achieve a specified conformance.

LOW

Embed XMP if the output format does not have XMP requirements.

NONE

Do not embed XMP.

Exceptions

PDFreactorWebserviceException Namespace: RealObjects.PDFreactor.Webservice.Client : Exception

Possible Causes

  • This type of exception is thrown by the PDFreactor Web Service client. It has several sub classes, all indicating different issues. To react to specific problems, it is recommended to catch appropriate sub class exceptions.

ClientException Namespace: RealObjects.PDFreactor.Webservice.Client : PDFreactorWebserviceException

Possible Causes

  • This type of exception is produced by the client and indicates that a connection to the PDFreactor Web Service could not be established. Exceptions of this class do not necessarily indicate a problem with the PDFreactor Web Service, only that it could not be reached. This could have various reasons, including a non-functioning PDFreactor Web Service, a blocking firewall or an incorrectly configured service URL.

ServerException Namespace: RealObjects.PDFreactor.Webservice.Client : PDFreactorWebserviceException

Possible Causes

  • This type of exception is produced by the PDFreactor Web Service and indicates that the conversion could not be processed for some reason. Exceptions of this class mean that the PDFreactor Web Service is running. Please note that the client requires the 'X-RO-Error-ID' HTTP header to be present to convert the exception in the appropriate type. If that header is missing, exceptions will have this generic type instead.

Additional Properties

Result → Result
The partial result of the conversion.

AsyncUnavailableException Namespace: RealObjects.PDFreactor.Webservice.Client : ServerException

Possible Causes

  • Asynchronous conversions are not available in this PDFreactor Web Service.

Additional Properties

Result → Result
The partial result of the conversion.

BadRequestException Namespace: RealObjects.PDFreactor.Webservice.Client : ServerException

Possible Causes

  • The page number you specified is either below 0 or exceeds the document's total number of pages.

Additional Properties

Result → Result
The partial result of the conversion.

ConversionAbortedException Namespace: RealObjects.PDFreactor.Webservice.Client : ServerException

Possible Causes

  • The supplied configuration is valid, however the conversion could not be completed for some reason. See the error message for details.

Additional Properties

Result → Result
The partial result of the conversion.

ConversionFailureException Namespace: RealObjects.PDFreactor.Webservice.Client : ServerException

Possible Causes

  • The configuration could not be processed and should be re-checked.

Additional Properties

Result → Result
The partial result of the conversion.

DocumentNotFoundException Namespace: RealObjects.PDFreactor.Webservice.Client : ServerException

Possible Causes

  • Conversion does not exist.

Additional Properties

Result → Result
The partial result of the conversion.

InvalidClientException Namespace: RealObjects.PDFreactor.Webservice.Client : ServerException

Possible Causes

  • The version of the client that was used is outdated and no longer supported. This is only available for the PDFreactor REST clients.

Additional Properties

Result → Result
The partial result of the conversion.

InvalidConfigurationException Namespace: RealObjects.PDFreactor.Webservice.Client : ServerException

Possible Causes

  • The supplied configuration was not valid for some reason. See the error message for details.

Additional Properties

Result → Result
The partial result of the conversion.

NoConfigurationException Namespace: RealObjects.PDFreactor.Webservice.Client : ServerException

Possible Causes

  • No configuration was supplied to the operation.

Additional Properties

Result → Result
The partial result of the conversion.

NoInputDocumentException Namespace: RealObjects.PDFreactor.Webservice.Client : ServerException

Possible Causes

  • No input document was specified in the configuration.

Additional Properties

Result → Result
The partial result of the conversion.

NotAcceptableException Namespace: RealObjects.PDFreactor.Webservice.Client : ServerException

Possible Causes

  • The server could not produce a result with a media type that matches the client's request. The configuration or Accept header should be adjusted accordingly.

Additional Properties

Result → Result
The partial result of the conversion.

ServiceUnavailableException Namespace: RealObjects.PDFreactor.Webservice.Client : ServerException

Possible Causes

  • The PDFreactor Web Service is running and reachable, but not in a state to perform the requested task.

Additional Properties

Result → Result
The partial result of the conversion.

UnauthorizedException Namespace: RealObjects.PDFreactor.Webservice.Client : ServerException

Possible Causes

  • The client failed an authorization check, e.g. because a supplied API key was invalid.

Additional Properties

Result → Result
The partial result of the conversion.

UnprocessableConfigurationException Namespace: RealObjects.PDFreactor.Webservice.Client : ServerException

Possible Causes

  • The supplied configuration was accepted by PDFreactor but could not be converted for some reason. See the error message for details.

Additional Properties

Result → Result
The partial result of the conversion.

UnprocessableInputException Namespace: RealObjects.PDFreactor.Webservice.Client : ServerException

Possible Causes

  • The supplied input data was accepted by PDFreactur but could not be processed for some reason. See the error message for details.

Additional Properties

Result → Result
The partial result of the conversion.

ClientTimeoutException Namespace: RealObjects.PDFreactor.Webservice.Client : ClientException

Possible Causes

  • The request to the PDFreactor Web Service timed out. This usually occurs during synchronous conversions. Increasing the timeout or switching to asynchronous conversions might resolve this.

InvalidServiceException Namespace: RealObjects.PDFreactor.Webservice.Client : ClientException

Possible Causes

  • A response was received but it could not be identified as a response from the PDFreactor Web Service.

UnreachableServiceException Namespace: RealObjects.PDFreactor.Webservice.Client : ClientException

Possible Causes

  • The PDFreactor Web Service could not be reached.