1 <!-- Creator : groff version 1.18.1 -->
2 <!-- CreationDate: Mon Mar 13 18:03:11 2006 -->
5 <meta name=
"generator" content=
"groff -Thtml, see www.gnu.org">
6 <meta name=
"Content-Style" content=
"text/css">
7 <title>TIFFTILE
</title>
11 <h1 align=center
>TIFFTILE
</h1>
12 <a href=
"#NAME">NAME
</a><br>
13 <a href=
"#SYNOPSIS">SYNOPSIS
</a><br>
14 <a href=
"#DESCRIPTION">DESCRIPTION
</a><br>
15 <a href=
"#DIAGNOSTICS">DIAGNOSTICS
</a><br>
16 <a href=
"#SEE ALSO">SEE ALSO
</a><br>
22 <table width=
"100%" border=
0 rules=
"none" frame=
"void"
23 cols=
"2" cellspacing=
"0" cellpadding=
"0">
24 <tr valign=
"top" align=
"left">
27 <p>TIFFTileSize, TIFFTileRowSize, TIFFVTileSize,
28 TIFFDefaultTileSize, TIFFComputeTile, TIFFCheckTile,
29 TIFFNumberOfTiles
− tile-related utility routines
</p>
32 <a name=
"SYNOPSIS"></a>
35 <table width=
"100%" border=
0 rules=
"none" frame=
"void"
36 cols=
"2" cellspacing=
"0" cellpadding=
"0">
37 <tr valign=
"top" align=
"left">
40 <p><b>#include
<tiffio.h
></b></p>
42 <p><b>void TIFFDefaultTileSize(TIFF *
</b><i>tif
</i><b>,
43 uint32 *
</b><i>tw
</i><b>, uint32 *
</b><i>th
</i><b>)
<br>
44 tsize_t TIFFTileSize(TIFF *
</b><i>tif
</i><b>)
<br>
45 tsize_t TIFFTileRowSize(TIFF *
</b><i>tif
</i><b>)
<br>
46 tsize_t TIFFVTileSize(TIFF *
</b><i>tif
</i><b>, uint32
</b>
48 ttile_t TIFFComputeTile(TIFF *
</b><i>tif
</i><b>, uint32
</b>
49 <i>x
</i><b>, uint32
</b> <i>y
</i><b>, uint32
</b> <i>z
</i><b>,
50 tsample_t
</b> <i>sample
</i><b>)
<br>
51 int TIFFCheckTile(TIFF *
</b><i>tif
</i><b>, uint32
</b>
52 <i>x
</i><b>, uint32
</b> <i>y
</i><b>, uint32
</b> <i>z
</i><b>,
53 tsample_t
</b> <i>sample
</i><b>)
<br>
54 ttile_t TIFFNumberOfTiles(TIFF *
</b><i>tif
</i><b>)
</b></p>
57 <a name=
"DESCRIPTION"></a>
60 <table width=
"100%" border=
0 rules=
"none" frame=
"void"
61 cols=
"2" cellspacing=
"0" cellpadding=
"0">
62 <tr valign=
"top" align=
"left">
65 <p><i>TIFFDefaultTileSize
</i> returns the pixel width and
66 height of a reasonable-sized tile; suitable for setting up
67 the
<i>TileWidth
</i> and
<i>TileLength
</i> tags. If the
68 <i>tw
</i> and
<i>th
</i> values passed in are non-zero, then
69 they are adjusted to reflect any compression-specific
70 requirements. The returned width and height are constrained
71 to be a multiple of
16 pixels to conform with the
72 <small>TIFF
</small> specification.
</p>
74 <p><i>TIFFTileSize
</i> returns the equivalent size for a
75 tile of data as it would be returned in a call to
76 <i>TIFFReadTile
</i> or as it would be expected in a call to
77 <i>TIFFWriteTile
</i>.
</p>
79 <p><i>TIFFVTileSize
</i> returns the number of bytes in a
80 row-aligned tile with
<i>nrows
</i> of data.
</p>
82 <p><i>TIFFTileRowSize
</i> returns the number of bytes of a
83 row of data in a tile.
</p>
85 <p><i>TIFFComputeTile
</i> returns the tile that contains the
86 specified coordinates. A valid tile is always returned;
87 out-of-range coordinate values are clamped to the bounds of
88 the image. The
<i>x
</i> and
<i>y
</i> parameters are always
89 used in calculating a tile. The
<i>z
</i> parameter is used
90 if the image is deeper than
1 slice
91 (
<i>ImageDepth
</i>>1). The
<i>sample
</i> parameter is
92 used only if data are organized in separate planes
93 (
<i>PlanarConfiguration
</i>=
2).
</p>
95 <p><i>TIFFCheckTile
</i> returns a non-zero value if the
96 supplied coordinates are within the bounds of the image and
97 zero otherwise. The
<i>x
</i> parameter is checked against
98 the value of the
<i>ImageWidth
</i> tag. The
<i>y
</i>
99 parameter is checked against the value of the
100 <i>ImageLength
</i> tag. The
<i>z
</i> parameter is checked
101 against the value of the
<i>ImageDepth
</i> tag (if defined).
102 The
<i>sample
</i> parameter is checked against the value of
103 the
<i>SamplesPerPixel
</i> parameter if the data are
104 organized in separate planes.
</p>
106 <p><i>TIFFNumberOfTiles
</i> returns the number of tiles in
110 <a name=
"DIAGNOSTICS"></a>
113 <table width=
"100%" border=
0 rules=
"none" frame=
"void"
114 cols=
"2" cellspacing=
"0" cellpadding=
"0">
115 <tr valign=
"top" align=
"left">
121 <a name=
"SEE ALSO"></a>
124 <table width=
"100%" border=
0 rules=
"none" frame=
"void"
125 cols=
"2" cellspacing=
"0" cellpadding=
"0">
126 <tr valign=
"top" align=
"left">
129 <p><b>TIFFReadEncodedTile
</b>(
3TIFF),
130 <b>TIFFReadRawTile
</b>(
3TIFF),
<b>TIFFReadTile
</b>(
3TIFF),
131 <b>TIFFWriteEncodedTile
</b>(
3TIFF),
132 <b>TIFFWriteRawTile
</b>(
3TIFF),
<b>TIFFWriteTile
</b>(
3TIFF),
133 <b>libtiff
</b>(
3TIFF)
</p>
135 <p>Libtiff library home page:
136 <b>http://www.remotesensing.org/libtiff/
</b></p>