Image Display: imf_disp

The image display and flipbook utility imf_disp is started as

   imf_disp [options] [directory] [file ...]

If the directory is present, imf_disp will enter flipbook mode and display a sequence of files as a movie. If no directory is specified, a static image file is displayed. If a single minus sign is given as file name, the image will be read from standard input. This is useful for connecting mental ray and imf_disp:

   ray -imgpipe 1 scene.mi | imf_disp -

If the file to display is still being rendered, imf_disp will open a connection to the mental ray program rendering it, and display rectangles as they are finished. This also works if mental ray and imf_disp run on different machines. Files that are still being rendered can be recognized by their size, which is always 128 bytes. Only one imf_disp can be connected to a running mental ray at any time.

The following options are supported on Unix systems. Many can also be set from pulldown menus. The standard X11 options such as -display or -geometry are also supported. The Windows NT version can only display static images and supports only the -g (gamma) option.

-delaymultiplier factor

Set timescale multiplier for flipbook playback speed. The default is 1.0.

-depth min max

When displaying depth (Z) images such as shadow maps, assign white to the minimum depth min and black to the maximum depth max, instead of determining the range from the depth map [24]. Infinite depths are always displayed light blue.

-G gamma

Set a gamma value. The default is 1.0, or whatever mental ray is using if imf_disp is connected to one.


Print a brief option summary.

-imgtitle title

Set the window title. Normally the window title displays information about the image file, the operation mode, and the pixel under the mouse.

-m on|off

Display the matte (alpha) channel instead of the color image.

-mask exp

Set the file search mask in the file selector dialog to the expression exp. The default is *. This dialog is used to select files to cycle through in flipbook mode. The mask is useful to restrict the file listing to similar-named files that are part of a sequence, such as image*.rgb. Note that exp should be quoted to prevent the shell from evaluating wildcards.

-pseudocolor on|off

If on, imf_disp uses a pseudocolor visual that relies on color mapping and dithering. If off, true colors are used. The default is off.

-reconnect on|off

If enabled, imf_disp will watch the displayed file. If it is re-rendered, imf_disp will connect to the mental ray executable and show the changes as they are finished. If disabled, the displayed image will stay on the display even if rerendered. The default is on.

-reload on|off

This option is similar to the preceding, but checks whether the image was rewritten by means other than rerendering, and reloads it if so.

-shm on|off

Set X11 shared-memory mode. This allows the X11 display server to directly use the process memory of imf_disp. This reduces memory usage, but since shared memory is an optional X11 extension, some systems may not support it. Shared memory also cannot be used if the display (as defined by the DISPLAY environment variable or the X11 -display option) is not on the machine that imf_disp is running on. The default is on.

-verbose on|off

Enable or disable verbose messages. The default is off.

-vis visual

Set the visual ID for the display. X11 visuals determine display information such as the color mode, the number of bits per pixel, and so on. Use the X11 xdpyinfo command to determine the visuals supported by the X11 server. Note that visual must be a decimal number. The default is the best truecolor visual available.

[24] This option was introduced with mental ray 2.1.36.

Copyright © 1986-2009 by mental images GmbH