set_scene_3d_label_paramT_set_scene_3d_label_paramSetScene3dLabelParamSetScene3dLabelParamset_scene_3d_label_param (算子)

名称

set_scene_3d_label_paramT_set_scene_3d_label_paramSetScene3dLabelParamSetScene3dLabelParamset_scene_3d_label_param — 在三维场景中设置文本标签的参数。

签名

描述

set_scene_3d_label_paramset_scene_3d_label_paramSetScene3dLabelParamSetScene3dLabelParamSetScene3dLabelParamset_scene_3d_label_param sets parameters of the label LabelIndexLabelIndexLabelIndexLabelIndexlabelIndexlabel_index in the 3D scene Scene3DScene3DScene3DScene3Dscene3Dscene_3d. The name and value of a parameter must be given in GenParamNameGenParamNameGenParamNameGenParamNamegenParamNamegen_param_name and GenParamValueGenParamValueGenParamValueGenParamValuegenParamValuegen_param_value. It is only possible to provide one GenParamNameGenParamNameGenParamNameGenParamNamegenParamNamegen_param_name,GenParamValueGenParamValueGenParamValueGenParamValuegenParamValuegen_param_value pair but multiple labels. The parameter is applied to all labels in LabelIndexLabelIndexLabelIndexLabelIndexlabelIndexlabel_index。

The following values can be set:

'reference_point'"reference_point""reference_point""reference_point""reference_point""reference_point"：

Coordinates of the reference point, as a tuple of [X, Y, Z] coordinates. To remove the current reference point, it is possible to pass an empty tuple for 'reference_point'"reference_point""reference_point""reference_point""reference_point""reference_point". This is only possible if 'relates_to'"relates_to""relates_to""relates_to""relates_to""relates_to" is 'window'"window""window""window""window""window".

'position'"position""position""position""position""position"：

Position (relative or absolute depending on the parameter 'relates_to'"relates_to""relates_to""relates_to""relates_to""relates_to") of the label, as a tuple of [Row, Column] coordinates or one of the following predefined positions: 'top_left'"top_left""top_left""top_left""top_left""top_left", 'top'"top""top""top""top""top", 'top_right'"top_right""top_right""top_right""top_right""top_right", 'left'"left""left""left""left""left", 'center'"center""center""center""center""center", 'right'"right""right""right""right""right", 'bottom_left'"bottom_left""bottom_left""bottom_left""bottom_left""bottom_left", 'bottom'"bottom""bottom""bottom""bottom""bottom", or 'bottom_right'"bottom_right""bottom_right""bottom_right""bottom_right""bottom_right".

'relates_to'"relates_to""relates_to""relates_to""relates_to""relates_to"：

Relation of the position. May be 'window'"window""window""window""window""window" (fixed positioning in window coordinates) or 'point'"point""point""point""point""point" (positioning relative to the reference point). 'relates_to'"relates_to""relates_to""relates_to""relates_to""relates_to" cannot be set to 'point'"point""point""point""point""point" if the reference point has been set to an empty tuple. 值列表： 'window'"window""window""window""window""window" , 'point'"point""point""point""point""point".

Default: 'window'"window""window""window""window""window".

'text'"text""text""text""text""text"：

Text of the label. Multiple Lines must be separated with '\n'"\n""\n""\n""\n""\n".

'font'"font""font""font""font""font"：

Font of the text label.

Possible values: Available fonts can be queried using query_fontquery_fontQueryFontQueryFontQueryFontquery_font。

Default: Font of the first window the scene is displayed in, default system font otherwise.

'text_color'"text_color""text_color""text_color""text_color""text_color"：

Color of the text on the label. The available colors can be queried with the operator query_colorquery_colorQueryColorQueryColorQueryColorquery_color。In addition, the color may be specified as an RGB triplet in the form '#rrggbb'"#rrggbb""#rrggbb""#rrggbb""#rrggbb""#rrggbb", where 'rr', 'gg', and 'bb' are hexadecimal numbers between '00' and 'ff', respectively.

Possible values: 'red'"red""red""red""red""red", 'green'"green""green""green""green""green".

Default: 'white'"white""white""white""white""white".

'alpha'"alpha""alpha""alpha""alpha""alpha"：

Transparency of the text label's background.

Possible values: floating point value between 0.0 (fully transparent) and 1.0 (fully opaque).

Default: 1.0

'color'"color""color""color""color""color"：

Color of the label itself. The available colors can be queried with the operator query_colorquery_colorQueryColorQueryColorQueryColorquery_color。In addition, the color may be specified as an RGB triplet in the form '#rrggbb'"#rrggbb""#rrggbb""#rrggbb""#rrggbb""#rrggbb", where 'rr', 'gg', and 'bb' are hexadecimal numbers between '00' and 'ff', respectively.

Possible values: 'red'"red""red""red""red""red", 'green'"green""green""green""green""green".

Default: 'gray'"gray""gray""gray""gray""gray".

'disp_background'"disp_background""disp_background""disp_background""disp_background""disp_background"：

Flag that determines if the background of the label should be visualized.

值列表： 'true'"true""true""true""true""true", 'false'"false""false""false""false""false".

Default: 'true'"true""true""true""true""true".

'disp_connecting_line'"disp_connecting_line""disp_connecting_line""disp_connecting_line""disp_connecting_line""disp_connecting_line"：

Flag that determines if the connecting line between the label and reference 3D point should be visualized.

值列表： 'true'"true""true""true""true""true", 'false'"false""false""false""false""false".

Default: 'true'"true""true""true""true""true".

'visible'"visible""visible""visible""visible""visible"：

Sets the visibility of the label. If set to 'if_point_is_visible'"if_point_is_visible""if_point_is_visible""if_point_is_visible""if_point_is_visible""if_point_is_visible", the label is only visible if its reference point is visible. If the compatibility mode is enabled or no reference point is set, 'if_point_is_visible'"if_point_is_visible""if_point_is_visible""if_point_is_visible""if_point_is_visible""if_point_is_visible" is equal to 'true'"true""true""true""true""true".

值列表： 'true'"true""true""true""true""true", 'false'"false""false""false""false""false", 'if_point_is_visible'"if_point_is_visible""if_point_is_visible""if_point_is_visible""if_point_is_visible""if_point_is_visible".

Default: 'true'"true""true""true""true""true".

执行信息

• 多线程类型：可重入（与非独占算子并行运行）。
• 多线程作用域：全局（可从任何线程调用）。
• 未采用并行化处理。

参数

结果

set_scene_3d_label_paramset_scene_3d_label_paramSetScene3dLabelParamSetScene3dLabelParamSetScene3dLabelParamset_scene_3d_label_param 在所有参数正确时返回 2 ( H_MSG_TRUE )。如有必要，则抛出异常。

可能的前趋

add_scene_3d_labeladd_scene_3d_labelAddScene3dLabelAddScene3dLabelAddScene3dLabeladd_scene_3d_label

模块

三维计量