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/TIFFReadRGBATile.3tiff.html (8048B)

<!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>TIFFReadRGBATile</title>

</head>
<body>

<h1 align="center">TIFFReadRGBATile</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="#SEE ALSO">SEE ALSO</a>

<hr>

TIFFReadRGBATile
&minus; read and decode an image tile into a fixed-format
raster

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

#include
&lt;tiffio.h&gt;

#define TIFFGetR(abgr)</td>
<td width="30%"></td>
<td width="8%"></td>
<td width="54%">

((abgr) &amp; 0xff)</td></tr>
<tr valign="top" align="left">
<td width="11%"></td>
<td width="-3%">

#define TIFFGetG(abgr)</td>
<td width="30%"></td>
<td width="8%"></td>
<td width="54%">

(((abgr) &gt;&gt; 8) &amp; 0xff)</td></tr>
<tr valign="top" align="left">
<td width="11%"></td>
<td width="-3%">

#define TIFFGetB(abgr)</td>
<td width="30%"></td>
<td width="8%"></td>
<td width="54%">

(((abgr) &gt;&gt; 16) &amp; 0xff)</td></tr>
<tr valign="top" align="left">
<td width="11%"></td>
<td width="-3%">

#define TIFFGetA(abgr)</td>
<td width="30%"></td>
<td width="8%"></td>
<td width="54%">

(((abgr) &gt;&gt; 24) &amp; 0xff)</td></tr>
</table>

int
TIFFReadRGBATile(TIFF *tif, uint32_t
x, uint32_t y, uint32_t
*raster)

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

TIFFReadRGBATile
reads a single tile of a tile-based image into memory,
storing the result in the user supplied RGBA raster.
The raster is assumed to be an array of width times length
32-bit entries, where width is the width of a tile
(TIFFTAG_TILEWIDTH) and length is the height of a tile
(TIFFTAG_TILELENGTH).

The x
and y values are the offsets from the top left corner
to the top left corner of the tile to be read. They must be
an exact multiple of the tile width and length.

Note that the
raster is assume to be organized such that the pixel at
location (x,y) is
raster[y*width+x]; with the
raster origin in the lower-left hand corner of the
tile. That is bottom to top organization. Edge tiles which
partly fall off the image will be filled out with
appropriate zeroed areas.

Raster pixels
are 8-bit packed red, green, blue, alpha samples. The macros
TIFFGetR, TIFFGetG, TIFFGetB, and
TIFFGetA should be used to access individual samples.
Images without Associated Alpha matting information have a
constant Alpha of 1.0 (255).

See the
TIFFRGBAImage(3TIFF) page for more details on how
various image types are converted to RGBA values.

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

Samples must be
either 1, 2, 4, 8, or 16 bits. Colorimetric samples/pixel
must be either 1, 3, or 4 (i.e. SamplesPerPixel minus
ExtraSamples).

Palette image
colormaps that appear to be incorrectly written as 8-bit
values are automatically scaled to 16-bits.

TIFFReadRGBATile
is just a wrapper around the more general
TIFFRGBAImage(3TIFF) facilities. It&rsquo;s main
advantage over the similar TIFFReadRGBAImage()
function is that for large images a single buffer capable of
holding the whole image doesn&rsquo;t need to be allocated,
only enough for one tile. The TIFFReadRGBAStrip()
function does a similar operation for stripped images.

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

1 is returned
if the image was successfully read and converted. Otherwise,
0 is returned if an error was encountered.

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

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

Sorry, can
not handle %d-bit pictures. The image had
BitsPerSample other than 1, 2, 4, 8, or 16.

Sorry, can
not handle %d-channel images. The image had
SamplesPerPixel other than 1, 3, or 4.

Missing
needed &quot;PhotometricInterpretation&quot; tag. The
image did not have a tag that describes how to display the
data.

No
&quot;PhotometricInterpretation&quot; tag, assuming RGB.
The image was missing a tag that describes how to display
it, but because it has 3 or 4 samples/pixel, it is assumed
to be RGB.

No
&quot;PhotometricInterpretation&quot; tag, assuming
min-is-black. The image was missing a tag that describes
how to display it, but because it has 1 sample/pixel, it is
assumed to be a grayscale or bilevel image.

No space for
photometric conversion table. There was insufficient
memory for a table used to convert image samples to 8-bit
RGB.

Missing
required &quot;Colormap&quot; tag. A Palette image did
not have a required Colormap tag.

No space for
tile buffer. There was insufficient memory to allocate
an i/o buffer.

No space for
strip buffer. There was insufficient memory to allocate
an i/o buffer.

Can not
handle format. The image has a format (combination of
BitsPerSample, SamplesPerPixel, and
PhotometricInterpretation) that
TIFFReadRGBAImage can not handle.

No space for
B&amp;W mapping table. There was insufficient memory to
allocate a table used to map grayscale data to
RGB.

No space for
Palette mapping table. There was insufficient memory to
allocate a table used to map data to 8-bit
RGB.

TIFFOpen(3TIFF),
TIFFRGBAImage(3TIFF),
TIFFReadRGBAImage(3TIFF),
TIFFReadRGBAStrip(3TIFF), libtiff(3TIFF)

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

cmd: