Open Inventor Release 2024.1.3
 
Loading...
Searching...
No Matches
SoMFNode.h
1/*=======================================================================
2 * Copyright 1991-1996, Silicon Graphics, Inc.
3 * ALL RIGHTS RESERVED
4 *
5 * UNPUBLISHED -- Rights reserved under the copyright laws of the United
6 * States. Use of a copyright notice is precautionary only and does not
7 * imply publication or disclosure.
8 *
9 * U.S. GOVERNMENT RESTRICTED RIGHTS LEGEND:
10 * Use, duplication or disclosure by the Government is subject to restrictions
11 * as set forth in FAR 52.227.19(c)(2) or subparagraph (c)(1)(ii) of the Rights
12 * in Technical Data and Computer Software clause at DFARS 252.227-7013 and/or
13 * in similar or successor clauses in the FAR, or the DOD or NASA FAR
14 * Supplement. Contractor/manufacturer is Silicon Graphics, Inc.,
15 * 2011 N. Shoreline Blvd. Mountain View, CA 94039-7311.
16 *
17 * THE CONTENT OF THIS WORK CONTAINS CONFIDENTIAL AND PROPRIETARY
18 * INFORMATION OF SILICON GRAPHICS, INC. ANY DUPLICATION, MODIFICATION,
19 * DISTRIBUTION, OR DISCLOSURE IN ANY FORM, IN WHOLE, OR IN PART, IS STRICTLY
20 * PROHIBITED WITHOUT THE PRIOR EXPRESS WRITTEN PERMISSION OF SILICON
21 * GRAPHICS, INC.
22**=======================================================================*/
23/*=======================================================================
24** Author : Paul S. Strauss (MMM yyyy)
25**=======================================================================*/
26/*=======================================================================
27 *** THE CONTENT OF THIS WORK IS PROPRIETARY TO FEI S.A.S, (FEI S.A.S.), ***
28 *** AND IS DISTRIBUTED UNDER A LICENSE AGREEMENT. ***
29 *** ***
30 *** REPRODUCTION, DISCLOSURE, OR USE, IN WHOLE OR IN PART, OTHER THAN AS ***
31 *** SPECIFIED IN THE LICENSE ARE NOT TO BE UNDERTAKEN EXCEPT WITH PRIOR ***
32 *** WRITTEN AUTHORIZATION OF FEI S.A.S. ***
33 *** ***
34 *** RESTRICTED RIGHTS LEGEND ***
35 *** USE, DUPLICATION, OR DISCLOSURE BY THE GOVERNMENT OF THE CONTENT OF THIS ***
36 *** WORK OR RELATED DOCUMENTATION IS SUBJECT TO RESTRICTIONS AS SET FORTH IN ***
37 *** SUBPARAGRAPH (C)(1) OF THE COMMERCIAL COMPUTER SOFTWARE RESTRICTED RIGHT ***
38 *** CLAUSE AT FAR 52.227-19 OR SUBPARAGRAPH (C)(1)(II) OF THE RIGHTS IN ***
39 *** TECHNICAL DATA AND COMPUTER SOFTWARE CLAUSE AT DFARS 52.227-7013. ***
40 *** ***
41 *** COPYRIGHT (C) 1996-2023 BY FEI S.A.S, ***
42 *** BORDEAUX, FRANCE ***
43 *** ALL RIGHTS RESERVED ***
44**=======================================================================*/
45/*=======================================================================
46** Modified by : VSG (MMM YYYY)
47**=======================================================================*/
48
49
50#ifndef _SO_MF_NODE_
51#define _SO_MF_NODE_
52
53class SoNode;
54
55#include <Inventor/fields/SoSubField.h>
56
58//
59// SoMFNode subclass of SoMField. Each field value is a pointer to an
60// SoNode. The field automatically maintains references to the nodes
61// it points to and propagates notification from the nodes.
62//
64
94class SoMFNode : public SoMField {
95
96 // Use standard field stuff
97 SO_MFIELD_REQUIRED_HEADER(SoMFNode);
98 SO_MFIELD_CONSTRUCTOR_HEADER(SoMFNode);
99 SO_MFIELD_VALUE_HEADER(SoMFNode, SoNode *, SoNode *);
100 SO_MFIELD_SETVALUESPOINTER_HEADER(SoNode *);
101
107 void addNode(SoNode *node);
108
115 void insertNode(SoNode *node, int newNodeIndex);
116
120 SoNode *getNode(int index) const;
121
125 int findNode(const SoNode *node) const;
126
130 int getNumNodes() const;
131
137 void removeNode(int index);
138
144 void removeNode(SoNode *node)
145 { removeNode(findNode(node)); }
146
153
157 void replaceNode(int index, SoNode *newNode);
158
162 void replaceNode(SoNode *oldNode, SoNode *newNode)
163 { replaceNode(findNode(oldNode), newNode); }
164
176
179
180 private:
181 static void initClass();
182 static void exitClass();
183
184 // Update a copied field to use the copy of each node if there is one
185 virtual void fixCopy(SbBool copyConnections);
186
187 // Override this to also check the stored nodes
188 virtual SbBool referencesCopy() const;
189
190private:
191 // Override this to maintain write-references in nodes
192 virtual void countWriteRefs(SoOutput *out) const;
193
194 // Changes value in field without doing other notification stuff.
195 // Keeps track of references and auditors.
196 void setVal(int index, SoNode *newValue);
197
198 SoNode** m_oldValues;
199 int m_oldNum;
200
201};
202
203#endif /* _SO_MF_NODE_ */
204
Multiple-value field containing any number of nodes.
Definition SoMFNode.h:94
void finishEditing()
Indicates that batch edits have finished.
void removeNode(SoNode *node)
Removes first instance of given node from group.
Definition SoMFNode.h:144
void replaceNode(SoNode *oldNode, SoNode *newNode)
Replaces first instance of given node with new node.
Definition SoMFNode.h:162
void removeAllNodes()
Removes all nodes from group.
int getNumNodes() const
Returns number of nodes.
int findNode(const SoNode *node) const
Finds index of given node within group.
void removeNode(int index)
Removes node with given index from group.
SoNode * getNode(int index) const
Returns pointer to nth node node.
void replaceNode(int index, SoNode *newNode)
Replaces node with given index with new node.
void addNode(SoNode *node)
Adds a node as last one in group.
void insertNode(SoNode *node, int newNodeIndex)
Adds a node so that it becomes the one with the given index.
SoNode ** startEditing()
Returns a pointer to the internally maintained array that can be modified.
Base class for all multiple-valued fields.
Definition SoMField.h:134
Abstract base class for all database nodes.
Definition SoNode.h:145
Used to write Open Inventor data files.
Definition SoOutput.h:186
int SbBool
Boolean type.
Definition SbBase.h:87