FM / man

/usr/share/doc/libtiff-devel/html/man

Name	Size	Mode	Actions
CMakeLists.txt	3435	0644	edit dl rm
fax2ps.1.html	6463	0644	edit dl rm
fax2tiff.1.html	15703	0644	edit dl rm
HtmlDoc.cmake	2147	0644	edit dl rm
index.html	3826	0644	edit dl rm
libtiff.3tiff.html	55646	0644	edit dl rm
pal2rgb.1.html	4522	0644	edit dl rm
ppm2tiff.1.html	3836	0644	edit dl rm
raw2tiff.1.html	11353	0644	edit dl rm
tiff2bw.1.html	3835	0644	edit dl rm
tiff2pdf.1.html	11566	0644	edit dl rm
tiff2ps.1.html	13490	0644	edit dl rm
tiff2rgba.1.html	4620	0644	edit dl rm
TIFFbuffer.3tiff.html	3668	0644	edit dl rm
TIFFClose.3tiff.html	2200	0644	edit dl rm
tiffcmp.1.html	3763	0644	edit dl rm
TIFFcodec.3tiff.html	3470	0644	edit dl rm
TIFFcolor.3tiff.html	18970	0644	edit dl rm
tiffcp.1.html	14246	0644	edit dl rm
tiffcrop.1.html	30269	0644	edit dl rm
TIFFDataWidth.3tiff.html	2268	0644	edit dl rm
TIFFDeferStrileArrayWriting.3tiff.html	4022	0644	edit dl rm
tiffdither.1.html	5324	0644	edit dl rm
tiffdump.1.html	3554	0644	edit dl rm
TIFFError.3tiff.html	3176	0644	edit dl rm
TIFFFieldDataType.3tiff.html	2184	0644	edit dl rm
TIFFFieldName.3tiff.html	2129	0644	edit dl rm
TIFFFieldPassCount.3tiff.html	2618	0644	edit dl rm
TIFFFieldReadCount.3tiff.html	2826	0644	edit dl rm
TIFFFieldTag.3tiff.html	2253	0644	edit dl rm
TIFFFieldWriteCount.3tiff.html	3150	0644	edit dl rm
TIFFFlush.3tiff.html	2901	0644	edit dl rm
TIFFGetField.3tiff.html	33650	0644	edit dl rm
tiffinfo.1.html	4186	0644	edit dl rm
tiffmedian.1.html	4669	0644	edit dl rm
TIFFmemory.3tiff.html	3306	0644	edit dl rm
TIFFOpen.3tiff.html	14772	0644	edit dl rm
TIFFOpenOptions.3tiff.html	7052	0644	edit dl rm
TIFFPrintDirectory.3tiff.html	4258	0644	edit dl rm
TIFFquery.3tiff.html	5098	0644	edit dl rm
TIFFReadDirectory.3tiff.html	7557	0644	edit dl rm
TIFFReadEncodedStrip.3tiff.html	3576	0644	edit dl rm
TIFFReadEncodedTile.3tiff.html	3516	0644	edit dl rm
TIFFReadRawStrip.3tiff.html	2862	0644	edit dl rm
TIFFReadRawTile.3tiff.html	2951	0644	edit dl rm
TIFFReadRGBAImage.3tiff.html	8618	0644	edit dl rm
TIFFReadRGBAStrip.3tiff.html	7258	0644	edit dl rm
TIFFReadRGBATile.3tiff.html	8048	0644	edit dl rm
TIFFReadScanline.3tiff.html	4500	0644	edit dl rm
TIFFReadTile.3tiff.html	3646	0644	edit dl rm
TIFFRGBAImage.3tiff.html	11629	0644	edit dl rm
tiffset.1.html	3630	0644	edit dl rm
TIFFSetDirectory.3tiff.html	3429	0644	edit dl rm
TIFFSetField.3tiff.html	31189	0644	edit dl rm
TIFFsize.3tiff.html	2469	0644	edit dl rm
tiffsplit.1.html	3125	0644	edit dl rm
TIFFStrileQuery.3tiff.html	4958	0644	edit dl rm
TIFFstrip.3tiff.html	4180	0644	edit dl rm
TIFFswab.3tiff.html	3239	0644	edit dl rm
TIFFtile.3tiff.html	4867	0644	edit dl rm
TIFFWarning.3tiff.html	3136	0644	edit dl rm
TIFFWriteDirectory.3tiff.html	6273	0644	edit dl rm
TIFFWriteEncodedStrip.3tiff.html	4424	0644	edit dl rm
TIFFWriteEncodedTile.3tiff.html	4215	0644	edit dl rm
TIFFWriteRawStrip.3tiff.html	3999	0644	edit dl rm
TIFFWriteRawTile.3tiff.html	3630	0644	edit dl rm
TIFFWriteScanline.3tiff.html	6819	0644	edit dl rm
TIFFWriteTile.3tiff.html	3170	0644	edit dl rm

Edit: /usr/share/doc/libtiff-devel/html/man/TIFFWriteScanline.3tiff.html (6819B)

<!DOCTYPE html PUBLIC "-//W3C//DTD HTML 4.01 Transitional//EN"
"http://www.w3.org/TR/html4/loose.dtd">
<html>
<head>
<meta name="generator" content="groff -Thtml, see www.gnu.org">
<meta http-equiv="Content-Type" content="text/html; charset=US-ASCII">
<meta name="Content-Style" content="text/css">
<style type="text/css">
 p { margin-top: 0; margin-bottom: 0; vertical-align: top }
 pre { margin-top: 0; margin-bottom: 0; vertical-align: top }
 table { margin-top: 0; margin-bottom: 0; vertical-align: top }
 h1 { text-align: center }
</style>
<title>TIFFWriteScanline</title>

</head>
<body>

<h1 align="center">TIFFWriteScanline</h1>

<a href="#NAME">NAME</a> 
<a href="#SYNOPSIS">SYNOPSIS</a> 
<a href="#DESCRIPTION">DESCRIPTION</a> 
<a href="#NOTES">NOTES</a> 
<a href="#RETURN VALUES">RETURN VALUES</a> 
<a href="#DIAGNOSTICS">DIAGNOSTICS</a> 
<a href="#BUGS">BUGS</a> 
<a href="#SEE ALSO">SEE ALSO</a>

<hr>

TIFFWriteScanline
&minus; write a scanline to an open TIFF
file

<h2>SYNOPSIS
<a name="SYNOPSIS"></a>
</h2>

#include
&lt;tiffio.h&gt;

int
TIFFWriteScanline(TIFF *tif, tdata_t
buf, uint32_t row, tsample_t
sample)

<h2>DESCRIPTION
<a name="DESCRIPTION"></a>
</h2>

Write data to a
file at the specified row. The sample parameter is
used only if data are organized in separate planes
(PlanarConfiguration=2). The data are assumed to be
uncompressed and in the native bit- and byte-order of the
host machine. The data written to the file is compressed
according to the compression scheme of the current
TIFF directory (see further below). If the
current scanline is past the end of the current subfile, the
ImageLength field is automatically increased to
include the scanline (except for
PlanarConfiguration=2, where the ImageLength
cannot be changed once the first data are written). If the
ImageLength is increased, the StripOffsets and
StripByteCounts fields are similarly enlarged to
reflect data written past the previous end of image.

<h2>NOTES
<a name="NOTES"></a>
</h2>

The library
writes encoded data using the native machine byte order.
Correctly implemented TIFF readers are
expected to do any necessary byte-swapping to correctly
process image data with BitsPerSample greater than 8. The
library attempts to hide bit-ordering differences between
the image and the native machine by converting data from the
native machine order.

In C++ the
sample parameter defaults to 0.

Once data are
written to a file for the current directory, the values of
certain tags may not be altered; see
TIFFSetField(3TIFF) for more information.

It is not
possible to write scanlines to a file that uses a tiled
organization. The routine TIFFIsTiled can be used to
determine if the file is organized as tiles or strips.

<h2>RETURN VALUES
<a name="RETURN VALUES"></a>
</h2>

TIFFWriteScanline
returns &minus;1 if it immediately detects an error and 1
for a successful write.

<h2>DIAGNOSTICS
<a name="DIAGNOSTICS"></a>
</h2>

All error
messages are directed to the TIFFError(3TIFF)
routine.

%s: File not
open for writing . The file was opened for reading, not
writing.

Can not
write scanlines to a tiled image. An attempt was made to
write a scanline to a tiled image. The image is assumed to
be organized in tiles because the TileWidth and
TileLength tags have been set with
TIFFSetField(3TIFF).

Compression
algorithm does not support random access. Data was
written in a non-sequential order to a file that uses a
compression algorithm and that has RowsPerStrip
greater than one. That is, data in the image is to be stored
in a compressed form, and with multiple rows packed into a
strip. In this case, the library does not support random
access to the data. The data should either be written as
entire strips, sequentially by rows, or the value of
RowsPerStrip should be set to one.

%s: Must set
&quot;ImageWidth&quot; before writing data. The
image&rsquo;s width has not be set before the first write.
See TIFFSetField(3TIFF) for information on how to do
this.

%s: Must set
&quot;PlanarConfiguration&quot; before writing data. The
organization of data has not be defined before the first
write. See TIFFSetField(3TIFF) for information on how
to do this.

Can not
change &quot;ImageLength&quot; when using separate
planes. Separate image planes are being used
(PlanarConfiguration=2), but the number of rows has
not been specified before the first write. The library
supports the dynamic growth of an image only when data are
organized in a contiguous manner
(PlanarConfiguration=1).

%d: Sample
out of range, max %d. The sample parameter was
greater than the value of the SamplesPerPixel tag.

%s: No space
for strip arrays . There was not enough space for the
arrays that hold strip offsets and byte counts.

Writing
subsampled YCbCR data does not work correctly because, for
PlanarConfiguration=2 the size of a scanline is not
calculated on a per-sample basis, and for
PlanarConfiguration=1 the library does not pack the
block-interleaved samples.

TIFFOpen(3TIFF),
TIFFWriteEncodedStrip(3TIFF),
TIFFWriteRawStrip(3TIFF), libtiff(3TIFF)

Libtiff library
home page: http://www.simplesystems.org/libtiff/
<hr>
</body>
</html>

cmd: