Click or drag to resize

IMcOperations2X2Y Method

Performs an arithmetic X to the Y power operation on an image.

Namespace:  MediaCy.IQL.Operations
Assembly:  MediaCy.IQL.Operations (in MediaCy.IQL.Operations.dll) Version: 10.0.6912.0
Syntax
VB
Copy
Function X2Y ( 
	PowerY As Object,
	<OptionalAttribute> ScaleOffset As Object,
	<OptionalAttribute> vSourceImg As Object
) As McImage

Parameters

PowerY
Type: SystemObject
A single number or an array of N-channels numbers, where N-channels is the number of color channels in the destination image. This argument cannot be a McImage or any other object; it must be numeric. The value(s) are used to raise the value of each pixels color channel to the corresponding power.
ScaleOffset (Optional)
Type: SystemObject
If given, a single value or an array of N-channels values that is used to scale the result before storing the operation result. If a single value is supplied, then that value is used to scale all channels; if an array is supplied each value in the array is used to scale the result for the corresponding color channel. If not given, no scaling is done. A scaling value of zero is ignored, so that no scaling of the result is done.
vSourceImg (Optional)
Type: SystemObject
Optional source image, operator applies to parent image when parameter is omitted.

Return Value

Type: McImage
The result McImage.
Remarks
Each source image pixel (X) is raised to the power (Y) given by the PowerY argument. Powers may be fractional as well as positive or negative. Any error results in a zero result. For example, for floating point image types a negative pixel value can only be raised to a positive, integral power, so any non-integral PowerY value applied to a negative pixel value will yield a zero result. The result is stored in the parent image or vSourceImg if there is no parent. For floating point image types, the stored results may exceed the bounds of the current destination McImage.RangeMin to McImage.RangeMax. These range properties are not changed automatically.
See Also