VectorToRaster (ImageKit Control/ Vector Method)

This method converts a vector image to a raster image.

[C++Builder] [ bool = ]imagekitcontrolname->Vector->VectorToRaster(short BitCount, bool DxfBlack, Byte BackRed, Byte BackGreen, Byte BackBlue)

[Delphi] [ Boolean = ]imagekitcontrolname.Vector.VectorToRaster(BitCount: Smallint; DxfBlack: Boolean; BackRed: Byte; BackGreen: Byte; BackBlue: Byte)

Parameters

Name	Explanation
BitCount	The bitcount of the raster image at time of conversion (1, 4, 8, 16, 24, 32)
DxfBlack	Reverses black and white in DXF images. True: Reverses color, False: Does not reverse color
BackRed	Background color (red value)
BackGreen	Background color (green value)
BackBlue	Background color (blue value)

Return Value

Returns True if successful, returns False when not successful.

Explanation

The VectorToRaster method converts a vector image to a raster image. The vector image to be processed is set in the ImageHandle property or the Layer(LayerNo).ImageHandle property (Depending on the value of the LayerNo property).

If successful the input vector image handle is freed from the memory and the new raster image handle is set into the ImageHandle property or the Layer(LayerNo).ImageHandle property (Depending on the value of the LayerNo property). If the time to process exceeds the value set in the TimeOutSeconds parameter, the process will be canceled.

When the Caption, Message, and ButtonName properties are blank, the progress dialog will not be displayed. When the progress dialog is displayed, the percentage that the processing has completed will be shown in the dialog

The VectorToRaster method corresponds to the Common Control's VectToDib method in earlier versions of the ImageKit.

Differences from ImageKit7/8/9 ActiveX

The BackRed, BackGreen, and BackBlue parameters have changed to Byte type.