This website is no longer updated, our new website is at vis.sdsc.edu. To request content please us send a note here.

VISTA Man Page

% ./vista -h

usage: vista [options] <volumefile>

General Options:
[-h ] - print this usage message
[-n <num threads>] - set number of threads.(Default: 1)
[--help] print this usage message
[--outmode status|normal|verbose - set output detail
[--pagetest don't render anything just walk thru the volume
[--fastmode quick and dirty render.
[--cachesize int] - set cache size in Megabytes must be less than installed physical memory(Default:memory/2)
[--pagesize int] - set page size in Kilobytes(Default:OS page size)
[--bbox display bounding box
[--grid display grid
[--isoval isoval select an iso-surface
[--isocolor r g b a set iso-surface color[1.0 1.0 1.0 1.0]

Camera Options:
[--camdist float] - is camera distance from center of unit volume Default=2.5 for std cameras except persp(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] - generate 360 spin around X axis
[--spiny] - generate 360 spin around Y axis
[--spinz] - generate 360 spin around Z axis
[--spiral] - generate 360 spiral
[--camfile camerafile] - provide a camera file
[-b startframe] - set first camera to use.(Default: 1)
[-e endframe] - set camera to end on.(Default: is last)
[-s step] - number of cameras to step by.(Default: 1)
[--fov angle] - set 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 1.
[--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] - provide 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 intensity 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 in 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 - only tested on floats
[--abs ] - Absolute value of Bytes in file - only tested on floats
[--logmode ] - Transform data to log space before applying transfer func
[--skip n ] n is no of bytes to skip 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 (ie 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(img_ default)
[--outformat ppm|png|pngrgb|pngrgba|hdr] - set the output format (ppm default)
[--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

EXAMPLE:
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 <yourOutputPath>/Render_ <yourVolumeFilePath>
ie ./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!

HDRI supported disabled