1Pamtopfm User Manual(0) Pamtopfm User Manual(0)
2
3
4
6 pamtopfm - Convert Netpbm image to PFM (Portable Float Map)
7
8
10 pamtopfm [-endian={big|little}] [-scale=float] [imagefile]
11
12 All options can be abbreviated to their shortest unique prefix. You
13 may use two hyphens instead of one. You may separate an option name
14 and its value with white space instead of an equals sign.
15
16
18 This program is part of Netpbm(1).
19
20 pamtopfm reads a Netpbm image (PNM or PAM) and converts it to a PFM
21 (Portable Float Map) image.
22
23 The PFM (Portable Float Map) image format is a lot like PPM, but uses
24 floating point numbers with no maxval to achieve a High Dynamic Range
25 (HDR) format. That means it doesn't have a concept of absolute color
26 and it can represent generic light intensity information rather than
27 just visual information like PPM does. For example, two pixels that
28 are so close in intensity that the human eye cannot tell them apart are
29 not visually distinct, so a visual image format such as PPM would have
30 no reason to use different sample values for them. But an HDR format
31 would.
32
33 There are details of the PFM format in the PFM Format Description" (1).
34
35 USC's HDRShop program ⟨https://vgl.ict.usc.edu/HDRShop/⟩ and a program
36 called Lefty use it.
37
38 pamtopfm creates a color PFM image if its input is RGB (PPM) and a non-
39 color PFM otherwise.
40
41 Use pfmtopam(1) to convert a PFM image to Netpbm format.
42
43
44
46 In addition to the options common to all programs based on libnetpbm
47 (most notably -quiet, see
48 Common Options ⟨index.html#commonoptions⟩ ), pamtopfm recognizes the
49 following command line options:
50
51
52
53 -scale=float
54
55 This specifies the scale factor of the PFM image.
56 Scale factor is a component of the PFM format.
57 Default is 1.0.
58
59
60 -endian={big|little}
61
62 This specifies the endianness of the PFM image. The samples
63 in the raster of a PFM image are 4 byte IEEE floating point
64 numbers. A parameter of the IEEE format, and therefore the
65 PFM
66 format, is endianness, i.e. whether the specified bytes are
67 ordered from low addresses to high addresses or vice versa.
68
69 big means big endian -- the natural ordering;
70 little means little-endian, the Intel-friendly ordering.
71
72 Default is whichever endianness the machine on which pamtopfm
73 runs uses internally, which results in the faster execu‐
74 tion.
75
76
77
78
80 Netpbm(1), pfmtopam(1), pam(1)
81
82
84 pamtopfm was added to Netpbm in Release 10.22 (April 2004).
85
87 This manual page was generated by the Netpbm tool 'makeman' from HTML
88 source. The master documentation is at
89
90 http://netpbm.sourceforge.net/doc/pamtopfm.html
91
92netpbm documentation 10 April 2004 Pamtopfm User Manual(0)