1 /******************************************************************************
2  * tif_ovrcache.h,v 1.3 2005/05/25 09:03:16 dron Exp
3  *
4  * Project:  TIFF Overview Builder
5  * Purpose:  Library functions to maintain two rows of tiles or two strips
6  *           of data for output overviews as an output cache.
7  * Author:   Frank Warmerdam, warmerdam@pobox.com
8  *
9  * This code could potentially be used by other applications wanting to
10  * manage a once-through write cache.
11  *
12  ******************************************************************************
13  * Copyright (c) 2000, Frank Warmerdam
14  *
15  * Permission is hereby granted, free of charge, to any person obtaining a
16  * copy of this software and associated documentation files (the "Software"),
17  * to deal in the Software without restriction, including without limitation
18  * the rights to use, copy, modify, merge, publish, distribute, sublicense,
19  * and/or sell copies of the Software, and to permit persons to whom the
20  * Software is furnished to do so, subject to the following conditions:
21  *
22  * The above copyright notice and this permission notice shall be included
23  * in all copies or substantial portions of the Software.
24  *
25  * THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS
26  * OR IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
27  * FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL
28  * THE AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
29  * LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING
30  * FROM, OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER
31  * DEALINGS IN THE SOFTWARE.
32  ******************************************************************************
33  */
34 
35 #ifndef TIF_OVRCACHE_H_INCLUDED
36 #define TIF_OVRCACHE_H_INCLUDED
37 
38 #include "tiffio.h"
39 
40 #if defined(__cplusplus)
41 extern "C" {
42 #endif
43 
44 typedef struct
45 {
46     uint32	nXSize;
47     uint32	nYSize;
48 
49     uint16	nBitsPerPixel;
50     uint16	nSamples;
51     uint16      nPlanarConfig;
52     uint32	nBlockXSize;
53     uint32	nBlockYSize;
54     toff_t	nBytesPerBlock;
55     toff_t      nBytesPerRow;
56 
57     int		nBlocksPerRow;
58     int		nBlocksPerColumn;
59 
60     int	        nBlockOffset; /* what block is the first in papabyBlocks? */
61     unsigned char *pabyRow1Blocks;
62     unsigned char *pabyRow2Blocks;
63 
64     toff_t	nDirOffset;
65     TIFF	*hTIFF;
66     int		bTiled;
67 
68 } TIFFOvrCache;
69 
70 TIFFOvrCache *TIFFCreateOvrCache( TIFF *hTIFF, toff_t nDirOffset );
71 unsigned char *TIFFGetOvrBlock( TIFFOvrCache *psCache, int iTileX, int iTileY,
72                                 int iSample );
73 unsigned char *TIFFGetOvrBlock_Subsampled( TIFFOvrCache *psCache, int iTileX, int iTileY );
74 void           TIFFDestroyOvrCache( TIFFOvrCache * );
75 
76 void TIFFBuildOverviews( TIFF *, int, int *, int, const char *,
77                          int (*)(double,void*), void * );
78 
79 void TIFF_ProcessFullResBlock( TIFF *, int, int, int, int, int, int *, int,
80                                int, TIFFOvrCache **, uint32, uint32,
81                                unsigned char *, uint32, uint32,
82                                int, const char * );
83 
84 uint32 TIFF_WriteOverview( TIFF *, uint32, uint32, int, int, int, int, int,
85                            int, int, int, int, unsigned short *,
86                            unsigned short *, unsigned short *, int,
87                            int, int);
88 
89 
90 
91 #if defined(__cplusplus)
92 }
93 #endif
94 
95 #endif /* ndef TIF_OVRCACHE_H_INCLUDED */
96 
97 /*
98  * Local Variables:
99  * mode: c
100  * c-basic-offset: 8
101  * fill-column: 78
102  * End:
103  */
104