man/man1/ra_bmp.1

.TH RA_BMP 1 3/25/04 RADIANCE
.SH NAME
ra_bmp - convert RADIANCE picture to/from Windows BMP image
.SH SYNOPSIS
.B ra_bmp
[
.B \-b
][
.B "\-g gamma"
][
.B "\-e spec"
][
.B "-p xr yr xg yg xb yb xw yw"
]
[
[
.B input|-
[
.B output
]
]
.br
.B ra_bmp
.B \-r
[
.B "\-g gamma"
][
.B "\-e +/-stops"
]
[
[
.B input|-
[
.B output
]
]
.SH DESCRIPTION
.I Ra_bmp
converts between RADIANCE and a Windows BMP image.
During forward conversion, the
.I \-b
option produces 8-bit grayscale output rather than 24-bit RGB.
The
.I \-g
option specifies the exponent used in monitor gamma correction;
the default value is 2.2.
The
.I \-e
option specifies a tone-mapping method or exposure compensation.
If the argument is one of the special words "auto", "human", or "linear",
the image will be tone-mapped with histogram adjustment,
human vision simulation, or an averaged linear exposure,
respectively.
(These words may be abbreviated by one or more letters.)\0
Otherwise, the exposure specification is interpreted as a
linear compensation value in integer f-stops, which must
be proceeded by a '+' or '-'.
The CRT color output primaries may be specified with the
.I \-p
option.
.PP
The
.I \-r
option invokes a reverse conversion, from a Windows BMP image
to a RADIANCE picture.
Tone-mapping and monitor primaries are not
supported for reverse conversion.
.PP
.I Ra_bmp
can accept 16-bit or color-mapped BMP files on input,
but cannot not produce them on output.
.PP
A hyphen ('-') may be specified to indicate standard input for
either forward or reverse conversion so that an output file may be
specified.
If the BMP input is taken from the standard input or sent to the
standard output without tone-mapping, then the scanlines may
be reversed from their usual ordering.
Reversed scanlines sometimes causes difficulties for programs attempting
to interpret the resulting RADIANCE picture or BMP image, which
may be rejected or displayed inverted.
.SH AUTHOR
Greg Ward
.SH "SEE ALSO"
pfilt(1), ra_ppm(1), ra_pr(1), ra_pr24(1), ra_t8(1), ra_t16(1),
ra_tiff(1), ximage(1)
Revision:	1.4
Committed:	Mon Oct 4 17:44:21 2004 UTC (19 years, 7 months ago) by greg
Branch:	MAIN
CVS Tags:	rad5R4, rad5R2, rad4R2P2, rad5R0, rad5R1, rad3R7P2, rad3R7P1, rad4R2, rad4R1, rad4R0, rad3R6, rad3R6P1, rad3R8, rad3R9, rad4R2P1, rad5R3, HEAD
Changes since 1.3:	+0 -2 lines
Log Message:	Altered ra_bmp so it doesn't reverse scanline order on grayscale output
#	User	Rev	Content
1	greg	1.1	.TH RA_BMP 1 3/25/04 RADIANCE
2			.SH NAME
3			ra_bmp - convert RADIANCE picture to/from Windows BMP image
4			.SH SYNOPSIS
5			.B ra_bmp
6			[
7			.B \-b
8			][
9			.B "\-g gamma"
10			][
11	greg	1.2	.B "\-e spec"
12			][
13			.B "-p xr yr xg yg xb yb xw yw"
14	greg	1.1	]
15			[
16			[
17			.B input\|-
18			[
19			.B output
20			]
21			]
22			.br
23			.B ra_bmp
24			.B \-r
25			[
26			.B "\-g gamma"
27			][
28			.B "\-e +/-stops"
29			]
30			[
31			[
32			.B input\|-
33			[
34			.B output
35			]
36			]
37			.SH DESCRIPTION
38			.I Ra_bmp
39			converts between RADIANCE and a Windows BMP image.
40	greg	1.2	During forward conversion, the
41	greg	1.1	.I \-b
42			option produces 8-bit grayscale output rather than 24-bit RGB.
43			The
44			.I \-g
45	greg	1.2	option specifies the exponent used in monitor gamma correction;
46	greg	1.1	the default value is 2.2.
47			The
48			.I \-e
49	greg	1.2	option specifies a tone-mapping method or exposure compensation.
50			If the argument is one of the special words "auto", "human", or "linear",
51			the image will be tone-mapped with histogram adjustment,
52			human vision simulation, or an averaged linear exposure,
53			respectively.
54			(These words may be abbreviated by one or more letters.)\0
55			Otherwise, the exposure specification is interpreted as a
56			linear compensation value in integer f-stops, which must
57			be proceeded by a '+' or '-'.
58	greg	1.3	The CRT color output primaries may be specified with the
59	greg	1.2	.I \-p
60			option.
61			.PP
62	greg	1.1	The
63			.I \-r
64			option invokes a reverse conversion, from a Windows BMP image
65			to a RADIANCE picture.
66	greg	1.2	Tone-mapping and monitor primaries are not
67			supported for reverse conversion.
68			.PP
69	greg	1.1	.I Ra_bmp
70			can accept 16-bit or color-mapped BMP files on input,
71			but cannot not produce them on output.
72			.PP
73			A hyphen ('-') may be specified to indicate standard input for
74			either forward or reverse conversion so that an output file may be
75			specified.
76			If the BMP input is taken from the standard input or sent to the
77	greg	1.3	standard output without tone-mapping, then the scanlines may
78			be reversed from their usual ordering.
79			Reversed scanlines sometimes causes difficulties for programs attempting
80	greg	1.1	to interpret the resulting RADIANCE picture or BMP image, which
81			may be rejected or displayed inverted.
82			.SH AUTHOR
83			Greg Ward
84			.SH "SEE ALSO"
85			pfilt(1), ra_ppm(1), ra_pr(1), ra_pr24(1), ra_t8(1), ra_t16(1),
86			ra_tiff(1), ximage(1)