update_window_poseUpdateWindowPoseUpdateWindowPoseupdate_window_poseT_update_window_pose🔗

Short description🔗

update_window_poseUpdateWindowPoseUpdateWindowPoseupdate_window_poseT_update_window_pose — Modify the pose of a 3D plot.

Signature🔗

update_window_pose( window WindowHandle, point.y LastRow, point.x LastCol, point.y CurrentRow, point.x CurrentCol, string Mode )

Description🔗

The operator update_window_poseUpdateWindowPose provides an easy way to modify the pose of the height field displayed by disp_objDispObj if the paint mode is set to '3d_plot'"3d_plot" using set_paintSetPaint.

Two window coordinates (LastRowlastRowlast_row,LastCollastCollast_col) and (CurrentRowcurrentRowcurrent_row, CurrentColcurrentColcurrent_col) are transformed into rotation, scaling, or movement depending on Modemodemode. This window coordinates must be provided with 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 coordinate (row1 - 0.5, col1 - 0.5). Accordingly, the bottom right corner corresponds to the coordinate (row2 - 0.5, col2 - 0.5). Use get_mposition_sub_pixGetMpositionSubPix or get_mbutton_sub_pixGetMbuttonSubPix to obtain this coordinates directly.

If Modemodemode is set to 'rotate'"rotate", the height field is rotated using a virtual trackball model. Both points are projected on a sphere centered in the center of the window WindowHandlewindowHandlewindow_handle. The circular arc between this two projections corresponds to the rotation applied to the height field.

If Modemodemode is set to 'scale'"scale", zooming is reduced if CurrentRowcurrentRowcurrent_row is greater than LastRowlastRowlast_row and increased if CurrentRowcurrentRowcurrent_row is smaller than LastRowlastRowlast_row.

If Modemodemode is set to 'move'"move", the input points are projected onto the plane through the center of the height field parallel to the viewing plane. The center of the height field is moved in this plane by the distance between both projections.

If Modemodemode is set to 'move_plane'"move_plane", the input points are projected on the plane given by height zero. The height field is moved in this plane by the distance between both projections.

Execution information🔗

Execution information

Multithreading type: reentrant (runs in parallel with non-exclusive operators).
Multithreading scope: global (may be called from any thread).
Processed without parallelization.

Parameters🔗

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

Window handle.

LastRowlastRowlast_row (input_control) point.y → (real / integer)HTuple (double / Hlong)HTuple (double / int / long)Union[float, int]Htuple (double / Hlong)

Row coordinate of the first point.

LastCollastCollast_col (input_control) point.x → (real / integer)HTuple (double / Hlong)HTuple (double / int / long)Union[float, int]Htuple (double / Hlong)

Column coordinate of the first point.

CurrentRowcurrentRowcurrent_row (input_control) point.y → (real / integer)HTuple (double / Hlong)HTuple (double / int / long)Union[float, int]Htuple (double / Hlong)

Row coordinate of the second point.

CurrentColcurrentColcurrent_col (input_control) point.x → (real / integer)HTuple (double / Hlong)HTuple (double / int / long)Union[float, int]Htuple (double / Hlong)

Column coordinate of the second point.

Modemodemode (input_control) string → (string)HTuple (HString)HTuple (string)strHtuple (char*)

Navigation mode.

Default: 'rotate'"rotate"
List of values: 'move', 'move_plane', 'rotate', 'scale'"move", "move_plane", "rotate", "scale"

Example🔗

(HDevelop)

* Interactive display of a height field
dev_set_paint ('3d_plot')
while (1)
  dev_set_check ('~give_error')
  get_mposition_sub_pix (WindowHandle, Row, Column, Button)
  dev_set_check ('give_error')
  if (ButtonDown and (Button == 0))
    ButtonDown := false
  endif
  if (not(Button == 0))
    if (ButtonDown)
      if (Button == 1)
        mode := 'rotate'
      endif
      if (Button == 4)
        mode := 'scale'
      endif
      if (Button == 5)
        mode := 'move'
      endif
      update_window_pose (WindowHandle, lastRow, lastCol, Row, Column, mode)
    else
      if (Button == 2)
        break
      endif
      ButtonDown := true
    endif
    lastCol := Column
    lastRow := Row
  endif
  dev_display (Image)
endwhile

Combinations with other operators🔗

Combinations

Possible predecessors

set_paintSetPaint, open_windowOpenWindow, get_mposition_sub_pixGetMpositionSubPix, get_mbutton_sub_pixGetMbuttonSubPix

Possible successors

disp_imageDispImage

Module🔗

Foundation