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
|
/****************************************************************************
* *
* OpenNI 1.x Alpha *
* Copyright (C) 2011 PrimeSense Ltd. *
* *
* This file is part of OpenNI. *
* *
* OpenNI 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 3 of the License, or *
* (at your option) any later version. *
* *
* OpenNI is distributed in the hope that it will be useful, *
* but WITHOUT ANY WARRANTY; without even the implied warranty of *
* MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the *
* GNU Lesser General Public License for more details. *
* *
* You should have received a copy of the GNU Lesser General Public License *
* along with OpenNI. If not, see <http://www.gnu.org/licenses/>. *
* *
****************************************************************************/
#ifndef __XN_GENERAL_BUFFER_H__
#define __XN_GENERAL_BUFFER_H__
//---------------------------------------------------------------------------
// Includes
//---------------------------------------------------------------------------
#include "XnPlatform.h"
#include "XnOS.h"
#include "XnStatusCodes.h"
//---------------------------------------------------------------------------
// Types
//---------------------------------------------------------------------------
/* Describes a general buffer. */
typedef struct XnGeneralBuffer
{
/* A pointer to the actual data. */
void* pData;
/* The size of the data in bytes. */
XnUInt32 nDataSize;
} XnGeneralBuffer;
//---------------------------------------------------------------------------
// Exported Functions
//---------------------------------------------------------------------------
/**
* Packs a pointer and a size into an XnGeneralBuffer struct.
*/
inline XnGeneralBuffer XnGeneralBufferPack(void* pData, XnUInt32 nDataSize)
{
XnGeneralBuffer result;
result.pData = pData;
result.nDataSize = nDataSize;
return result;
}
/**
* Copies one general buffer into another.
*/
inline XnStatus XnGeneralBufferCopy(XnGeneralBuffer* pDest, const XnGeneralBuffer* pSrc)
{
XN_VALIDATE_INPUT_PTR(pDest);
XN_VALIDATE_INPUT_PTR(pSrc);
if (pSrc->nDataSize > pDest->nDataSize)
return XN_STATUS_OUTPUT_BUFFER_OVERFLOW;
xnOSMemCopy(pDest->pData, pSrc->pData, pSrc->nDataSize);
pDest->nDataSize = pSrc->nDataSize;
return XN_STATUS_OK;
}
inline XnStatus XnGeneralBufferAlloc(XnGeneralBuffer* pDest, XnUInt32 nSize)
{
XN_VALIDATE_INPUT_PTR(pDest);
void* pData;
pData = xnOSMalloc(nSize);
XN_VALIDATE_ALLOC_PTR(pData);
pDest->pData = pData;
pDest->nDataSize = nSize;
return XN_STATUS_OK;
}
inline XnStatus XnGeneralBufferRealloc(XnGeneralBuffer* pDest, XnUInt32 nSize)
{
XN_VALIDATE_INPUT_PTR(pDest);
void* pData;
pData = xnOSRealloc(pDest, nSize);
XN_VALIDATE_ALLOC_PTR(pData);
pDest->pData = pData;
pDest->nDataSize = nSize;
return XN_STATUS_OK;
}
inline void XnGeneralBufferFree(XnGeneralBuffer* pDest)
{
XN_FREE_AND_NULL(pDest->pData);
pDest->nDataSize = 0;
}
//---------------------------------------------------------------------------
// Helper Macros
//---------------------------------------------------------------------------
#define XN_PACK_GENERAL_BUFFER(x) XnGeneralBufferPack(&x, sizeof(x))
#define XN_VALIDATE_GENERAL_BUFFER_TYPE(gb, t) \
if ((gb).nDataSize != sizeof(t)) \
{ \
return XN_STATUS_INVALID_BUFFER_SIZE; \
}
#endif //__XN_GENERAL_BUFFER_H__
|