panda3d.egg.EggVertex

class EggVertex

Bases: EggObject, EggAttributes

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

Inheritance diagram

Inheritance diagram of EggVertex

__init__() → None
__init__(copy: EggVertex) → None

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

assign(copy: EggVertex) → EggVertex

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

Return type

EggVertex

getPool() → EggVertexPool

Returns the vertex pool this vertex belongs in. This may be NULL if the vertex has not been added to a pool.

Return type

EggVertexPool

isForwardReference() → bool

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.getForwardVertex(). Presumably, when the vertex pool is later filled in, this vertex will be replaced with real data.

setPos(pos: LPoint2d) → None

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

setPos(pos: LPoint3d) → None

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

setPos(pos: LPoint4d) → None

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

setPos(pos: float) → None

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

setPos4(pos: LPoint4d) → None

This special flavor of setPos() 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.

getNumDimensions() → int

get_pos[123] return the pos as the corresponding type. It is an error to call any of these without first verifying that getNumDimensions() matches the desired type. However, getPos4() may always be called; it returns the pos as a four-component point in homogeneous space (with a 1.0 in the last position if the pos has fewer than four components).

getPos1() → float

Only valid if getNumDimensions() returns 1. Returns the position as a one-dimensional value.

getPos2() → LPoint2d

Only valid if getNumDimensions() returns 2. Returns the position as a two-dimensional value.

Return type

LPoint2d

getPos3() → LVertexd

Valid if getNumDimensions() returns 3 or 4. Returns the position as a three-dimensional value.

Return type

LVertexd

getPos4() → LPoint4d

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.

Return type

LPoint4d

hasUv() → bool

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.

hasUv(name: str) → bool

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

getUv() → LTexCoordd

Returns the unnamed UV coordinate pair on the vertex. It is an error to call this if hasUv() 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.

Return type

LTexCoordd

getUv(name: str) → LTexCoordd

Returns the named UV coordinate pair on the vertex. It is an error to call this if has_uv(name) returned false.

Return type

LTexCoordd

setUv(texCoord: LTexCoordd) → None

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.

setUv(name: str, texCoord: LTexCoordd) → None

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.

clearUv() → None

Removes all UV coordinate pairs from the vertex.

clearUv(name: str) → None

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

hasUvw(name: str) → bool

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

getUvw(name: str) → LTexCoord3d

Returns the named UV coordinate triple on the vertex. It is an error to call this if has_uvw(name) returned false.

Return type

LTexCoord3d

setUvw(name: str, texCoord: LTexCoord3d) → None

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.

getUvObj(name: str) → EggVertexUV

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.

Return type

EggVertexUV

modifyUvObj(name: str) → EggVertexUV

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.

Return type

EggVertexUV

setUvObj(vertex_uv: EggVertexUV) → None

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

hasAux() → bool

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

hasAux(name: str) → bool

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

clearAux() → None

Removes all auxiliary data from the vertex.

clearAux(name: str) → None

Removes the named auxiliary data from the vertex.

getAux(name: str) → LVecBase4d

Returns the named auxiliary data quadruple on the vertex. It is an error to call this if has_aux(name) returned false.

Return type

LVecBase4d

setAux(name: str, aux: LVecBase4d) → None

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

getAuxObj(name: str) → EggVertexAux

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.

Return type

EggVertexAux

modifyAuxObj(name: str) → EggVertexAux

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.

Return type

EggVertexAux

setAuxObj(vertex_aux: EggVertexAux) → None

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

static makeAverage(first: EggVertex, second: EggVertex) → EggVertex

Creates a new vertex that lies in between the two given vertices. The attributes for the UV sets they have in common are averaged.

Both vertices need to be either in no pool, or in the same pool. In the latter case, the new vertex will be placed in that pool.

Return type

EggVertex

getIndex() → int

Returns the index number of the vertex within its pool.

setExternalIndex(external_index: int) → None

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.createUniqueVertex(), 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.

getExternalIndex() → int

Returns the number set by setExternalIndex(). See setExternalIndex().

setExternalIndex2(external_index2: int) → None

Similar to setExternalIndex(), 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.

getExternalIndex2() → int

Returns the number set by setExternalIndex2(). See setExternalIndex2().

write(out: ostream, indent_level: int) → None

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

sortsLessThan(other: EggVertex) → bool

An ordering operator to compare two vertices for sorting order. This imposes an arbitrary ordering useful to identify unique vertices.

compareTo(other: EggVertex) → int

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.

getNumLocalCoord() → int

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

getNumGlobalCoord() → int

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

transform(mat: LMatrix4d) → None

Applies the indicated transformation matrix to the vertex.

hasGref(group: EggGroup) → bool

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

copyGrefsFrom(other: EggVertex) → None

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.

clearGrefs() → None

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

hasPref(prim: EggPrimitive) → int

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

testGrefIntegrity() → None
testPrefIntegrity() → None
output(out: ostream) → None
static getClassType() → TypeHandle
Return type

TypeHandle