Skip to content

User Support banner image

VISTA Man Page

This page contains the contents of the VISTA's help file. The information can also be viewed from the command line by using the following command from the progran directory:

vista -h
To use the commands, enter:

vista [options] <volumefile>

General Options

[-h ] - print this help file
[-n <num threads>] - set number of threads (Default: 1).
[--help] print this help file (same as -h.
[--outmode status|normal|verbose] - set output detail.
[--pagetest] walk through the volume without rendering.
[--fastmode] quick render, output may be of low quality.
[--cachesize int] - set cache size in megabytes, must be less than installed physical memory (Default is half the memory).
[--pagesize int] - set page size in Kilobytes(Default: OS page size).
[--bbox] display bounding box.
[--grid] display grid.
[--isoval] select an iso-surface.
[--isocolor r g b a] set an iso-surface color[1.0 1.0 1.0 1.0].

Camera Options


[--camdist float] - set camera distance from center of unit volume (Default is 2.5 for all cameras except persp, for which it is 3.0)
[--persp] - render an off-axis view - default.
[--front] - render a front view.
[--back] - render a back view.
[--left] - render a left view.
[--right] - render a right view.
[--top] - render a top view.
[--bottom] - render a bottom view.
[--spinx] - spin the volume 360° around X axis.
[--spiny] - spin the volume 360° around Y axis.
[--spinz] - spin the volume 360° around Z axis
[--spiral] - generate a 360° spiral
[--camfile camerafile] - set a camera file.
[-b startframe] - set the beginning camera (Default: 1).
[-e endframe] - set the end camera (Default: is last).
[-s step] - number of cameras per step (Default: 1).
[--fov angle] - set the field of view angle in degrees (Default: 45.0°).
[--ar x y] - set aspect ratio (Default: 4:3).

Color Options


[--grey] - map raw volumes to grayscale.
[--hsi1] - map raw volumes to HSI using method 1.
[--hsi2] - map raw volumes to HSI using method 2.
[--rgb] - map raw volumes to Red Green Blue ramp.
[--rbg] - map raw volumes to Red Blue Green ramp.
[--bgr] - map raw volumes to Blue Green Red ramp.
[--brg] - map raw volumes to Blue Red Green ramp.
[--grb] - map raw volumes to Green Red Blue ramp.
[--gbr] - map raw volumes to Green Blue Red ramp.
[--rain] - map raw volumes to VIBGYOR (11 color knots).
[--spect] - map raw volumes to VIBGYOR (26 colo rknots).
[--bigspect] - map raw volumes to VIBGYOR (26 color knots).
[--bigspect2] - map raw volumes to ROYGBIV (26 color knots).
[--logspect] - map raw volumes to stretched VIBGYOR (58 knots).
[--saturated] - map raw volumes to VIBGYOR (20 color knots).
[--vibrant] - map raw volumes to VIBGYOR(256 color knots).
[--nogreen] - map raw volumes to Y to R to M to B to C(256 knots).
[--y2r] - map raw volumes to Yellow to Red(256 color knots).
[--tmapfile transferfunctionfile] - set a transfer function file.
[--inv] - invert color ramps.
[--hdim] - dim intensity as scalar value.
[--edim] - dim intensity as exponential scalar value.
[--pdim] - dim intensity as 2 to the power of scalar value (default).
[--nodim] - no dimming.
[--hdrrange] - use full dynamic range with HDR images.
[--skewbal x ] - Skew the color table balance, x should be >0 and <1 (Default: 0.5).
[--skiprange min max] - skip a range of values in dataset (min<= skip =>max this range will not be rendered).
[--skiprange2 min max] - skip a range of values in dataset (min<= skip =>max this range will not be rendered).
[--skiprange3 min max] - skip a range of values in dataset (min<= skip =>max this range will not be rendered).
[--opacity x] - provide a uniform opacity >0 and <=1, (Default opacity = normalized datavalue).
[--oprangefactor min max val] - used when tmapfile contains opacity knots and needs scaling in a range.
[--oprangeval min max x] - render a range (min max) of data at a custom opacity (x >0 and <=1).
[--emitrange min max] - emit light in this range of values in dataset (min<= emit =>max this range will emit light).(Default emission = normalized datavalue/50) use --emit to specify a different emission value. Use --eopacity to specify a different opacity in this range.
[--eopacity x] - will set constant opacity in the emission range (between 0 and 1) (Default eopacity = normalized datavalue).
[--epower x] - will set emission power for emitrange preferable between 0 and 1 (negative will cause absorption).

Volume Options


[--raw X Y Z] - specify dimension(size) of a RAW volume file.
[--mmap ] - use Memory Map to read the file.
[--lsb ] - use if data is in Least Significant Byte (eg intel platform).
[--msb ] - use if data is in Most Significant Byte (eg ibm platform).
[--swapbytes ] - swap Order of Bytes in file (Note: only tested on floats).
[--abs ] - absolute value of Bytes in file (Note: only tested on floats).
[--logmode ] - transform data to log space before applying transfer function.
[--skip n ] - skip n bytes from begining of file (n >0).
[--minmax min max] - specify min and max values for RAW volumes files (Default: 0.0 1.0).
[--histfile filename] - specify histogram file for color remapping.
[--aminmax min max] - specify alpha min and max values for RAW volumes.
[--rawtype int|float|short|byte|ushort] - set format type for raw files (Default: float).
[--rawvars num] - number of variables in raw file.
[-r extentX extentY extentZ]
[-a AlphaBetaDepth] - set alpha beta depth. (Default: 0.01).
[-c centerX centerY centerZ] - set center of volume (Default: origin).

Image Output options


[-g] - set background color with alpha (Default: Black (0.0 0.0 0.0 0.0)).
[-x width] - set image width (Default: 320).
[-y height] - set image height (Default: 240).
[--outbase basename] - set base name for output images(Default: _img).
[--outformat ppm|png|pngrgb|pngrgba|hdr] - set the output format (Default: ppm).
[--out16bit ] - set the output depth to 16 bit.
[--outzbuf ] - save the Z buffer in a .zbuf file.

<volumefile> is one of
filename.mpr - an MPR file
filename.vol - a VOL file of type VOLC, VOLB, or VOLS

Examples


  1. Example for raw file:

    ./vista --raw 100 100 100 --minmax 0 99 ../../examples/cube.raw
    • Reads "cube.raw" from "../../examples" directory
    • and creates "img_00001.ppm" in current directory
  2. ./vista cube_red.volb
    • Reads "cube_red.volb" from current directory
    • and creates "img_00001.ppm" in current directory
  3. ./vista -outbase ../output/Render_ ../input/cube_red.volb
    • Reads "cube_red.volb" from directory named "input"
    • option -outbase creates output file.
    • Filename starting with "Render_" in "output" directory

No SRB support in this executable

HDR supported disabled


Did You Get
What You
Wanted?
Yes No
Comments