Related Functions
ExampleAll Editions
Related Functions
Example
The IN_SetPrintOptionsEx function sets the default values for print options. The user can change these options in the Print dialog box, or you can specify new options when you use the IN_PrintDocumentWindow function.
Syntax
int IN_SetPrintOptionsEx( colorType, threshold, brightness, scaleType, orientation, annotations, hotspots, flags, pFilename, writeToINI )
|
Parameters |
Values |
Meaning |
|
USHORT colorType |
0 1 2 3 4 |
color bilevel bilevel enhanced bilevel CAD bilevel dithered |
|
USHORT threshold |
0 to 255 |
0 = lightest 255 = darkest See Remarks. |
|
SHORT brightness |
-50 to 150 |
-50 = darkest 150 = brightest See Remarks. |
|
USHORT scaleType |
1 2 3 4 5 6 7 |
To Fit Actual Size Half Page No Scaling Actual Size or To Fit Fit to width Fit to length |
|
USHORT orientation |
1 2 3 4 5 |
Best Fit Portrait Landscape Minimum Length As set by printer driver |
|
USHORT annotations |
1 2 3 4 |
As displayed As icons As text All hidden |
|
USHORT hotspots |
1 2 3 |
As displayed Icons hidden All hidden |
|
USHORT flags |
1 2 4 8 16 32 64 (can be ORed) |
Print to file Collate Tile Center Rasterize Use small print buffer Banner |
|
CHARPTR pFilename |
pointer to file name and path of the document to print to. See Remarks. | |
|
IN_BOOL writeToINI |
0 | 1 |
don't write | write |
Remarks
The threshold value is used only when the colorType value is bilevel.
The brightness value is used when the colorType value is bilevel enhanced, bilevel CAD, or bilevel dithered.
The pFilename parameter takes effect only when PRINT_TO_FILE is set as the flags value.
The pFilename parameter can be any valid file name. However, only .prn can be used as the extension. Any other extension will automatically be replaced with .prn, and a file name without an extension will have .prn added.
If the writeToINI parameter is set to 1, this function writes the values for print options in the [Print] section of the Image.ini file.
Release information
Added to Imagenation for Windows in Release 6.3.
Not supported in Imagenation for UNIX.
See also