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
|
/****************************************************************************
* *
* 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_NODE_MANAGER_H
#define _XN_NODE_MANAGER_H
//---------------------------------------------------------------------------
// Includes
//---------------------------------------------------------------------------
#include <XnNode.h>
#include <IXnNodeAllocator.h>
#include <XnOS.h>
//---------------------------------------------------------------------------
// Types
//---------------------------------------------------------------------------
class XnList;
/**
* Node manager - a general pool of XnNode instances.
* The Node Manager is a Singleton, providing any interested party with XnNodes.
*/
class XnNodeManager : public INiNodeAllocator
{
public:
/**
* Get a reference to the single instance of the XnNodeManager
*/
static XnNodeManager* GetInstance();
/**
* Destructor. Destroy internal representations
*/
~XnNodeManager();
/**
* Provide an available XnNode from the pool
*
* @return NULL if no nodes are available and allocating new ones failed
*/
virtual XnNode* Allocate();
/**
* Release an XnNode to the pool
*
* @param pNode [in] The node to return to the pool
*/
virtual void Deallocate(XnNode* pNode);
protected:
/**
* Add more nodes to the pool.
*
* @param nDeltaSize [in] Number of new nodes required
*/
XnStatus Resize(XnUInt32 nDeltaSize);
/** 2 nodes for the internal XnList implementation */
XnNode m_InitialNodes[2];
/** pointer to the first available node in the pool */
XnNode* m_pFirstAvailable;
/** List of nodes. Each node's valus is a XnNode[] */
XnList* m_pAllNodes;
/** Initial size of the pool */
static const XnUInt32 nInitialSize;
/** Current capacity of the pool */
XnUInt32 m_nCurrentCapacity;
/** Number of nodes from the pool currently used */
XnUInt32 m_nCurrentOccupancy;
/** Number of nodes from the pool currently available */
XnUInt32 m_nCurrentAvailability;
/** Mutual exclusion lock */
XN_CRITICAL_SECTION_HANDLE m_hCriticalSection;
private:
/**
* Constructor. Initialize internal representations
*/
XnNodeManager();
/** Initialization state, to supply internal XnList implementation with the special Nodes */
enum {
XN_NM_INIT_STATE_CREATE_INTERNAL_LIST,
XN_NM_INIT_STATE_CREATE_FIRST_LINK,
XN_NM_INIT_STATE_DONE
} m_eInitializationState;
};
#endif // _XN_NODE_MANAGER_H
|
