Edition
Related Functions
Example
Edition
Related Functions
Example
The IN_Rasterize 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_Rasterize( docwinID, pageID, rasterizeType, colorDepth, dither, threshold, xResolution, yResolution, orientation, 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 rasterizeType |
IN_RASTERIZE_* USER_PROMPT (0) specify in dialog box DOCUMENT (1) entire page LAYERS (2) displayed layers AS_DISPLAYED (3) as displayed RASTERS_DISPLAYED (4) displayed raster layers EDITS_DISPLAYED (5) displayed edit layers ACTIVE_RASTER (6) active raster layer ACTIVE_EDIT (7) active edit layer | |
|
SHORT colorDepth |
defines the color depth of the new raster image: IN_RASTERIZE_OUTPUT_BILEVEL (1) IN_RASTERIZE_OUTPUT_BILEVEL_DITHERED (2) IN_RASTERIZE_OUTPUT_8BIT_GRAYSCALE (3) IN_RASTERIZE_OUTPUT_8BIT_COLOR (4) IN_RASTERIZE_OUTPUT_24BIT_COLOR (5) IN_RASTERIZE_OUTPUT_MONOCHROME (6) IN_RASTERIZE_OUTPUT_BILEVEL_CAD (7) [Windows NT/2000 only] | |
|
SHORT dither |
Defines what dither pattern to use: IN_RASTERIZE_DITHER_* NONE (0) No pattern. Use this value for now. ERROR (1) Reserved for future use. | |
|
SHORT threshold |
-100 to 100 |
lightness of dithering. 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 orientation |
orientation of the new image. This is a data transformation, not a header rotation. IN_RASTERIZE_ORIENT_NONE (0) IN_RASTERIZE_ORIENT_0 (1) IN_RASTERIZE_ORIENT_90 (2) IN_RASTERIZE_ORIENT_180 (3) IN_RASTERIZE_ORIENT_270 (4) IN_RASTERIZE_ORIENT_PORTRAIT (5) IN_RASTERIZE_ORIENT_LANDSCAPE (6) | |
|
DOUBLE imageSizeX |
0 | size value |
existing width | new width |
|
DOUBLE imageSizeY |
0 size value |
existing length new length. See Remarks. |
|
SHORT imageUnits |
units used by imageSizeX and imageSizeY: IN_UNITS_INCH (1) IN_UNITS_CM (2) IN_UNITS_FT (4) IN_UNITS_MM (5) IN_UNITS_M (6) | |
|
Meaning | ||
|
IN_OBJECT_PTR pNewDocwinID |
pointer to the new document window identifier. See Remarks. | |
Remarks
This function will be obsoleted in a future release so we strongly recommend that you use IN_RasterizeEx (a new Rasterize Extended function) instead of using this function.
The threshold value is ignored unless bilevel or bilevel dithered 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.
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 5.13.
Not yet available in Imagenation for UNIX.
See also