This file is indexed.

/usr/include/terralib/kernel/TeCoverageDecoder.h is in libterralib-dev 4.3.0+dfsg.2-11.

This file is owned by root:root, with mode 0o644.

The actual contents of the file can be viewed below.

  1
  2
  3
  4
  5
  6
  7
  8
  9
 10
 11
 12
 13
 14
 15
 16
 17
 18
 19
 20
 21
 22
 23
 24
 25
 26
 27
 28
 29
 30
 31
 32
 33
 34
 35
 36
 37
 38
 39
 40
 41
 42
 43
 44
 45
 46
 47
 48
 49
 50
 51
 52
 53
 54
 55
 56
 57
 58
 59
 60
 61
 62
 63
 64
 65
 66
 67
 68
 69
 70
 71
 72
 73
 74
 75
 76
 77
 78
 79
 80
 81
 82
 83
 84
 85
 86
 87
 88
 89
 90
 91
 92
 93
 94
 95
 96
 97
 98
 99
100
101
102
103
104
105
106
107
108
109
110
111
112
113
114
115
116
117
118
119
120
121
122
123
124
125
126
127
128
129
130
131
132
133
134
135
136
137
138
139
140
141
142
143
144
145
146
147
148
149
150
151
152
153
154
155
156
157
158
159
160
161
162
163
164
165
166
167
168
169
170
171
172
173
174
175
176
177
178
179
180
181
182
183
184
185
186
/************************************************************************************
TerraLib - a library for developing GIS applications.
Copyright © 2001-2007 INPE and Tecgraf/PUC-Rio.

This code is part of the TerraLib library.
This library is free software; you can redistribute it and/or
modify it under the terms of the GNU Lesser General Public
License as published by the Free Software Foundation; either
version 2.1 of the License, or (at your option) any later version.

You should have received a copy of the GNU Lesser General Public
License along with this library.

The authors reassure the license terms regarding the warranties.
They specifically disclaim any warranties, including, but not limited to,
the implied warranties of merchantability and fitness for a particular purpose.
The library provided hereunder is on an "as is" basis, and the authors have no
obligation to provide maintenance, support, updates, enhancements, or modifications.
In no event shall INPE and Tecgraf / PUC-Rio be held liable to any party for direct,
indirect, special, incidental, or consequential damages arising out of the use
of this library and its documentation.
*************************************************************************************/
/*!
  \file TeCoverageDecoder.h

  \par This file contains definitions and algorithms for accessing persistent
       representations of a generic Coverage.
*/
#ifndef  __TERRALIB_INTERNAL_COVERAGEDECODER_H
#define  __TERRALIB_INTERNAL_COVERAGEDECODER_H

#include "TeCoord2D.h"
#include "TeException.h"
#include "TeBlockLoader.h"
#include "TeCoverageParams.h"
#include "TeCoverageUtils.h"
#include "TeSpatialOperations.h"
#include <map>
#include <vector>

/*!
  \def READ
  \brief Read a value of some type from a pointer to a block of raw data.
*/
#define READ(data, t) *(t*)data; data += sizeof(t)

/*!
  \struct TeGeomValuePair
  \brief A generic geometry-value pair.
*/
template <class T>
struct TeGeomValuePair
{
    T geom; //!< A generic geometry
    std::vector<double> value; //!< a value vector

    //! Default constructor.
    TeGeomValuePair(){}

    //! Constructor for a generic geometry-value pair
    TeGeomValuePair(const T& geom,
                     const std::vector<double>& value):
            geom(geom),
            value(value){}
};



/*!
  \struct TeCoverageBlock
  \brief A generic coverage block.

  \par A generic coverage block contais a set of generic geometry-value pairs.
  \par This coverage block has a box, which is the minimum box enclosing all
       the generic geometries that are in the block.
*/
template <class T>
struct TeCoverageBlock
{
    int id; //!< The identifier of the block
    TeBox box; //!< The minimum box enclosing all elements of the block
    std::vector<TeGeomValuePair<T> > pairs; //!< vector of geometry-value pairs
};

/*!
  \class TeCoverageDecoder
  \brief Abstract class of a coverage data decoder.

  \par The decoder is used to provide a common interface for accessing
       coverage data regardless of where and how it is stored.
  \sa TeGeomValuePair TeCoverageBlock
*/
template <class T>
class TeCoverageDecoder
{
public:

    //! Constructor from coverage parameters
    TeCoverageDecoder(TeCoverageParams& params) :
        params_(params)
    {
    }

    //! Destructor
    virtual ~TeCoverageDecoder()
    {
        clear();
    }

    //! Return the coverage parameters
    virtual TeCoverageParams& getParameters()
    {
        return params_;
    }

    //! Initialize internal structures
    /*!
      Instantiate internal structures, must be called before any attempt
      to access the coverage data.
    */
    virtual void init()
    {
    }

    //! Clear internal structures
    /*!
      Clear internal structures, must be called before disposing of the
      decoder.
    */
    virtual void clear()
    {
    }

    //! Select generic geometry-value pairs from the coverage data
    /*!
      \par Select generic geometry-value pairs from the coverage data.
      \par The polygon parameter defines a selection area and the relation
           parameter specifies the kind of relation (e.g. intersection,
           crossing, overlapping) that holds between the selection area and
           the geometries to be selected.
      \param poly an instance of TePolygon representing a selection area
      \param relation a spatial relation
      \sa TeGeomValuePair
    */
    virtual void selectGeomValuePairs(const TePolygon& poly, const TeSpatialRelation relation, std::vector<TeGeomValuePair<T> >& selected)
    {
        // Select blocks which contain geometries that might respect the
        // spatial relation with the polygon
        std::vector<TeCoverageBlock<T> >& blocks = std::vector<TeCoverageBlock<T> >();
        selectBlocks(poly, TeINTERSECTS, blocks);

        for (std::vector<TeCoverageBlock<T> >::iterator itBlocks = blocks.begin(); itBlocks != blocks.end(); ++itBlocks)
        {
            // Look at all geometry-value pairs of selected blocks
            std::vector<TeGeomValuePair<T> >& pairs = itBlocks->pairs;
            for (std::vector<TeGeomValuePair<T> >::iterator it = pairs.begin(); it != pairs.end(); ++it)
            {
                // If the spatial relation holds, add geom-value pair to the result
                if (TeTopologicalRelation(&poly, &it->geom, relation))
                {
                    selected.push_back(*it);
                }
            }
        }
    }

    //! Select generic coverage blocks from the coverage data
    /*!
      \par Select generic coverage blocks from the coverage data.
      \par The polygon parameter defines a selection area and the relation
           parameter specifies the kind of relation (e.g. intersection,
           crossing, overlapping) that holds between the selection area and
           at least one geometry in each block to be selected.
      \param poly an instance of TePolygon representing a selection area
      \param relation a spatial relation
      \param dontSelect list IDs of blocks that must not be retrieved
      \sa TeCoverageBlock TeSpatialRelation
    */
    virtual void selectBlocks(const TePolygon& poly, const TeSpatialRelation relation, std::vector<TeCoverageBlock<T> >& selected, std::set<int>& dontSelect = std::set<int>()) = 0;

protected:

    TeCoverageParams& params_;  //!< Coverage parameters.
};

#endif // __TERRALIB_INTERNAL_COVERAGEDECODER_H