rgb2ycbcr.1 revision 15908
c10c16dec587a0662068f6e2991c29ed3a9db943Richard Lowe<!DOCTYPE REFENTRY PUBLIC "-//Sun Microsystems//DTD DocBook V3.0-Based SolBook Subset V2.0//EN" [
c10c16dec587a0662068f6e2991c29ed3a9db943Richard Lowe<!--ArborText, Inc., 1988-1999, v.4002-->
c10c16dec587a0662068f6e2991c29ed3a9db943Richard Lowe<!--ARC : LSARC 2003/085 libtiff, libjpeg, and libpng-->
c10c16dec587a0662068f6e2991c29ed3a9db943Richard Lowe<!ENTITY suncopy "Copyright (c) 2004, Sun Microsystems, Inc. All Rights Reserved.">
c10c16dec587a0662068f6e2991c29ed3a9db943Richard Lowe<!-- %Z%%M% %I% %E% SMI; -->
c10c16dec587a0662068f6e2991c29ed3a9db943Richard Lowe<refmeta><refentrytitle>rgb2ycbcr</refentrytitle><manvolnum>1</manvolnum>
c10c16dec587a0662068f6e2991c29ed3a9db943Richard Lowe<refmiscinfo class="date">26 Mar 2004</refmiscinfo>
c10c16dec587a0662068f6e2991c29ed3a9db943Richard Lowe<refmiscinfo class="sectdesc">&man1;</refmiscinfo>
c10c16dec587a0662068f6e2991c29ed3a9db943Richard Lowe<refmiscinfo class="software">&release;</refmiscinfo>
c10c16dec587a0662068f6e2991c29ed3a9db943Richard Lowe<refmiscinfo class="copyright">&suncopy;</refmiscinfo>
c10c16dec587a0662068f6e2991c29ed3a9db943Richard Lowe<indexterm><primary>rgb2ycbcr</primary></indexterm><indexterm><primary>convert
c10c16dec587a0662068f6e2991c29ed3a9db943Richard Lowenon-YCbCr TIFF images to YCbCr TIFF images</primary></indexterm>
c10c16dec587a0662068f6e2991c29ed3a9db943Richard Lowe<refnamediv id="rgb2ycbcr-1-name"><refname>rgb2ycbcr</refname><refpurpose>
c10c16dec587a0662068f6e2991c29ed3a9db943Richard Loweconvert non-YCbCr TIFF images to YCbCr TIFF images</refpurpose></refnamediv>
c10c16dec587a0662068f6e2991c29ed3a9db943Richard Lowe<refsynopsisdiv id="rgb2ycbcr-1-synp"><title>&synp-tt;</title>
c10c16dec587a0662068f6e2991c29ed3a9db943Richard Lowe<cmdsynopsis><command>&cmd;</command><arg choice="opt"><option role="nodash"><replaceable>
c10c16dec587a0662068f6e2991c29ed3a9db943Richard Loweoptions</replaceable></option></arg><arg choice="plain"><option role="nodash"><replaceable>
c10c16dec587a0662068f6e2991c29ed3a9db943Richard Lowesrc1.tif</replaceable></option></arg><arg choice="opt" rep="repeat"><option
c10c16dec587a0662068f6e2991c29ed3a9db943Richard Lowerole="nodash"><replaceable>src2.tif</replaceable></option></arg><arg choice="plain"><option
c10c16dec587a0662068f6e2991c29ed3a9db943Richard Lowerole="nodash"><replaceable>dest.tif</replaceable></option></arg>
c10c16dec587a0662068f6e2991c29ed3a9db943Richard Lowe<refsect1 id="rgb2ycbcr-1-desc"><title>&desc-tt;</title>
c10c16dec587a0662068f6e2991c29ed3a9db943Richard Lowe<para><command>&cmd;</command> converts RGB color, grayscale, or bi-level
c10c16dec587a0662068f6e2991c29ed3a9db943Richard LoweTIFF images to YCbCr images by transforming and sampling pixel data. If multiple
c10c16dec587a0662068f6e2991c29ed3a9db943Richard Lowefiles are specified on the command line, each source file is converted to
c10c16dec587a0662068f6e2991c29ed3a9db943Richard Lowea separate directory in the destination file.</para>
c10c16dec587a0662068f6e2991c29ed3a9db943Richard Lowe<para>By default, chrominance samples are created by sampling 2 by 2 blocks
c10c16dec587a0662068f6e2991c29ed3a9db943Richard Loweof luminance values, and output data files are compressed with the LZW compression
c10c16dec587a0662068f6e2991c29ed3a9db943Richard Lowescheme, with each strip no more than 8 kilobytes. These characteristics can
c10c16dec587a0662068f6e2991c29ed3a9db943Richard Lowebe overridden or explicitly specified with the options described below.</para>
c10c16dec587a0662068f6e2991c29ed3a9db943Richard Lowe<refsect1 id="rgb2ycbcr-1-opts"><title>&opts-tt;</title>
c10c16dec587a0662068f6e2991c29ed3a9db943Richard Lowe<para>The following options are supported:</para>
c10c16dec587a0662068f6e2991c29ed3a9db943Richard Lowe<varlistentry><term><option>c</option></term><listitem><para>Specify a compression
c10c16dec587a0662068f6e2991c29ed3a9db943Richard Lowescheme to use when writing image data:</para>
c10c16dec587a0662068f6e2991c29ed3a9db943Richard Lowe<variablelist>
c10c16dec587a0662068f6e2991c29ed3a9db943Richard Lowe<varlistentry><term><option>c jpeg</option></term><listitem><para>Baseline
c10c16dec587a0662068f6e2991c29ed3a9db943Richard LoweJPEG compression algorithm.</para>
c10c16dec587a0662068f6e2991c29ed3a9db943Richard Lowe<varlistentry><term><option>c lzw</option></term><listitem><para>Lempel-Ziv
c10c16dec587a0662068f6e2991c29ed3a9db943Richard Loweand Welch algorithm. This is the default algorithm.</para>
c10c16dec587a0662068f6e2991c29ed3a9db943Richard Lowe<varlistentry><term><option>c none</option></term><listitem><para>No compression.
c10c16dec587a0662068f6e2991c29ed3a9db943Richard Lowe<varlistentry><term><option>c packbits</option></term><listitem><para>PackBits
c10c16dec587a0662068f6e2991c29ed3a9db943Richard Lowecompression algorithm.</para>
c10c16dec587a0662068f6e2991c29ed3a9db943Richard Lowe<varlistentry><term><option>h</option></term><listitem><para>Set the horizontal
c10c16dec587a0662068f6e2991c29ed3a9db943Richard Lowesampling dimension to one of the following: 1, 2, or 4. The default value
c10c16dec587a0662068f6e2991c29ed3a9db943Richard Lowe<varlistentry><term><option>r</option></term><listitem><para>Write data with
c10c16dec587a0662068f6e2991c29ed3a9db943Richard Lowea specified number of rows per strip. By default, the number of rows per strip
c10c16dec587a0662068f6e2991c29ed3a9db943Richard Loweis selected so that each strip is approximately 8 kilobytes.</para>
c10c16dec587a0662068f6e2991c29ed3a9db943Richard Lowe<varlistentry><term><option>v</option></term><listitem><para>Set the vertical
c10c16dec587a0662068f6e2991c29ed3a9db943Richard Lowesampling dimension to one of the following: 1, 2, or 4. The default value
c10c16dec587a0662068f6e2991c29ed3a9db943Richard Lowe<refsect1 id="rgb2ycbcr-1-oper"><title>&oper-tt;</title>
c10c16dec587a0662068f6e2991c29ed3a9db943Richard Lowe<para>The following operands are supported:</para>
c10c16dec587a0662068f6e2991c29ed3a9db943Richard Lowe<varlistentry><term><option role="nodash"><replaceable>src.tif</replaceable></option></term>
c10c16dec587a0662068f6e2991c29ed3a9db943Richard Lowe<listitem><para>The name of the input file that contains non-YCbCr TIFF data.
c10c16dec587a0662068f6e2991c29ed3a9db943Richard Lowe<varlistentry><term><option role="nodash"><replaceable>dest.tif</replaceable></option></term>
c10c16dec587a0662068f6e2991c29ed3a9db943Richard Lowe<listitem><para>The name of the output file that contains YCbCr TIFF data.
c10c16dec587a0662068f6e2991c29ed3a9db943Richard Lowe<refsect1 id="rgb2ycbcr-1-attr"><title>&attr-tt;</title>
c10c16dec587a0662068f6e2991c29ed3a9db943Richard Lowe<para>See <olink targetdocent="REFMAN5" localinfo="attributes-5"><citerefentry>
c10c16dec587a0662068f6e2991c29ed3a9db943Richard Lowe<refentrytitle>attributes</refentrytitle><manvolnum>5</manvolnum></citerefentry></olink>
c10c16dec587a0662068f6e2991c29ed3a9db943Richard Lowefor descriptions of the following attributes:</para>
c10c16dec587a0662068f6e2991c29ed3a9db943Richard Lowe<tgroup cols="2" colsep="1" rowsep="1"><colspec colname="COLSPEC0" colwidth="1*">
c10c16dec587a0662068f6e2991c29ed3a9db943Richard Lowe<row><entry align="center" valign="middle">ATTRIBUTE TYPE</entry><entry align="center"
c10c16dec587a0662068f6e2991c29ed3a9db943Richard Lowe<row><entry><para>Availability</para></entry><entry><para>SUNWTiff</para></entry>
c10c16dec587a0662068f6e2991c29ed3a9db943Richard Lowe<row><entry colname="COLSPEC0"><para>Interface stability</para></entry><entry
c10c16dec587a0662068f6e2991c29ed3a9db943Richard Lowecolname="COLSPEC1"><para>Uncommitted</para></entry></row>
c10c16dec587a0662068f6e2991c29ed3a9db943Richard Lowe</informaltable>
c10c16dec587a0662068f6e2991c29ed3a9db943Richard Lowe<refsect1 id="rgb2ycbcr-1-also"><title>&also-tt;</title>
c10c16dec587a0662068f6e2991c29ed3a9db943Richard Lowe<!--Reference to another man page-->
c10c16dec587a0662068f6e2991c29ed3a9db943Richard Lowe<!--Reference to a Help manual-->
c10c16dec587a0662068f6e2991c29ed3a9db943Richard Lowe<!--Reference to a book.-->
c10c16dec587a0662068f6e2991c29ed3a9db943Richard Lowe<para><citerefentry><refentrytitle>tiffinfo</refentrytitle><manvolnum>1</manvolnum>
c10c16dec587a0662068f6e2991c29ed3a9db943Richard Lowe</citerefentry>, <citerefentry><refentrytitle>tiffcp</refentrytitle><manvolnum>
c10c16dec587a0662068f6e2991c29ed3a9db943Richard Lowe1</manvolnum></citerefentry>, <citerefentry><refentrytitle>libtiff</refentrytitle>
c10c16dec587a0662068f6e2991c29ed3a9db943Richard Lowe<refsect1 id="rgb2ycbcr-1-note"><title>¬e-tt;</title>
c10c16dec587a0662068f6e2991c29ed3a9db943Richard Lowe<para>Updated by Breda McColgan, Sun Microsystems Inc., 2004.</para>