HALCON Reference Manual 10.0.2
Table of Contents / Graphics / Window ClassesClassesClasses | | | Operators

unproject_coordinatesunproject_coordinatesunproject_coordinatesUnprojectCoordinatesUnprojectCoordinates (Operator)

Name

unproject_coordinatesunproject_coordinatesunproject_coordinatesUnprojectCoordinatesUnprojectCoordinates — Calculates image coordinates for a point in a 3D plot window.

Signature

unproject_coordinates(Image : : WindowHandle, Row, Column : ImageRow, ImageColumn, Height)

Herror unproject_coordinates(const Hobject Image, const Hlong WindowHandle, double Row, double Column, Hlong* ImageRow, Hlong* ImageColumn, Hlong* Height)

Herror T_unproject_coordinates(const Hobject Image, const Htuple WindowHandle, const Htuple Row, const Htuple Column, Htuple* ImageRow, Htuple* ImageColumn, Htuple* Height)

Herror unproject_coordinates(Hobject Image, const HTuple& WindowHandle, const HTuple& Row, const HTuple& Column, Hlong* ImageRow, Hlong* ImageColumn, Hlong* Height)

Hlong HWindow::UnprojectCoordinates(const HImage& Image, const HTuple& Row, const HTuple& Column, HTuple* ImageColumn, HTuple* Height) const

void HOperatorSetX.UnprojectCoordinates(
[in] IHUntypedObjectX* Image, [in] VARIANT WindowHandle, [in] VARIANT Row, [in] VARIANT Column, [out] VARIANT* ImageRow, [out] VARIANT* ImageColumn, [out] VARIANT* Height)

Hlong HImageX.UnprojectCoordinates(
[in] IHWindowX* WindowHandle, [in] VARIANT Row, [in] VARIANT Column, [out] Hlong* ImageColumn, [out] VARIANT* Height)

Hlong HWindowX.UnprojectCoordinates(
[in] IHImageX* Image, [in] VARIANT Row, [in] VARIANT Column, [out] Hlong* ImageColumn, [out] VARIANT* Height)

static void HOperatorSet.UnprojectCoordinates(HObject image, HTuple windowHandle, HTuple row, HTuple column, out HTuple imageRow, out HTuple imageColumn, out HTuple height)

void HImage.UnprojectCoordinates(HWindow windowHandle, HTuple row, HTuple column, out int imageRow, out int imageColumn, out HTuple height)

void HImage.UnprojectCoordinates(HWindow windowHandle, double row, double column, out int imageRow, out int imageColumn, out int height)

void HWindow.UnprojectCoordinates(HImage image, HTuple row, HTuple column, out int imageRow, out int imageColumn, out HTuple height)

void HWindow.UnprojectCoordinates(HImage image, double row, double column, out int imageRow, out int imageColumn, out int height)

Description

If ImageImageImageImageimage is displayed in WindowHandleWindowHandleWindowHandleWindowHandlewindowHandle using a 3D plot (i.e., '3d_plot'"3d_plot""3d_plot""3d_plot""3d_plot" was set using set_paintset_paintset_paintSetPaintSetPaint), unproject_coordinatesunproject_coordinatesunproject_coordinatesUnprojectCoordinatesUnprojectCoordinates calculates the image coordinates ImageRowImageRowImageRowImageRowimageRow, ImageColumnImageColumnImageColumnImageColumnimageColumn, and the HeightHeightHeightHeightheight for a given point RowRowRowRowrow,ColumnColumnColumnColumncolumn in window coordinates. The window coordinates RowRowRowRowrow, ColumnColumnColumnColumncolumn must be provided in respect to the current image part. As a consequence, this coordinates are subpixel coordinates. Given the current image part (row1,column1,row2, column2), the upper left corner corresponds to the coordinates (row1 - 0.5, col1 - 0.5). Accordingly, the bottom right corner corresponds to the coordinates (row2 - 0.5, col2 - 0.5). Use get_mposition_sub_pixget_mposition_sub_pixget_mposition_sub_pixGetMpositionSubPixGetMpositionSubPix or get_mbutton_sub_pixget_mbutton_sub_pixget_mbutton_sub_pixGetMbuttonSubPixGetMbuttonSubPix to obtain these coordinates directly.

One of the window parameters 'save_depth_buffer'"save_depth_buffer""save_depth_buffer""save_depth_buffer""save_depth_buffer" or 'interactive_plot'"interactive_plot""interactive_plot""interactive_plot""interactive_plot" must be set to 'true'"true""true""true""true" using set_window_paramset_window_paramset_window_paramSetWindowParamSetWindowParam. Otherwise, unproject_coordinatesunproject_coordinatesunproject_coordinatesUnprojectCoordinatesUnprojectCoordinates cannot be used.

Parallelization

Parameters

ImageImageImageImageimage (input_object)  image → objectHImageHImageHImageXHobject (byte / direction / cyclic / int1 / int2 / uint2 / int4 / real / complex / vector_field)

Displayed image.

WindowHandleWindowHandleWindowHandleWindowHandlewindowHandle (input_control)  window → HWindow, HTupleHTupleHWindowX, VARIANTHtuple (integer) (IntPtr) (Hlong) (Hlong) (Hlong)

Window identifier.

RowRowRowRowrow (input_control)  integer → HTupleHTupleVARIANTHtuple (real / integer) (double / int / long) (double / Hlong) (double / Hlong) (double / Hlong)

Row coordinate in the window.

ColumnColumnColumnColumncolumn (input_control)  integer → HTupleHTupleVARIANTHtuple (real / integer) (double / int / long) (double / Hlong) (double / Hlong) (double / Hlong)

Column coordinate in the window.

ImageRowImageRowImageRowImageRowimageRow (output_control)  integer → HTupleHTupleVARIANTHtuple (integer) (int / long) (Hlong) (Hlong) (Hlong)

Row coordinate in the image.

ImageColumnImageColumnImageColumnImageColumnimageColumn (output_control)  integer → HTupleHTupleVARIANTHtuple (integer) (int / long) (Hlong) (Hlong) (Hlong)

Column coordinate in the image.

HeightHeightHeightHeightheight (output_control)  real → HTupleHTupleVARIANTHtuple (integer / real) (int / long / double) (Hlong / double) (Hlong / double) (Hlong / double)

Height value.

Possible Predecessors

get_mbutton_sub_pixget_mbutton_sub_pixget_mbutton_sub_pixGetMbuttonSubPixGetMbuttonSubPix, get_mposition_sub_pixget_mposition_sub_pixget_mposition_sub_pixGetMpositionSubPixGetMpositionSubPix, disp_imagedisp_imagedisp_imageDispImageDispImage

See also

disp_objdisp_objdisp_objDispObjDispObj, update_window_poseupdate_window_poseupdate_window_poseUpdateWindowPoseUpdateWindowPose, set_paintset_paintset_paintSetPaintSetPaint

Module

Foundation

Table of Contents / Graphics / Window ClassesClassesClasses | | | Operators
HALCON Reference Manual 10.0.2 Copyright © 1996-2011 MVTec Software GmbH