/usr/include/bltVector.h is in blt-dev 2.5.3+dfsg-3.
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 | /*
* bltVector.h --
*
* Copyright 1993-2000 Lucent Technologies, Inc.
*
* Permission to use, copy, modify, and distribute this software and
* its documentation for any purpose and without fee is hereby
* granted, provided that the above copyright notice appear in all
* copies and that both that the copyright notice and warranty
* disclaimer appear in supporting documentation, and that the names
* of Lucent Technologies any of their entities not be used in
* advertising or publicity pertaining to distribution of the software
* without specific, written prior permission.
*
* Lucent Technologies disclaims all warranties with regard to this
* software, including all implied warranties of merchantability and
* fitness. In no event shall Lucent Technologies be liable for any
* special, indirect or consequential damages or any damages
* whatsoever resulting from loss of use, data or profits, whether in
* an action of contract, negligence or other tortuous action, arising
* out of or in connection with the use or performance of this
* software.
*/
#ifndef _BLT_VECTOR_H
#define _BLT_VECTOR_H
typedef enum {
BLT_VECTOR_NOTIFY_UPDATE = 1, /* The vector's values has been updated */
BLT_VECTOR_NOTIFY_DESTROY /* The vector has been destroyed and the client
* should no longer use its data (calling
* Blt_FreeVectorId) */
} Blt_VectorNotify;
typedef struct Blt_VectorIdStruct *Blt_VectorId;
typedef void (Blt_VectorChangedProc) _ANSI_ARGS_((Tcl_Interp *interp,
ClientData clientData, Blt_VectorNotify notify));
typedef struct {
double *valueArr; /* Array of values (possibly malloc-ed) */
int numValues; /* Number of values in the array */
int arraySize; /* Size of the allocated space */
double min, max; /* Minimum and maximum values in the vector */
int dirty; /* Indicates if the vector has been updated */
int reserved; /* Reserved for future use */
} Blt_Vector;
typedef double (Blt_VectorIndexProc) _ANSI_ARGS_((Blt_Vector * vecPtr));
typedef enum {
BLT_MATH_FUNC_SCALAR = 1, /* The function returns a single double
* precision value. */
BLT_MATH_FUNC_VECTOR, /* The function processes the entire vector. */
BLT_MATH_FUNC_MATRIX /* The function processes as a matrix. */
} Blt_MathFuncType;
/*
* To be safe, use the macros below, rather than the fields of the
* structure directly.
*
* The Blt_Vector is basically an opaque type. But it's also the
* actual memory address of the vector itself. I wanted to make the
* API as unobtrusive as possible. So instead of giving you a copy of
* the vector, providing various functions to access and update the
* vector, you get your hands on the actual memory (array of doubles)
* shared by all the vector's clients.
*
* The trade-off for speed and convenience is safety. You can easily
* break things by writing into the vector when other clients are
* using it. Use Blt_ResetVector to get around this. At least the
* macros are a reminder it isn't really safe to reset the data
* fields, except by the API routines.
*/
#define Blt_VecData(v) ((v)->valueArr)
#define Blt_VecLength(v) ((v)->numValues)
#define Blt_VecSize(v) ((v)->arraySize)
#define Blt_VecDirty(v) ((v)->dirty)
#ifndef USE_BLT_STUBS
EXTERN double Blt_VecMin _ANSI_ARGS_((Blt_Vector *vPtr));
EXTERN double Blt_VecMax _ANSI_ARGS_((Blt_Vector *vPtr));
EXTERN Blt_VectorId Blt_AllocVectorId _ANSI_ARGS_((Tcl_Interp *interp,
char *vecName));
EXTERN void Blt_SetVectorChangedProc _ANSI_ARGS_((Blt_VectorId clientId,
Blt_VectorChangedProc * proc, ClientData clientData));
EXTERN void Blt_FreeVectorId _ANSI_ARGS_((Blt_VectorId clientId));
EXTERN int Blt_GetVectorById _ANSI_ARGS_((Tcl_Interp *interp,
Blt_VectorId clientId, Blt_Vector **vecPtrPtr));
EXTERN char *Blt_NameOfVectorId _ANSI_ARGS_((Blt_VectorId clientId));
EXTERN char *Blt_NameOfVector _ANSI_ARGS_((Blt_Vector *vecPtr));
EXTERN int Blt_VectorNotifyPending _ANSI_ARGS_((Blt_VectorId clientId));
EXTERN int Blt_CreateVector _ANSI_ARGS_((Tcl_Interp *interp, char *vecName,
int size, Blt_Vector ** vecPtrPtr));
EXTERN int Blt_CreateVector2 _ANSI_ARGS_((Tcl_Interp *interp, char *vecName,
char *cmdName, char *varName, int size, Blt_Vector ** vecPtrPtr));
EXTERN int Blt_GetVector _ANSI_ARGS_((Tcl_Interp *interp, char *vecName,
Blt_Vector **vecPtrPtr));
EXTERN int Blt_VectorExists _ANSI_ARGS_((Tcl_Interp *interp, char *vecName));
EXTERN int Blt_ResetVector _ANSI_ARGS_((Blt_Vector *vecPtr, double *dataArr,
int nValues, int arraySize, Tcl_FreeProc *freeProc));
EXTERN int Blt_ResizeVector _ANSI_ARGS_((Blt_Vector *vecPtr, int nValues));
EXTERN int Blt_DeleteVectorByName _ANSI_ARGS_((Tcl_Interp *interp,
char *vecName));
EXTERN int Blt_DeleteVector _ANSI_ARGS_((Blt_Vector *vecPtr));
EXTERN int Blt_ExprVector _ANSI_ARGS_((Tcl_Interp *interp, char *expression,
Blt_Vector *vecPtr));
EXTERN void Blt_InstallIndexProc _ANSI_ARGS_((Tcl_Interp *interp,
char *indexName, Blt_VectorIndexProc * procPtr));
#else
#include "bltDecls.h"
#endif /* USE_BLT_STUBS */
#endif /* _BLT_VECTOR_H */
|