libtiff/html/man/TIFFWriteRawStrip.3t.html

140 lines
4.9 KiB
HTML
Raw Normal View History

2002-10-07 09:47:36 -04:00
<html>
<head>
<meta name="generator" content="groff -Thtml, see www.gnu.org">
<meta name="Content-Style" content="text/css">
<title>TIFFWriteRawstrip</title>
</head>
<body>
<h1 align=center>TIFFWriteRawstrip</h1>
<a href="#NAME">NAME</a><br>
<a href="#SYNOPSIS">SYNOPSIS</a><br>
<a href="#DESCRIPTION">DESCRIPTION</a><br>
<a href="#NOTES">NOTES</a><br>
<a href="#RETURN VALUES">RETURN VALUES</a><br>
<a href="#DIAGNOSTICS">DIAGNOSTICS</a><br>
<a href="#SEE ALSO">SEE ALSO</a><br>
<hr>
2003-11-27 10:07:01 -05:00
<!-- Creator : groff version 1.17.2 -->
<!-- CreationDate: Thu Nov 27 17:58:07 2003 -->
2002-10-07 09:47:36 -04:00
<a name="NAME"></a>
<h2>NAME</h2>
2003-11-27 10:07:01 -05:00
<table width="100%" border=0 rules="none" frame="void"
2002-10-07 09:47:36 -04:00
cols="2" cellspacing="0" cellpadding="0">
<tr valign="top" align="left">
2003-11-27 10:07:01 -05:00
<td width="10%"></td><td width="90%">
TIFFWriteRawStrip - write a strip of raw data to an open <small>TIFF</small> file</td></table>
2002-10-07 09:47:36 -04:00
<a name="SYNOPSIS"></a>
<h2>SYNOPSIS</h2>
2003-11-27 10:07:01 -05:00
<table width="100%" border=0 rules="none" frame="void"
2002-10-07 09:47:36 -04:00
cols="2" cellspacing="0" cellpadding="0">
<tr valign="top" align="left">
2003-11-27 10:07:01 -05:00
<td width="10%"></td><td width="90%">
<b>#include &lt;tiffio.h&gt;<br>
2002-10-07 09:47:36 -04:00
tsize_t TIFFWriteRawStrip(TIFF* tif, tstrip_t strip, tdata_t
2003-11-27 10:07:01 -05:00
buf, tsize_t size)</b></td></table>
2002-10-07 09:47:36 -04:00
<a name="DESCRIPTION"></a>
<h2>DESCRIPTION</h2>
2003-11-27 10:07:01 -05:00
<table width="100%" border=0 rules="none" frame="void"
2002-10-07 09:47:36 -04:00
cols="2" cellspacing="0" cellpadding="0">
<tr valign="top" align="left">
2003-11-27 10:07:01 -05:00
<td width="10%"></td><td width="90%">
Append <i>size</i> bytes of raw data to the specified
strip.</td></table>
2002-10-07 09:47:36 -04:00
<a name="NOTES"></a>
<h2>NOTES</h2>
2003-11-27 10:07:01 -05:00
<table width="100%" border=0 rules="none" frame="void"
2002-10-07 09:47:36 -04:00
cols="2" cellspacing="0" cellpadding="0">
<tr valign="top" align="left">
2003-11-27 10:07:01 -05:00
<td width="10%"></td><td width="90%">
The strip number must be valid according to the current
2002-10-07 09:47:36 -04:00
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
2003-11-27 10:07:01 -05:00
<i>TIFFWriteRawStrip</i>.</td></table>
2002-10-07 09:47:36 -04:00
<a name="RETURN VALUES"></a>
<h2>RETURN VALUES</h2>
2003-11-27 10:07:01 -05:00
<table width="100%" border=0 rules="none" frame="void"
2002-10-07 09:47:36 -04:00
cols="2" cellspacing="0" cellpadding="0">
<tr valign="top" align="left">
2003-11-27 10:07:01 -05:00
<td width="10%"></td><td width="90%">
-1 is returned if an error occurred. Otherwise, the value of
<i>size</i> is returned.</td></table>
2002-10-07 09:47:36 -04:00
<a name="DIAGNOSTICS"></a>
<h2>DIAGNOSTICS</h2>
2003-11-27 10:07:01 -05:00
<table width="100%" border=0 rules="none" frame="void"
cols="2" cellspacing="0" cellpadding="0">
<tr valign="top" align="left">
<td width="10%"></td><td width="90%">
All error messages are directed to the <i>TIFFError</i>(3T)
routine.</td></table>
<table width="100%" border=0 rules="none" frame="void"
cols="2" cellspacing="0" cellpadding="0">
<tr valign="top" align="left">
<td width="10%"></td><td width="90%">
<b>%s: File not open for writing</b>. The file was opened
for reading, not writing.</td></table>
<table width="100%" border=0 rules="none" frame="void"
2002-10-07 09:47:36 -04:00
cols="2" cellspacing="0" cellpadding="0">
<tr valign="top" align="left">
2003-11-27 10:07:01 -05:00
<td width="10%"></td><td width="90%">
<b>Can not write scanlines to a tiled image</b>. The image
is assumed to be organized in tiles because the
2002-10-07 09:47:36 -04:00
<i>TileWidth</i> and <i>TileLength</i> tags have been set
2003-11-27 10:07:01 -05:00
with <i>TIFFSetField</i>(3T).</td></table>
<table width="100%" border=0 rules="none" frame="void"
cols="2" cellspacing="0" cellpadding="0">
<tr valign="top" align="left">
<td width="10%"></td><td width="90%">
<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>TIFFSetField</i>(3T) for information on how to
do this.</td></table>
<table width="100%" border=0 rules="none" frame="void"
cols="2" cellspacing="0" cellpadding="0">
<tr valign="top" align="left">
<td width="10%"></td><td width="90%">
<b>%s: Must set &quot;PlanarConfiguration&quot; before
2002-10-07 09:47:36 -04:00
writing data</b>. The organization of data has not be
defined before the first write. See <i>TIFFSetField</i>(3T)
2003-11-27 10:07:01 -05:00
for information on how to do this.</td></table>
<table width="100%" border=0 rules="none" frame="void"
cols="2" cellspacing="0" cellpadding="0">
<tr valign="top" align="left">
<td width="10%"></td><td width="90%">
<b>%s: No space for strip arrays&quot;</b>. There was not
2002-10-07 09:47:36 -04:00
enough space for the arrays that hold strip offsets and byte
2003-11-27 10:07:01 -05:00
counts.</td></table>
<table width="100%" border=0 rules="none" frame="void"
cols="2" cellspacing="0" cellpadding="0">
<tr valign="top" align="left">
<td width="10%"></td><td width="90%">
<b>%s: Strip %d out of range, max %d</b>. The specified
2002-10-07 09:47:36 -04:00
strip is not a valid strip according to the currently
2003-11-27 10:07:01 -05:00
specified image dimensions.</td></table>
2002-10-07 09:47:36 -04:00
<a name="SEE ALSO"></a>
<h2>SEE ALSO</h2>
2003-11-27 10:07:01 -05:00
<table width="100%" border=0 rules="none" frame="void"
2002-10-07 09:47:36 -04:00
cols="2" cellspacing="0" cellpadding="0">
<tr valign="top" align="left">
2003-11-27 10:07:01 -05:00
<td width="10%"></td><td width="90%">
<i>libtiff</i>(3T), <i>TIFFOpen</i>(3T),
2002-10-07 09:47:36 -04:00
<i>TIFFWriteEncodedStrip</i>(3T),
2003-11-27 10:07:01 -05:00
<i>TIFFWriteScanline</i>(3T)</td></table>
2002-10-07 09:47:36 -04:00
<hr>
</body>
</html>