dev_set_lutdev_set_lutDevSetLutDevSetLutdev_set_lut (Operator)

Name

dev_set_lutdev_set_lutDevSetLutDevSetLutdev_set_lut — Set “look-up-table” (lut).

Signature

dev_set_lut( : : LutName : )

Description

dev_set_lutdev_set_lutDevSetLutDevSetLutDevSetLutdev_set_lut sets the look-up-table of the active graphics window. A look-up-table defines the transformation of a “gray value” from an one-channel-image into a gray value or color on the screen. query_lutquery_lutQueryLutQueryLutQueryLutquery_lut lists the names of all look-up-tables.

For more information see the description of the operator set_lutset_lutSetLutSetLutSetLutset_lut. However, in contrast to that operator the new look-up-table is also used for all new graphics windows that are opened afterwards.

Attention

Using the code export feature of HDevelop, the code that is generated for this operator may have a different behavior than the related HALCON operator. For a detailed description of the code export of HDevelop graphics operators into the different programming languages see in the “HDevelop User's Guide” the chapter Code Export -> General Aspects of Code Generation -> Graphics Windows.

Parameters

LutNameLutNameLutNameLutNamelutNamelut_name (input_control) filename.read → (string)

Name of look-up-table, values of look-up-table (RGB) or file name.

Default value: 'default' "default" "default" "default" "default" "default"

Suggested values: 'default'"default""default""default""default""default", 'linear'"linear""linear""linear""linear""linear", 'inverse'"inverse""inverse""inverse""inverse""inverse", 'sqr'"sqr""sqr""sqr""sqr""sqr", 'inv_sqr'"inv_sqr""inv_sqr""inv_sqr""inv_sqr""inv_sqr", 'cube'"cube""cube""cube""cube""cube", 'inv_cube'"inv_cube""inv_cube""inv_cube""inv_cube""inv_cube", 'sqrt'"sqrt""sqrt""sqrt""sqrt""sqrt", 'inv_sqrt'"inv_sqrt""inv_sqrt""inv_sqrt""inv_sqrt""inv_sqrt", 'cubic_root'"cubic_root""cubic_root""cubic_root""cubic_root""cubic_root", 'inv_cubic_root'"inv_cubic_root""inv_cubic_root""inv_cubic_root""inv_cubic_root""inv_cubic_root", 'color1'"color1""color1""color1""color1""color1", 'color2'"color2""color2""color2""color2""color2", 'color3'"color3""color3""color3""color3""color3", 'color4'"color4""color4""color4""color4""color4", 'three'"three""three""three""three""three", 'six'"six""six""six""six""six", 'twelve'"twelve""twelve""twelve""twelve""twelve", 'twenty_four'"twenty_four""twenty_four""twenty_four""twenty_four""twenty_four", 'rainbow'"rainbow""rainbow""rainbow""rainbow""rainbow", 'temperature'"temperature""temperature""temperature""temperature""temperature", 'cyclic_gray'"cyclic_gray""cyclic_gray""cyclic_gray""cyclic_gray""cyclic_gray", 'cyclic_temperature'"cyclic_temperature""cyclic_temperature""cyclic_temperature""cyclic_temperature""cyclic_temperature", 'hsi'"hsi""hsi""hsi""hsi""hsi", 'change1'"change1""change1""change1""change1""change1", 'change2'"change2""change2""change2""change2""change2", 'change3'"change3""change3""change3""change3""change3"

File extension: .lut

Example (HDevelop)

read_image(Image,'mreut')
dev_set_lut('inverse')
* For true color only:
dev_display(Image)

Result

If the values of the specified parameters are correct, dev_set_lutdev_set_lutDevSetLutDevSetLutDevSetLutdev_set_lut returns 2 (H_MSG_TRUE). Otherwise, an exception is raised and an error code returned.

Possible Successors

dev_displaydev_displayDevDisplayDevDisplayDevDisplaydev_display

Module

Foundation