HALCON 17.12 / HALCON Operator Reference / Graphics / 3D Scene
ClassesClasses | | Operators

set_scene_3d_paramset_scene_3d_paramSetScene3dParamSetScene3dParam (Operator)

Name

set_scene_3d_paramset_scene_3d_paramSetScene3dParamSetScene3dParam — Set parameters of a 3D scene.

Signature

set_scene_3d_param( : : Scene3D, GenParamName, GenParamValue : )

Herror set_scene_3d_param(const Hlong Scene3D, const char* GenParamName, const char* GenParamValue)

Herror T_set_scene_3d_param(const Htuple Scene3D, const Htuple GenParamName, const Htuple GenParamValue)

void SetScene3dParam(const HTuple& Scene3D, const HTuple& GenParamName, const HTuple& GenParamValue)

void HScene3D::SetScene3dParam(const HString& GenParamName, const HTuple& GenParamValue) const

void HScene3D::SetScene3dParam(const HString& GenParamName, const HString& GenParamValue) const

void HScene3D::SetScene3dParam(const char* GenParamName, const char* GenParamValue) const

static void HOperatorSet.SetScene3dParam(HTuple scene3D, HTuple genParamName, HTuple genParamValue)

void HScene3D.SetScene3dParam(string genParamName, HTuple genParamValue)

void HScene3D.SetScene3dParam(string genParamName, string genParamValue)

Description

set_scene_3d_paramset_scene_3d_paramSetScene3dParamSetScene3dParamSetScene3dParam sets parameters of the 3D scene Scene3DScene3DScene3DScene3Dscene3D. The name and value of a parameter must be given in GenParamNameGenParamNameGenParamNameGenParamNamegenParamName and GenParamValueGenParamValueGenParamValueGenParamValuegenParamValue.

All parameters that can be set with set_scene_3d_instance_paramset_scene_3d_instance_paramSetScene3dInstanceParamSetScene3dInstanceParamSetScene3dInstanceParam can be set with set_scene_3d_paramset_scene_3d_paramSetScene3dParamSetScene3dParamSetScene3dParam for all instances of a scene.

Additionally, the following parameters can be set:

'disp_background'"disp_background""disp_background""disp_background""disp_background":

Flag, if the current window content should be used as background.

Values: 'true' or 'false'

Default value: 'false'

'colored'"colored""colored""colored""colored":

Set the colors of all currently added instances to different colors. The value of this parameter defines the number of colors that are used.

Values: 3, 6, or 12

Default value: all objects are displayed white

'object_index_persistence'"object_index_persistence""object_index_persistence""object_index_persistence""object_index_persistence":

Must be set to 'true'"true""true""true""true" to enable the object index query with get_display_scene_3d_infoget_display_scene_3d_infoGetDisplayScene3dInfoGetDisplayScene3dInfoGetDisplayScene3dInfo.

Values: 'true' or 'false'

Default value: 'false'

'depth_persistence'"depth_persistence""depth_persistence""depth_persistence""depth_persistence":

Must be set to 'true'"true""true""true""true" to enable the depth query with get_display_scene_3d_infoget_display_scene_3d_infoGetDisplayScene3dInfoGetDisplayScene3dInfoGetDisplayScene3dInfo.

Values: 'true' or 'false'

Default value: 'false'

'quality'"quality""quality""quality""quality":

Must be set to 'low'"low""low""low""low" to enable faster rendering without anti aliasing.

Values: 'low' or 'high'

Default value: 'high'

'compatibility_mode_enable'"compatibility_mode_enable""compatibility_mode_enable""compatibility_mode_enable""compatibility_mode_enable":

Enforce the usage of the fallback mode to OpenGL 1.1.

Values: 'true' of 'false'

Default value: 'false'

Execution Information

Parameters

Scene3DScene3DScene3DScene3Dscene3D (input_control)  scene_3d → HScene3D, HTupleHTupleHtuple (integer) (IntPtr) (Hlong) (Hlong)

Handle of the 3D scene.

GenParamNameGenParamNameGenParamNameGenParamNamegenParamName (input_control)  string → HTupleHTupleHtuple (string) (string) (HString) (char*)

Names of the generic parameters.

Default value: 'quality' "quality" "quality" "quality" "quality"

List of values: 'alpha'"alpha""alpha""alpha""alpha", 'attribute'"attribute""attribute""attribute""attribute", 'blue_channel_attrib'"blue_channel_attrib""blue_channel_attrib""blue_channel_attrib""blue_channel_attrib", 'color'"color""color""color""color", 'color_attrib'"color_attrib""color_attrib""color_attrib""color_attrib", 'color_attrib_end'"color_attrib_end""color_attrib_end""color_attrib_end""color_attrib_end", 'color_attrib_start'"color_attrib_start""color_attrib_start""color_attrib_start""color_attrib_start", 'colored'"colored""colored""colored""colored", 'compatibility_mode_enable'"compatibility_mode_enable""compatibility_mode_enable""compatibility_mode_enable""compatibility_mode_enable", 'depth_persistence'"depth_persistence""depth_persistence""depth_persistence""depth_persistence", 'disp_background'"disp_background""disp_background""disp_background""disp_background", 'disp_lines'"disp_lines""disp_lines""disp_lines""disp_lines", 'disp_normals'"disp_normals""disp_normals""disp_normals""disp_normals", 'disp_pose'"disp_pose""disp_pose""disp_pose""disp_pose", 'green_channel_attrib'"green_channel_attrib""green_channel_attrib""green_channel_attrib""green_channel_attrib", 'line_color'"line_color""line_color""line_color""line_color", 'line_width'"line_width""line_width""line_width""line_width", 'lut'"lut""lut""lut""lut", 'normal_color'"normal_color""normal_color""normal_color""normal_color", 'object_index_persistence'"object_index_persistence""object_index_persistence""object_index_persistence""object_index_persistence", 'point_size'"point_size""point_size""point_size""point_size", 'quality'"quality""quality""quality""quality", 'red_channel_attrib'"red_channel_attrib""red_channel_attrib""red_channel_attrib""red_channel_attrib", 'rgb_channel_attrib_end'"rgb_channel_attrib_end""rgb_channel_attrib_end""rgb_channel_attrib_end""rgb_channel_attrib_end", 'rgb_channel_attrib_start'"rgb_channel_attrib_start""rgb_channel_attrib_start""rgb_channel_attrib_start""rgb_channel_attrib_start", 'visible'"visible""visible""visible""visible"

GenParamValueGenParamValueGenParamValueGenParamValuegenParamValue (input_control)  string → HTupleHTupleHtuple (string / integer / real) (string / int / long / double) (HString / Hlong / double) (char* / Hlong / double)

Values of the generic parameters.

Default value: 'high' "high" "high" "high" "high"

Suggested values: 'true'"true""true""true""true", 'false'"false""false""false""false", 'coord_x'"coord_x""coord_x""coord_x""coord_x", 'coord_y'"coord_y""coord_y""coord_y""coord_y", 'coord_z'"coord_z""coord_z""coord_z""coord_z", 'normal_x'"normal_x""normal_x""normal_x""normal_x", 'normal_y'"normal_y""normal_y""normal_y""normal_y", 'normal_z'"normal_z""normal_z""normal_z""normal_z", 'red'"red""red""red""red", 'green'"green""green""green""green", 'blue'"blue""blue""blue""blue", 'auto'"auto""auto""auto""auto", 'faces'"faces""faces""faces""faces", 'primitive'"primitive""primitive""primitive""primitive", 'points'"points""points""points""points", 'lines'"lines""lines""lines""lines"

Result

set_scene_3d_paramset_scene_3d_paramSetScene3dParamSetScene3dParamSetScene3dParam returns 2 (H_MSG_TRUE) if all parameters are correct. If necessary, an exception is raised.

Possible Predecessors

create_scene_3dcreate_scene_3dCreateScene3dCreateScene3dCreateScene3d

See also

set_scene_3d_instance_paramset_scene_3d_instance_paramSetScene3dInstanceParamSetScene3dInstanceParamSetScene3dInstanceParam

Module

3D Metrology

ClassesClasses | | Operators
HALCON Operator Reference 17.12 Copyright © 1996-2017 MVTec Software GmbH