\
.\" This man page was generated by the Netpbm tool 'makeman' from HTML source.
.\" Do not hand-hack it!  If you have bug fixes or improvements, please find
.\" the corresponding HTML page on the Netpbm website, generate a patch
.\" against that, and send it to the Netpbm maintainer.
.TH "Ppmtospu User Manual" 1 "08 March 2012" "netpbm documentation"

.SH NAME
ppmtospu - convert a PPM image to an Atari Spectrum 512 image

.UN synopsis
.SH SYNOPSIS

\fBppmtospu\fP

[\fB-d0\fP|\fB-d2\fP|\fB-d4\fP]
[\fIppmfile\fP]
.PP
All options can be abbreviated to their shortest unique prefix.
You may use two hyphens instead of one.  You may separate an option
name and its value with white space instead of an equals sign.

.UN description
.SH DESCRIPTION
.PP
This program is part of
.BR "Netpbm" (1)\c
\&. 
.PP
This program converts from the PPM format to the uncompressed Spectrum 512
image format used on Atari ST computers.
.PP
Input comes from the file you name with the \fIppmfile\fP argument, or
Standard Input by default.  Output goes to Standard Output.
.PP
The input must be 320 pixels wide by 200 pixels high.  If you have an
image of a different size, you can use \fBpamcut\fP or \fBpamscale\fP
to force it to these dimensions.


.UN options
.SH OPTIONS
.PP
In addition to the options common to all programs based on libnetpbm
(most notably \fB-quiet\fP, see 
.UR index.html#commonoptions
 Common Options
.UE
\&), \fBppmtospu\fP recognizes the following
command line options:


.TP
\fB-d0\fP
The program does no dithering.

.TP
\fB-d2\fP
The program uses a 2x2 ordered dither.
.sp
This is the default.

.TP
\fB-d4\fP
The program uses a 4x4 ordered dither.
    



.UN seealso
.SH SEE ALSO
.BR "sputoppm" (1)\c
\&,
.BR "spctoppm" (1)\c
\&,
.BR "pamscale" (1)\c
\&,
.BR "pamcut" (1)\c
\&,
.BR "ppm" (1)\c
\&


.UN author
.SH AUTHOR

Copyright (C) 1990 by Steve Belczyk


.UN history
.SH HISTORY
.PP
This program was new in Netpbm 10.58 (March 2012).
.PP
But it was written in 1990.  Steve Belczyk posted it along
with \fBsputoppm\fP, \fBspctoppm\fP, \fBpi1toppm\fP, and
\fBpi1toppm\fP - all programs for dealing with Atari image formats -
to comp.sources.misc on July 15, 1990.  For reasons that have been lost
to history, all of these entered the Netpbm (then Pbmplus) distribution
\fIexcept\fP \fBppmtospu\fP.
.PP
Georges Kesseler wondered In March 2012 why there was no counterpart to
\fBsputoppm\fP in Netpbm and searched the web, finding only one reference
to \fBppmtopsu\fP: the 1990 comp.sources.misc posting, including the source
code.  He emailed the Netpbm maintainer suggesting it be added.
.PP
Bryan Henderson found the source code to be extremely primitive, not even
using common library code.  So Bryan completely recoded it, but retained
nearly all of the original logic.
.SH DOCUMENT SOURCE
This manual page was generated by the Netpbm tool 'makeman' from HTML
source.  The master documentation is at
.IP
.B http://netpbm.sourceforge.net/doc/ppmtospu.html
.PP