libtiff/html/man/TIFFWriteRawStrip.3t.html~
1999-11-23 04:29:23 +00:00

135 lines
3.3 KiB
HTML

<!DOCTYPE HTML PUBLIC "-//W3C//DTD HTML 3.2 Final//EN">
<HTML><HEAD><TITLE>Manpage of TIFFWriteRawstrip</TITLE>
</HEAD><BODY BGCOLOR=WHITE><FONT FACE="helvetica, sans, arial">
<H1>TIFFWriteRawstrip</H1>
Section: Misc. Reference Manual Pages (3T)<BR>Updated: October 15, 1995<BR><A HREF="#index">Index</A>
<BR><A HREF="index.html">Return to Main Contents</A>
<HR>
<A NAME="lbAB">&nbsp;</A>
<H2>NAME</H2>
TIFFWriteRawStrip - write a strip of raw data to an open
<FONT SIZE="-1">TIFF</FONT>
file
<A NAME="lbAC">&nbsp;</A>
<H2>SYNOPSIS</H2>
<B>#include &lt;<A HREF="file:/usr/include/tiffio.h">tiffio.h</A>&gt;</B>
<BR>
<B>tsize_t TIFFWriteRawStrip(TIFF* tif, tstrip_t strip, tdata_t buf, tsize_t size)</B>
<A NAME="lbAD">&nbsp;</A>
<H2>DESCRIPTION</H2>
Append
<I>size</I>
bytes of raw data to the specified strip.
<A NAME="lbAE">&nbsp;</A>
<H2>NOTES</H2>
The strip number must be valid according to the current settings
of the
<I>ImageLength</I>
and
<I>RowsPerStrip</I>
tags.
An image may be dynamically grown by increasing the value of
<I>ImageLength</I>
prior to each call to
<I>TIFFWriteRawStrip</I>.
<A NAME="lbAF">&nbsp;</A>
<H2>RETURN VALUES</H2>
-1 is returned if an error occurred.
Otherwise, the value of
<I>size</I>
is returned.
<A NAME="lbAG">&nbsp;</A>
<H2>DIAGNOSTICS</H2>
All error messages are directed to the
<I><A HREF="http:/cgi-bin/man2html?TIFFError+3t">TIFFError</A></I>(3T)
routine.
<P>
<B>%s: File not open for writing</B>.
The file was opened for reading, not writing.
<P>
<B>Can not write scanlines to a tiled image</B>.
The image is assumed to be organized in tiles because the
<I>TileWidth</I>
and
<I>TileLength</I>
tags have been set with
<I><A HREF="http:/cgi-bin/man2html?TIFFSetField+3t">TIFFSetField</A></I>(3T).
<P>
<B>%s: Must set &quot;ImageWidth&quot; before writing data</B>.
The image's width has not be set before the first write.
See
<I><A HREF="http:/cgi-bin/man2html?TIFFSetField+3t">TIFFSetField</A></I>(3T)
for information on how to do this.
<P>
<B>%s: Must set &quot;PlanarConfiguration&quot; before writing data</B>.
The organization of data has not be defined before the first write.
See
<I><A HREF="http:/cgi-bin/man2html?TIFFSetField+3t">TIFFSetField</A></I>(3T)
for information on how to do this.
<P>
<B>%s: No space for strip arrays&quot;</B>.
There was not enough space for the arrays that hold strip
offsets and byte counts.
<P>
<B>%s: Strip %d out of range, max %d</B>.
The specified strip is not a valid strip according to the
currently specified image dimensions.
<A NAME="lbAH">&nbsp;</A>
<H2>SEE ALSO</H2>
<I><A HREF="http:/cgi-bin/man2html?libtiff+3t">libtiff</A></I>(3T),
<I><A HREF="http:/cgi-bin/man2html?TIFFOpen+3t">TIFFOpen</A></I>(3T),
<I><A HREF="http:/cgi-bin/man2html?TIFFWriteEncodedStrip+3t">TIFFWriteEncodedStrip</A></I>(3T),
<I><A HREF="http:/cgi-bin/man2html?TIFFWriteScanline+3t">TIFFWriteScanline</A></I>(3T)
<HR>
<A NAME="index">&nbsp;</A><H2>Index</H2>
<DL>
<DT><A HREF="#lbAB">NAME</A><DD>
<DT><A HREF="#lbAC">SYNOPSIS</A><DD>
<DT><A HREF="#lbAD">DESCRIPTION</A><DD>
<DT><A HREF="#lbAE">NOTES</A><DD>
<DT><A HREF="#lbAF">RETURN VALUES</A><DD>
<DT><A HREF="#lbAG">DIAGNOSTICS</A><DD>
<DT><A HREF="#lbAH">SEE ALSO</A><DD>
</DL>
<HR>
This document was created by
<A HREF="index.html">man2html</A>,
using the manual pages.<BR>
Time: 01:31:38 GMT, November 23, 1999
</BODY>
</HTML>