man/man1/ra_t8.1

.\" RCSid "$Id: ra_t8.1,v 1.2 2003/12/09 15:59:06 greg Exp $"
.TH RA_T8 1 5/30/95 RADIANCE
.SH NAME
ra_t8 - convert RADIANCE picture to/from Targa 8-bit image file
.SH SYNOPSIS
.B ra_t8
[
.B \-d
][
.B \-b
][
.B "\-c ncolors"
][
.B "\-g gamma"
][
.B "\-e +/-stops"
][
.B "-n sampfac"
]
.B input
[
.B output
]
.br
.B ra_t8
.B \-r
[
.B "\-g gamma"
][
.B "\-e +/-stops"
]
[
.B input
[
.B output
]
]
.SH DESCRIPTION
.I Ra_t8
converts between RADIANCE and Targa 8-bit color-mapped image files
(type 1 in Targa's documentation).
In the default mode, a RADIANCE picture is converted to a
color-mapped Targa file of the same horizontal and vertical dimensions with
8-bits per pixel.
The
.I \-d
option turns off dithering.
The
.I \-b
option converts the image to black and white.
Only with this option can the input be taken from stdin.
The
.I \-c
option allows fewer than 256 colors.
The
.I \-g
option specifies the exponent used in gamma correction;
the default value is 2.2.
An exponent of 1.0 turns gamma correction off.
The
.I \-e
option specifies an exposure compensation in f-stops (powers of two).
Only integer stops are allowed, for efficiency.
The
.I \-n
option specifies a sampling factor for neural network color
quantization.
This value should be between 1 and 80, where 1 takes the longest and
produces the best results in small areas of the image.
If no value is given, a faster median cut algorithm is used.
The
.I \-r
option invokes a reverse conversion, from an 8-bit Targa file to
a RADIANCE picture.
If the output file is missing, the standard output is used.
.SH AUTHORS
Greg Ward
.br
Anthony Dekker provided the code for neural network color quantization
.SH BUGS
Run-length encoded files can be read but not written with this
program.
.SH "SEE ALSO"
pfilt(1), ra_bmp(1), ra_bn(1), ra_ppm(1), ra_pr(1), ra_pr24(1), ra_t16(1),
ra_tiff(1), ximage(1)
Revision:	1.3
Committed:	Fri Mar 26 22:58:20 2004 UTC (21 years, 7 months ago) by greg
Branch:	MAIN
CVS Tags:	rad5R4, rad5R2, rad5R3, rad5R0, rad5R1, rad4R2, rad3R7P2, rad3R7P1, rad6R0, rad4R1, rad4R0, rad3R6, rad3R6P1, rad3R8, rad3R9, rad4R2P1, rad4R2P2, HEAD
Changes since 1.2:	+2 -2 lines
Log Message:	Added support to ra_bmp for 16-bit images and RLE, plus created man page
#	User	Rev	Content
1	greg	1.3	.\" RCSid "$Id: ra_t8.1,v 1.2 2003/12/09 15:59:06 greg Exp $"
2	greg	1.1	.TH RA_T8 1 5/30/95 RADIANCE
3			.SH NAME
4			ra_t8 - convert RADIANCE picture to/from Targa 8-bit image file
5			.SH SYNOPSIS
6			.B ra_t8
7			[
8			.B \-d
9			][
10			.B \-b
11			][
12			.B "\-c ncolors"
13			][
14			.B "\-g gamma"
15			][
16			.B "\-e +/-stops"
17			][
18			.B "-n sampfac"
19			]
20			.B input
21			[
22			.B output
23			]
24			.br
25			.B ra_t8
26			.B \-r
27			[
28			.B "\-g gamma"
29			][
30			.B "\-e +/-stops"
31			]
32			[
33			.B input
34			[
35			.B output
36			]
37			]
38			.SH DESCRIPTION
39			.I Ra_t8
40			converts between RADIANCE and Targa 8-bit color-mapped image files
41			(type 1 in Targa's documentation).
42			In the default mode, a RADIANCE picture is converted to a
43			color-mapped Targa file of the same horizontal and vertical dimensions with
44			8-bits per pixel.
45			The
46			.I \-d
47			option turns off dithering.
48			The
49			.I \-b
50			option converts the image to black and white.
51			Only with this option can the input be taken from stdin.
52			The
53			.I \-c
54			option allows fewer than 256 colors.
55			The
56			.I \-g
57			option specifies the exponent used in gamma correction;
58			the default value is 2.2.
59			An exponent of 1.0 turns gamma correction off.
60			The
61			.I \-e
62			option specifies an exposure compensation in f-stops (powers of two).
63			Only integer stops are allowed, for efficiency.
64			The
65			.I \-n
66			option specifies a sampling factor for neural network color
67			quantization.
68			This value should be between 1 and 80, where 1 takes the longest and
69			produces the best results in small areas of the image.
70			If no value is given, a faster median cut algorithm is used.
71			The
72			.I \-r
73			option invokes a reverse conversion, from an 8-bit Targa file to
74			a RADIANCE picture.
75			If the output file is missing, the standard output is used.
76			.SH AUTHORS
77			Greg Ward
78			.br
79			Anthony Dekker provided the code for neural network color quantization
80			.SH BUGS
81			Run-length encoded files can be read but not written with this
82			program.
83			.SH "SEE ALSO"
84	greg	1.3	pfilt(1), ra_bmp(1), ra_bn(1), ra_ppm(1), ra_pr(1), ra_pr24(1), ra_t16(1),
85	greg	1.1	ra_tiff(1), ximage(1)