Monkeybread Software - DynaPDF Manual

DynaPDF Manual - Page 785

Function Reference

Page 785 of 839

The function sets two callback functions which can be used to control a progress bar. This function is

absent in the Visual Basic interface because this interface uses events instead of callback functions.

The progress callback functions are called by these functions:

• CheckConformance()

• ImportPDFFile()

• Optimize()

• CloseFile(), CloseFileEx(), and so on

The parameter Data is a user defined pointer that is passed unchanged to the callback functions.

The parameter InitProgress defines a callback function that is called before the progress callback

function is called the first time. The parameters of this callback function can be used to initialize a

progress bar. The parameter ProgType of the initialization callback function defines the current

process; this can be either importing, writing, or converting a page.

Other operations do not call the progress callback functions because most operations are too fast as

if they could be used to display the current progress.

The parameter MaxCount defines how often the progress callback function will be called. To disable

the progress callback functions set the parameters InitProgress and Progress to NULL.

Return values of the progress callback function:

The return value of the progress callback function must be 0, any other return value breaks

processing. All functions, except ImportPDFFile(), release the PDF file in memory if a non-zero

value will be returned.

Return values:

If the function succeeds the return value is 1. If the function fails the return value is 0.

SetRenderingIntent

Syntax:

LBOOL pdfSetRenderingIntent(

const PPDF* IPDF,

// Instance pointer

SI32 ImgHandle,

// Image handle

TRenderingIntent Value) // Rendering intent

Set function sets the rendering intent of an image. The rendering intent describes how colors should

be interpreted.

The parameter ImgHandle must be a valid image handle that was returned by InsertImage() or

InsertImageEx(). Imported images returned by ParseContent(), for example, can be changed too.

Return values:

If the function succeeds the return value is 1. If the function fails the return value is 0.