This is an abstract base class for an XFileNode which is also an XFileDataObject. More...
#include "xFileDataNode.h"
Public Member Functions | |
XFileDataNode (XFile *x_file, const std::string &name, XFileTemplate *xtemplate) | |
virtual TypeHandle | force_init_type () |
const XFileDataNode & | get_data_child (int n) const |
Since the children of an XFileDataNode are syntactically constrained to themselves be XFileDataNodes, this is a convenience function that returns the same thing as XFileNode::get_child(), but it is cast to a type XFileDataNode and dereferenced. More... | |
XFileTemplate * | get_template () const |
Returns the template used to define this data object. More... | |
const std::string & | get_template_name () const |
A convenience function to return the name of the template used to define this data object. More... | |
virtual TypeHandle | get_type () const |
virtual std::string | get_type_name () const |
Returns a string that represents the type of object this data object represents. More... | |
virtual bool | is_object () const |
Returns true if this node represents a data object that is the instance of some template, or false otherwise. More... | |
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, or false otherwise. More... | |
Public Member Functions inherited from XFileNode | |
XFileNode (XFile *x_file, const std::string &name) | |
void | add_child (XFileNode *node) |
Adds the indicated node as a child of this node. More... | |
XFileDataNode * | add_Frame (const std::string &name) |
Creates a new Frame instance, as a child of this node. More... | |
XFileDataNode * | add_FrameTransformMatrix (const LMatrix4d &mat) |
Creates a new FrameTransformMatrix instance, as a child of this node. More... | |
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. More... | |
XFileDataNode * | add_Mesh (const std::string &name) |
Creates a new Mesh instance, as a child of this node. More... | |
XFileDataNode * | add_MeshMaterialList (const std::string &name) |
Creates a new MeshMaterialList instance, as a child of this node. More... | |
XFileDataNode * | add_MeshNormals (const std::string &name) |
Creates a new MeshNormals instance, as a child of this node. More... | |
XFileDataNode * | add_MeshTextureCoords (const std::string &name) |
Creates a new MeshTextureCoords instance, as a child of this node. More... | |
XFileDataNode * | add_MeshVertexColors (const std::string &name) |
Creates a new MeshVertexColors instance, as a child of this node. More... | |
XFileDataNode * | add_TextureFilename (const std::string &name, const Filename &filename) |
Creates a new TextureFilename instance, as a child of this node. More... | |
virtual void | clear () |
Removes all children from the node, and otherwise resets it to its initial state. More... | |
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 template object to zero. More... | |
XFileNode * | find_child (const std::string &name) const |
Returns the child with the indicated name, if any, or NULL if none. More... | |
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. More... | |
int | find_child_index (const XFileNode *child) const |
Returns the index number of the indicated child, or -1 if none. More... | |
XFileNode * | find_descendent (const std::string &name) const |
Returns the first child or descendent found with the indicated name after a depth-first search, if any, or NULL if none. More... | |
XFileNode * | get_child (int n) const |
Returns the nth child of this node. More... | |
virtual const WindowsGuid & | get_guid () const |
If has_guid() returned true, returns the particular GUID associated with this node. More... | |
int | get_num_children () const |
Returns the list of children of this node. More... | |
int | get_num_objects () const |
Returns the list of child objects of this node. More... | |
XFileDataNode * | get_object (int n) const |
Returns the nth child object of this node. More... | |
XFile * | get_x_file () const |
virtual bool | has_guid () const |
Returns true if this node has a GUID associated. More... | |
virtual bool | is_reference () const |
Returns true if this node represents an indirect reference to an object defined previously in the file. More... | |
virtual bool | is_template_def () const |
Returns true if this node represents the definition of some template. More... | |
virtual bool | matches (const XFileNode *other) const |
Returns true if the node, particularly a template node, is structurally equivalent to the other node (which must be of the same type). More... | |
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. More... | |
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. More... | |
Public Member Functions inherited from TypedObject | |
TypedObject (const TypedObject ©)=default | |
TypedObject * | as_typed_object () |
Returns the object, upcast (if necessary) to a TypedObject pointer. More... | |
const TypedObject * | as_typed_object () const |
Returns the object, upcast (if necessary) to a TypedObject pointer. More... | |
int | get_best_parent_from_Set (const std::set< int > &) const |
int | get_type_index () const |
Returns the internal index number associated with this object's TypeHandle, a unique number for each different type. More... | |
bool | is_exact_type (TypeHandle handle) const |
Returns true if the current object is the indicated type exactly. More... | |
bool | is_of_type (TypeHandle handle) const |
Returns true if the current object is or derives from the indicated type. More... | |
TypedObject & | operator= (const TypedObject ©)=default |
Public Member Functions inherited from Namable | |
Namable (const std::string &initial_name="") | |
void | clear_name () |
Resets the Namable's name to empty. More... | |
const std::string & | get_name () const |
bool | has_name () const |
Returns true if the Namable has a nonempty name set, false if the name is empty. More... | |
void | output (std::ostream &out) const |
Outputs the Namable. More... | |
void | set_name (const std::string &name) |
Public Member Functions inherited from ReferenceCount | |
int | get_ref_count () const |
WeakReferenceList * | get_weak_list () const |
Returns the WeakReferenceList associated with this ReferenceCount object. More... | |
bool | has_weak_list () const |
Returns true if this particular ReferenceCount object has a WeakReferenceList created, false otherwise. More... | |
void | local_object () |
This function should be called, once, immediately after creating a new instance of some ReferenceCount-derived object on the stack. More... | |
void | ref () const |
Explicitly increments the reference count. More... | |
bool | ref_if_nonzero () const |
Atomically increases the reference count of this object if it is not zero. More... | |
bool | test_ref_count_integrity () const |
Does some easy checks to make sure that the reference count isn't completely bogus. More... | |
bool | test_ref_count_nonzero () const |
Does some easy checks to make sure that the reference count isn't zero, or completely bogus. More... | |
virtual bool | unref () const |
Explicitly decrements the reference count. More... | |
WeakReferenceList * | weak_ref () |
Adds the indicated PointerToVoid as a weak reference to this object. More... | |
void | weak_unref () |
Removes the indicated PointerToVoid as a weak reference to this object. More... | |
Public Member Functions inherited from XFileDataObject | |
XFileDataObject (const XFileDataDef *data_def=nullptr) | |
XFileDataObject & | add_Coords2d (XFile *x_file, const LVecBase2d &coords) |
Appends a new Coords2d instance. More... | |
XFileDataObject & | add_double (double double_value) |
Appends a new floating-point value to the data object, if it makes sense to do so. More... | |
virtual bool | add_element (XFileDataObject *element) |
Adds the indicated element as a nested data element, if this data object type supports it. More... | |
XFileDataObject & | add_IndexedColor (XFile *x_file, int index, const LColor &color) |
Appends a new IndexedColor instance. More... | |
XFileDataObject & | add_int (int int_value) |
Appends a new integer value to the data object, if it makes sense to do so. More... | |
XFileDataObject & | add_MeshFace (XFile *x_file) |
Appends a new MeshFace instance. More... | |
XFileDataObject & | add_string (const std::string &string_value) |
Appends a new string value to the data object, if it makes sense to do so. More... | |
XFileDataObject & | add_Vector (XFile *x_file, const LVecBase3d &vector) |
Appends a new Vector instance. More... | |
double | d () const |
Unambiguously returns the object's representation as a double, or 0.0 if the object has no double representation. More... | |
const XFileDataDef * | get_data_def () const |
Returns the data object that this object is represented by, if any, or NULL if there is none. More... | |
int | i () const |
Unambiguously returns the object's representation as an integer, or 0 if the object has no integer representation. More... | |
virtual bool | is_complex_object () const |
Returns true if this kind of data object is a complex object that can hold nested data elements, false otherwise. More... | |
LMatrix4d | mat4 () const |
Returns the object's representation as an LMatrix4d. More... | |
const XFileDataObject & | operator [] (int n) const |
Returns the nth nested object within this object. More... | |
const XFileDataObject & | operator [] (const std::string &name) const |
Returns the named nested object within this object. More... | |
XFileDataObject & | operator [] (int n) |
Returns the nth nested object within this object. More... | |
XFileDataObject & | operator [] (const std::string &name) |
Returns the named nested object within this object. More... | |
void | operator= (int int_value) |
Stores the indicated integer value into the object, if it makes sense to do so. More... | |
void | operator= (double double_value) |
Stores the indicated floating-point value into the object, if it makes sense to do so. More... | |
void | operator= (const std::string &string_value) |
Stores the indicated string value into the object, if it makes sense to do so. More... | |
void | operator= (const LVecBase2d &vec) |
Stores the indicated Vec2 value into the object, if it makes sense to do so. More... | |
void | operator= (const LVecBase3d &vec) |
Stores the indicated Vec3 value into the object, if it makes sense to do so. More... | |
void | operator= (const LVecBase4d &vec) |
Stores the indicated Vec4 value into the object, if it makes sense to do so. More... | |
void | operator= (const LMatrix4d &mat) |
Stores the indicated Matrix value into the object, if it makes sense to do so. More... | |
virtual void | output_data (std::ostream &out) const |
Writes a suitable representation of this node to an .x file in text mode. More... | |
std::string | s () const |
Unambiguously returns the object's representation as a string, or empty string if the object has no string representation. More... | |
void | set (int int_value) |
Stores the indicated integer value into the object, if it makes sense to do so. More... | |
void | set (double double_value) |
Stores the indicated floating-point value into the object, if it makes sense to do so. More... | |
void | set (const std::string &string_value) |
Stores the indicated string value into the object, if it makes sense to do so. More... | |
void | set (const LVecBase2d &vec) |
Stores the indicated Vec2 value into the object, if it makes sense to do so. More... | |
void | set (const LVecBase3d &vec) |
Stores the indicated Vec3 value into the object, if it makes sense to do so. More... | |
void | set (const LVecBase4d &vec) |
Stores the indicated Vec4 value into the object, if it makes sense to do so. More... | |
void | set (const LMatrix4d &mat) |
Stores the indicated Matrix value into the object, if it makes sense to do so. More... | |
int | size () const |
Returns the number of nested data objects within this object. More... | |
LVecBase2d | vec2 () const |
Returns the object's representation as an LVecBase2d. More... | |
LVecBase3d | vec3 () const |
Returns the object's representation as an LVecBase3d. More... | |
LVecBase4d | vec4 () const |
Returns the object's representation as an LVecBase4d. More... | |
virtual void | write_data (std::ostream &out, int indent_level, const char *separator) const |
Writes a suitable representation of this node to an .x file in text mode. More... | |
Static Public Member Functions | |
static TypeHandle | get_class_type () |
static void | init_type () |
Static Public Member Functions inherited from XFileNode | |
static TypeHandle | get_class_type () |
static void | init_type () |
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. More... | |
Static Public Member Functions inherited from TypedObject | |
static TypeHandle | get_class_type () |
static void | init_type () |
This function is declared non-inline to work around a compiler bug in g++ 2.96. More... | |
Static Public Member Functions inherited from Namable | |
static TypeHandle | get_class_type () |
static void | init_type () |
Static Public Member Functions inherited from ReferenceCount | |
static TypeHandle | get_class_type () |
static void | init_type () |
Static Public Member Functions inherited from XFileDataObject | |
static TypeHandle | get_class_type () |
static void | init_type () |
Additional Inherited Members | |
Public Types inherited from XFileNode | |
typedef pmap< const XFileDataDef *, XFileDataObject * > | PrevData |
Public Attributes inherited from TypedObject | |
get_type | |
Public Attributes inherited from Namable | |
get_name | |
set_name | |
Public Attributes inherited from ReferenceCount | |
get_ref_count | |
Returns the current reference count. More... | |
This is an abstract base class for an XFileNode which is also an XFileDataObject.
That is to say, objects that inherit from this class may be added to the toplevel X file graph as nodes, and they also may be containers for data elements.
Specifically, this is the base class of both XFileDataNodeTemplate and XFileDataNodeReference.
Definition at line 33 of file xFileDataNode.h.
|
inline |
Since the children of an XFileDataNode are syntactically constrained to themselves be XFileDataNodes, this is a convenience function that returns the same thing as XFileNode::get_child(), but it is cast to a type XFileDataNode and dereferenced.
Definition at line 21 of file xFileDataNode.I.
|
inline |
Returns the template used to define this data object.
Since the only classes to inherit from XFileDataNode are XFileDataNodeTemplate and XFileDataNodeReference, both of which represent a class that is defined by a template, it makes sense to put this common method here in the base class.
Definition at line 34 of file xFileDataNode.I.
|
inline |
A convenience function to return the name of the template used to define this data object.
Definition at line 43 of file xFileDataNode.I.
Referenced by XFileMesh::fill_mesh_child().
|
virtual |
Returns a string that represents the type of object this data object represents.
Reimplemented from XFileDataObject.
Definition at line 63 of file xFileDataNode.cxx.
|
virtual |
Returns true if this node represents a data object that is the instance of some template, or false otherwise.
This also returns true for references to objects (which are generally treated just like the objects themselves).
If this returns true, the node must be of type XFileDataNode (it is either an XFileDataNodeTemplate or an XFileDataNodeReference).
Reimplemented from XFileNode.
Definition at line 39 of file xFileDataNode.cxx.
|
virtual |
Returns true if this node represents an instance of the standard template with the indicated name, or false otherwise.
If this returns true, the object must be of type XFileDataNode.
Reimplemented from XFileNode.
Definition at line 49 of file xFileDataNode.cxx.
Referenced by XFileMesh::fill_mesh_child().