README
1fv is an HDRI viewer. It utilizes OpenGL and GLUT so that it is highly
2portable. Currently supported formats are the followings:
3
4* Greg Ward's HDR (also known as Radiance/PIC/RGBE). See
5 http://www.graphics.cornell.edu/~bjw/rgbe.html for details.
6* Paul Debevec's PFM (Portable Float Map). See
7 http://netpbm.sourceforge.net/doc/pfm.html for details.
8
9fv reads data from the standard input or files specified as
10arguments. In the latter case, each file may be compressed one with
11gzip, bzip2, or xz. The file may also change after fv is invoked,
12except its header part. fv checks whether the file changes and updates
13the display if necessary. This feature is useful for checking
14intermediate outputs from renderers.
15
16The command line options are:
17
18 fv.exe [OPTION]... [FILE]...
19 -g, --gamma=GAMMA
20 use GAMMA as the gamma value (default 2.200000).
21 -t, --title=TITLE
22 use TITLE as the string displayed in the titlebar (default fv).
23 -h, --help
24 display this help and exit.
25 -v, --version
26 output version information and exit.
27
28The drag-and-drop onto the executable file (or its shortcut) is also
29supported on Windows.
30
31The displayed image can be moved by dragging or arrow keys. Other
32functions can be invoked from the right-click menu or by the following
33keys:
34
35 E/I Zoom In
36 W/O Zoom Out
37 Q/P Reset Zoom
38 F/J Expose With the Current Pixel
39 B Expose Automatically
40 * This is done based on the log-average luminance found in
41 Eric Reinhard's "Photographic Tone Reproduction for
42 Digital Images"
43 (http://www.cs.utah.edu/~reinhard/cdrom/, see also
44 erratum), but only for non-zero pixels. This approach is
45 better than just adding a small delta and works nicely
46 for many images.
47 D/K Expose Up
48 S/L Expose Down
49 A/; Reset Exposure Scale
50 C/M Flip Horizontally
51 V/N Flip Vertically
52 Space Reset Origin
53 Enter Save as PNG
54 * This saves the image in the current directory with a
55 name determined from the current time.
56 Z Toggle Full Screen
57 Esc Quit
58
59# Notes for MacOSX:
60# * The right button is emulated by "ctrl-click" for a single-button
61# mouse. If the mouse has multiple buttons, the GLUT for MacOSX
62# doesn't emulate the right button. You need to enable "the sub
63# button" on the mouse control panel. The default setting assigns
64# extra buttons to Expose, etc., so please be careful.
65# * Running multiple fv instances causes the following log messages:
66# CFMessagePort: bootstrap_register(): failed ...
67# CFMessagePortCreateLocal(): failed to name Mach port ...
68# These are harmless so please ignore.
69