]>
Commit | Line | Data |
---|---|---|
8414a40c VZ |
1 | .\" |
2 | .\" Copyright (c) 1988-1997 Sam Leffler | |
3 | .\" Copyright (c) 1991-1997 Silicon Graphics, Inc. | |
4 | .\" | |
5 | .\" Permission to use, copy, modify, distribute, and sell this software and | |
6 | .\" its documentation for any purpose is hereby granted without fee, provided | |
7 | .\" that (i) the above copyright notices and this permission notice appear in | |
8 | .\" all copies of the software and related documentation, and (ii) the names of | |
9 | .\" Sam Leffler and Silicon Graphics may not be used in any advertising or | |
10 | .\" publicity relating to the software without the specific, prior written | |
11 | .\" permission of Sam Leffler and Silicon Graphics. | |
12 | .\" | |
13 | .\" THE SOFTWARE IS PROVIDED "AS-IS" AND WITHOUT WARRANTY OF ANY KIND, | |
14 | .\" EXPRESS, IMPLIED OR OTHERWISE, INCLUDING WITHOUT LIMITATION, ANY | |
15 | .\" WARRANTY OF MERCHANTABILITY OR FITNESS FOR A PARTICULAR PURPOSE. | |
16 | .\" | |
17 | .\" IN NO EVENT SHALL SAM LEFFLER OR SILICON GRAPHICS BE LIABLE FOR | |
18 | .\" ANY SPECIAL, INCIDENTAL, INDIRECT OR CONSEQUENTIAL DAMAGES OF ANY KIND, | |
19 | .\" OR ANY DAMAGES WHATSOEVER RESULTING FROM LOSS OF USE, DATA OR PROFITS, | |
20 | .\" WHETHER OR NOT ADVISED OF THE POSSIBILITY OF DAMAGE, AND ON ANY THEORY OF | |
21 | .\" LIABILITY, ARISING OUT OF OR IN CONNECTION WITH THE USE OR PERFORMANCE | |
22 | .\" OF THIS SOFTWARE. | |
23 | .\" | |
24 | .if n .po 0 | |
25 | .TH TIFFWriteRawtile 3TIFF "December 16, 1991" "libtiff" | |
26 | .SH NAME | |
27 | TIFFWriteRawTile \- write a tile of raw data to an open | |
28 | .SM TIFF | |
29 | file | |
30 | .SH SYNOPSIS | |
31 | .B "#include <tiffio.h>" | |
32 | .sp | |
33 | .BI "tsize_t TIFFWriteRawTile(TIFF *" tif ", ttile_t " tile ", tdata_t " buf ", tsize_t " size ")" | |
34 | .SH DESCRIPTION | |
35 | Append | |
36 | .I size | |
37 | bytes of raw data to the specified tile. | |
38 | .SH "RETURN VALUES" | |
39 | \-1 is returned if an error occurred. Otherwise, the value of | |
40 | .IR size | |
41 | is returned. | |
42 | .SH DIAGNOSTICS | |
43 | All error messages are directed to the | |
44 | .BR TIFFError (3TIFF) | |
45 | routine. | |
46 | .PP | |
47 | \fB%s: File not open for writing\fP. | |
48 | The file was opened for reading, not writing. | |
49 | .PP | |
50 | \fBCan not write tiles to a stripped image\fP. | |
51 | The image is assumed to be organized in strips because neither of the | |
52 | .I TileWidth | |
53 | or | |
54 | .I TileLength | |
55 | tags have been set with | |
56 | .BR TIFFSetField (3TIFF). | |
57 | .PP | |
58 | \fB%s: Must set "ImageWidth" before writing data\fP. | |
59 | The image's width has not be set before the first write. | |
60 | See | |
61 | .BR TIFFSetField (3TIFF) | |
62 | for information on how to do this. | |
63 | .PP | |
64 | \fB%s: Must set "PlanarConfiguration" before writing data\fP. The organization | |
65 | of data has not be defined before the first write. See | |
66 | .BR TIFFSetField (3TIFF) | |
67 | for information on how to do this. | |
68 | .PP | |
69 | \fB%s: No space for tile arrays"\fP. | |
70 | There was not enough space for the arrays that hold tile offsets and byte | |
71 | counts. | |
72 | .PP | |
73 | \fB%s: Specified tile %d out of range, max %d\fP. | |
74 | The specified tile is not valid according to the currently specified image | |
75 | dimensions. | |
76 | .SH "SEE ALSO" | |
77 | .BR TIFFOpen (3TIFF), | |
78 | .BR TIFFWriteEncodedTile (3TIFF), | |
79 | .BR TIFFWriteScanline (3TIFF), | |
80 | .BR libtiff (3TIFF) | |
81 | .PP | |
82 | Libtiff library home page: | |
83 | .BR http://www.remotesensing.org/libtiff/ |