dev_set_paint ( : : Mode : )

Define the grayvalue output mode.

dev_set_paint defines the output mode for gray value display in the graphics window. The mode is used by dev_display.

This page describes shortly the different modes, that can be used for gray value output. It should be noted, that the mode 'default' is the most suitable. For a detailed description of all possible options see set_paint.

A different way to display gray values is the histogram (mode: 'histogram'). This mode has three additional parameter values: Row (second value) and column (third value). They denote row and column of the histogram center for positioning on the screen. The scale factor (fourth value) determines the histogram size: a scale factor of 1 distinguishes 256 grayvalues, 2 distinguishes 128 grevalues, and so on. The four values are passed as a tuple, e.g., ['histogram', 256,256,1]. If only the first value is passed ('histogram'), the other values are set to defaults or the last values, respectively. For histogram computation see gray_histo.

The modes 'row' and 'column' allow to display gray values along rows or columns, respecively. The position (row and column index) is passed with the second parameter value. The third parameter value is the scale factor in percent (100 means 1 pixel per grayvalue, 50 means one pixel per two grayvalues).

Gray images can also be interpreted as 3d data, depending on the gray value. To view these 3d plots, select the modes 'contourline', '3D-plot' or '3D-plot_hidden'. For a detailed description of all parameter settings see set_paint.

Parameters for modes that need more than one parameter can be passed the following ways:

- Only the name of the mode is passed: the defaults or the last
  values are used, respectively.
  Example: dev_set_paint('contourline')
- All values are passed: all output characteristics can be set.
  Example: dev_set_paint(['contourline',10,1])
- Only the first n values are passed: only the passed values are
  changed.
  Example: dev_set_paint(['contourline',10])


Attention

If dev_set_paint should be used for exported Code (C++), please note the description of set_paint due to the different semantics in C++.


Parameters

Mode (input_control)
string-array -> string / integer
Grayvalue output name. Additional parameters possible.
Default value: 'default'
List of values: 'default', 'histogram', 'row', 'column', 'contourline', '3D-plot', '3D-plot_hidden', '3D-plot_point'


Example
read_image(Image,'fabrik')
dev_set_paint('3D-plot')
dev_display(Image)

Parallelization Information

dev_set_paint is local and processed completely exclusively without parallelization.


Possible Predecessors

dev_open_window


Possible Successors

dev_set_color, dev_display


See also

set_paint


Module

Foundation



Copyright © 1996-2008 MVTec Software GmbH