Panda3D
Loading...
Searching...
No Matches
xFileNode.h
Go to the documentation of this file.
1/**
2 * PANDA 3D SOFTWARE
3 * Copyright (c) Carnegie Mellon University. All rights reserved.
4 *
5 * All use of this software is subject to the terms of the revised BSD
6 * license. You should have received a copy of this license along
7 * with this source code in a file named "LICENSE."
8 *
9 * @file xFileNode.h
10 * @author drose
11 * @date 2004-10-03
12 */
13
14#ifndef XFILENODE_H
15#define XFILENODE_H
16
17#include "pandatoolbase.h"
18#include "typedObject.h"
19#include "referenceCount.h"
20#include "pointerTo.h"
21#include "namable.h"
22#include "pnotify.h"
23#include "pvector.h"
24#include "pmap.h"
25#include "luse.h"
26
27class XFile;
28class WindowsGuid;
30class XFileDataDef;
31class XFileDataObject;
32class XFileDataNode;
34class Filename;
35
36/**
37 * A single node of an X file. This may be either a template or a data node.
38 */
39class XFileNode : public TypedObject, public Namable,
40 virtual public ReferenceCount {
41protected:
42 INLINE XFileNode(XFile *x_file);
43
44public:
45 XFileNode(XFile *x_file, const std::string &name);
46 virtual ~XFileNode();
47
48 INLINE XFile *get_x_file() const;
49
50 INLINE int get_num_children() const;
51 INLINE XFileNode *get_child(int n) const;
52 XFileNode *find_child(const std::string &name) const;
53 int find_child_index(const std::string &name) const;
54 int find_child_index(const XFileNode *child) const;
55 XFileNode *find_descendent(const std::string &name) const;
56
57 INLINE int get_num_objects() const;
58 INLINE XFileDataNode *get_object(int n) const;
59
60 virtual bool has_guid() const;
61 virtual const WindowsGuid &get_guid() const;
62
63 virtual bool is_template_def() const;
64 virtual bool is_reference() const;
65 virtual bool is_object() const;
66 virtual bool is_standard_object(const std::string &template_name) const;
67
68 void add_child(XFileNode *node);
69 virtual void clear();
70
71 virtual void write_text(std::ostream &out, int indent_level) const;
72
74
75 virtual bool repack_data(XFileDataObject *object,
76 const XFileParseDataList &parse_data_list,
77 PrevData &prev_data,
78 size_t &index, size_t &sub_index) const;
79
80 virtual bool fill_zero_data(XFileDataObject *object) const;
81
82 virtual bool matches(const XFileNode *other) const;
83
84 // The following methods can be used to create instances of the standard
85 // template objects. These definitions match those defined in
86 // standardTemplates.x in this directory (and compiled into the executable).
87 XFileDataNode *add_Mesh(const std::string &name);
88 XFileDataNode *add_MeshNormals(const std::string &name);
89 XFileDataNode *add_MeshVertexColors(const std::string &name);
90 XFileDataNode *add_MeshTextureCoords(const std::string &name);
91 XFileDataNode *add_MeshMaterialList(const std::string &name);
92 XFileDataNode *add_Material(const std::string &name, const LColor &face_color,
93 double power, const LRGBColor &specular_color,
94 const LRGBColor &emissive_color);
95 XFileDataNode *add_TextureFilename(const std::string &name,
96 const Filename &filename);
97 XFileDataNode *add_Frame(const std::string &name);
98 XFileDataNode *add_FrameTransformMatrix(const LMatrix4d &mat);
99
100public:
101 static std::string make_nice_name(const std::string &str);
102
103protected:
104 XFile *_x_file;
105
106 typedef pvector< PT(XFileNode) > Children;
107 Children _children;
108
110 Objects _objects;
111
113 ChildrenByName _children_by_name;
114
115public:
116 static TypeHandle get_class_type() {
117 return _type_handle;
118 }
119 static void init_type() {
121 ReferenceCount::init_type();
122 register_type(_type_handle, "XFileNode",
123 TypedObject::get_class_type(),
124 ReferenceCount::get_class_type());
125 }
126 virtual TypeHandle get_type() const {
127 return get_class_type();
128 }
129 virtual TypeHandle force_init_type() {init_type(); return get_class_type();}
130
131private:
132 static TypeHandle _type_handle;
133
134 friend class XFileDataNodeReference;
135};
136
137#include "xFileNode.I"
138
139#endif
The name of a file, such as a texture file or an Egg file.
Definition filename.h:44
A base class for all things which can have a name.
Definition namable.h:26
A base class for all things that want to be reference-counted.
TypeHandle is the identifier used to differentiate C++ class types.
Definition typeHandle.h:81
This is an abstract class that all classes which use TypeHandle, and also provide virtual functions t...
Definition typedObject.h:88
static void init_type()
This function is declared non-inline to work around a compiler bug in g++ 2.96.
This is an implementation of the Windows GUID object, used everywhere as a world-unique identifier fo...
Definition windowsGuid.h:26
A definition of a single data element appearing within a template record.
This is a nested reference to an instance of a template object, declared via the syntax:
This is a node which contains all of the data elements defined by a template.
This is an abstract base class for an XFileNode which is also an XFileDataObject.
The abstract base class for a number of different types of data elements that may be stored in the X ...
A single node of an X file.
Definition xFileNode.h:40
virtual bool has_guid() const
Returns true if this node has a GUID associated.
int get_num_objects() const
Returns the list of child objects of this node.
Definition xFileNode.I:57
XFileNode * find_descendent(const std::string &name) const
Returns the first child or descendent found with the indicated name after a depth-first search,...
Definition xFileNode.cxx:99
XFileDataNode * add_Frame(const std::string &name)
Creates a new Frame instance, as a child of this node.
XFileDataNode * add_MeshTextureCoords(const std::string &name)
Creates a new MeshTextureCoords instance, as a child of this node.
virtual const WindowsGuid & get_guid() const
If has_guid() returned true, returns the particular GUID associated with this node.
int get_num_children() const
Returns the list of children of this node.
Definition xFileNode.I:37
virtual bool is_standard_object(const std::string &template_name) const
Returns true if this node represents an instance of the standard template with the indicated name,...
virtual void write_text(std::ostream &out, int indent_level) const
Writes a suitable representation of this node to an .x file in text mode.
virtual bool is_reference() const
Returns true if this node represents an indirect reference to an object defined previously in the fil...
XFileDataNode * add_TextureFilename(const std::string &name, const Filename &filename)
Creates a new TextureFilename instance, as a child of this node.
virtual bool is_template_def() const
Returns true if this node represents the definition of some template.
XFileDataNode * add_MeshVertexColors(const std::string &name)
Creates a new MeshVertexColors instance, as a child of this node.
XFileDataNode * add_Material(const std::string &name, const LColor &face_color, double power, const LRGBColor &specular_color, const LRGBColor &emissive_color)
Creates a new Material instance, as a child of this node.
void add_child(XFileNode *node)
Adds the indicated node as a child of this node.
XFileDataNode * add_MeshNormals(const std::string &name)
Creates a new MeshNormals instance, as a child of this node.
XFileDataNode * add_FrameTransformMatrix(const LMatrix4d &mat)
Creates a new FrameTransformMatrix instance, as a child of this node.
static std::string make_nice_name(const std::string &str)
Transforms the indicated egg name to a name that is acceptable for a node in the X File format.
XFileDataNode * get_object(int n) const
Returns the nth child object of this node.
Definition xFileNode.I:67
XFileNode * find_child(const std::string &name) const
Returns the child with the indicated name, if any, or NULL if none.
Definition xFileNode.cxx:55
virtual void clear()
Removes all children from the node, and otherwise resets it to its initial state.
virtual bool matches(const XFileNode *other) const
Returns true if the node, particularly a template node, is structurally equivalent to the other node ...
virtual bool repack_data(XFileDataObject *object, const XFileParseDataList &parse_data_list, PrevData &prev_data, size_t &index, size_t &sub_index) const
This is called on the template that defines an object, once the data for the object has been parsed.
XFileDataNode * add_MeshMaterialList(const std::string &name)
Creates a new MeshMaterialList instance, as a child of this node.
virtual bool is_object() const
Returns true if this node represents a data object that is the instance of some template,...
XFileNode * get_child(int n) const
Returns the nth child of this node.
Definition xFileNode.I:46
XFileDataNode * add_Mesh(const std::string &name)
Creates a new Mesh instance, as a child of this node.
virtual bool fill_zero_data(XFileDataObject *object) const
This is similar to repack_data(), except it is used to fill the initial values for a newly-created te...
int find_child_index(const std::string &name) const
Returns the index number of the child with the indicated name, if any, or -1 if none.
Definition xFileNode.cxx:70
A container for a pvector of the above objects.
This represents the complete contents of an X file (file.x) in memory.
Definition xFile.h:32
This is our own Panda specialization on the default STL map.
Definition pmap.h:49
This is our own Panda specialization on the default STL vector.
Definition pvector.h:42
PANDA 3D SOFTWARE Copyright (c) Carnegie Mellon University.
PANDA 3D SOFTWARE Copyright (c) Carnegie Mellon University.
PANDA 3D SOFTWARE Copyright (c) Carnegie Mellon University.
PANDA 3D SOFTWARE Copyright (c) Carnegie Mellon University.
PANDA 3D SOFTWARE Copyright (c) Carnegie Mellon University.
PANDA 3D SOFTWARE Copyright (c) Carnegie Mellon University.
PANDA 3D SOFTWARE Copyright (c) Carnegie Mellon University.
PANDA 3D SOFTWARE Copyright (c) Carnegie Mellon University.
void register_type(TypeHandle &type_handle, const std::string &name)
This inline function is just a convenient way to call TypeRegistry::register_type(),...
PANDA 3D SOFTWARE Copyright (c) Carnegie Mellon University.
PANDA 3D SOFTWARE Copyright (c) Carnegie Mellon University.