10139N/A<!DOCTYPE REFENTRY PUBLIC "-//Sun Microsystems//DTD DocBook V3.0-Based SolBook Subset V2.0//EN" [

10139N/A<!--ArborText, Inc., 1988-1999, v.4002-->

10139N/A<!ENTITY exam-tt "EXAMPLES">

10139N/A<!ENTITY cmd "tiff2ps">

10139N/A<!ENTITY % commonents SYSTEM "smancommon.ent">

10139N/A%commonents;

10139N/A<!ENTITY % booktitles SYSTEM "booktitles.ent">

10139N/A%booktitles;

10139N/A<!ENTITY suncopy "Copyright (c) 2004, Sun Microsystems, Inc. All Rights Reserved.">

10139N/A]>

10139N/A<?Pub UDT _bookmark _target>

10139N/A<?Pub Inc>

10139N/A<refentry id="tiff2ps-1">

10139N/A<refmeta><refentrytitle>tiff2ps</refentrytitle><manvolnum>1</manvolnum>

10139N/A<refmiscinfo class="date">26 Mar 2004</refmiscinfo>

10139N/A<refmiscinfo class="sectdesc">&man1;</refmiscinfo>

10139N/A<refmiscinfo class="software">&release;</refmiscinfo>

10139N/A<refmiscinfo class="arch">generic</refmiscinfo>

10139N/A<refmiscinfo class="copyright">&suncopy;</refmiscinfo>

10139N/A</refmeta>

10139N/A<indexterm><primary>tiff2ps</primary></indexterm><indexterm><primary>convert

10139N/Aa TIFF image to PostScript</primary></indexterm>

10139N/A<refnamediv id="tiff2ps-1-name"><refname>tiff2ps</refname><refpurpose>convert

10139N/Aa TIFF image to PostScript</refpurpose></refnamediv>

10139N/A<refsynopsisdiv id="tiff2ps-1-synp"><title>&synp-tt;</title>

10139N/A<cmdsynopsis><command>&cmd;</command><arg choice="opt"><option role="nodash"><replaceable>

10139N/Aoptions</replaceable></option></arg><arg choice="plain" rep="repeat"><option

10139N/Arole="nodash"><replaceable>input.tif</replaceable></option></arg>

10139N/A</cmdsynopsis></refsynopsisdiv>

10139N/A<refsect1 id="tiff2ps-1-desc"><title>&desc-tt;</title>

10139N/A<para><command>&cmd;</command> reads TIFF images and writes PostScript or

10139N/AEncapsulated PostScript (EPS) on the standard output. By default, <command>&cmd;</command>

10139N/Awrites Encapsulated PostScript for the first image in the specified TIFF image

10139N/Afile.</para>

10139N/A<para>By default, <command>&cmd;</command> generates PostScript that fills

10139N/Aa printed area specified by the TIFF tags in the input file. If the file does

10139N/Anot contain XResolution or YResolution tags, then the printed area is set

10139N/Aaccording to the image dimensions. You can use the <option>w</option> and <option>

10139N/Ah</option> options to set the dimensions of the printed area in inches, overriding

10139N/Aany relevant TIFF tags.</para>

10139N/A<para>The PostScript generated for RGB, palette, and CMYK images uses the

10139N/Acolorimage operator. The PostScript generated for grayscale and bilevel images

10139N/Auses the image operator. When the colorimage operator is used, PostScript

10139N/Acode to emulate this operator on older PostScript printers is also generated.

10139N/ANote that this emulation code can be very slow.</para>

10139N/A<para>Color images with associated alpha data are composited over a white

10139N/Abackground.</para>

10139N/A</refsect1>

10139N/A<refsect1 id="tiff2ps-1-opts"><title>&opts-tt;</title>

10139N/A<para>The following options are supported:</para>

10139N/A<variablelist termlength="narrow">

10139N/A<varlistentry><term><option>1</option></term><listitem><para>Generate PostScript

10139N/ALevel I. This is the default.</para>

10139N/A</listitem></varlistentry>

10139N/A<varlistentry><term><option>2</option></term><listitem><para>Generate PostScript

10139N/ALevel II.</para>

10139N/A</listitem></varlistentry>

10139N/A<varlistentry><term><option>a</option></term><listitem><para>Generate output

10139N/Afor all IFDs (pages) in the input file.</para>

10139N/A</listitem></varlistentry>

10139N/A<varlistentry><term><option>d</option></term><listitem><para>Set the initial

10139N/ATIFF directory to the specified directory number. Note that directories are

10139N/Anumbered starting at zero. This option is useful for selecting individual

10139N/Apages in a multipage file, for example facsimile.</para>

10139N/A</listitem></varlistentry>

10139N/A<varlistentry><term><option>e</option></term><listitem><para>Force the generation

10139N/Aof Encapsulated PostScript.</para>

10139N/A</listitem></varlistentry>

10139N/A<varlistentry><term><option>h</option></term><listitem><para>Specify the vertical

10139N/Asize of the printed area in inches.</para>

10139N/A</listitem></varlistentry>

10139N/A<varlistentry><term><option>o</option></term><listitem><para>Set the initial

10139N/ATIFF directory to the IFD at the specified file offset. This option is useful

10139N/Afor selecting thumbnail images, which are hidden using the SubIFD tag.</para>

10139N/A</listitem></varlistentry>

10139N/A<varlistentry><term><option>p</option></term><listitem><para>Force the generation

10139N/Aof non-Encapsulated PostScript.</para>

10139N/A</listitem></varlistentry>

10139N/A<varlistentry><term><option>s</option></term><listitem><para>Generate output

10139N/Afor a single IFD (page) in the input file.</para>

10139N/A</listitem></varlistentry>

10139N/A<varlistentry><term><option>w</option></term><listitem><para>Specify the horizontal

10139N/Asize of the printed area in inches.</para>

10139N/A</listitem></varlistentry>

10139N/A<varlistentry><term><option>z</option></term><listitem><para>When generating

10139N/APostScript Level II, data is scaled so that the data does not image into the

10139N/Adeadzone on a page, that is, the outer margin that the printing device is

10139N/Aunable to mark. This option suppresses this behavior. When PostScriptLevel

10139N/AI is generated, data is imaged to the entire printed page and this option

10139N/Ahas no affect.</para>

10139N/A</listitem></varlistentry>

10139N/A</variablelist>

10139N/A<variablelist termlength="narrow"></variablelist></refsect1>

10139N/A<refsect1 id="tiff2ps-1-oper"><title>&oper-tt;</title>

10139N/A<para>The following operands are supported:</para>

10139N/A<variablelist termlength="narrow">

10139N/A<varlistentry><term><option role="nodash"><replaceable>input.tif</replaceable></option></term>

10139N/A<listitem><para>The name of the input TIFF file.</para>

10139N/A</listitem></varlistentry>

10139N/A</variablelist></refsect1>

10139N/A<refsect1 id="tiff2ps-1-exam"><title>&exam-tt;</title>

10139N/A<example role="example">

10139N/A<title>Generating PostScript Level II for All Pages of a Facsimile</title>

10139N/A<para><screen>example% <userinput>&cmd; -a2 fax.tif | lpr</userinput></screen></para>

10139N/A<para>Note that if you have version 2.6.1 or newer of Ghostscript, you can

10139N/Aefficiently preview facsimile generated by the above command.</para>

10139N/A</example>

10139N/A<example role="example">

10139N/A<title>Generating Encapsulated PostScript for the Image at Directory 2 of

10139N/Aan Image</title>

10139N/A<para><screen>example% <userinput>&cmd; -d 1 foo.tif</userinput></screen></para>

10139N/A<para>Note that directories are numbered starting at zero.</para>

10139N/A</example>

10139N/A</refsect1>

10139N/A<refsect1 id="tiff2ps-1-attr"><title>&attr-tt;</title>

10139N/A<para>See <olink targetdocent="REFMAN5" localinfo="attributes-5"><citerefentry>

10139N/A<refentrytitle>attributes</refentrytitle><manvolnum>5</manvolnum></citerefentry></olink>

10139N/Afor descriptions of the following attributes:</para>

10139N/A<informaltable frame="all">

10139N/A<tgroup cols="2" colsep="1" rowsep="1"><colspec colname="COLSPEC0" colwidth="1*">

10139N/A<colspec colname="COLSPEC1" colwidth="1*">

10139N/A<thead>

10139N/A<row><entry align="center" valign="middle">ATTRIBUTE TYPE</entry><entry align="center"

10139N/Avalign="middle">ATTRIBUTE VALUE</entry></row>

10139N/A</thead>

10139N/A<tbody>

18745N/A<row><entry><para>Availability</para></entry><entry><para>image/library/libtiff</para></entry>

10139N/A</row>

10139N/A<row><entry colname="COLSPEC0"><para>Interface stability</para></entry><entry

13623N/Acolname="COLSPEC1"><para>Uncommitted</para></entry></row>

10139N/A</tbody>

10139N/A</tgroup>

10139N/A</informaltable>

10139N/A</refsect1>

10139N/A<refsect1 id="tiff2ps-1-also"><title>&also-tt;</title>

10139N/A<para><citerefentry><refentrytitle>pal2rgb</refentrytitle><manvolnum>1</manvolnum>

10139N/A</citerefentry>, <citerefentry><refentrytitle>tiffinfo</refentrytitle><manvolnum>

10139N/A1</manvolnum></citerefentry>, <citerefentry><refentrytitle>tiffcp</refentrytitle>

10139N/A<manvolnum>1</manvolnum></citerefentry>, <citerefentry><refentrytitle>tiffgt

10139N/A</refentrytitle><manvolnum>1</manvolnum></citerefentry>, <citerefentry><refentrytitle>

10139N/Atiffmedian</refentrytitle><manvolnum>1</manvolnum></citerefentry>, <citerefentry>

10139N/A<refentrytitle>tiff2bw</refentrytitle><manvolnum>1</manvolnum></citerefentry>, <citerefentry>

10139N/A<refentrytitle>tiffsv</refentrytitle><manvolnum>1</manvolnum></citerefentry>, <citerefentry>

10139N/A<refentrytitle>libtiff</refentrytitle><manvolnum>3</manvolnum></citerefentry></para>

10139N/A</refsect1>

10139N/A<refsect1 id="tiff2ps-1-note"><title>&note-tt;</title>

11904N/A<para>PostScript does not support colormaps. Therefore, 8-bit

10139N/Apalette images produce 24-bit PostScript&nbsp; images. This conversion results

10139N/Ain output that is six times bigger than the original image and which takes

10139N/Aa long time to send to a printer over a serial line. Matters are even worse

10139N/Afor 4-, 2-, and 1-bit palette images.</para>

10139N/A<para>Does not support tiled images when generating PostScript Level I output.

10139N/A</para>

10139N/A<para>Updated by Breda McColgan, Sun Microsystems Inc., 2004.</para>

10139N/A</refsect1>

10139N/A</refentry>