> mrViewer [-options] [<images...>]where -options are optional mrViewer command-line options and images are optionally a list of images or sequences you want to display. For a list of valid options, use:
> mrViewer -hOn certain platforms, like Windows, mrViewer can also associate itself to several image and video files it knows about. In that case, opening a Windows Explorer window and double-clicking on a file that mrViewer recognizes may automatically invoke a new copy of mrViewer.
Directory | refers to the directory where the file resides. |
Filename | refers to the filename(s) the movie, image or sequence refers to. |
Sequence | true if the filename refers to a whole sequence of images, false if it refers to a single image or movie. |
Width | the actual width of the image, sequence or movie. |
Height | the actual height of the image, sequence of movie. |
Aspect Ratio | the actual aspect ratio of the image (ie. resolution width / resolution height ). |
Pixel Ratio | the shape of the pixels in the image. A pixel ratio of 1 refers to square pixels (like those of a printer or monitor). A different value refers to pixels for other media (usually, NTSC or PAL video). |
Depth | the color depth of each channel (8-bit, 16-bit, or 32-bit for float images). |
Image Channels | Number of image channels in the image. |
Rendering Intent | The embedded rendering intent for this image. |
Gamma | the built-in gamma of the image. |
Render
Transform |
Any embedded CTL
(Color Transformation Language) rendering transform. |
ICC Profile | Any embedded ICC (International Color Consortium) profile in the image. |
Format | the format of the image. |
Line Order | The line order of the image (if applicable) |
Memory | The amount of memory the image uses. |
Disk space | The amount of disk space the image uses (only applicable if the image is on the filesystem) |
Compression | Compression type used to save the image. Some formats allow changing the compression type before saving. |
Compression Ratio | The percentage of compression (ie. the difference between the space the image uses on memory and the space it uses on disk) |
Creation Date | the date the image was created or last modified. |
IPTC | IPTC
(International code) attributes if applicable. |
EXIF | EXIF attributes (if applicable) |
Video | when a video file is displayed, it shows codec, number of video streams and frames per second. |
Audio | when an audio file is attached, it shows codec, number of audio streams, number audio channels and audio frequency. |
Variable | Explanation | Default Value |
---|---|---|
CTL_MODULE_PATH | A string of colon (Unix) or semicolon (Windows) separated paths that mrViewer will use to find .ctl scripts. | If unset, mrViewer's ctl directory |
CTL_DISPLAY_TRANSFORM | The CTL script used to transform images from CIExy space for display on your screen | transform_display_video |
CTL_IMAGE_DEFAULT_TRANSFORM | A default CTL script used to transform images from RGB to CIExy space | transform_RRT |
CTL_DISPLAY_CHROMATICITIES | Chromaticities of your display | Rec. ITU-R BT.709 chromaticities |
CTL_DISPLAY_WHITE_LUMINANCE | White Luminance of your display | 120 candelas per square meter |
CTL_DISPLAY_SURROUND_LUMINANCE | Luminance of the surrounding environment | 12 candelas per square meter |
MRV_HOST | Machine where mrViewer's database resides | localhost |
MRV_PORT | TCP/IP Port override to use to connect to database | Uses default for database type |
MRV_USER | User used to login to mrViewer's database | mrviewer |
MRV_PASSWORD | Password used to login to mrViewer's database | mrviewer |
MRV_DATABASE | Name of mrViewer's database | assets2d_production |
SHOW | If set, any image viewed will be stored in the database as belonging to that show. | Undefined |
SEQ | If set, any image viewed will be stored in the database as belonging to that sequence. | Undefined |
SHOT | If set, any image viewed will be stored in the database as belonging to that shot. | Undefined |
ICC_PROFILES | Directory where ICC and ICM profiles reside | %WINDIR%/SYSTEM32/spool/drivers/color on Windows and /usr/share/color/icc on Unix |
HOME | Home directory for user where mrViewer's preferences will be stored | $HOME on Unix and %HOMEDIR% on Windows |
R | Display Red Channel |
G | Display Green Channel |
B | Display Blue Channel |
A | Display Alpha Channel |
O | Display Alpha Overlayed over RGB |
L | Display Luminance (if available) |
Z | Display Z Depth (if available) |
T | Display Tag Channel (if available) |
S | Toggle Safe Area Display |
F1 | Toggle Top Toolbar |
F2 | Toggle Pixel Info Toolbar |
F3 | Toggle Timeline |
Spacebar | Toggle full-screen |
F12 | Toggle
Presentation Mode This mode is mrViewer's full screen, best antialiased mode, suitable for exhibition or projection. |
1-9 | Zoom to # times |
Alt + RMB or ALT + LMB + MMB | Zoom view window arbitrarily |
Alt + MMB | Scroll view window |
Mousewheel | Zoom in/out |
Home | Go to start of sequence |
End | Go to end of sequence |
Ctrl + Home | Go to start of timeline |
Ctrl + End | Go to end of timeline |
PgUp | Go to previous image |
PgDown | Go to next image |
Left Arrow or NumPad 4 | Go back a frame or previous image |
Right Arrow or NumPad 6 | Go to next frame or next image |
Alt + Mousewheel | Scrub playback |
Ctrl + Left Arrow | Go back 1 second |
Ctrl + Right Arrow | Advance 1 second |
Down Arrow or NumPad 2 | Play movie forwards |
Up Arrow or NumPad 8 | Play movie backwards |
Shift + Down Arrow | Play movie 1/2 normal speed |
Shift + Up Arrow | Play movie backwards 1/2 normal speed |
Ctrl + Down Arrow | Play movie x2 normal speed |
Ctrl + Up Arrow | Play movie backwards x2 normal speed |
NumPad 5 | Stop playback. |
Extension |
Name |
Read |
Write |
Comments |
---|---|---|---|---|
.avi | AVI | Yes | No | All Channels, all codecs |
.bmp | Microsoft's Bitmap | Yes | Yes | |
.cin | Cineon | Yes | No | |
.ct | mental ray floating point color images | Yes | No | |
.dds | Microsoft Direct Draw Surface | Yes | No | |
.dpx | DPX | Yes | No | |
.exr | ILM OpenEXR | Yes | Yes | All Channels and Layers displayed |
.gif | GIF | Yes | Yes | |
.iff | Maya IFF | Yes | No | |
.jpeg | JPEG | Yes | Yes | |
.map | mental ray textures | Yes | No | Only non-tiled maps supported |
.mi | mental ray network render file stubs | Yes | No | Floating point connections |
.mov | Quicktime Movies | Yes | No | |
.mpeg | Motion Pictures Group | Yes | No | |
.nt | mental ray floating point normal images | Yes | No | |
.ogg | OGG | Yes | No | |
Adobe Postscript | Yes | No | Single page, converted to a bitmap | |
.pic | Softimage pic | Yes | No | |
.png | PNG | Yes | Yes | |
.psd | Photoshop | Yes | Yes | All Layers displayed, paths and vector graphics lost |
.reel | mrViewer's reel (EDL) files | Yes | Yes | |
.rpf | Autodesk 3DS Rich Picture Format | Yes | No | Some layers supported |
.shmap | mental ray floating point shadow maps | Yes | No | |
.st | mental ray floating point scalar images | Yes | No | |
.tga | Targa | Yes | Yes | |
.tif | TIFF | Yes | Yes | All Layers displayed |
.wmv | Microsoft WMV | Yes | No | WMV9 supported, but slow |
.z | Rendeman Shadow Maps | Yes | No | |
.zt | mental ray floating point z-depth images | Yes | No |
Boost libraries
are distributed under the following License:
Boost Software License - Version 1.0
- August 17th, 2003
Permission is hereby granted, free of charge, to any person or
organization obtaining a copy of the software and accompanying
documentation covered by this license (the "Software") to use,
reproduce, display, distribute, execute, and transmit the Software, and
to prepare derivative works of the Software, and to permit
third-parties to whom the Software is furnished to do so, all subject
to the following:
The copyright notices in the Software and this entire statement,
including the above license grant, this restriction and the following
disclaimer, must be included in all copies of the Software, in whole or
in part, and all derivative works of the Software, unless such copies
or derivative works are solely in the form of machine-executable object
code generated by a source language processor.
THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS
OR IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF
MERCHANTABILITY, FITNESS FOR A PARTICULAR PURPOSE, TITLE AND
NON-INFRINGEMENT. IN NO EVENT SHALL THE COPYRIGHT HOLDERS OR ANYONE
DISTRIBUTING THE SOFTWARE BE LIABLE FOR ANY DAMAGES OR OTHER LIABILITY,
WHETHER IN CONTRACT, TORT OR OTHERWISE, ARISING FROM, OUT OF OR IN
CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
SOFTWARE.
libtiff
is distributed under a BSD license.
zlib is distributed under the Zlib license:
Copyright (C) 1995-2004 Jean-loup Gailly and Mark Adler