Edition
Related Functions
Example
Edition
Related Functions
Example
The IN_RasterizeEx function combines the specified layers in the document window and converts them into a raster image. It combines features available in the IN_Merge, IN_ResizePage, and IN_ChangeRaster functions.
Syntax
int IN_RasterizeEx( docwinID, pageID, mergeType, colorDepth, brightness, threshold, xResolution, yResolution, rotation, imageSizeX, imageSizeY, imageUnits, pNewDocwinID )
|
Input Parameters |
Values |
Meaning |
|
IN_DOCWIN docwinID |
0 | docwinID |
active | specific |
|
IN_PAGE pageID |
-1 0 pageID |
rasterize all pages rasterize the current page rasterize the specified page |
|
SHORT mergeType |
IN_RASTERIZE_* USER_PROMPT (0) DOCUMENT (1) LAYERS (2) AS_DISPLAYED (3) RASTERS_DISPLAYED (4) EDITS_DISPLAYED (5) ACTIVE_RASTER (6) ACTIVE_EDIT (7) |
type of merge operation: specify in dialog box entire page displayed layers as displayed displayed raster layers displayed edit layers active raster layer active edit layer |
|
SHORT colorDepth |
IN_RASTERIZE_OUTPUT_* BILEVEL (1) BILEVEL_DITHERED (2) 8BIT_GRAYSCALE (3) 8BIT_COLOR (4) 24BIT_COLOR (5) MONOCHROME (6) BILEVEL_CAD (7) |
type of output data generated: bilevel raster dithered 8-bit grayscale raster 8-bit color raster 24-bit color raster black-and-white toned raster monochrome image (Windows 2000, XP, Server 2003, or Vista only) |
|
SHORT brightness |
-50 to 150 |
-50 = darkest 150 = lightest See Remarks. |
|
SHORT threshold |
0 to 255 |
0 = lightest 255 = darkest See Remarks. |
|
SHORT xResolution |
0 10 to 4000 |
current resolution. See Remarks. horizontal dots per inch |
|
SHORT yResolution |
0 10 to 4000 |
current resolution vertical dots per inch |
|
SHORT rotation |
IN_RASTERIZE_ORIENT_* NONE (0) 0 (1) 90 (2) 180 (3) 270 (4) PORTRAIT (5)
LANDSCAPE (6) |
orientation of the new image: no change no change rotate 90 degrees CCW rotate 180 degrees rotate 270 degrees CCW rotate 90 degrees if height is rotate 90 degrees if width is See Remarks. |
|
DOUBLE imageSizeX |
0 | size value |
existing width | new width |
|
DOUBLE imageSizeY |
0 size value |
existing length new length. See Remarks. |
|
SHORT imageUnits |
IN_UNITS_*
INCH (1) CM (2) FT (4) MM (5) M (6) |
units used by imageSizeX and imageSizeY: inches centimeters feet millimeters meters |
|
Meaning | ||
|
IN_OBJECT_PTR pNewDocwinID |
pointer to the new document window identifier. See Remarks. | |
Remarks
The brightness value is used when the colorDepth value is BILEVEL_DITHERED, BILEVEL_CAD, or MONOCHROME.
The threshold value is ignored unless BILEVEL output is selected as the colorDepth value.
The current resolution is determined by the active raster layer on the page, if any, or the first raster, if no raster layers are active. If the page contains only edit layers, then the current resolution is usually 1200 dpi.
Changing the rotation value is a permanent change to the data, not just a display or header change.
The imageSizeX and imageSizeY values must either both be set to 0, or both be set to a size value. You cannot use 0 for one and a size value for the other. When both are set to 0, the imageUnits value is ignored.
The pNewDocwinID is the same as the original document window if the overwrite raster flag is set to on, NULL if the function fails.
Release information
Added to Imagenation for Windows in Release 6.3.
Not yet available in Imagenation for UNIX.
See also