Trace Functions

 

Amyuni PDF Converter uses String and DWORD Values in Windows Registry for the Trace functions.   These  String and DWORD Values  need to be created in the same location of the printer configuration.   Usually, the printer subKey is stored in:

HKEY_CURRENT_USER\SOFTWARE\{Amyuni PDF Converter Name}

 

The TraceEnabled String Value is the only value that needs to be created with value 1 to enable this feature.  The other functions will use the default values if they are not created.

 

This table shows the String and DWORD Values available for trace functions with its defaults values.  

Name Type Default Value Description

TraceEnabled

DWORD (0 or 1)

0

Enabling generation of trace information (MANDATORY).

PSContentEnabled

DWORD (0 or 1)

0

Enabling generation of Postscript content files

TraceLevel

DWORD (0 or 1)

0xFFFFFFFF

DWORD value containing a bit mask for each traced resources (see table below)

TraceFile

String

C:\Temp\pdfdrv.log

Output trace file

TraceByJob

DWORD (0 or 1)

0

Initialize the trace file for each printed job/pdev

PSContentFolder

String

C:\Temp\

Output folder for Postscript content files (one per page)

PSContentByPage

DWORD (0 or 1)

0

Separate Postscript content files by page

bPSContentRemove

DWORD (0 or 1)

1

Remove all Postscript content files at the beginning

bOutputHeader

DWORD (0 or 1)

1

Print a trace header for every printed job/pdev

bOutputMilliseconds

DWORD (0 or 1)

0

Print an elapsed time column to the trace file

bOutputPdev

DWORD (0 or 1)

1

Print the current pdev pointer address as a column to the trace file

Note: The values 0 means disabled and 1 means enabled.

 

TraceLevel

Value

Description

ACTRACE_LEVEL_NONE

0x00000000

Nothing is traced

ACTRACE_LEVEL_GDIDRV

0x00000001

Trace GDI Drawing functions

ACTRACE_LEVEL_GDIDRVDATA

0x00000002

Trace GDI Drawing Data

ACTRACE_LEVEL_ESCAPES

0x00000004

Trace Driver Escapes

ACTRACE_LEVEL_POSTSCRIPTDRAW

0x00000008

Trace Post-script Drawings

ACTRACE_LEVEL_POSTSCRIPTFUNC

0x00000010

Trace Post-script Functions

ACTRACE_LEVEL_POSTSCRIPTDATA

0x00000020

Trace Post-script Data

ACTRACE_LEVEL_DOCPROPS

0x00000040

Trace Document Properties

ACTRACE_LEVEL_DLL

0x00000080

Trace DLL Load and Unload

ACTRACE_LEVEL_POSTSCRIPTEPS

0x00000100

Trace Post-script EPS Commands

ACTRACE_LEVEL_GDIDRVEVENTS

0x00000200

Trace GDI Events

ACTRACE_LEVEL_IMAGES

0x00000400

Trace Images

ACTRACE_LEVEL_TRANSPARENCYGROUPS

0x00000800

Trace Internal Transparency Groups

ACTRACE_LEVEL_BBOX

0x00001000

Trace Bounding Boxes

ACTRACE_LEVEL_CLIPBBOX

0x00002000

Trace Clipping Bounding Boxes

ACTRACE_LEVEL_CLIPPINGS

0x00004000

Trace Clippings

ACTRACE_LEVEL_TEXTS

0x00008000

Trace Text Commands

ACTRACE_LEVEL_PATHS

0x00010000

Trace Lines, Rectangles and Polygons

 

0x00020000

Reserved for Internal Use

ACTRACE_LEVEL_PROPSHEETS

0x00040000

Trace Property Sheets

ACTRACE_LEVEL_ALL

0xFFFFFFFF

Trace All