Name
set_hsiset_hsiSetHsiset_hsiSetHsiSetHsi — Define output colors (HSI-coded).
set_hsiset_hsiSetHsiset_hsiSetHsiSetHsi sets the region output color(s)/grayvalue(s) for
the valid window. Colors are passed as HueHueHueHueHuehue,
SaturationSaturationSaturationSaturationSaturationsaturation, and IntensityIntensityIntensityIntensityIntensityintensity. Transformation from
HSI to RGB is done with:
If only one combination is passed, all output will take place in
that color. If a tuple of colors is passed, the output color of
regions and geometric objects is modulo to the number of colors.
HALCON always begins output with
the first color passed. Note, that the number of output colors
depends on the number of objects that are displayed in one operator
call. If only single objects are displayed, they always appear in
the first color, even if the consist of more than one connected
components.
Selected colors are used until the next call of
set_colorset_colorSetColorset_colorSetColorSetColor,set_pixelset_pixelSetPixelset_pixelSetPixelSetPixel, set_rgbset_rgbSetRgbset_rgbSetRgbSetRgb or
set_grayset_graySetGrayset_graySetGraySetGray. Colors are relevant to windows, i.e. only the
colors of the valid window can be set. Region output colors are
used by operatores like disp_regiondisp_regionDispRegiondisp_regionDispRegionDispRegion, disp_linedisp_lineDispLinedisp_lineDispLineDispLine,
disp_rectangle1disp_rectangle1DispRectangle1disp_rectangle1DispRectangle1DispRectangle1, disp_rectangle2disp_rectangle2DispRectangle2disp_rectangle2DispRectangle2DispRectangle2,
disp_arrowdisp_arrowDispArrowdisp_arrowDispArrowDispArrow, etc. It is also used by operators with
gray value output in certain output modes (e.g. '3d_plot_lines','histogram',
'contourline', etc. See set_paintset_paintSetPaintset_paintSetPaintSetPaint).
The colors are internally stored as RGB triples. Some HSI triples
can not be represented by a valid RGB triple (i.e. in the range 0..255). In
this case the nearest color which can be represented is used instead.
- Multithreading type: reentrant (runs in parallel with non-exclusive operators).
- Multithreading scope: global (may be called from any thread).
- Processed without parallelization.
Hue for region output.
Default value: 30
Typical range of values: 0
≤
Hue
Hue
Hue
Hue
Hue
hue
≤
255
Restriction: 0 <= Hue && Hue <= 255
Saturation for region output.
Default value: 255
Typical range of values: 0
≤
Saturation
Saturation
Saturation
Saturation
Saturation
saturation
≤
255
Restriction: 0 <= Saturation && Saturation <= 255
Intensity for region output.
Default value: 84
Typical range of values: 0
≤
Intensity
Intensity
Intensity
Intensity
Intensity
intensity
≤
255
Restriction: 0 <= Intensity && Intensity <= 255
set_hsiset_hsiSetHsiset_hsiSetHsiSetHsi returns 2 (H_MSG_TRUE) if the window is valid and the
output colors are displayable. Otherwise an exception is raised.
get_hsiget_hsiGetHsiget_hsiGetHsiGetHsi
disp_regiondisp_regionDispRegiondisp_regionDispRegionDispRegion
get_hsiget_hsiGetHsiget_hsiGetHsiGetHsi,
get_pixelget_pixelGetPixelget_pixelGetPixelGetPixel,
trans_from_rgbtrans_from_rgbTransFromRgbtrans_from_rgbTransFromRgbTransFromRgb,
trans_to_rgbtrans_to_rgbTransToRgbtrans_to_rgbTransToRgbTransToRgb,
disp_regiondisp_regionDispRegiondisp_regionDispRegionDispRegion
Foundation