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
139
140
141
142
|
/*
*
* Copyright (C) 2000 Silicon Graphics, Inc. All Rights Reserved.
*
* This library 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 2.1 of the License, or (at your option) any later version.
*
* This library 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.
*
* Further, this software is distributed without any warranty that it is
* free of the rightful claim of any third person regarding infringement
* or the like. Any license provided herein, whether implied or
* otherwise, applies only to this software file. Patent licenses, if
* any, provided herein do not apply to combinations of this program with
* other software, or any other product whatsoever.
*
* You should have received a copy of the GNU Lesser General Public
* License along with this library; if not, write to the Free Software
* Foundation, Inc., 59 Temple Place, Suite 330, Boston, MA 02111-1307 USA
*
* Contact information: Silicon Graphics, Inc., 1600 Amphitheatre Pkwy,
* Mountain View, CA 94043, or:
*
* http://www.sgi.com
*
* For further information regarding this notice, see:
*
* http://oss.sgi.com/projects/GenInfo/NoticeExplan/
*
*/
// -*- C++ -*-
/*
* Copyright (C) 1990,91 Silicon Graphics, Inc.
*
_______________________________________________________________________
______________ S I L I C O N G R A P H I C S I N C . ____________
|
| $Revision $
|
| Description:
| This file defines the SoFile node class.
|
| Author(s) : Paul S. Strauss
|
______________ S I L I C O N G R A P H I C S I N C . ____________
_______________________________________________________________________
*/
#ifndef _SO_FILE_
#define _SO_FILE_
#include <Inventor/misc/SoChildList.h>
#include <Inventor/nodes/SoSubNode.h>
#include <Inventor/fields/SoSFString.h>
class SoSensor;
class SoFieldSensor;
//////////////////////////////////////////////////////////////////////////////
//
// Class: SoFile
//
// This node represents a subgraph that was read from a
// named input file. When a file node is written out, just the field
// containing the name of the file is written. (No children are
// written out.) When one is encountered during reading, reading
// continues from the named file, and all children found in the file
// are added as hidden children of this node.
//
// Whenever the name of the input file changes
// (name.setValue("foo.iv")), the old children are removed and the
// contents of the new file is read in. The file node remembers
// what directory the last file was read from, and will read the new
// file from the same directory after checking the standard list of
// directories (see the static methods on SoInput), assuming the
// field isn't set to an absolute path name.
//
//////////////////////////////////////////////////////////////////////////////
class SoGroup;
// C-api: public=name
class SoFile : public SoNode {
SO_NODE_HEADER(SoFile);
public:
// Fields
SoSFString name; // File name
// Constructor
SoFile();
// Method that returns a copy of the File node's children added to
// a group.
SoGroup *copyChildren() const;
SoEXTENDER public:
// Traversal methods for all the actions:
virtual void doAction(SoAction *action);
virtual void callback(SoCallbackAction *action);
virtual void GLRender(SoGLRenderAction *action);
virtual void getBoundingBox(SoGetBoundingBoxAction *action);
virtual void getMatrix(SoGetMatrixAction *action);
virtual void handleEvent(SoHandleEventAction *action);
virtual void pick(SoPickAction *action);
SoINTERNAL public:
static void initClass();
// Returns pointer to children
virtual SoChildList *getChildren() const;
// Copies the contents of the given node into this instance.
// This copies without re-reading the file.
virtual void copyContents(const SoFieldContainer *fromFC,
SbBool copyConnections);
protected:
// Reads stuff into instance of SoFile. Returns FALSE on error.
virtual SbBool readInstance(SoInput *in, unsigned short flags);
virtual ~SoFile();
private:
SoChildList children;
// These keep the image and filename fields in sync.
SoFieldSensor * nameChangedSensor;
static void nameChangedCB(void *, SoSensor *);
SbBool readOK; // FALSE on read error.
};
#endif /* _SO_FILE_ */
|
