man-pages/man1/sldtoppm.1.html
2021-03-31 01:06:50 +01:00

294 lines
6.3 KiB
HTML

<!DOCTYPE HTML PUBLIC "-//W3C//DTD HTML 4.01 Transitional//EN">
<HTML><HEAD><TITLE>Man page of sldtoppm</TITLE>
</HEAD><BODY>
<H1>sldtoppm</H1>
Section: User Commands (1)<BR>Updated: 10 October 1991<BR><A HREF="#index">Index</A>
<A HREF="/cgi-bin/man/man2html">Return to Main Contents</A><HR>
<A NAME="ixAAB"></A>
<A NAME="ixAAC"></A>
<A NAME="lbAB">&nbsp;</A>
<H2>NAME</H2>
sldtoppm - convert an AutoCAD slide file into a portable pixmap
<A NAME="lbAC">&nbsp;</A>
<H2>SYNOPSIS</H2>
<B>sldtoppm</B>
[<B>-adjust</B>]
[<B>-dir</B>]
[<B>-height</B>|<B>-ysize</B>
<I>s</I>]
[<B>-info</B>]
[<B>-lib</B>|<B>-Lib</B>
<I>name</I>]
[<B>-scale</B>
<I>s</I>]
[<B>-verbose</B>]
[<B>-width</B>|<B>-xsize</B>
<I>s</I>]
[<I>slidefile</I>]
<A NAME="lbAD">&nbsp;</A>
<H2>DESCRIPTION</H2>
Reads an AutoCAD&#174; slide file and outputs a portable pixmap.
If no
<I>slidefile</I>
is specified, input is read from standard input.
The ppmdraw library is used to convert the vector and polygon
information in the slide file to a pixmap; see the file ppmdraw.h for
details on this package.
<A NAME="lbAE">&nbsp;</A>
<H2>OPTIONS</H2>
<DL COMPACT>
<DT id="1"><B>-adjust</B>
<DD>
If the display on which the slide file was created had non-square
pixels, when the slide is processed with
<B>sldtoppm</B>
and the
<B>-adjust</B>
option is not present, the following warning will appear:
Warning - pixels on source screen were non-square.
<BR>
Specifying
<B>-adjust</B>
will correct image width to compensate.
Specifying the
<B>-adjust</B>
option causes
<B>sldtoppm</B>
to scale the width of the image so that pixels in the resulting
portable pixmap are square (and hence circles appear as true circles,
not ellipses). The scaling is performed in the vector domain, before
scan converting the objects. The results are, therefore, superior in
appearance to what you'd obtain were you to perform the equivalent
scaling with
<B>pnmscale</B>
after the bitmap had been created.
<DT id="2"><B>-dir</B>
<DD>
The input is assumed to be an AutoCAD slide library file. A directory
listing each slide in the library is printed on standard error.
<DT id="3"><B>-height</B><I> size</I>
<DD>
Scales the image in the vector domain so it is
<I>size</I>
pixels in height. If no
<B>-width</B>
or
<B>-xsize</B>
option is specified, the width will be adjusted to preserve the
pixel aspect ratio.
<DT id="4"><B>-info</B>
<DD>
Dump the slide file header on standard error, displaying the original
screen size and aspect ratio among other information.
<DT id="5"><B>-lib</B><I> name</I>
<DD>
Extracts the slide with the given
<I>name</I>
from the slide library given as input. The specified
<I>name</I>
is converted to upper case.
<DT id="6"><B>-Lib</B><I> name</I>
<DD>
Extracts the slide with the given
<I>name</I>
from the slide library given as input. The
<I>name</I>
is used exactly as specified; it is not converted to upper case.
<DT id="7"><B>-scale</B><I> s</I>
<DD>
Scales the image by factor
<I>s</I>,
which may be any floating point value greater than zero. Scaling is
done after aspect ratio adjustment, if any. Since scaling is
performed in the vector domain, before rasterisation, the results look
much better than running the output of
<B>sldtoppm</B>
through
<B>pnmscale</B>.
<DT id="8"><B>-verbose</B>
<DD>
Dumps the slide file header and lists every vector and polygon in the
file on standard error.
<DT id="9"><B>-width</B><I> size</I>
<DD>
Scales the image in the vector domain so it is
<I>size</I>
pixels wide. If no
<B>-height</B>
or
<B>-ysize</B>
option is specified, the height will be adjusted to preserve the
pixel aspect ratio.
<DT id="10"><B>-xsize</B><I> size</I>
<DD>
Scales the image in the vector domain so it is
<I>size</I>
pixels wide. If no
<B>-height</B>
or
<B>-ysize</B>
option is specified, the height will be adjusted to preserve the
pixel aspect ratio.
<DT id="11"><B>-ysize</B><I> size</I>
<DD>
Scales the image in the vector domain so it is
<I>size</I>
pixels in height. If no
<B>-width</B>
or
<B>-xsize</B>
option is specified, the width will be adjusted to preserve the
pixel aspect ratio.
</DL>
<P>
All flags can be abbreviated to their shortest unique prefix.
<A NAME="lbAF">&nbsp;</A>
<H2>BUGS</H2>
Only Level 2 slides are converted. Level 1 format has been obsolete
since the advent of AutoCAD Release 9 in 1987, and was not portable
across machine architectures.
<P>
Slide library items with names containing 8 bit (such as ISO) or 16
bit (Kanji, for example) characters may not be found when chosen with the
<B>-lib</B>
option unless
<B>sldtoppm</B>
has been built with character set conversion functions appropriate to
the locale. You can always retrieve slides from libraries regardless
of the character set by using the
<B>-Lib</B>
option and specifying the precise name of library member. Use the
<B>-dir</B>
option to list the slides in a library if you're unsure of the
exact name.
<A NAME="lbAG">&nbsp;</A>
<H2>SEE ALSO</H2>
AutoCAD Reference Manual:
<I>Slide File Format</I>,
<B><A HREF="/cgi-bin/man/man2html?1+pnmscale">pnmscale</A></B>(1),
<B><A HREF="/cgi-bin/man/man2html?5+ppm">ppm</A></B>(5)
<A NAME="lbAH">&nbsp;</A>
<H2>AUTHOR</H2>
<DL COMPACT><DT id="12"><DD>
<PRE>
John Walker
Autodesk SA
Avenue des Champs-Montants 14b
CH-2074 MARIN
Suisse/Schweiz/Svizzera/Svizra/Switzerland
<DL COMPACT>
<DT id="13">Usenet:<DD><A HREF="mailto:kelvin@Autodesk.com">kelvin@Autodesk.com</A>
<DT id="14">Fax:<DD>038/33 88 15
<DT id="15">Voice:<DD>038/33 76 33
</PRE>
</DL>
</DL>
<P>
Permission to use, copy, modify, and distribute this software and its
documentation for any purpose and without fee is hereby granted,
without any conditions or restrictions. This software is provided ``as
is'' without express or implied warranty.
<P>
AutoCAD and Autodesk are registered trademarks of Autodesk, Inc.
<P>
<HR>
<A NAME="index">&nbsp;</A><H2>Index</H2>
<DL>
<DT id="16"><A HREF="#lbAB">NAME</A><DD>
<DT id="17"><A HREF="#lbAC">SYNOPSIS</A><DD>
<DT id="18"><A HREF="#lbAD">DESCRIPTION</A><DD>
<DT id="19"><A HREF="#lbAE">OPTIONS</A><DD>
<DT id="20"><A HREF="#lbAF">BUGS</A><DD>
<DT id="21"><A HREF="#lbAG">SEE ALSO</A><DD>
<DT id="22"><A HREF="#lbAH">AUTHOR</A><DD>
</DL>
<HR>
This document was created by
<A HREF="/cgi-bin/man/man2html">man2html</A>,
using the manual pages.<BR>
Time: 00:05:27 GMT, March 31, 2021
</BODY>
</HTML>