Pixel processing

This module contains pixel-to-pixel transformations of any kind:

• color space transformations
• image arithmetics
• logical image combinations

Reference

YayiPixelProcessingPython.AbsSubtract((Image)im_source1, (Image)im_source2, (Image)im_destination) → object :

Pixel-wise absolute difference of two images

C++ signature :

yayi::s_return_code AbsSubtract(yayi::IImage const*,yayi::IImage const*,yayi::IImage*)

YayiPixelProcessingPython.Add((Image)im_source1, (Image)im_source2, (Image)im_destination) → object :

Adds two images

C++ signature :

yayi::s_return_code Add(yayi::IImage const*,yayi::IImage const*,yayi::IImage*)

YayiPixelProcessingPython.AddConstant((Image)im_source, (HyperRectangle)value, (Image)im_destination) → object :

Pixel-wise addition of a constant value

C++ signature :

yayi::s_return_code AddConstant(yayi::IImage const*,yayi::s_any_type,yayi::IImage*)

YayiPixelProcessingPython.AddConstantUpperBound((Image)arg1, (HyperRectangle)im_source, (HyperRectangle)value, (Image)im_destination) → object :

Adds a constant value to the image, with an upper-bound on the addition (such as the output value is never greater than the upper-bound)

C++ signature :

yayi::s_return_code AddConstantUpperBound(yayi::IImage const*,yayi::s_any_type,yayi::s_any_type,yayi::IImage*)

YayiPixelProcessingPython.BitwiseAnd((Image)im_source1, (Image)im_source2, (Image)im_destination) → object :

Logical and between two images

C++ signature :

yayi::s_return_code BitwiseAnd(yayi::IImage const*,yayi::IImage const*,yayi::IImage*)

YayiPixelProcessingPython.BitwiseNot((Image)im_source, (Image)im_destination) → object :

Logical not of the input image

C++ signature :

yayi::s_return_code BitwiseNot(yayi::IImage const*,yayi::IImage*)

YayiPixelProcessingPython.BitwiseOr((Image)im_source1, (Image)im_source2, (Image)im_destination) → object :

Logical or between two images

C++ signature :

yayi::s_return_code BitwiseOr(yayi::IImage const*,yayi::IImage const*,yayi::IImage*)

YayiPixelProcessingPython.CompareI((Image)im_source_left, (comparison_operations)compare_op, (Image)im_source_right, (HyperRectangle)value_true, (HyperRectangle)value_false, (Image)im_destination) → object :

Compare an im_source_left to im_source_right at each pixel, fills the destination image with value_true or value_false accordingly

C++ signature :

yayi::s_return_code CompareI(yayi::IImage const*,yayi::e_comparison_operations,yayi::IImage const*,yayi::s_any_type,yayi::s_any_type,yayi::IImage*)

YayiPixelProcessingPython.CompareII((Image)im_source_left, (comparison_operations)compare_op, (Image)im_source_right, (Image)im_true, (HyperRectangle)value_false, (Image)im_destination) → object :

Compare an im_source_left to im_source_right at each pixel, set the destination image with the corresponding pixel of im_true or the constant value_false accordingly

C++ signature :

yayi::s_return_code CompareII(yayi::IImage const*,yayi::e_comparison_operations,yayi::IImage const*,yayi::IImage const*,yayi::s_any_type,yayi::IImage*)

YayiPixelProcessingPython.CompareIII((Image)im_source_left, (comparison_operations)compare_op, (Image)im_source_right, (Image)im_true, (Image)im_false, (Image)im_destination) → object :

Compare an im_source_left to im_source_right at each pixel, set the destination image with the corresponding pixel of im_true or im_false accordingly

C++ signature :

yayi::s_return_code CompareIII(yayi::IImage const*,yayi::e_comparison_operations,yayi::IImage const*,yayi::IImage const*,yayi::IImage const*,yayi::IImage*)

YayiPixelProcessingPython.CompareS((Image)im_source, (comparison_operations)compare_op, (HyperRectangle)value, (HyperRectangle)value_true, (HyperRectangle)value_false, (Image)im_destination) → object :

Compare an image to value at each pixel, fills the destination image with value_true or value_false accordingly

C++ signature :

yayi::s_return_code CompareS(yayi::IImage const*,yayi::e_comparison_operations,yayi::s_any_type,yayi::s_any_type,yayi::s_any_type,yayi::IImage*)

YayiPixelProcessingPython.CompareSI((Image)im_source, (comparison_operations)compare_op, (HyperRectangle)value_compare, (Image)im_true, (HyperRectangle)value_false, (Image)im_destination) → object :

Compare an im_source to value_compare at each pixel, set the destination image with the corresponding pixel of im_true or the constant value_false accordingly

C++ signature :

yayi::s_return_code CompareSI(yayi::IImage const*,yayi::e_comparison_operations,yayi::s_any_type,yayi::IImage const*,yayi::s_any_type,yayi::IImage*)

YayiPixelProcessingPython.CompareSII((Image)im_source, (comparison_operations)compare_op, (HyperRectangle)value, (Image)im_true, (Image)im_false, (Image)im_destination) → object :

Compare an im_source to value at each pixel, set the destination image with the corresponding pixel of im_true or im_false accordingly

C++ signature :

yayi::s_return_code CompareSII(yayi::IImage const*,yayi::e_comparison_operations,yayi::s_any_type,yayi::IImage const*,yayi::IImage const*,yayi::IImage*)

YayiPixelProcessingPython.ComposeFromModulusArgument((Image)im_modulus, (Image)im_argument, (Image)imout) → object :

Fills a complex image from its polar (modulus and argument) representation

C++ signature :

yayi::s_return_code ComposeFromModulusArgument(yayi::IImage const*,yayi::IImage const*,yayi::IImage*)

YayiPixelProcessingPython.Constant((HyperRectangle)value, (Image)im) → object :

Sets all the pixels of the image to value “value”

C++ signature :

yayi::s_return_code Constant(yayi::s_any_type,yayi::IImage*)

YayiPixelProcessingPython.ConstantWindow((HyperRectangle)value, (HyperRectangle)window, (Image)im) → object :

Sets all the pixels of the image’s window to the constant value

C++ signature :

yayi::s_return_code ConstantWindow(yayi::s_any_type,yayi::s_any_type,yayi::IImage*)

YayiPixelProcessingPython.Copy((Image)im_source, (Image)im_destination) → object :

Copy one image onto another

C++ signature :

yayi::s_return_code Copy(yayi::IImage const*,yayi::IImage*)

YayiPixelProcessingPython.CopyComposeChannels((Image)im_source1, (Image)im_source2, (Image)im_source3, (Image)im_out) → object :

Copy each image pixel into a channel of the output image (in the same order as provided)

C++ signature :

yayi::s_return_code CopyComposeChannels(yayi::IImage const*,yayi::IImage const*,yayi::IImage const*,yayi::IImage*)

YayiPixelProcessingPython.CopyIntoChannel((Image)im_source, (int)channel_output, (Image)im_destination) → object :

Copy the input image (im_source) into the specified channel (channel_output) of the output image (im_destination)

C++ signature :

yayi::s_return_code CopyIntoChannel(yayi::IImage const*,unsigned int,yayi::IImage*)

YayiPixelProcessingPython.CopyOneChannel((Image)im_source, (int)channel_input, (Image)im_destination) → object :

Copy the channel channel_input of the first image into the second (scalar) image

C++ signature :

yayi::s_return_code CopyOneChannel(yayi::IImage const*,unsigned int,yayi::IImage*)

YayiPixelProcessingPython.CopyOneChannelIntoAnother((Image)im_source, (int)channel_input, (int)channel_output, (Image)im_destination) → object :

Copy the channel channel_input of the first image into the channel channel_output of the second image

C++ signature :

yayi::s_return_code CopyOneChannelIntoAnother(yayi::IImage const*,unsigned int,unsigned int,yayi::IImage*)

YayiPixelProcessingPython.CopySplitChannels((Image)im_source, (Image)channel1_out, (Image)channel2_out, (Image)channel3_out) → object :

Copy each channel of the input image into the output images

C++ signature :

yayi::s_return_code CopySplitChannels(yayi::IImage const*,yayi::IImage*,yayi::IImage*,yayi::IImage*)

YayiPixelProcessingPython.CopyWindow((Image)im_source, (HyperRectangle)window_source, (HyperRectangle)window_destination, (Image)im_destination) → object :

Copy a window of an image onto a window of another image

C++ signature :

yayi::s_return_code CopyWindow(yayi::IImage const*,yayi::s_any_type,yayi::s_any_type,yayi::IImage*)

YayiPixelProcessingPython.Exponential((Image)im_source, (Image)im_destination) → object :

Computes the exponential of each pixels of the image

C++ signature :

yayi::s_return_code Exponential(yayi::IImage const*,yayi::IImage*)

YayiPixelProcessingPython.ExtractModulusArgument((Image)imin, (Image)im_modulus, (Image)im_argument) → object :

Extracts the polar (modulus and argument) information from a complex image

C++ signature :

yayi::s_return_code ExtractModulusArgument(yayi::IImage const*,yayi::IImage*,yayi::IImage*)

YayiPixelProcessingPython.GaussianRandomGenerator((Image)arg1, (float)arg2, (float)im_destination) → object :

Generates the pixels of the image as being drawn from a gaussian distribution

C++ signature :

yayi::s_return_code GaussianRandomGenerator(yayi::IImage*,double,double)

YayiPixelProcessingPython.Intersection((Image)im_source1, (Image)im_source2, (Image)im_destination) → object :

Intersection (infimum) of two images

C++ signature :

yayi::s_return_code Intersection(yayi::IImage const*,yayi::IImage const*,yayi::IImage*)

YayiPixelProcessingPython.Logarithm((Image)im_source, (Image)im_destination) → object :

Computes the logarithm of each pixels of the image

C++ signature :

yayi::s_return_code Logarithm(yayi::IImage const*,yayi::IImage*)

YayiPixelProcessingPython.LookupTransform((Image)im_source, (HyperRectangle)map_lut, (HyperRectangle)default, (Image)im_destination) → object :

Applies an LUT transform to im_source. If a pixel value in not contained in map_lut, uses the default value

C++ signature :

yayi::s_return_code LookupTransform(yayi::IImage const*,yayi::s_any_type,yayi::s_any_type,yayi::IImage*)

YayiPixelProcessingPython.Multiply((Image)im_source1, (Image)im_source2, (Image)im_destination) → object :

Pixel-wise multiplication of two images

C++ signature :

yayi::s_return_code Multiply(yayi::IImage const*,yayi::IImage const*,yayi::IImage*)

YayiPixelProcessingPython.MultiplyConstant((Image)im_source, (HyperRectangle)value, (Image)im_destination) → object :

Multiplies an image by a constant value

C++ signature :

yayi::s_return_code MultiplyConstant(yayi::IImage const*,yayi::s_any_type,yayi::IImage*)

YayiPixelProcessingPython.Power((Image)im_source, (HyperRectangle)gamma, (Image)im_destination) → object :

Computes the power of each pixels of the image

C++ signature :

yayi::s_return_code Power(yayi::IImage const*,yayi::s_any_type,yayi::IImage*)

YayiPixelProcessingPython.Square((Image)im_source, (Image)im_destination) → object :

Computes the square of each pixels of the image

C++ signature :

yayi::s_return_code Square(yayi::IImage const*,yayi::IImage*)

YayiPixelProcessingPython.SquareRoot((Image)im_source, (Image)im_destination) → object :

Computes the square root of each pixels of the image

C++ signature :

yayi::s_return_code SquareRoot(yayi::IImage const*,yayi::IImage*)

YayiPixelProcessingPython.Subtract((Image)im_source1, (Image)im_source2, (Image)im_destination) → object :

Subtracts two images

C++ signature :

yayi::s_return_code Subtract(yayi::IImage const*,yayi::IImage const*,yayi::IImage*)

YayiPixelProcessingPython.SubtractConstant((Image)im_source, (HyperRectangle)value, (Image)im_destination) → object :

Subtract a constant value from the image

C++ signature :

yayi::s_return_code SubtractConstant(yayi::IImage const*,yayi::s_any_type,yayi::IImage*)

YayiPixelProcessingPython.SubtractConstantLowerBound((Image)arg1, (HyperRectangle)im_source, (HyperRectangle)value, (Image)im_destination) → object :

Subtract a constant value from the image, with an lower-bound on the subtraction (such as the output value is never lower than the lower-bound).

C++ signature :

yayi::s_return_code SubtractConstantLowerBound(yayi::IImage const*,yayi::s_any_type,yayi::s_any_type,yayi::IImage*)

YayiPixelProcessingPython.SubtractLowerBound((Image)im_source1, (Image)im_source2, (HyperRectangle)lower_bound, (Image)im_destination) → object :

Subtracts two images with a lower bound, in case pixel_left < pixel_right

C++ signature :

yayi::s_return_code SubtractLowerBound(yayi::IImage const*,yayi::IImage const*,yayi::s_any_type,yayi::IImage*)

YayiPixelProcessingPython.Threshold((Image)im_source, (HyperRectangle)lower_bound, (HyperRectangle)upper_bound, (HyperRectangle)value_true, (HyperRectangle)value_false, (Image)im_destination) → object :

Thresholds an image. Assigns value_true at x if im_source(x) in [lower_bound, upper_bound], false_value otherwise

C++ signature :

yayi::s_return_code Threshold(yayi::IImage const*,yayi::s_any_type,yayi::s_any_type,yayi::s_any_type,yayi::s_any_type,yayi::IImage*)

YayiPixelProcessingPython.Union((Image)im_source1, (Image)im_source2, (Image)im_destination) → object :

Union (supremum) of two images

C++ signature :

yayi::s_return_code Union(yayi::IImage const*,yayi::IImage const*,yayi::IImage*)

YayiPixelProcessingPython.color_AdobeRGB_to_XYZ_refWD65((Image)im_source, (Image)im_destination) → object :

Transforms a color image in RGB colour space to a colour image in XYZ colour space, assuming the RGB space is AdobeRGB (reference white D65, AdobeRGB rgb primaries, gamma 2.2)

C++ signature :

yayi::s_return_code color_AdobeRGB_to_XYZ_refWD65(yayi::IImage const*,yayi::IImage*)

YayiPixelProcessingPython.color_CIERGB_to_XYZ_refWE((Image)im_source, (Image)im_destination) → object :

Transforms a color image in RGB colour space to a colour image in XYZ colour space, assuming the RGB space is CIE-RGB (reference white E, CIE rgb primaries, gamma 2.2)

C++ signature :

yayi::s_return_code color_CIERGB_to_XYZ_refWE(yayi::IImage const*,yayi::IImage*)

YayiPixelProcessingPython.color_HLS_l1_to_RGB((Image)im_source, (Image)im_destination) → object :

Transforms a color image in HLS (l1) colour space to a colour image in RGB colour space

C++ signature :

yayi::s_return_code color_HLS_l1_to_RGB(yayi::IImage const*,yayi::IImage*)

YayiPixelProcessingPython.color_LAB_to_XYZ_refWA((Image)im_source, (Image)im_destination) → object :

Transforms a color image in LAB colour space to a colour image in XYZ colour space, using ‘A’ as reference white.

C++ signature :

yayi::s_return_code color_LAB_to_XYZ_refWA(yayi::IImage const*,yayi::IImage*)

YayiPixelProcessingPython.color_LAB_to_XYZ_refWD65((Image)im_source, (Image)im_destination) → object :

Transforms a color image in LAB colour space to a colour image in XYZ colour space, using ‘D65’ as reference white.

C++ signature :

yayi::s_return_code color_LAB_to_XYZ_refWD65(yayi::IImage const*,yayi::IImage*)

YayiPixelProcessingPython.color_LAB_to_XYZ_refWD75((Image)im_source, (Image)im_destination) → object :

Transforms a color image in LAB colour space to a colour image in XYZ colour space, using ‘D75’ as reference white.

C++ signature :

yayi::s_return_code color_LAB_to_XYZ_refWD75(yayi::IImage const*,yayi::IImage*)

YayiPixelProcessingPython.color_LAB_to_XYZ_refWE((Image)im_source, (Image)im_destination) → object :

Transforms a color image in LAB colour space to a colour image in XYZ colour space, using ‘E’ as reference white.

C++ signature :

yayi::s_return_code color_LAB_to_XYZ_refWE(yayi::IImage const*,yayi::IImage*)

YayiPixelProcessingPython.color_RGB_to_HLS_l1((Image)im_source, (Image)im_destination) → object :

Transforms a color image in RGB colour space to a colour image in HLS (l1) colour space

C++ signature :

yayi::s_return_code color_RGB_to_HLS_l1(yayi::IImage const*,yayi::IImage*)

YayiPixelProcessingPython.color_RGB_to_L601((Image)im_source, (Image)im_destination) → object :

Transforms a color image in RGB into a luminosity image, following the Rec601 definition

C++ signature :

yayi::s_return_code color_RGB_to_L601(yayi::IImage const*,yayi::IImage*)

YayiPixelProcessingPython.color_RGB_to_L709((Image)im_source, (Image)im_destination) → object :

Transforms a color image in RGB into a luminosity image, following the Rec709 definition

C++ signature :

yayi::s_return_code color_RGB_to_L709(yayi::IImage const*,yayi::IImage*)

YayiPixelProcessingPython.color_RGB_to_YUV((Image)im_source, (Image)im_destination) → object :

Transforms a color image in RGB colour space to a colour image in YUV colour space

C++ signature :

yayi::s_return_code color_RGB_to_YUV(yayi::IImage const*,yayi::IImage*)

YayiPixelProcessingPython.color_XYZ_to_AdobeRGB_refWD65((Image)im_source, (Image)im_destination) → object :

Transforms a color image in XYZ colour space to a colour image in RGB colour space, assuming the RGB space is AdobeRGB (reference white D65, AdobeRGB rgb primaries, gamma 2.2)

C++ signature :

yayi::s_return_code color_XYZ_to_AdobeRGB_refWD65(yayi::IImage const*,yayi::IImage*)

YayiPixelProcessingPython.color_XYZ_to_CIERGB_refWE((Image)im_source, (Image)im_destination) → object :

Transforms a color image in XYZ colour space to a colour image in RGB colour space, assuming the RGB space is CIE-RGB (reference white E, CIE rgb primaries, gamma 2.2)

C++ signature :

yayi::s_return_code color_XYZ_to_CIERGB_refWE(yayi::IImage const*,yayi::IImage*)

YayiPixelProcessingPython.color_XYZ_to_LAB_refWA((Image)im_source, (Image)im_destination) → object :

Transforms a color image in XYZ colour space to a colour image in LAB colour space, using ‘A’ as reference white.

C++ signature :

yayi::s_return_code color_XYZ_to_LAB_refWA(yayi::IImage const*,yayi::IImage*)

YayiPixelProcessingPython.color_XYZ_to_LAB_refWD65((Image)im_source, (Image)im_destination) → object :

Transforms a color image in XYZ colour space to a colour image in LAB colour space, using ‘D65’ as reference white.

C++ signature :

yayi::s_return_code color_XYZ_to_LAB_refWD65(yayi::IImage const*,yayi::IImage*)

YayiPixelProcessingPython.color_XYZ_to_LAB_refWD75((Image)im_source, (Image)im_destination) → object :

Transforms a color image in XYZ colour space to a colour image in LAB colour space, using ‘D75’ as reference white.

C++ signature :

yayi::s_return_code color_XYZ_to_LAB_refWD75(yayi::IImage const*,yayi::IImage*)

YayiPixelProcessingPython.color_XYZ_to_LAB_refWE((Image)im_source, (Image)im_destination) → object :

Transforms a color image in XYZ colour space to a colour image in LAB colour space, using ‘E’ as reference white.

C++ signature :

yayi::s_return_code color_XYZ_to_LAB_refWE(yayi::IImage const*,yayi::IImage*)

YayiPixelProcessingPython.color_XYZ_to_sRGB_refWD65((Image)im_source, (Image)im_destination) → object :

Transforms a color image in XYZ colour space to a colour image in RGB colour space, assuming the RGB space is sRGB (reference white D65, CIE rgb primaries, gamma 2.4, specific linearising)

C++ signature :

yayi::s_return_code color_XYZ_to_sRGB_refWD65(yayi::IImage const*,yayi::IImage*)

YayiPixelProcessingPython.color_YUV_to_RGB((Image)im_source, (Image)im_destination) → object :

Transforms a color image in YUV colour space to a colour image in RGB colour space

C++ signature :

yayi::s_return_code color_YUV_to_RGB(yayi::IImage const*,yayi::IImage*)

YayiPixelProcessingPython.color_sRGB_to_XYZ_refWD65((Image)im_source, (Image)im_destination) → object :

Transforms a color image in RGB colour space to a colour image in XYZ colour space, assuming the RGB space is sRGB (reference white D65, CIE rgb primaries, gamma 2.4, specific linearising)

C++ signature :

yayi::s_return_code color_sRGB_to_XYZ_refWD65(yayi::IImage const*,yayi::IImage*)

class YayiPixelProcessingPython.comparison_operations

names = {'op_sup': YayiPixelProcessingPython.comparison_operations.op_sup, 'op_diff': YayiPixelProcessingPython.comparison_operations.op_diff, 'op_inf': YayiPixelProcessingPython.comparison_operations.op_inf, 'op_equal': YayiPixelProcessingPython.comparison_operations.op_equal, 'op_supeq': YayiPixelProcessingPython.comparison_operations.op_supeq, 'op_infeq': YayiPixelProcessingPython.comparison_operations.op_infeq}

op_diff = YayiPixelProcessingPython.comparison_operations.op_diff

op_equal = YayiPixelProcessingPython.comparison_operations.op_equal

op_inf = YayiPixelProcessingPython.comparison_operations.op_inf

op_infeq = YayiPixelProcessingPython.comparison_operations.op_infeq

op_sup = YayiPixelProcessingPython.comparison_operations.op_sup

op_supeq = YayiPixelProcessingPython.comparison_operations.op_supeq

values = {0: YayiPixelProcessingPython.comparison_operations.op_equal, 1: YayiPixelProcessingPython.comparison_operations.op_diff, 2: YayiPixelProcessingPython.comparison_operations.op_supeq, 3: YayiPixelProcessingPython.comparison_operations.op_sup, 4: YayiPixelProcessingPython.comparison_operations.op_infeq, 5: YayiPixelProcessingPython.comparison_operations.op_inf}