Click or drag to resize

IMcImageConvert Method

Creates a copy of the Aoi of this image with a different type.

Namespace:  MediaCy.IQL.Engine
Assembly:  MediaCy.IQL.Engine (in MediaCy.IQL.Engine.dll) Version: 10.0.6912.0
Syntax
VB
Copy
Function Convert ( 
	vType As Object,
	Optional ImageCreationFlags As mcImageCreateFlags = mcImageCreateFlags.mcicfDefault
) As McImage

Parameters

vType
Type: SystemObject
This can be an instance of a McImageType interface or it can be a numeric value from mcImageQuickTypes. These are
ImageCreationFlags (Optional)
Type: MediaCy.IQL.EnginemcImageCreateFlags
Flag to pass to the IMcImages::Add method. See mcImageCreateFlags for the list of supported flags. You may also OR in mcImportPropertiesFlags to control which properties, if any are copied into the new image. If no mcImportPropertiesFlags are OR'ed into the value, then we default to mcipfAllExceptIntensity plus mcipfApplyMonoColorToRGB, so that monochrome tint or pseudo coloring will be burned into any destination RGB image.

Return Value

Type: McImage
A new McImage of the given type.
Remarks
The CopyToNewImage method is a more generalized version of this method that allows you to specify a source rectangle other than the Aoi and also to supply a name for the new image. The ConvertEx method is a version of this method that allows you or the user to specify how the pixel bit-depth scaling is to be handled. This method always scales the source image range to the destination image range. If UseActiveFrameRange is True, then any ActiveFrameRange is honored to decide which frames should be copied. At least one frame must be selected for copying. If the image has an AOI, then the converted image will be the size of the rectangular bounds of the AOI, and only pixels which are foreground in the AOI will be copied into the new, converted image.
See Also