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 - 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).

A Full-Featured Open-Source Framework for Image Processing

Latest stable version: 3.3.5 Current pre-release: 3.3.6 (2024/04/22)

display

No arguments

Description: