set_drawing_object_params — Set the parameters of a drawing object.
set_drawing_object_params( : : DrawID, GenParamName, GenParamValue : )
set_drawing_object_params is used to set the parameters
GenParamName of the drawing object DrawID to the values
specified in GenParamValue.
Depending on the type of the drawing object the following parameters can be set for the different types of drawing object:
'row': Row coordinate of the center of the circle.
'column': Column coordinate of the center of the circle.
'radius': Radius of the circle.
'row': Row coordinate of the center.
'column': Column coordinate of the center.
'radius': Radius of the circle.
'start_angle': Start angle of the circle arc.
'end_angle': End angle of the circle arc.
'row': Row coordinate of the center of the ellipse.
'column': Column coordinate of the center of the ellipse.
'phi': Orientation of the first half axis in radians.
'radius1': Length of the first half axis.
'radius2': Length of the second half axis.
'row': Row coordinate of the center of the ellipse sector.
'column': Column coordinate of the center of the ellipse sector.
'phi': Orientation of the first half axis in radians.
'radius1': Length of the first half axis.
'radius2': Length of the second half axis.
'start_angle': Starting angle of the ellipse arc.
'end_angle': End angle of the ellipse arc.
'row1': Row coordinate of the upper left corner.
'column1': Column coordinate of the upper left corner.
'row2': Row coordinate of the lower right corner.
'column2': Column coordinate of the lower right corner.
'row': Row coordinate of the center of the rectangle.
'column': Column coordinate of the center of the rectangle.
'phi': Orientation of the first half axis in radians.
'length1': Length of the first half axis.
'length2': Length of the second half axis.
'row1': Row coordinate of the first line point.
'column1': Column coordinate of the first line point.
'row2': Row coordinate of the second line point.
'column2': Column coordinate of the second line point.
'row': Row coordinates of the contour points.
'column': Column coordinates of the contour points.
It is possible to either set only the row or column coordinates
of the contour points, or both at the same time. In the first case,
the number of elements in the input tuple must be the same as the
number of points in the contour. In the second case, all existing
contour points are discarded and replaced by new ones. The new
coordinates are specified in GenParamValue in the following order:
[Row_0, Row_1, ..., Row_n, Column_0, Column_1, ... Column_n].
'row': Row coordinate of the text position.
'column': Column coordinate of the text position.
'string': Text string to be displayed.
In addition, there is an additional number of attributes that model the appearance of the drawing object in the window it is attached to. Depending on the type of the drawing object the following attributes can be set.
Draw objects of type 'text':
Set the color of a text object. The color can be specified either by
name, e.g., 'green', or by RGB values, e.g., '#ffb529'.
See set_color for more information.
Set the font of a text object. A list of all available fonts can be
queried with query_font. See set_font for a detailed
description of the available values.
Draw objects of type 'circle', 'circle_sector', 'ellipse', 'ellipse_sector', 'rectangle1', 'rectangle1', 'xld', 'line':
Set the color of a drawing object. The color can be specified either by
name, e.g., 'green', or by RGB values, e.g., '#ffb529'.
See set_color for more information.
Set the line style of the drawing object. This attribute requires at least
one pair of attribute values in form of a tuple. The first defines the
length of the visible part, the second defines the length of the invisible
part. See set_line_style for more details.
Please notice that since the length of the input tuple may vary,
'line_style' must not be combined with other parameters
or attributes in the same call.
Otherwise an exception will the thrown.
Set the line width of the drawing object in pixel. See set_line_width
for more information.
If more than one parameter shall be set, they have to be passed as a tuple
in GenParamName containing the name of the parameters.
The corresponding values have to be passed as a tuple in GenParamValue.
If the drawing object is currently attached to a window, this window is
redrawn for each call of set_drawing_object_params.
DrawID (input_control) drawing_object → (handle)
Handle of the drawing object.
GenParamName (input_control) attribute.name(-array) → (string)
Parameter names of the drawing object.
List of values: 'color', 'column', 'column1', 'column2', 'end_angle', 'font', 'length1', 'length2', 'line_style', 'line_width', 'phi', 'radius', 'radius1', 'radius2', 'row', 'row1', 'row2', 'start_angle', 'string'
GenParamValue (input_control) attribute.name(-array) → (real / integer / string)
Parameter values.
set_drawing_object_params returns 2 (H_MSG_TRUE), if the DrawID is valid,
and the pairs of names and values of the tuples GenParamName and
GenParamValue are coherent with the corresponding drawing object type.
Otherwise an exception is raised.
create_drawing_object_rectangle1,
create_drawing_object_rectangle2,
create_drawing_object_ellipse,
create_drawing_object_circle,
create_drawing_object_line,
create_drawing_object_ellipse_sector,
create_drawing_object_circle_sector,
create_drawing_object_xld,
attach_drawing_object_to_window
get_drawing_object_params,
attach_drawing_object_to_window,
get_drawing_object_iconic
attach_drawing_object_to_window,
get_drawing_object_iconic,
set_drawing_object_callback
Foundation