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
|
/****************************************************************************
* *
* PrimeSense Sensor 5.x Alpha *
* Copyright (C) 2011 PrimeSense Ltd. *
* *
* This file is part of PrimeSense Sensor. *
* *
* PrimeSense Sensor 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. *
* *
* PrimeSense Sensor 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 PrimeSense Sensor. If not, see <http://www.gnu.org/licenses/>.*
* *
****************************************************************************/
#ifndef _XNV_CONTAINER_H_
#define _XNV_CONTAINER_H_
//---------------------------------------------------------------------------
// Includes
//---------------------------------------------------------------------------
#include <XnCore.h>
#include "XnVStatus.h"
//---------------------------------------------------------------------------
// Types
//---------------------------------------------------------------------------
/**
* This is a general container.
* It can either be initialized by the size it should be in, or by a buffer already
* allocated outside.
* All functionalities that change the size of the container are disabled if
* the buffer was supplied by the user.
*/
class XN_EE_CORE_API XnVContainer
{
public:
/**
* Create a new container, initializing the buffer it will use.
*
* @param [in] pBuffer The buffer in which to implement the container
* @param [in] nCapacity Maximum elements in the container
* @param [in] nElSize The size of each element
*/
XnVContainer(void* pBuffer, XnUInt32 nCapacity, XnUInt16 nElSize);
/**
* Create a new container, using a user-supplied buffer.
*
* @param [in] nCapacity Maximum elements in the container
* @param [in] nElSize The size of each element
*/
XnVContainer(XnUInt32 nCapacity, XnUInt16 nElSize);
virtual ~XnVContainer();
/**
* Change the buffer on which the container is implemented.
*
* @param [in] pBuffer The new buffer
* @param [in] nCapacity The buffer's capacity
*/
XnStatus ReAdjust(void* pBuffer, XnUInt32 nCapacity);
/**
* Change the buffer on which the container is implemented.
* This function works only on containers which allocated their own internal buffer.
*
* @param [in] nCapacity The new buffer's capacity
*/
XnStatus ReAdjust(XnUInt32 nCapacity);
XnStatus Add(void* pData); // copies size of nSize!
XnStatus SetAt(XnUInt32 nIndex, void* pData);
inline void* GetAt(XnUInt32 nPosition) const
{
return (XnChar*)m_pBuffer + nPosition * m_nElSize;
}
inline void* GetNext(void* pPrevious) const
{
return (XnChar*)pPrevious + m_nElSize;
}
inline void* GetPrevious(void* pOriginal) const
{
return (XnChar*)pOriginal - m_nElSize;
}
inline XnUInt32 GetSize() const
{
return m_nElCount;
}
inline XnUInt32 GetCapacity() const
{
return m_nCapacity;
}
inline void* Data()
{
return m_pBuffer;
}
inline const void* Data() const
{
return m_pBuffer;
}
inline XnBool IsExternal() const
{
return !m_bAllocated;
}
inline void Clear()
{
m_nElCount = 0;
}
inline XnUInt16 GetElSize() const
{
return m_nElSize;
}
protected:
XnStatus Resize(XnUInt32 nNewCapacity);
XnUInt16 m_nElSize;
XnUInt32 m_nCapacity;
XnUInt32 m_nElCount;
void* m_pBuffer;
XnBool m_bAllocated;
};
#endif //_XNV_CONTAINER_H_
|
