debian/pfsglview.1

   1 .TH "pfsglview" 1
   2 .SH NAME
   3 pfsglview \- Viewer for high-dynamic range images in pfs format
   4 .SH SYNOPSIS
   5 .B pfsglview
   6 [--h] [--v]
   7 .SH DESCRIPTION
   8 pfsview is a OpenGL/GLUT application for viewing high-dynamic range images. It
   9 expects pfs stream on the standard input and displays the frames in
  10 that stream one by one.
  11
  12 .SH DYNAMIC RANGE WINDOW
  13 To show high-dynamic range data on a low-dynamic range monitor,
  14 pfsglview uses concept of a dynamic range window. The dynamic range
  15 window is the highest and lowest value that should be mapped to black
  16 and white pixel. Values above or below the window are clipped (see
  17 clipping methods below). The dynamic range window is displayed in
  18 pfsglview as a blue area on the dynamic range scale (second toolbox from
  19 the top). The window can be moved, shrunk and expended using a mouse
  20 or a keyboard.
  21
  22 .SH ZOOMING AND PANNING
  23 To zoom image, the mouse can be dragged in vertical direction with the left button pressed.
  24 Pressing [space] button or pressing left mouse button above the statistic window (left-bottom corner) changes from
  25 zooming to panning modes and vice versa. To pan image, the mouse can be dragged in vertical
  26 and horizontal directions with the left button pressed.
  27
  28 .SH POPUP MENU OPTIONS
  29 .TP
  30 .B Zoom reset
  31 Set default zoom parameters.
  32 .TP
  33 .B Zoom in
  34 Increase image (mouse dragging with left button pressed).
  35 .TP
  36 .B Zoom out
  37 Decrease image (mouse dragging with left button pressed).
  38 .TP
  39 .B Increase exposure
  40 Move dynamic range window into higher luminance values.
  41 .TP
  42 .B Decrease exposure
  43 Move dynamic range window into lover luminance values.
  44 .TP
  45 .B Extend dynamic range
  46 Extend dynamic range window.
  47 .TP
  48 .B Shrink dynamic range
  49 Shrink dynamic range window
  50 .TP
  51 .B Low dynamic range
  52 Set dynamic range window to <-1,1> range (log scale).
  53 .TP
  54 .B Fit to dynamic range
  55 Set dynamic range windo to minimum and maximum luminance of a given image.
  56 .TP
  57 .B Choose channel
  58 Change image data channel.
  59 .TP
  60 .B Mapping method
  61 Change mapping method (see below for details).
  62 .TP
  63 .B Next frame
  64 Display next image from the pipe.
  65 .TP
  66 .B Previous frame
  67 Display previous image from the pipe.
  68 .TP
  69 .B Histogram
  70 Switch on/off histogram window.
  71 .TP
  72 .B Info
  73 Switch on/off info window.
  74 .TP
  75 .B Save&Quit
  76 Send the visible LDR image (8-bits) to stdout and quit pfsglview.
  77
  78
  79 .SH MAPPING METHODS
  80
  81 High-dynamic range data are usually better visualized using non-linear
  82 scale, for example a logarithmic or a power function. pfsglview offers
  83 several such scales, shown in \fIpopup\fR menu. Gray-scale values for
  84 each mapping method are computed by the formulas:
  85
  86 \fBLINEAR\fR: y = (x-min)/(max-min)
  87
  88 \fBGAMMA\fR: y = [ (x-min)/(max-min) ]^gamma
  89
  90 \fBLOGARITHMIC\fR: y = (log10(x)-log10(min))/(log10(max)-log10(min))
  91
  92 where \fIy\fR is the gray-scale value after mapping, \fIx\fR
  93 is an input HDR value, \fImin\fR and \fImax\fR are lower and upper bounds
  94 of the dynamic range window.
  95
  96 .SH EXAMPLES
  97 .TP
  98 pfsin memorial.hdr | pfsglview
  99 See the memorial image.
 100 .TP
 101 pfsin memorial.hdr | pfsglview | pfsout memorial.jpg
 102 See the memorial image and save the clipped (8-bits) version to memorial.jpg (\fISave&Quit\fR option from popup menu should be activated).
 103
 104 .SH "SEE ALSO"
 105 .BR pfsin (1)
 106
 107 Please report bugs and comments to Radoslaw Mantiuk <radoslaw.mantiuk@gmail.com>.