A job that converts a single PDF file or TIFF image into something else. More...

Inheritance diagram for SolidFramework.Services.ToPdfJobEnvelope:

Public Member Functions
	ToPdfJobEnvelope ()
	Initializes a new instance of the ToPdfJobEnvelope class.

override void	Execute ()
	Executes this instance. More...

virtual string	GetHashString ()
	Creates a hash of the JobEnvelope's options and it's source file to be used in duplicate envelope detection Will return null if the JobEnvelope contains unique data that excludes it from duplicate envelope detection More...

virtual void	Cancel ()
	Cancels this instance.

string	GetJobDescription ()
	Gets a string representation of this JobEnvelope. More...

void	Dispose ()
	Performs application-defined tasks associated with freeing, releasing, or resetting unmanaged resources.

Static Public Member Functions
static JobEnvelope	Parse (string description, WorkerProcess.IMessageChannel outputChannel, Action< IEnumerable< JobEnvelopeData >, JobEnvelope > additionalOptionProcessor)
	Parses a JobEnvelope from the specified job description or throws an exception if it can't be parsed. More...

static bool	TryParse (string description, WorkerProcess.IMessageChannel outputChannel, Action< IEnumerable< JobEnvelopeData >, JobEnvelope > additionalOptionProcessor, out JobEnvelope jobEnvelope)
	Creates a JobEnvelope from a job description (created by GetJobDescription). A return value indicates whether the conversion succeeded or failed. More...

static bool	TryParse (string description, WorkerProcess.IMessageChannel outputChannel, out JobEnvelope jobEnvelope)
	Creates a JobEnvelope from a job description (created by GetJobDescription). A return value indicates whether the conversion succeeded or failed. More...

static void	RegisterCustomJobEnvelopeType (Type customJobEnvelopeType)
	Registers a custom JobEnvelope type As the regular JobHandler won't understand the custom JobEnvelope type you'll also need to create a JobProcessor that uses a custom JobHandler. The JobHandler should be a console application that registers the same custom JobEnvelope types before calling new JobHandler().Run(); More...

static bool	UnregisterCustomJobEnvelopeType (Type customJobEnvelopeType)
	Unregisters a custom JobEnvelope type More...

Properties
bool	CreateTagged `[getset]`
	Gets or sets whether to tag content in the PDF. The default is `false`.

override string	Name `[get]`
	Gets the name for this type of JobEnvelope. More...

string	Password `[getset]`
	Gets or sets the password.

bool	GraphicsAsImages `[getset]`
	Gets or sets whether vector images should be converted to bitmap images. The default is `false`.

bool	KeepBackgroundColorText `[getset]`
	Gets or sets whether to recover text that is invisible because it is exactly the same colour as the background. The default is `false`. More...

bool	KeepInvisibleText `[getset]`
	Gets or sets whether to recover text that is invisible because it has no stroke or fill. This is typically used in PDFs to provide a searchable layer in scanned pages. The default is `false`.

PageRange	PageRange `[getset]`
	Gets or sets the page range that should be converted. The default is `null` (all pages).

string	ImageWatermarkPath `[getset]`
	Gets or sets the path to the watermark image file. The default is `null` (no watermark).

object	CustomData `[getset]`
	Gets or sets the custom data. The default is `null`. Note: setting this to a non-string value will prevent duplicate job detection

string	SourcePath `[getset]`
	Gets or sets the path to the source file.

IList< string >	OutputPaths `[get]`
	Gets the list of output paths.

JobStatus	Status `[get]`
	Gets the status of the conversion. This can indicate success, whether there was a problem, etc.

string	Message `[get]`
	Gets the message.

int	ID `[get]`
	Gets the ID.

bool	DoProgress `[getset]`
	Gets or sets whether events should be raised to indicate how far the conversion has progressed. The default is `false`.

bool	NoCopies `[getset]`
	Gets or sets whether the conversion should be performed on the original source file rather than a temporary copy. The default is `false` (perform the conversion on a temporary copy). Setting this to true can risk data loss if: More...

bool	Duplicate `[getset]`
	Gets or sets whether the JobEnvelope is a duplicate.

TimeSpan	ProcessDuration `[get]`
	Gets the time it took to process the job.

Detailed Description

A job that converts a single PDF file or TIFF image into something else.

Member Function Documentation

◆ Execute()

override void SolidFramework.Services.ToPdfJobEnvelope.Execute ( )

virtual

Executes this instance.

Reimplemented from SolidFramework.Services.Plumbing.PdfToJobEnvelope.

Reimplemented in SolidFramework.Services.ToSearchablePdfAJobEnvelope, SolidFramework.Services.ToSearchablePdfJobEnvelope, and SolidFramework.Services.ToTextJobEnvelope.

◆ GetHashString()

virtual string SolidFramework.Services.Plumbing.JobEnvelope.GetHashString ( )

virtualinherited

Creates a hash of the JobEnvelope's options and it's source file to be used in duplicate envelope detection Will return null if the JobEnvelope contains unique data that excludes it from duplicate envelope detection

Returns: A hash of the JobEnvelope's options and source file, or null if the JobEnvelope contains unique data

◆ GetJobDescription()

string SolidFramework.Services.Plumbing.JobEnvelope.GetJobDescription ( )

inherited

Gets a string representation of this JobEnvelope.

Returns: A string representation of this JobEnvelope.

◆ Parse()

static JobEnvelope SolidFramework.Services.Plumbing.JobEnvelope.Parse	(	string	description,
		WorkerProcess.IMessageChannel	outputChannel,
		Action< IEnumerable< JobEnvelopeData >, JobEnvelope >	additionalOptionProcessor
	)

staticinherited

Parses a JobEnvelope from the specified job description or throws an exception if it can't be parsed.

Parameters

description	The job description to parse (as created by JobEnvelope.GetJobDescription).
outputChannel	The output channel the JobEnvelope should write to.
additionalOptionProcessor	A function to handle options added by JobProcessor.GetAdditionalJobOptions

Returns: The JobEnvelope that was parsed from the description.

◆ RegisterCustomJobEnvelopeType()

static void SolidFramework.Services.Plumbing.JobEnvelope.RegisterCustomJobEnvelopeType ( Type customJobEnvelopeType )

staticinherited

Registers a custom JobEnvelope type As the regular JobHandler won't understand the custom JobEnvelope type you'll also need to create a JobProcessor that uses a custom JobHandler. The JobHandler should be a console application that registers the same custom JobEnvelope types before calling new JobHandler().Run();

Parameters

customJobEnvelopeType The custom JobEnvelope type to register

◆ TryParse() [1/2]

static bool SolidFramework.Services.Plumbing.JobEnvelope.TryParse	(	string	description,
		WorkerProcess.IMessageChannel	outputChannel,
		Action< IEnumerable< JobEnvelopeData >, JobEnvelope >	additionalOptionProcessor,
		out JobEnvelope	jobEnvelope
	)

staticinherited

Creates a JobEnvelope from a job description (created by GetJobDescription). A return value indicates whether the conversion succeeded or failed.

Parameters

description	The description of the JobEnvelope.
outputChannel	The output channel the JobEnvelope should write to.
additionalOptionProcessor	A function to handle options added by JobProcessor.GetAdditionalJobOptions
jobEnvelope	The JobEnvelope to store the result in.

Returns: true if the conversion succeeded, otherwise false.

◆ TryParse() [2/2]

static bool SolidFramework.Services.Plumbing.JobEnvelope.TryParse	(	string	description,
		WorkerProcess.IMessageChannel	outputChannel,
		out JobEnvelope	jobEnvelope
	)

staticinherited

Creates a JobEnvelope from a job description (created by GetJobDescription). A return value indicates whether the conversion succeeded or failed.

Parameters

description	The description of the JobEnvelope.
outputChannel	The output channel the JobEnvelope should write to.
jobEnvelope	The JobEnvelope to store the result in.

Returns: true if the conversion succeeded, otherwise false.

◆ UnregisterCustomJobEnvelopeType()

static bool SolidFramework.Services.Plumbing.JobEnvelope.UnregisterCustomJobEnvelopeType ( Type customJobEnvelopeType )

staticinherited

Unregisters a custom JobEnvelope type

Parameters

customJobEnvelopeType The custom JobEnvelope type to unregister

Returns: true if the custom JobEnvelope type was registered, otherwise false

Property Documentation

◆ KeepBackgroundColorText

bool SolidFramework.Services.Plumbing.PdfToJobEnvelope.KeepBackgroundColorText

getsetinherited

Gets or sets whether to recover text that is invisible because it is exactly the same colour as the background. The default is false.

Note that if recovered it will not be obvious in the reconstructed document if the formatting is maintained, since it will still be the same colour as the background.

◆ Name

override string SolidFramework.Services.ToPdfJobEnvelope.Name

get

Gets the name for this type of JobEnvelope.

The name for this type of JobEnvelope.

◆ NoCopies

bool SolidFramework.Services.Plumbing.JobEnvelope.NoCopies

getsetinherited

Gets or sets whether the conversion should be performed on the original source file rather than a temporary copy. The default is false (perform the conversion on a temporary copy). Setting this to true can risk data loss if:

don't have correct permissions to access source file
the source file disappears during conversion (i.e. the file is deleted or its drive is unmounted)
etc.

Public Member Functions

Static Public Member Functions

Properties

Detailed Description

Member Function Documentation

◆ Execute()

◆ GetHashString()

◆ GetJobDescription()

◆ Parse()

◆ RegisterCustomJobEnvelopeType()

◆ TryParse() [1/2]

◆ TryParse() [2/2]

◆ UnregisterCustomJobEnvelopeType()

Property Documentation

◆ KeepBackgroundColorText

◆ Name

◆ NoCopies