dev_set_lutdev_set_lutDevSetLutDevSetLutdev_set_lut (Operator)
Name
dev_set_lutdev_set_lutDevSetLutDevSetLutdev_set_lut — Set “look-up-table” (lut).
Signature
Herror dev_set_lut(const char* LutName)
Herror T_dev_set_lut(const Htuple LutName)
def dev_set_lut(lut_name: MaybeSequence[Union[str, float, int]]) -> None
Description
dev_set_lutdev_set_lutDevSetLutDevSetLutdev_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_lutQueryLutQueryLutquery_lut lists the names of all look-up-tables.
For more information see the description of the operator
set_lutset_lutSetLutSetLutset_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
LutNameLutNameLutNamelutNamelut_name (input_control) filename.read(-array) → HTupleMaybeSequence[Union[str, float, int]]HTupleHtuple (string / real / integer) (string / double / int / long) (HString / double / Hlong) (char* / double / Hlong)
Name of look-up-table, values of look-up-table (RGB)
or file name.
Default:
'default'
"default"
"default"
"default"
"default"
Suggested values:
'default'"default""default""default""default", 'linear'"linear""linear""linear""linear", 'inverse'"inverse""inverse""inverse""inverse", 'sqr'"sqr""sqr""sqr""sqr", 'inv_sqr'"inv_sqr""inv_sqr""inv_sqr""inv_sqr", 'cube'"cube""cube""cube""cube", 'inv_cube'"inv_cube""inv_cube""inv_cube""inv_cube", 'sqrt'"sqrt""sqrt""sqrt""sqrt", 'inv_sqrt'"inv_sqrt""inv_sqrt""inv_sqrt""inv_sqrt", '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", 'color1'"color1""color1""color1""color1", 'color2'"color2""color2""color2""color2", 'color3'"color3""color3""color3""color3", 'color4'"color4""color4""color4""color4", 'three'"three""three""three""three", 'six'"six""six""six""six", 'twelve'"twelve""twelve""twelve""twelve", 'twenty_four'"twenty_four""twenty_four""twenty_four""twenty_four", 'rainbow'"rainbow""rainbow""rainbow""rainbow", 'temperature'"temperature""temperature""temperature""temperature", 'cyclic_gray'"cyclic_gray""cyclic_gray""cyclic_gray""cyclic_gray", 'cyclic_temperature'"cyclic_temperature""cyclic_temperature""cyclic_temperature""cyclic_temperature", 'hsi'"hsi""hsi""hsi""hsi", 'change1'"change1""change1""change1""change1", 'change2'"change2""change2""change2""change2", 'change3'"change3""change3""change3""change3", 'jet'"jet""jet""jet""jet", 'jet_inverse'"jet_inverse""jet_inverse""jet_inverse""jet_inverse"
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_lutDevSetLutDevSetLutdev_set_lut returns 2 (
H_MSG_TRUE)
. Otherwise, an
exception is raised and an error code returned.
Possible Successors
dev_displaydev_displayDevDisplayDevDisplaydev_display
See also
set_lutset_lutSetLutSetLutset_lut
Module
Foundation