miqser (“mixer”) is a tool for processing RIB streams. Its primary purpose is to alter the encoding of a RIB stream, it can convert ASCII encoded RIB to binary and vice versa, as well as applying/removing gzip compression. In addition, it can alter the indentation of an ASCII RIB stream, to make it more readable - a useful tool for tracking down problems with RIB files.
Miqser works by reading in a RIB file using the Aqsis RIB parsing library (rib2 & rib2ri), and then sending the results to the Aqsis RIB client library (ri2rib) for output. The client library is configured to control the output using the [[miqser#options|command line arguments]] of miqser.
The most common use for miqser is to convert a RIB stream to/from binary
encoding. To do so, use the following command line to convert myrib.rib
from ASCII to binary and save it as myrib.bin.rib
:
miqser -binary -o myrib.bin.rib myrib.rib
Alternatively, convert myrib.bin.rib
from binary to ASCII and save it as myrib.rib
by using:
miqser -o myrib.rib myrib.bin.rib
A short help text listing all options can be displayed using the miqser -help option. All options can either begin with a single dash or two dashes and can appear anywhere on the command line.
Usage: miqser [options] [RIB file...]
-h, -help Print this help and exit
-version Print version information and exit
-pause Wait for a keypress on completion
-o, -output=string Set the output filename, default to <stdout>
-nostandard Do not declare standard RenderMan parameters
-outputstandard Print the standard declarations to the resulting RIB
-v, -verbose=integer Set log output level
0 = errors
1 = warnings (default)
2 = information
3 = debug
-i, -indentation=integer
Set output indentation type
0 = none (default)
1 = space
2 = tab
-l, -indentlevel=integer
Set the indetation amount
-compression=integer Set output compression type
0 = none (default)
1 = gzip
-b, -binary Output a binary encoded RIB file
-frames f1 f2 Specify a starting/ending frame to render (inclusive).
-frameslist=string Specify a range of frames to render, ',' separated with '-' to indicate ranges.
-nc, -nocolor Disable colored output
-syslog Log messages to syslog
-archives=string Override the default archive searchpath(s)
-decodeonly Decode a binary rib into text, *without* validating or formatting the result. (Debug use only)
-frameslist=1-5,20-25,30,40
.Option
"searchpath" "archive" [string]
.Level | Verbosity |
---|---|
0 | Only display errors |
1 | Display warnings (default) |
2 | Display informational messages |
3 | Display debug information |
Table 1
Value | Indentation type |
---|---|
0 | Don’t indent |
1 | Indent using spaces |
2 | Indent using tab characters |
Table 2