render_object_model_3dRenderObjectModel3dRenderObjectModel3drender_object_model_3dT_render_object_model_3d🔗

Short description🔗

render_object_model_3dRenderObjectModel3dRenderObjectModel3drender_object_model_3dT_render_object_model_3d — Render 3D object models to get an image.

Signature🔗

render_object_model_3d( out image Image, object_model_3d ObjectModel3D, campar CamParam, pose Pose, string GenParamName, string GenParamValue )

Description🔗

render_object_model_3dRenderObjectModel3d renders the 3D object models of ObjectModel3DobjectModel3Dobject_model_3d and returns the result in the image Imageimageimage. To setup the scene to display, set CamParamcamParamcam_param and the individual Poseposepose of the objects. Be aware that Poseposepose can contain either one pose for each object or one pose for all objects.

The view of the output image is identical to that produced by disp_object_model_3dDispObjectModel3d. The parameters and additional details are documented with disp_object_model_3dDispObjectModel3d, except that the parameters 'object_index_persistence'"object_index_persistence", and 'disp_background'"disp_background" can not be set.

render_object_model_3dRenderObjectModel3d requires OpenGL 2.1, GLSL 1.2, and the OpenGL extensions GL_EXT_framebuffer_object and GL_EXT_framebuffer_blit. Otherwise the compatibility mode is automatically enabled. The compatibility mode requires OpenGL 1.1.

Attention🔗

Cameras with hypercentric lenses are not supported.

Execution information🔗

Execution information

Multithreading type: mutually exclusive (runs in parallel with other non-exclusive operators, but not with itself).
Multithreading scope: global (may be called from any thread).
Processed without parallelization.

Parameters🔗

Imageimageimage (output_object) multichannel-image → object (byte)HObject (byte)HImage (byte)HObject (byte)Hobject * (byte)

Rendered scene.

ObjectModel3DobjectModel3Dobject_model_3d (input_control) object_model_3d(-array) → (handle)HTuple (HHandle)HObjectModel3D, HTuple (IntPtr)MaybeSequence[HHandle]Htuple (handle)

Handles of the 3D object models.

CamParamcamParamcam_param (input_control) campar → (real / integer / string)HTuple (double / Hlong / HString)Sequence[Union[int, float, str]]Htuple (double / Hlong / char*)

Camera parameters of the scene.

Poseposepose (input_control) pose(-array) → (real / integer)HTuple (double / Hlong)HPose, HTuple (double / int / long)Sequence[Union[int, float]]Htuple (double / Hlong)

3D poses of the objects.

GenParamNamegenParamNamegen_param_name (input_control) string-array → (string)HTuple (HString)HTuple (string)Sequence[str]Htuple (char*)

Names of the generic parameters.

Default: [][]
List of values: 'alpha', 'attribute', 'blue_channel_attrib', 'color', 'color_attrib', 'color_attrib_end', 'color_attrib_start', 'colored', 'compatibility_mode_enable', 'disp_lines', 'disp_normals', 'disp_pose', 'green_channel_attrib', 'light_position', 'line_color', 'lut', 'normal_color', 'point_size', 'quality', 'red_channel_attrib', 'rgb_channel_attrib_end', 'rgb_channel_attrib_start'

GenParamValuegenParamValuegen_param_value (input_control) string-array → (string / integer / real)HTuple (HString / Hlong / double)HTuple (string / int / long / double)Sequence[Union[str, int, float]]Htuple (char* / Hlong / double)

Values of the generic parameters.

Default: [][]
List of values: 'auto', 'blue', 'coord_x', 'coord_y', 'coord_z', 'faces', 'false', 'green', 'lines', 'normal_x', 'normal_y', 'normal_z', 'points', 'primitive', 'red', 'true'

Result🔗

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

Combinations with other operators🔗

Combinations

Possible predecessors

find_surface_modelFindSurfaceModel, fit_primitives_object_model_3dFitPrimitivesObjectModel3d, segment_object_model_3dSegmentObjectModel3d, read_object_model_3dReadObjectModel3d, xyz_to_object_model_3dXyzToObjectModel3d

Possible successors

disp_objDispObj

Module🔗

3D Metrology