/usr/include/terralib/kernel/TeBufferRegion.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 | /************************************************************************************
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 TeBufferRegion.h
\brief This file contains structures and definitions for buffer region (map distance) operation on objects.
\author Gilberto Ribeiro de Queiroz <gribeiro@dpi.inpe.br>
*/
#ifndef __TERRALIB_INTERNAL_BUFFER_H
#define __TERRALIB_INTERNAL_BUFFER_H
#include "TeCoord2D.h"
class TeLine2D;
class TePolygon;
class TePolygonSet;
class TeLineSet;
class TePointSet;
class TeCellSet;
/*! \brief Contains structures and definitions needed to execute Buffer Region operation
*/
namespace TeBUFFERREGION
{
//! Buffer type.
/*!
- TeINSIDEBUFFER used to make only inside buffer lines
- TeOUTSIDEBUFFER used to make only outside buffer lines
- TeINSIDEOUTSIDEBUFFER used to make inside and outside buffer lines
*/
enum TeBufferType { TeINSIDEBUFFER, TeOUTSIDEBUFFER, TeINSIDEOUTSIDEBUFFER };
/** \brief Calculates a buffer region around a point (DEPRECATED: use TeBufferRegion with buffer levels instead).
\param coord the location of the point
\param bufferDistance the desired distance in the same unit as coord
\param numPoints the number of points that should be used to describe the buffer zone (a circle in this case)
\param pol to return the buffer zone: a circle polygon in clockwise order
\return Returns true if operation succeed otherwise returns false.
*/
TL_DLL bool TeBufferRegion(const TeCoord2D& coord, const double& bufferDistance, const unsigned int& numPoints, TePolygon& pol);
/** \brief Calculates a buffer region around a point.
\param coord the location of the point
\param bufferDistance the desired distance in the same unit as coord
\param numPoints the number of points that should be used to describe the buffer zone (a circle in this case)
\param bufferLevels the number of buffer intervals
\param bufferPols to return the buffer intervals: a circle polygon in clockwise order with holes in counterclockwise order
\return Returns true if operation succeed otherwise returns false.
*/
TL_DLL bool TeBufferRegion(const TeCoord2D& coord, const double& bufferDistance, const unsigned int& numPoints, const unsigned int& bufferLevels, vector<TePolygon>& bufferPols);
/** \brief Calculates a buffer region around a line (DEPRECATED: use TeBufferRegion with buffer levels instead).
\param line the line
\param bufferDistance the desired distance in the same unit as line coordinates
\param numPoints the number of points that should be used to describe the curved corners of the buffer zone
\param ps to return the buffer zone: a set of polygons
\return Returns true if operation succeed otherwise returns false.
*/
TL_DLL bool TeBufferRegion(const TeLine2D& line, const double& bufferDistance, const unsigned int& numPoints, TePolygonSet& ps);
/** \brief Calculates a buffer region around a line.
\param line the line
\param bufferDistance the desired distance in the same unit as line coordinates
\param numPoints the number of points that should be used to describe the curved corners of the buffer zone
\param bufferLevels the number of buffer intervals
\param polVec to return the buffer zone: a vector of polygons
\return Returns true if operation succeed otherwise returns false.
*/
TL_DLL bool TeBufferRegion(const TeLine2D& line, const double& bufferDistance, const unsigned int& numPoints, const unsigned int& bufferLevels, vector<TePolygonSet>& polVec);
/** \brief Calculates a buffer region around a polygon (DEPRECATED: use TeBufferRegion with buffer levels instead).
\param pol the polygon
\param bufferDistance the desired distance in the same unit as polygon rings coordinates
\param numPoints the number of points that should be used to describe the curved corners of the buffer zone
\param ps to return the buffer zone: a set of polygons
\return Returns true if operation succeed otherwise returns false.
*/
TL_DLL bool TeBufferRegion(const TePolygon& pol, const double& bufferDistance, const unsigned int& numPoints, TePolygonSet& ps);
/** \brief Calculates a buffer region around a polygon (DEPRECATED: use TeBufferRegion with buffer levels instead).
\param pol the polygon
\param bufferDistance the desired distance in the same unit as polygon rings coordinates
\param numPoints the number of points that should be used to describe the curved corners of the buffer zone
\param bufferLevels the number of buffer intervals
\param buffType the buffer type: inside/outside/inside+outside
\param polsVec to return the buffer zone: a vector of polygon set
\return Returns true if operation succeed otherwise returns false.
*/
TL_DLL bool TeBufferRegion(const TePolygon& pol, const double& bufferDistance, const unsigned int& numPoints, const unsigned int& bufferLevels, const TeBufferType& buffType, vector<TePolygonSet>& polsVec);
/** \brief Calculates a buffer region around an object polygon set.
\param polSetIn the object polygon set
\param bufferDistance the desired distance in the same unit as polygon rings coordinates
\param numPoints the number of points that should be used to describe the curved corners of the buffer zone
\param bufferLevels the number of buffer intervals
\param bufferType the buffer type: inside/outside/inside+outside
\param polyVecOut to return the buffers of the object, each level in a position of the vector
\return Returns true if operation succeed otherwise returns false.
*/
TL_DLL bool TeBufferRegion(const TePolygonSet& polSetIn, const double& bufferDistance, const unsigned int& numPoints, const unsigned int& bufferLevels, const TeBufferType& bufferType, vector<TePolygonSet>& polyVecOut);
/** \brief Calculates a buffer region around an object line set.
\param lineSetIn the object line set
\param bufferDistance the desired distance in the same unit as lines coordinates
\param numPoints the number of points that should be used to describe the curved corners of the buffer zone
\param bufferLevels the number of buffer intervals
\param polyVecOut to return the buffers of the object, each level in a position of the vector
\return Returns true if operation succeed otherwise returns false.
*/
TL_DLL bool TeBufferRegion(const TeLineSet& lineSetIn, const double& bufferDistance, const unsigned int& numPoints, const unsigned int& bufferLevels, vector<TePolygonSet>& polyVecOut);
/** \brief Calculates a buffer region around an object point set.
\param pointSetIn the object point set
\param bufferDistance the desired distance in the same unit as points coordinates
\param numPoints the number of points that should be used to describe the curved corners of the buffer zone
\param bufferLevels the number of buffer intervals
\param polyVecOut to return the buffers of the object, each level in a position of the vector
\return Returns true if operation succeed otherwise returns false.
*/
TL_DLL bool TeBufferRegion(const TePointSet& pointSetIn, const double& bufferDistance, const unsigned int& numPoints, const unsigned int& bufferLevels, vector<TePolygonSet>& polyVecOut);
/** \brief Calculates a buffer region around an object cell set.
\param cellSetIn the object cell set
\param bufferDistance the desired distance in the same unit as cells coordinates
\param numPoints the number of points that should be used to describe the curved corners of the buffer zone
\param bufferLevels the number of buffer intervals
\param bufferType the buffer type: inside/outside/inside+outside
\param polyVecOut to return the buffers of the object, each level in a position of the vector
\return Returns true if operation succeed otherwise returns false.
*/
TL_DLL bool TeBufferRegion(const TeCellSet& cellSetIn, const double& bufferDistance, const unsigned int& numPoints, const unsigned int& bufferLevels, const TeBufferType& bufferType, vector<TePolygonSet>& polyVecOut);
} // end namespace TeBUFFER
#endif //__TERRALIB_INTERNAL_BUFFER_H
|