Panda3D
Public Types | Public Member Functions | Static Public Member Functions | Public Attributes | Friends | List of all members
EggVertex Class Reference

Any one-, two-, three-, or four-component vertex, possibly with attributes such as a normal. More...

#include "eggVertex.h"

Inheritance diagram for EggVertex:
EggObject EggAttributes TypedReferenceCount MemoryBase TypedObject ReferenceCount MemoryBase MemoryBase

Public Types

typedef second_of_pair_iterator< AuxMap::const_iterator > aux_iterator
 
typedef AuxMap::size_type aux_size_type
 
typedef pmap< std::string, PT(EggVertexAux) > AuxMap
 
typedef aux_iterator const_aux_iterator
 
typedef uv_iterator const_uv_iterator
 
typedef pset< EggGroup * > GroupRef
 
typedef pmultiset< EggPrimitive * > PrimitiveRef
 
typedef second_of_pair_iterator< UVMap::const_iterator > uv_iterator
 
typedef UVMap::size_type uv_size_type
 
typedef pmap< std::string, PT(EggVertexUV) > UVMap
 

Public Member Functions

 EggVertex (const EggVertex &copy)
 Copies all properties of the vertex except its vertex pool, index number, and group membership. More...
 
const_aux_iterator aux_begin () const
 Returns an iterator that allows walking through the complete set of auxiliary data on the vertex. More...
 
const_aux_iterator aux_end () const
 Returns an iterator that allows walking through the complete set of auxiliary data on the vertex. More...
 
aux_size_type aux_size () const
 Returns the number of auxiliary datas on the vertex. More...
 
void clear_aux ()
 Removes all auxiliary data from the vertex. More...
 
void clear_aux (const std::string &name)
 Removes the named auxiliary data from the vertex. More...
 
void clear_grefs ()
 Removes all group references from the vertex, so that it is not assigned to any group. More...
 
void clear_uv ()
 Removes all UV coordinate pairs from the vertex. More...
 
void clear_uv (const std::string &name)
 Removes the named UV coordinate pair from the vertex, along with any UV morphs. More...
 
int compare_to (const EggVertex &other) const
 An ordering operator to compare two vertices for sorting order. More...
 
void copy_grefs_from (const EggVertex &other)
 Copies all the group references from the other vertex onto this one. More...
 
virtual TypeHandle force_init_type ()
 
const LVecBase4d & get_aux (const std::string &name) const
 Returns the named auxiliary data quadruple on the vertex. More...
 
const EggVertexAuxget_aux_obj (const std::string &name) const
 Returns the named EggVertexAux object, which defines the auxiliary data for this name. More...
 
int get_external_index () const
 Returns the number set by set_external_index(). More...
 
int get_external_index2 () const
 Returns the number set by set_external_index2(). More...
 
int get_index () const
 Returns the index number of the vertex within its pool. More...
 
int get_num_dimensions () const
 Returns the number of dimensions the vertex uses. More...
 
int get_num_global_coord () const
 Returns the number of primitives that own this vertex whose vertices are interpreted in the global coordinate system. More...
 
int get_num_local_coord () const
 Returns the number of primitives that own this vertex whose vertices are interpreted to be in a local coordinate system. More...
 
EggVertexPoolget_pool () const
 Returns the vertex pool this vertex belongs in. More...
 
double get_pos1 () const
 Only valid if get_num_dimensions() returns 1. More...
 
LPoint2d get_pos2 () const
 Only valid if get_num_dimensions() returns 2. More...
 
LVertexd get_pos3 () const
 Valid if get_num_dimensions() returns 3 or 4. More...
 
LPoint4d get_pos4 () const
 This is always valid, regardless of the value of get_num_dimensions. More...
 
virtual TypeHandle get_type () const
 
LTexCoordd get_uv () const
 Returns the unnamed UV coordinate pair on the vertex. More...
 
LTexCoordd get_uv (const std::string &name) const
 Returns the named UV coordinate pair on the vertex. More...
 
const EggVertexUVget_uv_obj (const std::string &name) const
 Returns the named EggVertexUV object, which defines both the UV coordinate pair for this name and the UV morphs. More...
 
const LTexCoord3d & get_uvw (const std::string &name) const
 Returns the named UV coordinate triple on the vertex. More...
 
GroupRef::const_iterator gref_begin () const
 Returns an iterator that can, in conjunction with gref_end(), be used to traverse the entire set of groups that reference this vertex. More...
 
GroupRef::const_iterator gref_end () const
 Returns an iterator that can, in conjunction with gref_begin(), be used to traverse the entire set of groups that reference this vertex. More...
 
GroupRef::size_type gref_size () const
 Returns the number of elements between gref_begin() and gref_end(). More...
 
bool has_aux () const
 Returns true if the vertex has any auxiliary data, false otherwise. More...
 
bool has_aux (const std::string &name) const
 Returns true if the vertex has the named auxiliary data quadruple. More...
 
bool has_gref (const EggGroup *group) const
 Returns true if the indicated group references this vertex, false otherwise. More...
 
int has_pref (const EggPrimitive *prim) const
 Returns the number of times the vertex appears in the indicated primitive, or 0 if it does not appear. More...
 
bool has_uv () const
 Returns true if the vertex has an unnamed UV coordinate pair, false otherwise. More...
 
bool has_uv (const std::string &name) const
 Returns true if the vertex has the named UV coordinate pair, and the named UV coordinate pair is 2-d, false otherwise. More...
 
bool has_uvw (const std::string &name) const
 Returns true if the vertex has the named UV coordinate triple, and the named UV coordinate triple is 3-d, false otherwise. More...
 
bool is_forward_reference () const
 Returns true if the vertex is a forward reference to some vertex that hasn't been defined yet. More...
 
EggVertexAuxmodify_aux_obj (const std::string &name)
 Returns a modifiable pointer to the named EggVertexAux object, which defines the auxiliary data for this name. More...
 
EggVertexUVmodify_uv_obj (const std::string &name)
 Returns a modifiable pointer to the named EggVertexUV object, which defines both the UV coordinate pair for this name and the UV morphs. More...
 
EggVertexoperator= (const EggVertex &copy)
 Copies all properties of the vertex except its vertex pool, index number, and group membership. More...
 
void output (std::ostream &out) const
 
PrimitiveRef::const_iterator pref_begin () const
 Returns an iterator that can, in conjunction with pref_end(), be used to traverse the entire set of primitives that reference this vertex. More...
 
PrimitiveRef::const_iterator pref_end () const
 Returns an iterator that can, in conjunction with pref_begin(), be used to traverse the entire set of primitives that reference this vertex. More...
 
PrimitiveRef::size_type pref_size () const
 Returns the number of elements between pref_begin() and pref_end(). More...
 
void set_aux (const std::string &name, const LVecBase4d &aux)
 Sets the indicated auxiliary data quadruple on the vertex. More...
 
void set_aux_obj (EggVertexAux *vertex_aux)
 Sets the indicated EggVertexAux on the vertex. More...
 
void set_external_index (int external_index)
 Sets a special index number that is associated with the EggVertex (but is not written to the egg file). More...
 
void set_external_index2 (int external_index2)
 Similar to set_external_index(), but this is a different number which may be used for a different purpose by the calling code. More...
 
void set_pos (double pos)
 Sets the vertex position. More...
 
void set_pos (const LPoint2d &pos)
 Sets the vertex position. More...
 
void set_pos (const LPoint3d &pos)
 Sets the vertex position. More...
 
void set_pos (const LPoint4d &pos)
 Sets the vertex position. More...
 
void set_pos4 (const LPoint4d &pos)
 This special flavor of set_pos() sets the vertex as a four-component value, but does not change the set number of dimensions. More...
 
void set_uv (const LTexCoordd &texCoord)
 Replaces the unnamed UV coordinate pair on the vertex with the indicated value. More...
 
void set_uv (const std::string &name, const LTexCoordd &texCoord)
 Sets the indicated UV coordinate pair on the vertex. More...
 
void set_uv_obj (EggVertexUV *vertex_uv)
 Sets the indicated EggVertexUV on the vertex. More...
 
void set_uvw (const std::string &name, const LTexCoord3d &texCoord)
 Sets the indicated UV coordinate triple on the vertex. More...
 
bool sorts_less_than (const EggVertex &other) const
 An ordering operator to compare two vertices for sorting order. More...
 
void test_gref_integrity () const
 
void test_pref_integrity () const
 
void transform (const LMatrix4d &mat)
 Applies the indicated transformation matrix to the vertex. More...
 
const_uv_iterator uv_begin () const
 Returns an iterator that allows walking through the complete set of named UV's on the vertex. More...
 
const_uv_iterator uv_end () const
 Returns an iterator that allows walking through the complete set of named UV's on the vertex. More...
 
uv_size_type uv_size () const
 Returns the number of named UV's on the vertex. More...
 
void write (std::ostream &out, int indent_level) const
 Writes the vertex to the indicated output stream in Egg format. More...
 
- Public Member Functions inherited from EggObject
 EggObject (const EggObject &copy)
 
virtual EggTransformas_transform ()
 Returns this object cross-cast to an EggTransform pointer, if it inherits from EggTransform, or NULL if it does not. More...
 
void clear_user_data ()
 Removes *all* user data pointers from the node. More...
 
void clear_user_data (TypeHandle type)
 Removes the user data pointer of the indicated type. More...
 
EggUserDataget_user_data () const
 Returns the user data pointer most recently stored on this object, or NULL if nothing was previously stored. More...
 
EggUserDataget_user_data (TypeHandle type) const
 Returns the user data pointer of the indicated type, if it exists, or NULL if it does not. More...
 
bool has_user_data () const
 Returns true if a generic user data pointer has recently been set and not yet cleared, false otherwise. More...
 
bool has_user_data (TypeHandle type) const
 Returns true if the user data pointer of the indicated type has been set, false otherwise. More...
 
EggObjectoperator= (const EggObject &copy)
 
void set_user_data (EggUserData *user_data)
 Sets the user data associated with this object. More...
 
- Public Member Functions inherited from TypedReferenceCount
 TypedReferenceCount (const TypedReferenceCount &copy)
 
void operator= (const TypedReferenceCount &copy)
 
- Public Member Functions inherited from TypedObject
 TypedObject (const TypedObject &copy)=default
 
TypedObjectas_typed_object ()
 Returns the object, upcast (if necessary) to a TypedObject pointer. More...
 
const TypedObjectas_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...
 
TypedObjectoperator= (const TypedObject &copy)=default
 
- Public Member Functions inherited from ReferenceCount
int get_ref_count () const
 
WeakReferenceListget_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...
 
WeakReferenceListweak_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 EggAttributes
 EggAttributes (const EggAttributes &copy)
 
void clear_color ()
 
void clear_normal ()
 
int compare_to (const EggAttributes &other) const
 An ordering operator to compare two vertices for sorting order. More...
 
void copy_color (const EggAttributes &other)
 Sets this color to be the same as the other's, include morphs. More...
 
void copy_normal (const EggAttributes &other)
 Sets this normal to be the same as the other's, include morphs. More...
 
LColor get_color () const
 Returns the color set on this particular attribute. More...
 
const LNormald & get_normal () const
 
bool has_color () const
 
bool has_normal () const
 
bool matches_color (const EggAttributes &other) const
 Returns true if this color matches that of the other EggAttributes object, include the morph list. More...
 
bool matches_normal (const EggAttributes &other) const
 Returns true if this normal matches that of the other EggAttributes object, include the morph list. More...
 
EggAttributesoperator= (const EggAttributes &copy)
 
void set_color (const LColor &Color)
 
void set_normal (const LNormald &normal)
 
bool sorts_less_than (const EggAttributes &other) const
 An ordering operator to compare two vertices for sorting order. More...
 
void transform (const LMatrix4d &mat)
 Applies the indicated transformation matrix to the attributes. More...
 
void write (std::ostream &out, int indent_level) const
 Writes the attributes to the indicated output stream in Egg format. More...
 

Static Public Member Functions

static TypeHandle get_class_type ()
 
static void init_type ()
 
static PT (EggVertex) make_average(const EggVertex *first
 
- Static Public Member Functions inherited from EggObject
static TypeHandle get_class_type ()
 
static void init_type ()
 
- Static Public Member Functions inherited from TypedReferenceCount
static TypeHandle get_class_type ()
 
static void init_type ()
 
- 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 ReferenceCount
static TypeHandle get_class_type ()
 
static void init_type ()
 
- Static Public Member Functions inherited from EggAttributes
static TypeHandle get_class_type ()
 
static void init_type ()
 

Public Attributes

EggMorphVertexList _dxyzs
 
static const EggVertexsecond
 
- Public Attributes inherited from TypedObject
 get_type
 
- Public Attributes inherited from ReferenceCount
 get_ref_count
 Returns the current reference count. More...
 
- Public Attributes inherited from EggAttributes
EggMorphNormalList _dnormals
 
EggMorphColorList _drgbas
 

Friends

class EggGroup
 
class EggPrimitive
 
class EggVertexPool
 

Detailed Description

Any one-, two-, three-, or four-component vertex, possibly with attributes such as a normal.

Definition at line 39 of file eggVertex.h.

Constructor & Destructor Documentation

◆ EggVertex()

EggVertex::EggVertex ( const EggVertex copy)

Copies all properties of the vertex except its vertex pool, index number, and group membership.

Definition at line 55 of file eggVertex.cxx.

Member Function Documentation

◆ aux_begin()

EggVertex::const_aux_iterator EggVertex::aux_begin ( ) const
inline

Returns an iterator that allows walking through the complete set of auxiliary data on the vertex.

This interface is not safe to use outside of PANDAEGG.DLL.

Definition at line 231 of file eggVertex.I.

Referenced by EggVertexPool::get_aux_names().

◆ aux_end()

EggVertex::const_aux_iterator EggVertex::aux_end ( ) const
inline

Returns an iterator that allows walking through the complete set of auxiliary data on the vertex.

This interface is not safe to use outside of PANDAEGG.DLL.

Definition at line 253 of file eggVertex.I.

Referenced by EggVertexPool::get_aux_names().

◆ aux_size()

EggVertex::aux_size_type EggVertex::aux_size ( ) const
inline

Returns the number of auxiliary datas on the vertex.

Definition at line 269 of file eggVertex.I.

◆ clear_aux() [1/2]

void EggVertex::clear_aux ( )
inline

Removes all auxiliary data from the vertex.

Definition at line 209 of file eggVertex.I.

◆ clear_aux() [2/2]

void EggVertex::clear_aux ( const std::string &  name)

Removes the named auxiliary data from the vertex.

Definition at line 338 of file eggVertex.cxx.

◆ clear_grefs()

void EggVertex::clear_grefs ( )

Removes all group references from the vertex, so that it is not assigned to any group.

Definition at line 772 of file eggVertex.cxx.

Referenced by copy_grefs_from(), and EggVertexPool::remove_unused_vertices().

◆ clear_uv() [1/2]

void EggVertex::clear_uv ( )
inline

Removes all UV coordinate pairs from the vertex.

Definition at line 201 of file eggVertex.I.

◆ clear_uv() [2/2]

void EggVertex::clear_uv ( const std::string &  name)

Removes the named UV coordinate pair from the vertex, along with any UV morphs.

Definition at line 330 of file eggVertex.cxx.

References EggVertexUV::filter_name().

◆ compare_to()

int EggVertex::compare_to ( const EggVertex other) const

An ordering operator to compare two vertices for sorting order.

This imposes an arbitrary ordering useful to identify unique vertices.

Group membership is not considered in this comparison. This is somewhat problematic, but cannot easily be helped, because considering group membership would make it difficult to add and remove groups from vertices. It also makes it impossible to meaningfully compare with a concrete EggVertex object (which cannot have group memberships).

However, this is not altogether bad, because two vertices that are identical in all other properties should generally also be identical in group memberships, else the vertices will tend to fly apart when the joints animate.

Definition at line 553 of file eggVertex.cxx.

Referenced by sorts_less_than().

◆ copy_grefs_from()

void EggVertex::copy_grefs_from ( const EggVertex other)

Copies all the group references from the other vertex onto this one.

This assigns the current vertex to exactly the same groups, with exactly the same memberships, as the given one.

Warning: only an EggVertex allocated from the free store may have groups assigned to it. Do not attempt to call this on a temporary concrete EggVertex object; a core dump will certainly result.

Definition at line 747 of file eggVertex.cxx.

References clear_grefs(), gref_begin(), and gref_end().

◆ get_aux()

const LVecBase4d & EggVertex::get_aux ( const std::string &  name) const

Returns the named auxiliary data quadruple on the vertex.

It is an error to call this if has_aux(name) returned false.

Definition at line 174 of file eggVertex.cxx.

◆ get_aux_obj()

const EggVertexAux * EggVertex::get_aux_obj ( const std::string &  name) const

Returns the named EggVertexAux object, which defines the auxiliary data for this name.

This object might be shared between multiple vertices. You should not attempt to modify this object; instead, call modify_aux_object to return a modifiable pointer.

Definition at line 260 of file eggVertex.cxx.

◆ get_external_index()

int EggVertex::get_external_index ( ) const
inline

Returns the number set by set_external_index().

See set_external_index().

Definition at line 300 of file eggVertex.I.

◆ get_external_index2()

int EggVertex::get_external_index2 ( ) const
inline

Returns the number set by set_external_index2().

See set_external_index2().

Definition at line 319 of file eggVertex.I.

◆ get_index()

int EggVertex::get_index ( ) const
inline

Returns the index number of the vertex within its pool.

Definition at line 277 of file eggVertex.I.

◆ get_num_dimensions()

int EggVertex::get_num_dimensions ( ) const
inline

Returns the number of dimensions the vertex uses.

Usually this will be 3, but it may be 1, 2, 3, or 4.

Definition at line 99 of file eggVertex.I.

Referenced by EggVertexPool::get_num_dimensions().

◆ get_num_global_coord()

int EggVertex::get_num_global_coord ( ) const

Returns the number of primitives that own this vertex whose vertices are interpreted in the global coordinate system.

Definition at line 654 of file eggVertex.cxx.

References EggNode::is_local_coord(), pref_begin(), and pref_end().

◆ get_num_local_coord()

int EggVertex::get_num_local_coord ( ) const

Returns the number of primitives that own this vertex whose vertices are interpreted to be in a local coordinate system.

Definition at line 636 of file eggVertex.cxx.

References EggNode::is_local_coord(), pref_begin(), and pref_end().

◆ get_pool()

EggVertexPool * EggVertex::get_pool ( ) const
inline

Returns the vertex pool this vertex belongs in.

This may be NULL if the vertex has not been added to a pool.

Definition at line 19 of file eggVertex.I.

Referenced by PT(), and split_vertex().

◆ get_pos1()

double EggVertex::get_pos1 ( ) const
inline

Only valid if get_num_dimensions() returns 1.

Returns the position as a one-dimensional value.

Definition at line 109 of file eggVertex.I.

◆ get_pos2()

LPoint2d EggVertex::get_pos2 ( ) const
inline

Only valid if get_num_dimensions() returns 2.

Returns the position as a two-dimensional value.

Definition at line 120 of file eggVertex.I.

◆ get_pos3()

LVertexd EggVertex::get_pos3 ( ) const
inline

Valid if get_num_dimensions() returns 3 or 4.

Returns the position as a three-dimensional value.

Definition at line 131 of file eggVertex.I.

Referenced by EggMesherEdge::compute_box(), EggMesherEdge::compute_length(), and XFileVertex::set_from_egg().

◆ get_pos4()

LPoint4d EggVertex::get_pos4 ( ) const
inline

This is always valid, regardless of the value of get_num_dimensions.

It returns the position as a four-dimensional value. If the pos has fewer than four dimensions, this value represents the pos extended into four- dimensional homogenous space, e.g. by adding 1 as the fourth component.

Definition at line 145 of file eggVertex.I.

◆ get_uv() [1/2]

LTexCoordd EggVertex::get_uv ( ) const
inline

Returns the unnamed UV coordinate pair on the vertex.

It is an error to call this if has_uv() has returned false.

This is the more restrictive interface, and is generally useful only in the absence of multitexturing; see get_uv(name) for the interface that supports multitexturing.

Definition at line 179 of file eggVertex.I.

◆ get_uv() [2/2]

LTexCoordd EggVertex::get_uv ( const std::string &  name) const

Returns the named UV coordinate pair on the vertex.

It is an error to call this if has_uv(name) returned false.

Definition at line 152 of file eggVertex.cxx.

References EggVertexUV::filter_name().

◆ get_uv_obj()

const EggVertexUV * EggVertex::get_uv_obj ( const std::string &  name) const

Returns the named EggVertexUV object, which defines both the UV coordinate pair for this name and the UV morphs.

This object might be shared between multiple vertices. You should not attempt to modify this object; instead, call modify_uv_object to return a modifiable pointer.

Definition at line 245 of file eggVertex.cxx.

References EggVertexUV::filter_name().

◆ get_uvw()

const LTexCoord3d & EggVertex::get_uvw ( const std::string &  name) const

Returns the named UV coordinate triple on the vertex.

It is an error to call this if has_uvw(name) returned false.

Definition at line 163 of file eggVertex.cxx.

References EggVertexUV::filter_name().

◆ gref_begin()

EggVertex::GroupRef::const_iterator EggVertex::gref_begin ( ) const

Returns an iterator that can, in conjunction with gref_end(), be used to traverse the entire set of groups that reference this vertex.

Each iterator returns a pointer to a group.

This interface is not safe to use outside of PANDAEGG.DLL.

Definition at line 702 of file eggVertex.cxx.

Referenced by copy_grefs_from(), and split_vertex().

◆ gref_end()

EggVertex::GroupRef::const_iterator EggVertex::gref_end ( ) const

Returns an iterator that can, in conjunction with gref_begin(), be used to traverse the entire set of groups that reference this vertex.

Each iterator returns a pointer to a group.

This interface is not safe to use outside of PANDAEGG.DLL.

Definition at line 714 of file eggVertex.cxx.

Referenced by copy_grefs_from(), and split_vertex().

◆ gref_size()

EggVertex::GroupRef::size_type EggVertex::gref_size ( ) const

Returns the number of elements between gref_begin() and gref_end().

This interface is not safe to use outside of PANDAEGG.DLL.

Definition at line 724 of file eggVertex.cxx.

◆ has_aux() [1/2]

bool EggVertex::has_aux ( ) const
inline

Returns true if the vertex has any auxiliary data, false otherwise.

Definition at line 166 of file eggVertex.I.

Referenced by EggVertexPool::has_aux().

◆ has_aux() [2/2]

bool EggVertex::has_aux ( const std::string &  name) const

Returns true if the vertex has the named auxiliary data quadruple.

Definition at line 142 of file eggVertex.cxx.

◆ has_gref()

bool EggVertex::has_gref ( const EggGroup group) const

Returns true if the indicated group references this vertex, false otherwise.

Definition at line 733 of file eggVertex.cxx.

◆ has_pref()

int EggVertex::has_pref ( const EggPrimitive prim) const

Returns the number of times the vertex appears in the indicated primitive, or 0 if it does not appear.

Definition at line 824 of file eggVertex.cxx.

◆ has_uv() [1/2]

bool EggVertex::has_uv ( ) const
inline

Returns true if the vertex has an unnamed UV coordinate pair, false otherwise.

This is the more restrictive interface, and is generally useful only in the absence of multitexturing; see has_uv(name) for the interface that supports multitexturing.

Definition at line 158 of file eggVertex.I.

Referenced by EggVertexPool::has_uvs().

◆ has_uv() [2/2]

bool EggVertex::has_uv ( const std::string &  name) const

Returns true if the vertex has the named UV coordinate pair, and the named UV coordinate pair is 2-d, false otherwise.

Definition at line 115 of file eggVertex.cxx.

References EggVertexUV::filter_name(), and EggVertexUV::has_w().

◆ has_uvw()

bool EggVertex::has_uvw ( const std::string &  name) const

Returns true if the vertex has the named UV coordinate triple, and the named UV coordinate triple is 3-d, false otherwise.

Definition at line 129 of file eggVertex.cxx.

References EggVertexUV::filter_name(), and EggVertexUV::has_w().

◆ is_forward_reference()

bool EggVertex::is_forward_reference ( ) const
inline

Returns true if the vertex is a forward reference to some vertex that hasn't been defined yet.

In this case, the vertex may not have any properties filled in yet.

This can only happen if you implicitly create a vertex via EggVertexPool::get_forward_vertex(). Presumably, when the vertex pool is later filled in, this vertex will be replaced with real data.

Definition at line 33 of file eggVertex.I.

Referenced by EggVertexPool::get_vertex(), EggVertexPool::has_defined_vertices(), and EggVertexPool::has_forward_vertices().

◆ modify_aux_obj()

EggVertexAux * EggVertex::modify_aux_obj ( const std::string &  name)

Returns a modifiable pointer to the named EggVertexAux object, which defines the auxiliary data for this name.

Returns NULL if there is no such named UV object.

Definition at line 293 of file eggVertex.cxx.

◆ modify_uv_obj()

EggVertexUV * EggVertex::modify_uv_obj ( const std::string &  name)

Returns a modifiable pointer to the named EggVertexUV object, which defines both the UV coordinate pair for this name and the UV morphs.

Returns NULL if there is no such named UV object.

Definition at line 274 of file eggVertex.cxx.

References EggVertexUV::filter_name().

◆ operator=()

EggVertex & EggVertex::operator= ( const EggVertex copy)

Copies all properties of the vertex except its vertex pool, index number, and group membership.

Definition at line 78 of file eggVertex.cxx.

◆ pref_begin()

EggVertex::PrimitiveRef::const_iterator EggVertex::pref_begin ( ) const

Returns an iterator that can, in conjunction with pref_end(), be used to traverse the entire set of primitives that reference this vertex.

Each iterator returns a pointer to a primitive.

This interface is not safe to use outside of PANDAEGG.DLL.

Definition at line 793 of file eggVertex.cxx.

Referenced by get_num_global_coord(), get_num_local_coord(), and split_vertex().

◆ pref_end()

EggVertex::PrimitiveRef::const_iterator EggVertex::pref_end ( ) const

Returns an iterator that can, in conjunction with pref_begin(), be used to traverse the entire set of primitives that reference this vertex.

Each iterator returns a pointer to a primitive.

This interface is not safe to use outside of PANDAEGG.DLL.

Definition at line 805 of file eggVertex.cxx.

Referenced by get_num_global_coord(), get_num_local_coord(), and split_vertex().

◆ pref_size()

EggVertex::GroupRef::size_type EggVertex::pref_size ( ) const

Returns the number of elements between pref_begin() and pref_end().

This interface is not safe to use outside of PANDAEGG.DLL.

Definition at line 815 of file eggVertex.cxx.

Referenced by EggVertexPool::add_unused_vertices_to_prim(), EggVertexPool::remove_unused_vertices(), and split_vertex().

◆ set_aux()

void EggVertex::set_aux ( const std::string &  name,
const LVecBase4d &  aux 
)

Sets the indicated auxiliary data quadruple on the vertex.

This replaces any auxiliary data with the same name already on the vertex.

Definition at line 225 of file eggVertex.cxx.

◆ set_aux_obj()

void EggVertex::set_aux_obj ( EggVertexAux aux)

Sets the indicated EggVertexAux on the vertex.

This replaces any auxiliary data with the same name already on the vertex.

Definition at line 321 of file eggVertex.cxx.

◆ set_external_index()

void EggVertex::set_external_index ( int  external_index)
inline

Sets a special index number that is associated with the EggVertex (but is not written to the egg file).

This number is not interpreted by any egg code; it is simply maintained along with the vertex. It *is* used to differentiate otherwise identical vertices in EggVertexPool::create_unique_vertex(), however.

The intention of this number is as an aid for file converters, to associate an EggVertex back to the index number of the original source vertex.

Definition at line 292 of file eggVertex.I.

◆ set_external_index2()

void EggVertex::set_external_index2 ( int  external_index2)
inline

Similar to set_external_index(), but this is a different number which may be used for a different purpose by the calling code.

The egg library does not assign any meaning to this number or use it in any way.

Definition at line 310 of file eggVertex.I.

◆ set_pos() [1/4]

void EggVertex::set_pos ( double  pos)
inline

Sets the vertex position.

This variant sets the vertex to a one- dimensional value.

Definition at line 42 of file eggVertex.I.

Referenced by DXFToEggLayer::add_vertex(), and EggVertexPool::make_new_vertex().

◆ set_pos() [2/4]

void EggVertex::set_pos ( const LPoint2d &  pos)
inline

Sets the vertex position.

This variant sets the vertex to a two- dimensional value.

Definition at line 53 of file eggVertex.I.

◆ set_pos() [3/4]

void EggVertex::set_pos ( const LPoint3d &  pos)
inline

Sets the vertex position.

This variant sets the vertex to a three- dimensional value.

Definition at line 64 of file eggVertex.I.

◆ set_pos() [4/4]

void EggVertex::set_pos ( const LPoint4d &  pos)
inline

Sets the vertex position.

This variant sets the vertex to a four- dimensional value.

Definition at line 75 of file eggVertex.I.

◆ set_pos4()

void EggVertex::set_pos4 ( const LPoint4d &  pos)
inline

This special flavor of set_pos() sets the vertex as a four-component value, but does not change the set number of dimensions.

It's handy for retrieving the vertex position via get_pos4, manipulating it, then storing it back again, without worrying about the number of dimensions it actually had.

Definition at line 89 of file eggVertex.I.

◆ set_uv() [1/2]

void EggVertex::set_uv ( const LTexCoordd &  uv)
inline

Replaces the unnamed UV coordinate pair on the vertex with the indicated value.

This is the more restrictive interface, and is generally useful only in the absence of multitexturing; see set_uv(name, uv) for the interface that supports multitexturing.

Definition at line 193 of file eggVertex.I.

◆ set_uv() [2/2]

void EggVertex::set_uv ( const std::string &  name,
const LTexCoordd &  uv 
)

Sets the indicated UV coordinate pair on the vertex.

This replaces any UV coordinate pair with the same name already on the vertex, but preserves UV morphs.

Definition at line 186 of file eggVertex.cxx.

References EggVertexUV::filter_name().

◆ set_uv_obj()

void EggVertex::set_uv_obj ( EggVertexUV uv)

Sets the indicated EggVertexUV on the vertex.

This replaces any UV coordinate pair with the same name already on the vertex, including UV morphs.

Definition at line 312 of file eggVertex.cxx.

◆ set_uvw()

void EggVertex::set_uvw ( const std::string &  name,
const LTexCoord3d &  uvw 
)

Sets the indicated UV coordinate triple on the vertex.

This replaces any UV coordinate pair or triple with the same name already on the vertex, but preserves UV morphs.

Definition at line 206 of file eggVertex.cxx.

References EggVertexUV::filter_name().

◆ sorts_less_than()

bool EggVertex::sorts_less_than ( const EggVertex other) const
inline

An ordering operator to compare two vertices for sorting order.

This imposes an arbitrary ordering useful to identify unique vertices.

Definition at line 328 of file eggVertex.I.

References compare_to().

◆ transform()

void EggVertex::transform ( const LMatrix4d &  mat)

Applies the indicated transformation matrix to the vertex.

Definition at line 672 of file eggVertex.cxx.

◆ uv_begin()

EggVertex::const_uv_iterator EggVertex::uv_begin ( ) const
inline

Returns an iterator that allows walking through the complete set of named UV's on the vertex.

This interface is not safe to use outside of PANDAEGG.DLL.

Definition at line 220 of file eggVertex.I.

Referenced by EggVertexPool::get_uv_names().

◆ uv_end()

EggVertex::const_uv_iterator EggVertex::uv_end ( ) const
inline

Returns an iterator that allows walking through the complete set of named UV's on the vertex.

This interface is not safe to use outside of PANDAEGG.DLL.

Definition at line 242 of file eggVertex.I.

Referenced by EggVertexPool::get_uv_names().

◆ uv_size()

EggVertex::uv_size_type EggVertex::uv_size ( ) const
inline

Returns the number of named UV's on the vertex.

Definition at line 261 of file eggVertex.I.

◆ write()

void EggVertex::write ( std::ostream &  out,
int  indent_level 
) const

Writes the vertex to the indicated output stream in Egg format.

Definition at line 487 of file eggVertex.cxx.

References indent().


The documentation for this class was generated from the following files: