Debian Codegraph @

upstream/debian-unstable/man1/ppmtospu.1

raw
1 \
2 .\" This man page was generated by the Netpbm tool 'makeman' from HTML source.
3 .\" Do not hand-hack it! If you have bug fixes or improvements, please find
4 .\" the corresponding HTML page on the Netpbm website, generate a patch
5 .\" against that, and send it to the Netpbm maintainer.
6 .TH "Ppmtospu User Manual" 1 "08 March 2012" "netpbm documentation"
7
8 .SH NAME
9 ppmtospu - convert a PPM image to an Atari Spectrum 512 image
10
11 .UN synopsis
12 .SH SYNOPSIS
13
14 \fBppmtospu\fP
15
16 [\fB-d0\fP|\fB-d2\fP|\fB-d4\fP]
17 [\fIppmfile\fP]
18 .PP
19 All options can be abbreviated to their shortest unique prefix.
20 You may use two hyphens instead of one. You may separate an option
21 name and its value with white space instead of an equals sign.
22
23 .UN description
24 .SH DESCRIPTION
25 .PP
26 This program is part of
27 .BR "Netpbm" (1)\c
28 \&.
29 .PP
30 This program converts from the PPM format to the uncompressed Spectrum 512
31 image format used on Atari ST computers.
32 .PP
33 Input comes from the file you name with the \fIppmfile\fP argument, or
34 Standard Input by default. Output goes to Standard Output.
35 .PP
36 The input must be 320 pixels wide by 200 pixels high. If you have an
37 image of a different size, you can use \fBpamcut\fP or \fBpamscale\fP
38 to force it to these dimensions.
39
40
41 .UN options
42 .SH OPTIONS
43 .PP
44 In addition to the options common to all programs based on libnetpbm
45 (most notably \fB-quiet\fP, see
46 .UR index.html#commonoptions
47 Common Options
48 .UE
49 \&), \fBppmtospu\fP recognizes the following
50 command line options:
51
52
53 .TP
54 \fB-d0\fP
55 The program does no dithering.
56
57 .TP
58 \fB-d2\fP
59 The program uses a 2x2 ordered dither.
60 .sp
61 This is the default.
62
63 .TP
64 \fB-d4\fP
65 The program uses a 4x4 ordered dither.
66
67
68
69
70 .UN seealso
71 .SH SEE ALSO
72 .BR "sputoppm" (1)\c
73 \&,
74 .BR "spctoppm" (1)\c
75 \&,
76 .BR "pamscale" (1)\c
77 \&,
78 .BR "pamcut" (1)\c
79 \&,
80 .BR "ppm" (1)\c
81 \&
82
83
84 .UN author
85 .SH AUTHOR
86
87 Copyright (C) 1990 by Steve Belczyk
88
89
90 .UN history
91 .SH HISTORY
92 .PP
93 This program was new in Netpbm 10.58 (March 2012).
94 .PP
95 But it was written in 1990. Steve Belczyk posted it along
96 with \fBsputoppm\fP, \fBspctoppm\fP, \fBpi1toppm\fP, and
97 \fBpi1toppm\fP - all programs for dealing with Atari image formats -
98 to comp.sources.misc on July 15, 1990. For reasons that have been lost
99 to history, all of these entered the Netpbm (then Pbmplus) distribution
100 \fIexcept\fP \fBppmtospu\fP.
101 .PP
102 Georges Kesseler wondered In March 2012 why there was no counterpart to
103 \fBsputoppm\fP in Netpbm and searched the web, finding only one reference
104 to \fBppmtopsu\fP: the 1990 comp.sources.misc posting, including the source
105 code. He emailed the Netpbm maintainer suggesting it be added.
106 .PP
107 Bryan Henderson found the source code to be extremely primitive, not even
108 using common library code. So Bryan completely recoded it, but retained
109 nearly all of the original logic.
110 .SH DOCUMENT SOURCE
111 This manual page was generated by the Netpbm tool 'makeman' from HTML
112 source. The master documentation is at
113 .IP
114 .B http://netpbm.sourceforge.net/doc/ppmtospu.html
115 .PP