Skip to content

get_disp_object_model_3d_infoget_disp_object_model_3d_infoGetDispObjectModel3dInfoGetDispObjectModel3dInfoget_disp_object_model_3d_infoT_get_disp_object_model_3d_info🔗

Short description🔗

get_disp_object_model_3d_infoget_disp_object_model_3d_infoGetDispObjectModel3dInfoGetDispObjectModel3dInfoget_disp_object_model_3d_infoT_get_disp_object_model_3d_info — Get the depth or the index of a displayed 3D object model.

Signature🔗

get_disp_object_model_3d_info( window WindowHandle, integer Row, integer Column, string Information, out integer Value )get_disp_object_model_3d_info( : : WindowHandle, Row, Column, Information : Value )void GetDispObjectModel3dInfo( const HTuple& WindowHandle, const HTuple& Row, const HTuple& Column, const HTuple& Information, HTuple* Value )static void HOperatorSet.GetDispObjectModel3dInfo( HTuple windowHandle, HTuple row, HTuple column, HTuple information, out HTuple value )def get_disp_object_model_3d_info( window_handle: HHandle, row: MaybeSequence[Union[float, int]], column: MaybeSequence[Union[float, int]], information: MaybeSequence[str] ) -> Sequence[Union[int, float]]

def get_disp_object_model_3d_info_s( window_handle: HHandle, row: MaybeSequence[Union[float, int]], column: MaybeSequence[Union[float, int]], information: MaybeSequence[str] ) -> Union[int, float]Herror T_get_disp_object_model_3d_info( const Htuple WindowHandle, const Htuple Row, const Htuple Column, const Htuple Information, Htuple* Value )

static HTuple HObjectModel3D::GetDispObjectModel3dInfo( const HWindow& WindowHandle, const HTuple& Row, const HTuple& Column, const HTuple& Information )

static Hlong HObjectModel3D::GetDispObjectModel3dInfo( const HWindow& WindowHandle, double Row, double Column, const HString& Information )

static Hlong HObjectModel3D::GetDispObjectModel3dInfo( const HWindow& WindowHandle, double Row, double Column, const char* Information )

static Hlong HObjectModel3D::GetDispObjectModel3dInfo( const HWindow& WindowHandle, double Row, double Column, const wchar_t* Information ) (Windows only)

static HTuple HObjectModel3D.GetDispObjectModel3dInfo( HWindow windowHandle, HTuple row, HTuple column, HTuple information )

static int HObjectModel3D.GetDispObjectModel3dInfo( HWindow windowHandle, double row, double column, string information )

Description🔗

get_disp_object_model_3d_infoGetDispObjectModel3dInfo returns information on the 3D object models that have been displayed with disp_object_model_3dDispObjectModel3d in the window WindowHandlewindowHandlewindow_handle. The requested information at the positions (Rowrowrow, Columncolumncolumn) is returned in Valuevaluevalue.

The following values can be queried via Informationinformationinformation:

  • 'object_index'"object_index" The indices of the 3D object models that have been displayed at the positions (Rowrowrow, Columncolumncolumn). If no 3D object model was displayed at this position, \(-1\) is returned. In order to retrieve this information, disp_object_model_3dDispObjectModel3d must have been called with the generic parameter 'object_index_persistence'"object_index_persistence" set to 'true'"true".

  • 'depth'"depth" The depth (i.e. the Z coordinate in the camera coordinate system) at the positions (Rowrowrow, Columncolumncolumn). If no 3D object model was displayed at one of these positions, \(-1.0\) is returned for this position. In order to retrieve this information, disp_object_model_3dDispObjectModel3d must have been called with the generic parameter 'depth_persistence'"depth_persistence" set to 'true'"true".

The window coordinates Rowrowrow, Columncolumncolumn must be provided in respect to the current image part. Thereby they are understood in edge centered subpixel accurate coordinates, see Transformations / 2D Transformations. Given the current image part (row1,column1,row2,column2, in the HALCON standard coordinate system), the upper left corner corresponds to the coordinates (row1 - 0.5, column1 - 0.5). Accordingly, the bottom right corner corresponds to the coordinates (row2 - 0.5, column2 - 0.5). Use get_mposition_sub_pixGetMpositionSubPix or get_mbutton_sub_pixGetMbuttonSubPix to obtain these coordinates directly. In case the window coordinates correspond to values outside the current image part, the operator behavior is undefined.

Execution information🔗

Execution information
  • Multithreading type: reentrant (runs in parallel with non-exclusive operators).

  • Multithreading scope: global (may be called from any thread).

  • Automatically parallelized on internal data level.

Parameters🔗

WindowHandlewindowHandlewindow_handle (input_control) window → (handle)(handle)HTuple (HHandle)HWindow, HTuple (IntPtr)HHandleHtuple (handle)

Window handle.

Rowrowrow (input_control) integer(-array) → (real / integer)(real / integer)HTuple (double / Hlong)HTuple (double / int / long)MaybeSequence[Union[float, int]]Htuple (double / Hlong)

Row coordinates.

Columncolumncolumn (input_control) integer(-array) → (real / integer)(real / integer)HTuple (double / Hlong)HTuple (double / int / long)MaybeSequence[Union[float, int]]Htuple (double / Hlong)

Column coordinates.

Informationinformationinformation (input_control) string(-array) → (string)(string)HTuple (HString)HTuple (string)MaybeSequence[str]Htuple (char*)

Information.

Default: 'depth'"depth"
List of values: 'depth', 'object_index'"depth", "object_index"

Valuevaluevalue (output_control) integer(-array) → (integer / real)(integer / real)HTuple (Hlong / double)HTuple (int / long / double)Sequence[Union[int, float]]Htuple (Hlong / double)

Indices or the depth of the objects at (Row,Column).

Result🔗

get_disp_object_model_3d_infoGetDispObjectModel3dInfo returns 2 (H_MSG_TRUE) if all parameters are correct.

Combinations with other operators🔗

Combinations

Possible predecessors

disp_object_model_3dDispObjectModel3d, get_mbuttonGetMbutton, get_mbutton_sub_pixGetMbuttonSubPix, get_mpositionGetMposition, get_mposition_sub_pixGetMpositionSubPix

See also

disp_object_model_3dDispObjectModel3d

Module🔗

3D Metrology