This file is indexed.

/usr/include/spatialite/gaiamatrix.h is in libspatialite-dev 4.3.0a-5build1.

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
187
188
189
190
191
192
193
194
195
196
197
198
199
200
201
202
203
204
205
206
207
208
209
210
211
212
213
214
215
216
217
218
219
220
221
222
223
224
225
226
227
228
229
230
231
232
233
234
235
236
237
238
239
240
241
242
243
244
245
246
247
248
249
250
251
252
253
254
255
256
257
258
259
260
261
262
263
264
265
266
267
268
269
270
271
272
273
274
275
276
277
/* 
 gaiamatrix.h -- Gaia common utility functions: affine trasform Matrix
  
 version 4.3, 2015 June 29

 Author: Sandro Furieri a.furieri@lqt.it

 ------------------------------------------------------------------------------
 
 Version: MPL 1.1/GPL 2.0/LGPL 2.1
 
 The contents of this file are subject to the Mozilla Public License Version
 1.1 (the "License"); you may not use this file except in compliance with
 the License. You may obtain a copy of the License at
 http://www.mozilla.org/MPL/
 
Software distributed under the License is distributed on an "AS IS" basis,
WITHOUT WARRANTY OF ANY KIND, either express or implied. See the License
for the specific language governing rights and limitations under the
License.

The Original Code is the SpatiaLite library

The Initial Developer of the Original Code is Alessandro Furieri
 
Portions created by the Initial Developer are Copyright (C) 2008-2015
the Initial Developer. All Rights Reserved.

Contributor(s):

Alternatively, the contents of this file may be used under the terms of
either the GNU General Public License Version 2 or later (the "GPL"), or
the GNU Lesser General Public License Version 2.1 or later (the "LGPL"),
in which case the provisions of the GPL or the LGPL are applicable instead
of those above. If you wish to allow use of your version of this file only
under the terms of either the GPL or the LGPL, and not to allow others to
use your version of this file under the terms of the MPL, indicate your
decision by deleting the provisions above and replace them with the notice
and other provisions required by the GPL or the LGPL. If you do not delete
the provisions above, a recipient may use your version of this file under
the terms of any one of the MPL, the GPL or the LGPL.
 
*/

/**
 \file gaiamatrix.h

 Auxiliary/helper functions
 */
#ifndef DOXYGEN_SHOULD_SKIP_THIS
#ifdef DLL_EXPORT
#define GAIAMATRIX_DECLARE __declspec(dllexport)
#else
#define GAIAMATRIX_DECLARE extern
#endif
#endif

#ifndef _GAIAMATRIX_H
#ifndef DOXYGEN_SHOULD_SKIP_THIS
#define _GAIAMATRIX_H
#endif

#ifdef __cplusplus
extern "C"
{
#endif

/**
 Typedef for gaiaAffineTransformMatrix object (opaque, hidden)

 \sa gaiaAffineTransformMatrixPtr
 */
    typedef struct priv_affine_transform gaiaAffineTransformMatrix;
/**
 Typedef for gaiaAffineTransformMatrixPtr object pointer (opaque, hidden)

 \sa gaiaAffineTransformMatrix
 */
    typedef gaiaAffineTransformMatrix *gaiaAffineTransformMatrixPtr;

/* function prototypes */

/**
 Creating a fully initialized BLOB-Matrix
 \param a XX component of the affine transformation.
 \param b XY component of the affine transformation.
 \param c XZ component of the affine transformation.
 \param d YX component of the affine transformation.
 \param e YY component of the affine transformation.
 \param f YZ component of the affine transformation.
 \param g ZX component of the affine transformation.
 \param h ZY component of the affine transformation.
 \param i ZZ component of the affine transformation.
 \param xoff X translation component of the affine transformation.
 \param yoff Y translation component of the affine transformation.
 \param zoff Z translation component of the affine transformation.
 \param blob on completion this variable will contain a BLOB-encoded
  affine transform Matrix
 \param blob_sz on completion this variable will contain the BLOB's size
  (in bytes)

 \return 0 on failure: any other different value on success.

 \sa gaia_matrix_is_valid, gaia_matrix_as_text, 
  gaia_matrix_multiply, gaia_matrix_create_multiply, 
  gaia_matrix_transform_geometry

 \note you are responsible to destroy (before or after) any BLOB
  returned by this function.
 */
    GAIAMATRIX_DECLARE int gaia_matrix_create (double a, double b, double c,
					       double d, double e, double f,
					       double g, double h, double i,
					       double xoff, double yoff,
					       double zoff,
					       unsigned char **blob,
					       int *blob_sz);

/**
 Creating a BLOB-Matrix by multiplying MatrixA by MatrixB
 \param iblob1 pointer to a BLOB-encoded Matrix A
 \param iblob1_sz A BLOB's size (in bytes)
 \param iblob2 pointer to a BLOB-encoded Matrix A
 \param iblob2_sz A BLOB's size (in bytes)
 \param blob on completion this variable will contain a BLOB-encoded
  affine transform Matrix
 \param blob_sz on completion this variable will contain the BLOB's size
  (in bytes)

 \return 0 on failure: any other different value on success.

 \sa gaia_matrix_create, gaia_matrix_is_valid, gaia_matrix_as_text, 
  gaia_matrix_create_multiply, gaia_matrix_transform_geometry,
  gaia_matrix_invert

 \note you are responsible to destroy (before or after) any BLOB
  returned by this function.
 */
    GAIAMATRIX_DECLARE int gaia_matrix_multiply (const unsigned char *iblob1,
						 int iblob1_sz,
						 const unsigned char *iblob2,
						 int iblob2_sz,
						 unsigned char **blob,
						 int *blob_sz);

/**
 Creating a BLOB-Matrix by applying a further trasformation to a previous BLOB-Matrix
 \param iblob pointer to a BLOB-encoded Matrix
 \param iblob_sz BLOB's size (in bytes)
 \param a XX component of the affine transformation.
 \param b XY component of the affine transformation.
 \param c XZ component of the affine transformation.
 \param d YX component of the affine transformation.
 \param e YY component of the affine transformation.
 \param f YZ component of the affine transformation.
 \param g ZX component of the affine transformation.
 \param h ZY component of the affine transformation.
 \param i ZZ component of the affine transformation.
 \param xoff X translation component of the affine transformation.
 \param yoff Y translation component of the affine transformation.
 \param zoff Z translation component of the affine transformation.
 \param blob on completion this variable will contain a BLOB-encoded
  affine transform Matrix
 \param blob_sz on completion this variable will contain the BLOB's size
  (in bytes)

 \return 0 on failure: any other different value on success.

 \sa gaia_matrix_create, gaia_matrix_is_valid, gaia_matrix_as_text, 
  gaia_matrix_multiply, gaia_matrix_transform_geometry

 \note you are responsible to destroy (before or after) any BLOB
  returned by this function.
 */
    GAIAMATRIX_DECLARE int gaia_matrix_create_multiply (const unsigned char
							*iblob, int iblob_sz,
							double a, double b,
							double c, double d,
							double e, double f,
							double g, double h,
							double i, double xoff,
							double yoff,
							double zoff,
							unsigned char **blob,
							int *blob_sz);

/**
 Testing a BLOB-Matrix for validity
 \param blob pointer to a BLOB-encoded Matrix
 \param blob_sz BLOB's size (in bytes)

 \return TRUE if the BLOB really is of the BLOB-Matrix type; FALSE if not.

 \sa gaia_matrix_create, gaia_matrix_as_text, 
  gaia_matrix_multiply, gaia_matrix_create_multiply, 
  gaia_matrix_transform_geometry
 */
    GAIAMATRIX_DECLARE int gaia_matrix_is_valid (const unsigned char *blob,
						 int blob_sz);

/**
 Printing a textual represention from a BLOB-Matrix
 \param blob pointer to a BLOB-encoded Matrix
 \param blob_sz BLOB's size (in bytes)

 \return a text string; NULL on failure.

 \sa gaia_matrix_create, gaia_matrix_is_valid, 
  gaia_matrix_multiply, gaia_matrix_create_multiply, 
  gaia_matrix_transform_geometry
 \note you are responsible to destroy (before or after) any text
  string returned by this function by calling sqlite3_free().
 */
    GAIAMATRIX_DECLARE char *gaia_matrix_as_text (const unsigned char *blob,
						  int blob_sz);

/**
 Transforming a Geometry accordingly to an Affine Transform Matrix
 \param geom the input Geometry
 \param blob pointer to a BLOB-encoded Matrix 
 \param blob_sz BLOB's size (in bytes)

 \return pointer to the transformed Geometry or NULL on failure.

 \sa gaia_matrix_create, gaia_matrix_is_valid, gaia_matrix_as_text, 
  gaia_matrix_multiply, gaia_matrix_create_multiply

 \note you are responsible to destroy (before or after) any Geometry
  returned by this function.
 */
    GAIAMATRIX_DECLARE gaiaGeomCollPtr
	gaia_matrix_transform_geometry (gaiaGeomCollPtr geom,
					const unsigned char *blob, int blob_sz);

/**
 Computing the Determinant from an Affine Transform Matrix
 \param blob pointer to a BLOB-encoded Matrix 
 \param blob_sz BLOB's size (in bytes)

 \return the Determinant of the Matix; 0.0 on invalid args.

 \sa gaia_matrix_create, gaia_matrix_is_valid, gaia_matrix_invert
 \note you are responsible to destroy (before or after) any Geometry
  returned by this function.
 */
    GAIAMATRIX_DECLARE double
	gaia_matrix_determinant (const unsigned char *blob, int blob_sz);

/**
 Creating a BLOB-Matrix by applying a further trasformation to a previous BLOB-Matrix
 \param iblob pointer to a BLOB-encoded Matrix
 \param iblob_sz BLOB's size (in bytes)
 \param blob on completion this variable will contain a BLOB-encoded
  affine transform Matrix (Inverse)
 \param blob_sz on completion this variable will contain the BLOB's size
  (in bytes)

 \return 0 on failure: any other different value on success.
 Note that not all Matrices can be Inverted, only those having
 a valid Determinant.

 \sa gaia_matrix_create, gaia_matrix_is_valid, gaia_matrix_multiply, 
 gaia_matrix_determinant

 \note you are responsible to destroy (before or after) any BLOB
  returned by this function.
 */
    GAIAMATRIX_DECLARE int gaia_matrix_invert (const unsigned char
					       *iblob, int iblob_sz,
					       unsigned char **blob,
					       int *blob_sz);

#ifdef __cplusplus
}
#endif

#endif				/* _GAIAMATRIX_H */