set_drawing_object_paramsset_drawing_object_paramsSetDrawingObjectParamsset_drawing_object_paramsSetDrawingObjectParamsSetDrawingObjectParams (Operator)

Name

set_drawing_object_paramsset_drawing_object_paramsSetDrawingObjectParamsset_drawing_object_paramsSetDrawingObjectParamsSetDrawingObjectParams — Set the parameters of a drawing object.

Signature

Description

set_drawing_object_paramsset_drawing_object_paramsSetDrawingObjectParamsset_drawing_object_paramsSetDrawingObjectParamsSetDrawingObjectParams is used to set the parameters GenParamNameGenParamNameGenParamNameGenParamNameGenParamNamegenParamName of the drawing object DrawIDDrawIDDrawIDDrawIDDrawIDdrawID to the values specified in GenParamValueGenParamValueGenParamValueGenParamValueGenParamValuegenParamValue.

Depending on the type of the drawing object the following parameters can be set for the different types of drawing object:

circle:

'row'"row""row""row""row""row": Row coordinate of the center of the circle.

'column'"column""column""column""column""column": Column coordinate of the center of the circle.

'radius'"radius""radius""radius""radius""radius": Radius of the circle.

circle_sector:

'row'"row""row""row""row""row": Row coordinate of the center.

'column'"column""column""column""column""column": Column coordinate of the center.

'radius'"radius""radius""radius""radius""radius": Radius of the circle.

'start_angle'"start_angle""start_angle""start_angle""start_angle""start_angle": Start angle of the circle arc.

'end_angle'"end_angle""end_angle""end_angle""end_angle""end_angle": End angle of the circle arc.

ellipse:

'row'"row""row""row""row""row": Row coordinate of the center of the ellipse.

'column'"column""column""column""column""column": Column coordinate of the center of the ellipse.

'phi'"phi""phi""phi""phi""phi": Orientation of the first half axis in radians.

'radius1'"radius1""radius1""radius1""radius1""radius1": Length of the first half axis.

'radius2'"radius2""radius2""radius2""radius2""radius2": Length of the second half axis.

ellipse_sector:

'row'"row""row""row""row""row": Row coordinate of the center of the ellipse sector.

'column'"column""column""column""column""column": Column coordinate of the center of the ellipse sector.

'phi'"phi""phi""phi""phi""phi": Orientation of the first half axis in radians.

'radius1'"radius1""radius1""radius1""radius1""radius1": Length of the first half axis.

'radius2'"radius2""radius2""radius2""radius2""radius2": Length of the second half axis.

'start_angle'"start_angle""start_angle""start_angle""start_angle""start_angle": Starting angle of the ellipse arc.

'end_angle'"end_angle""end_angle""end_angle""end_angle""end_angle": End angle of the ellipse arc.

rectangle1:

'row1'"row1""row1""row1""row1""row1": Row coordinate of the upper left corner.

'column1'"column1""column1""column1""column1""column1": Column coordinate of the upper left corner.

'row2'"row2""row2""row2""row2""row2": Row coordinate of the lower right corner.

'column2'"column2""column2""column2""column2""column2": Column coordinate of the lower right corner.

rectangle2:

'row'"row""row""row""row""row": Row coordinate of the center of the rectangle.

'column'"column""column""column""column""column": Column coordinate of the center of the rectangle.

'phi'"phi""phi""phi""phi""phi": Orientation of the first half axis in radians.

'length1'"length1""length1""length1""length1""length1": Length of the first half axis.

'length2'"length2""length2""length2""length2""length2": Length of the second half axis.

line:

'row1'"row1""row1""row1""row1""row1": Row coordinate of the first line point.

'column1'"column1""column1""column1""column1""column1": Column coordinate of the first line point.

'row2'"row2""row2""row2""row2""row2": Row coordinate of the second line point.

'column2'"column2""column2""column2""column2""column2": Column coordinate of the second line point.

xld:

'row'"row""row""row""row""row": Row coordinates of the contour points.

'column'"column""column""column""column""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 GenParamValueGenParamValueGenParamValueGenParamValueGenParamValuegenParamValue in the following order: [Row_0, Row_1, ..., Row_n, Column_0, Column_1, ... Column_n].

text:

'row'"row""row""row""row""row": Row coordinate of the text position.

'column'"column""column""column""column""column": Column coordinate of the text position.

'string'"string""string""string""string""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':

  'color'"color""color""color""color""color":

  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_colorset_colorSetColorset_colorSetColorSetColor for more information.

  'font'"font""font""font""font""font":

  Set the font of a text object. A list of all available fonts can be queried with query_fontquery_fontQueryFontquery_fontQueryFontQueryFont. See set_fontset_fontSetFontset_fontSetFontSetFont for a detailed description of the available values.

• Draw objects of type 'circle', 'circle_sector', 'ellipse', 'ellipse_sector', 'rectangle1', 'rectangle1', 'xld', 'line':

  'color'"color""color""color""color""color":

  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_colorset_colorSetColorset_colorSetColorSetColor for more information.

  'line_style'"line_style""line_style""line_style""line_style""line_style":

  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_styleset_line_styleSetLineStyleset_line_styleSetLineStyleSetLineStyle for more details. Please notice that since the length of the input tuple may vary, 'line_style'"line_style""line_style""line_style""line_style""line_style" must not be combined with other parameters or attributes in the same call. Otherwise an exception will the thrown.

  'line_width'"line_width""line_width""line_width""line_width""line_width":

  Set the line width of the drawing object in pixel. See set_line_widthset_line_widthSetLineWidthset_line_widthSetLineWidthSetLineWidth for more information.

If more than one parameter shall be set, they have to be passed as a tuple in GenParamNameGenParamNameGenParamNameGenParamNameGenParamNamegenParamName containing the name of the parameters. The corresponding values have to be passed as a tuple in GenParamValueGenParamValueGenParamValueGenParamValueGenParamValuegenParamValue.

If the drawing object is currently attached to a window, this window is redrawn for each call of set_drawing_object_paramsset_drawing_object_paramsSetDrawingObjectParamsset_drawing_object_paramsSetDrawingObjectParamsSetDrawingObjectParams.

Parallelization

• Multithreading type: reentrant (runs in parallel with non-exclusive operators).
• Multithreading scope: global (may be called from any thread).
• Processed without parallelization.

Parameters

Result

set_drawing_object_paramsset_drawing_object_paramsSetDrawingObjectParamsset_drawing_object_paramsSetDrawingObjectParamsSetDrawingObjectParams returns 2 (H_MSG_TRUE), if the DrawIDDrawIDDrawIDDrawIDDrawIDdrawID is valid, and the pairs of names and values of the tuples GenParamNameGenParamNameGenParamNameGenParamNameGenParamNamegenParamName and GenParamValueGenParamValueGenParamValueGenParamValueGenParamValuegenParamValue are coherent with the corresponding drawing object type. Otherwise an exception is raised.

Possible Predecessors

create_drawing_object_rectangle1create_drawing_object_rectangle1CreateDrawingObjectRectangle1create_drawing_object_rectangle1CreateDrawingObjectRectangle1CreateDrawingObjectRectangle1, create_drawing_object_rectangle2create_drawing_object_rectangle2CreateDrawingObjectRectangle2create_drawing_object_rectangle2CreateDrawingObjectRectangle2CreateDrawingObjectRectangle2, create_drawing_object_ellipsecreate_drawing_object_ellipseCreateDrawingObjectEllipsecreate_drawing_object_ellipseCreateDrawingObjectEllipseCreateDrawingObjectEllipse, create_drawing_object_circlecreate_drawing_object_circleCreateDrawingObjectCirclecreate_drawing_object_circleCreateDrawingObjectCircleCreateDrawingObjectCircle, create_drawing_object_linecreate_drawing_object_lineCreateDrawingObjectLinecreate_drawing_object_lineCreateDrawingObjectLineCreateDrawingObjectLine, create_drawing_object_ellipse_sectorcreate_drawing_object_ellipse_sectorCreateDrawingObjectEllipseSectorcreate_drawing_object_ellipse_sectorCreateDrawingObjectEllipseSectorCreateDrawingObjectEllipseSector, create_drawing_object_circle_sectorcreate_drawing_object_circle_sectorCreateDrawingObjectCircleSectorcreate_drawing_object_circle_sectorCreateDrawingObjectCircleSectorCreateDrawingObjectCircleSector, create_drawing_object_xldcreate_drawing_object_xldCreateDrawingObjectXldcreate_drawing_object_xldCreateDrawingObjectXldCreateDrawingObjectXld, attach_drawing_object_to_windowattach_drawing_object_to_windowAttachDrawingObjectToWindowattach_drawing_object_to_windowAttachDrawingObjectToWindowAttachDrawingObjectToWindow

Possible Successors

get_drawing_object_paramsget_drawing_object_paramsGetDrawingObjectParamsget_drawing_object_paramsGetDrawingObjectParamsGetDrawingObjectParams, attach_drawing_object_to_windowattach_drawing_object_to_windowAttachDrawingObjectToWindowattach_drawing_object_to_windowAttachDrawingObjectToWindowAttachDrawingObjectToWindow, get_drawing_object_iconicget_drawing_object_iconicGetDrawingObjectIconicget_drawing_object_iconicGetDrawingObjectIconicGetDrawingObjectIconic

See also

attach_drawing_object_to_windowattach_drawing_object_to_windowAttachDrawingObjectToWindowattach_drawing_object_to_windowAttachDrawingObjectToWindowAttachDrawingObjectToWindow, get_drawing_object_iconicget_drawing_object_iconicGetDrawingObjectIconicget_drawing_object_iconicGetDrawingObjectIconicGetDrawingObjectIconic, set_drawing_object_callbackset_drawing_object_callbackSetDrawingObjectCallbackset_drawing_object_callbackSetDrawingObjectCallbackSetDrawingObjectCallback

Module

Foundation