Operator Reference

HALCON Operator Reference / Filters / Arithmetic
ClassesClasses | | Operators

abs_imageabs_imageAbsImageAbsImageabs_image (Operator)

abs_imageabs_imageAbsImageAbsImageabs_image — Calculate the absolute value (modulus) of an image.

Signature

abs_image(Image : ImageAbs : : )

Herror abs_image(const Hobject Image, Hobject* ImageAbs)

Herror T_abs_image(const Hobject Image, Hobject* ImageAbs)

void AbsImage(const HObject& Image, HObject* ImageAbs)

HImage HImage::AbsImage() const

static void HOperatorSet.AbsImage(HObject image, out HObject imageAbs)

HImage HImage.AbsImage()

def abs_image(image: HObject) -> HObject

Description

The operator abs_imageabs_imageAbsImageAbsImageabs_image calculates the absolute gray values of images of any type and stores the result in ImageAbsImageAbsImageAbsimageAbsimage_abs. The power spectrum of complex images is calculated as a real image. For a ImageImageImageimageimage of type 'int1', ImageAbsImageAbsImageAbsimageAbsimage_abs is of type byte. For ImageImageImageimageimage of other signed types the type of the input image is used for ImageAbsImageAbsImageAbsimageAbsimage_abs. The behavior in case of overflows or underflows is undefined. The operator abs_imageabs_imageAbsImageAbsImageabs_image generates a logical copy of unsigned images.

abs_imageabs_imageAbsImageAbsImageabs_image can be executed on an OpenCL device for int1, int2, int4, real, and complex images. However, since for OpenCL 1.0 only single precision floating point is supported for all devices, and not all rounding modes are supported, the OpenCL implementation can produce slightly different results from the scalar or SIMD implementations.

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 channel level.
  • Automatically parallelized on domain level.

Parameters

ImageImageImageimageimage (input_object)  (multichannel-)image(-array) → objectHImageHObjectHObjectHobject (int1* / int2* / int4* / int8 / real* / complex*) *allowed for compute devices

Image(s) for which the absolute gray values are to be calculated.

ImageAbsImageAbsImageAbsimageAbsimage_abs (output_object)  (multichannel-)image(-array) → objectHImageHObjectHObjectHobject * (byte / int2 / int4 / int8 / real)

Result image(s).

Example (HDevelop)

convert_image_type (Image, ImageInt2, 'int2')
texture_laws (ImageInt2, ImageTexture, 'el', 2, 5)
abs_image (ImageTexture, ImageTexture)

Result

The operator abs_imageabs_imageAbsImageAbsImageabs_image returns the value 2 ( H_MSG_TRUE) . The behavior in case of empty input (no input images available) is set via the operator set_system(::'no_object_result',<Result>:)set_system("no_object_result",<Result>)SetSystem("no_object_result",<Result>)SetSystem("no_object_result",<Result>)set_system("no_object_result",<Result>)

See also

convert_image_typeconvert_image_typeConvertImageTypeConvertImageTypeconvert_image_type, power_bytepower_bytePowerBytePowerBytepower_byte

Module

Foundation

ClassesClasses | | Operators