get_disp_object_model_3d_infoT_get_disp_object_model_3d_infoGetDispObjectModel3dInfoGetDispObjectModel3dInfoget_disp_object_model_3d_info (算子名称)
名称
get_disp_object_model_3d_infoT_get_disp_object_model_3d_infoGetDispObjectModel3dInfoGetDispObjectModel3dInfoget_disp_object_model_3d_info — Get the depth or the index of a displayed 3D object model.
参数签名
void GetDispObjectModel3dInfo(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 void HOperatorSet.GetDispObjectModel3dInfo(HTuple windowHandle, HTuple row, HTuple column, HTuple information, out HTuple value)
static HTuple HObjectModel3D.GetDispObjectModel3dInfo(HWindow windowHandle, HTuple row, HTuple column, HTuple information)
static int HObjectModel3D.GetDispObjectModel3dInfo(HWindow windowHandle, double row, double column, string information)
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]
描述
get_disp_object_model_3d_infoget_disp_object_model_3d_infoGetDispObjectModel3dInfoGetDispObjectModel3dInfoGetDispObjectModel3dInfoget_disp_object_model_3d_info returns information on the
3D object models that have been displayed with disp_object_model_3ddisp_object_model_3dDispObjectModel3dDispObjectModel3dDispObjectModel3ddisp_object_model_3d
in the window WindowHandleWindowHandleWindowHandleWindowHandlewindowHandlewindow_handle. The requested information at the
positions (RowRowRowRowrowrow, ColumnColumnColumnColumncolumncolumn) is returned in ValueValueValueValuevaluevalue.
The following values can be queried via InformationInformationInformationInformationinformationinformation:
- 'object_index'"object_index""object_index""object_index""object_index""object_index"
-
The indices of the 3D object models that have been displayed at the
positions (RowRowRowRowrowrow, ColumnColumnColumnColumncolumncolumn).
If no 3D object model was displayed at this position, -1 is returned.
In order to retrieve this information, disp_object_model_3ddisp_object_model_3dDispObjectModel3dDispObjectModel3dDispObjectModel3ddisp_object_model_3d must
have been called with the generic parameter
'object_index_persistence'"object_index_persistence""object_index_persistence""object_index_persistence""object_index_persistence""object_index_persistence" set to 'true'"true""true""true""true""true".
- 'depth'"depth""depth""depth""depth""depth"
-
The depth (i.e. the Z coordinate in the camera coordinate system) at the
positions (RowRowRowRowrowrow, ColumnColumnColumnColumncolumncolumn). 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_3ddisp_object_model_3dDispObjectModel3dDispObjectModel3dDispObjectModel3ddisp_object_model_3d must
have been called with the generic parameter
'depth_persistence'"depth_persistence""depth_persistence""depth_persistence""depth_persistence""depth_persistence" set to 'true'"true""true""true""true""true".
The window coordinates RowRowRowRowrowrow, ColumnColumnColumnColumncolumncolumn 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_pixget_mposition_sub_pixGetMpositionSubPixGetMpositionSubPixGetMpositionSubPixget_mposition_sub_pix or get_mbutton_sub_pixget_mbutton_sub_pixGetMbuttonSubPixGetMbuttonSubPixGetMbuttonSubPixget_mbutton_sub_pix to obtain
these coordinates directly.
In case the window coordinates correspond to values outside the current
image part, 该算子 behavior is undefined.
运行信息
- 多线程类型:可重入(与非独占操作符并行运行)。
- 多线程作用域:全局(可以从任何线程调用)。
- Automatically parallelized on internal data level.
参数表
WindowHandleWindowHandleWindowHandleWindowHandlewindowHandlewindow_handle (input_control) window → HWindow, HTupleHHandleHTupleHtuple (handle) (IntPtr) (HHandle) (handle)
Window handle.
RowRowRowRowrowrow (input_control) integer(-array) → HTupleMaybeSequence[Union[float, int]]HTupleHtuple (real / integer) (double / int / long) (double / Hlong) (double / Hlong)
Row coordinates.
ColumnColumnColumnColumncolumncolumn (input_control) integer(-array) → HTupleMaybeSequence[Union[float, int]]HTupleHtuple (real / integer) (double / int / long) (double / Hlong) (double / Hlong)
Column coordinates.
InformationInformationInformationInformationinformationinformation (input_control) string(-array) → HTupleMaybeSequence[str]HTupleHtuple (string) (string) (HString) (char*)
Information.
Default:
'depth'
"depth"
"depth"
"depth"
"depth"
"depth"
List of values:
'depth'"depth""depth""depth""depth""depth", 'object_index'"object_index""object_index""object_index""object_index""object_index"
ValueValueValueValuevaluevalue (output_control) integer(-array) → HTupleSequence[Union[int, float]]HTupleHtuple (integer / real) (int / long / double) (Hlong / double) (Hlong / double)
Indices or the depth of the objects at (Row,Column).
结果
get_disp_object_model_3d_infoget_disp_object_model_3d_infoGetDispObjectModel3dInfoGetDispObjectModel3dInfoGetDispObjectModel3dInfoget_disp_object_model_3d_info returns 2 (
H_MSG_TRUE)
if all parameters are
correct.
可能的前置算子
disp_object_model_3ddisp_object_model_3dDispObjectModel3dDispObjectModel3dDispObjectModel3ddisp_object_model_3d,
get_mbuttonget_mbuttonGetMbuttonGetMbuttonGetMbuttonget_mbutton,
get_mbutton_sub_pixget_mbutton_sub_pixGetMbuttonSubPixGetMbuttonSubPixGetMbuttonSubPixget_mbutton_sub_pix,
get_mpositionget_mpositionGetMpositionGetMpositionGetMpositionget_mposition,
get_mposition_sub_pixget_mposition_sub_pixGetMpositionSubPixGetMpositionSubPixGetMpositionSubPixget_mposition_sub_pix
参考其它
disp_object_model_3ddisp_object_model_3dDispObjectModel3dDispObjectModel3dDispObjectModel3ddisp_object_model_3d
模块
3D Metrology