Operator Reference

HALCON Operator Reference / Filters / Color
ClassesClasses | | Operators

rgb1_to_grayrgb1_to_grayRgb1ToGrayRgb1ToGrayrgb1_to_gray (Operator)

rgb1_to_grayrgb1_to_grayRgb1ToGrayRgb1ToGrayrgb1_to_gray — Transform an RGB image into a gray scale image.

Signature

rgb1_to_gray(RGBImage : GrayImage : : )

Herror rgb1_to_gray(const Hobject RGBImage, Hobject* GrayImage)

Herror T_rgb1_to_gray(const Hobject RGBImage, Hobject* GrayImage)

void Rgb1ToGray(const HObject& RGBImage, HObject* GrayImage)

HImage HImage::Rgb1ToGray() const

static void HOperatorSet.Rgb1ToGray(HObject RGBImage, out HObject grayImage)

HImage HImage.Rgb1ToGray()

def rgb1_to_gray(rgbimage: HObject) -> HObject

Description

rgb1_to_grayrgb1_to_grayRgb1ToGrayRgb1ToGrayrgb1_to_gray transforms an RGB image into a gray scale image. The three channels of the RGB image are passed as the first three channels of the input image. The image is transformed according to the following formula: gray = 0.299 * red + 0.587 * green + 0.114 * blue .

If one of the input images in RGBImageRGBImageRGBImageRGBImagergbimage is a single-channel image its reference will be simply copied to the output GrayImageGrayImageGrayImagegrayImagegray_image.

Execution Information

  • Supports OpenCL compute devices.
  • Multithreading type: reentrant (runs in parallel with non-exclusive operators).
  • Multithreading scope: global (may be called from any thread).
  • Automatically parallelized on tuple level.
  • Automatically parallelized on domain level.

Parameters

RGBImageRGBImageRGBImageRGBImagergbimage (input_object)  (multichannel-)image(-array) → objectHImageHObjectHObjectHobject (byte / int2 / uint2 / real)

Three-channel RBG image.

GrayImageGrayImageGrayImagegrayImagegray_image (output_object)  singlechannelimage(-array) → objectHImageHObjectHObjectHobject * (byte / int2 / uint2 / real)

Gray scale image.

Example (HDevelop)

* Transformation from rgb to gray
read_image(Image,'patras')
dev_display(Image)
rgb1_to_gray(Image,GrayImage)
dev_display(GrayImage)

Example (C)

/* Transformation from rgb to gray  */
read_image(Image,"patras");
disp_color(Image,WindowHandle);
rgb1_to_gray(Image,&GrayImage);
disp_image(GrayImage,WindowHandle);

Example (HDevelop)

* Transformation from rgb to gray
read_image(Image,'patras')
dev_display(Image)
rgb1_to_gray(Image,GrayImage)
dev_display(GrayImage)

Example (HDevelop)

* Transformation from rgb to gray
read_image(Image,'patras')
dev_display(Image)
rgb1_to_gray(Image,GrayImage)
dev_display(GrayImage)

Possible Predecessors

compose3compose3Compose3Compose3compose3

Alternatives

trans_from_rgbtrans_from_rgbTransFromRgbTransFromRgbtrans_from_rgb, rgb3_to_grayrgb3_to_grayRgb3ToGrayRgb3ToGrayrgb3_to_gray

Module

Foundation

ClassesClasses | | Operators