display
No arguments
Description:
Display selected images in an interactive window.
(equivalent to shortcut command d).
When invoked with a
+ prefix (i.e.
+display), the command outputs its log messages on
stdout rather than on
stderr.
Display window #0 is used as the default window for the display, if already opened.
Available controls are shown below (where
LMB = Left mouse button,
RMB = Right mouse button,
MMB = Middle mouse button and
MW = Mouse wheel).
Thumbnail navigation bar:
TAB: Show/hide thumbnails -
LMB: Select thumbnail or shift thumbnail bar -
0-
9,
ARROWS (opt.
+SHIFT),
B,
BACKSPACE,
C,
E,
END,
H,
HOME,
SPACE: Navigate and select thumbnails (add
CTRL if mouse pointer is outside thumbnail bar).
Image view:
LMB or
MMB: Image pan -
RMB or
MW: Image zoom -
ARROWS (opt.
+SHIFT),
HOME,
END: Shift view -
A: Switch alpha rendering -
C: Center view -
E: Go to lower-right corner -
ENTER: Reset view -
G: Toggle grid -
H: Go to upper-left corner -
K: Switch background -
M: Toggle 3D view -
N: Switch normalization -
P: Print info about current image pixel on
stdout -
PAGEUP or
PAGEDOWN: Raise/lower base channel -
R: Rotate image -
T: Plot as a 1D curve -
V: Crop image -
Z: Switch zoom factor -
0-
9: Set zoom factor.
3D mesh view:
LMB: Mesh rotation -
CTRL+LMB or
MMB: Mesh pan -
RMB: Mesh zoom -
A: Toggle axes -
D: Switch face side mode -
F: Change focale -
J: Start/stop animation -
K: Switch background -
O: Switch outline mode -
P: Print 3D pose matrix on
stdout -
R: Switch rendering mode -
T: Switch motion rendering mode -
X: Show/hide bounding-box -
U: Switch animation mode -
Z: Toggle z-buffer.
2D images specific:
CTRL+LMB: Rectangular selection.
3D volumetric images specific:
CTRL+MW: Pan along orthogonal axis -
X: Reset area layout.
Window size, decoration and data I/O:
CTRL+C: Decrease window size -
CTRL+D: Increase window size -
CTRL+F: Toggle fullscreen -
CTRL+I: Toggle info label -
CTRL+O: Save copy of image as a
.gmz file -
CTRL+L: Save copy of image list as
.gmz file -
CTRL+S: Save screenshot as a
.png file -
CTRL+W: Start/stop window recording -
CTRL+X: Toggle cursor.
Configuration variables:
The viewer configuration can be tuned by assigning the following variables:
_display_selected is an integer or an image name that tells which image is selected by default.
_display_alpha can be { 0:off | 1:on | 2:over black | 3:over gray | 4:over white } (default value: 0).
_display_background, an integer in range [ 0,9 ] (default value: 3).
_display_cursor can be { 0:off | 1:on (2D only) | 2:on (+3D volumetric images) } (default value: 1).
_display_is_grid can be { 0:off | 1:on } (default value: 1).
_display_is_info can be { 0:off | 1:on } (default value: 1).
_display_normalization can be { -1:auto | 0:off | 1:cut | 2:stretch channelwise | 3:stretch global | 4: stretch (global-once) } (default value: -1).
_display_print_images can be { 0:off | N>0 } (default value: 5). It sets the max number N of images whose information is initially printed on stderr or stdout.
_display_3d_is_rendered can be { 0:off | 1:on } (default value: 1).
_display_3d_rendering_mode can be { 0:dots | 1:wireframe | 2:flat | 3:flat-shaded | 4:gouraud-shaded | 5=phong-shaded } (default value: 4).
_display_3d_outline_mode can be { 0:no-outline | 1:black-outline | 2:gray-outline | 3:red-outline | 4:green-outline | 5:blue-outline | 6:white-outline } (default value: 0).
_display_3d_motion_rendering_mode can be { -1:bounding-box | 0:dots | 1:wireframe | 2:flat | 3:flat-shaded | 4:gouraud-shaded | 5=phong-shaded } (default value: 3).
_display_3d_motion_time_limit is specified in ms. Above this time, motion rendering toggle to bounding-box mode (default value: 300).
_display_3d_side_mode can be { 0:single-sided | 1:double-sided | 2:single-sided (flipped) } (default value: 0).
_display_3d_is_zbuffer can be { 0:off | 1:on } (default value: 1).
_display_3d_focale can be { <0: perspective projection w/o sprite zooming, 0: parallel projection | >0: perspective projection } (default value: 1.5).
_display_3d_is_axes can be { 0:off | 1:on } (default value: 1).
_display_3d_is_bounding_box can be { 0:off | 1:on } (default value: 0).
_display_3d_background is an unsigned integer in range [0,11] (default value: 11).
_display_3d_pose is a sequence of 12 values that defines the current 3D pose matrix (read/write).
_display_3d_animation can be { 0:off | 1:forward | 2:backward } (default value: 0).
_display_3d_animation_mode can be { 0-3:X-axis | 4-7:Y-axis | 8-11:Z-axis | 12-15:XYZ-axes } (default value: 4).