ogles logo
Ogles Usage
Johann Adam Schall von Bell

Command Line Options

Home
Screenshots
History
Installation
Usage
  Script file basics
  Command line
  Data views
  Graphical controls
  Keyboard controlls
  Script file details
Download




Accompanied by:
The Simple
Dicom
Reader






mailto:koeppen@neuranse.com







SourceForge.net Logo
(mostly inherited from Ogle)


Command line options include those for GLUT and those specific to Ogles.
GLUT options must preceed Ogles-specific options.

ogles [GLUT_options] [Ogles_options] [script_file]

-bg_color r g b

Set background color. The r g b floating point parameters specify the red, green and blue components of the background color, with each component in the range 0 to 1. If a background with a color gradient is desired, each of the four corners of the render window can be assigned its own color. Moving clockwise from lower left, the command line options are
-bg_color r0 g0 b0,
-bg_color1 r1 g1 b1,
-bg_color2 r2 g2 b2,
-bg_color3 r3 g3 b3.

If only the top and bottom are to be specified, it is sufficient to specify only -bg_color and -bg_color1. If only the left and right are to be specified, it is sufficient to specify only-bg_color and -bg_color2.
Also see the entry for the script command "bgColor"


-center_zero

Shift the data so that the zero value corresponds to the unsigned byte value 128. This is potentially useful for signed data sets where -min !=max, but probably redundant with the way Ogles uses colormaps. This operation significant slows reading large data volumes.


-gamma g

Set gamma correction exponent to g. A value of 1.0 effectively turns off gamma correction. Values of 1.8 or 2.2 are typical for many displays.


-help

Display some information about using Ogles.


-log_file path

Write text error messages to log files named ``<path>/ogle.out'' and ``<path>/ogle.err'' instead of sending them to the terminal.
In "beta" versions, if the -log_file option is not given, Ogles writes log files in the current directory, and sets the level of verbosity to at least 2.


-raw_datafile filename

Read raw float data from filename. The filename should have the form P-XxYxZ-N-TSEI.F where P is a prefix string with no minus characters, X, Y and Z are integer volume dimensions, N is the integer number of variables in the data file, T indicates the data type (``c'' for 1-byte integer, ``s'' for 2-byte integer, ``i'' for 4-byte integer, ``l'' for 8-byte integer, ``f'' for 4-byte float, ``d'' for 8-byte float), S indicates whether integer data is signed (``s'' for signed, ``u'' for unsigned), Eindicates the data order (``l'' for little endian, ``b'' for big endian, ``o'' for other), I indicates the multiple variable interleaving (``i'' for interleaved, ``c'' for contiguous, ``n'' for neither), and F is a suffix string with no minus characters.
example: 'ogles -raw_datafile ..\data\tu-128x128x88-1-islc.raw'.
If a script file is also provided then the datafile is ignored.


-rub_datafile filename

Read raw unsigned byte data from filename. If this option is provided, then the -sizes option must also be provided. If a command file is also provided then the datafile is ignored. Raw unsigned byte data may also have a string which describes the minimum and maximum floating point values of the data. The format of the string is "DATA_RANGE: 0 min max" where .I min and .I max are text floating point values. This string must be after all of the raw unsigned byte data.
example: 'ogles rub_datafile tu-256x256x93x84.rub -sizes 256 256 93'


-sizes nx ny nz

Set volume dimensions. If a script file is provided then Ogles ignores the -sizes command line argument.


-stride s

Set stride for all 3 directions to s. If the script file specifies a stride then that takes priority over this command line argument.


-stereo

Enable stereoscopic rendering. The stereoscopic flag within the application might or might not work if the -stereo command line option was not provided. Providing the -stereo command line option still allows for that feature to be disabled with the application controls. The -stereo option is functional in the Volume Render Window only. It is not yet implemented in the Slicer Windows.


-verbose
Increase verbosity. This reports, among other things, timing information. If the -verbose option multiple times will increase the amount of information reported.


-isometric_voxel_size

Set voxel (3d pixel) size in mm. This option is only operative, when provided after -rub_datafile or -raw_datafile name is specified. The -iso metric_voxel_size option is superfluous when an Analyze header is spezified in a script file.
example: 'ogles -raw_datafile ..\data\tu-128x128x88-1-islc.raw -isometric-voxel-size 0.42'


top




Sept. 03, 2008, Johannes A. Koeppen, koeppen@neuranse.com