panda3d.core.GeomNode

from panda3d.core import GeomNode
class GeomNode

Bases: PandaNode

A node that holds Geom objects, renderable pieces of geometry. This is the primary kind of leaf node in the scene graph; almost all visible objects will be contained in a GeomNode somewhere.

Inheritance diagram

Inheritance diagram of GeomNode

__init__(name: str) → None
setPreserved(value: bool) → None

Sets the “preserved” flag. When this is true, the GeomNode will be left untouched by any flatten operations.

getPreserved() → bool

Returns the “preserved” flag. When this is true, the GeomNode will be left untouched by any flatten operations.

getNumGeoms() → int

Returns the number of geoms in the node.

getGeom(n: int) → Geom

Returns the nth geom of the node. This object should not be modified, since the same object might be shared between multiple different GeomNodes, but see modifyGeom().

Return type

Geom

modifyGeom(n: int) → Geom

Returns the nth geom of the node, suitable for modifying it. If the nth Geom has multiple reference counts to it, reassigns it to an identical copy first, and returns the new copy–this provides a “copy on write” that ensures that the Geom that is returned is unique to this GeomNode and is not shared with any other GeomNodes.

Note that if this method is called in a downstream stage (for instance, during cull or draw), then it will propagate the new list of Geoms upstream all the way to pipeline stage 0, which may step on changes that were made independently in pipeline stage 0. Use with caution.

Return type

Geom

getGeomState(n: int) → RenderState

Returns the RenderState associated with the nth geom of the node. This is just the RenderState directly associated with the Geom; the actual state in which the Geom is rendered will also be affected by RenderStates that appear on the scene graph in nodes above this GeomNode.

Return type

RenderState

setGeomState(n: int, state: RenderState) → None

Changes the RenderState associated with the nth geom of the node. This is just the RenderState directly associated with the Geom; the actual state in which the Geom is rendered will also be affected by RenderStates that appear on the scene graph in nodes above this GeomNode.

Note that if this method is called in a downstream stage (for instance, during cull or draw), then it will propagate the new list of Geoms upstream all the way to pipeline stage 0, which may step on changes that were made independently in pipeline stage 0. Use with caution.

addGeom(geom: Geom, state: RenderState) → None

Adds a new Geom to the node. The geom is given the indicated state (which may be RenderState.makeEmpty(), to completely inherit its state from the scene graph).

addGeomsFrom(other: GeomNode) → None

Copies the Geoms (and their associated RenderStates) from the indicated GeomNode into this one.

setGeom(n: int, geom: Geom) → None

Replaces the nth Geom of the node with a new pointer. There must already be a Geom in this slot.

Note that if this method is called in a downstream stage (for instance, during cull or draw), then it will propagate the new list of Geoms upstream all the way to pipeline stage 0, which may step on changes that were made independently in pipeline stage 0. Use with caution.

removeGeom(n: int) → None

Removes the nth geom from the node.

removeAllGeoms() → None

Removes all the geoms from the node at once.

checkValid() → bool

Verifies that the each Geom within the GeomNode reference vertices that actually exist within its GeomVertexData. Returns true if the GeomNode appears to be valid, false otherwise.

decompose() → None

Calls decompose() on each Geom with the GeomNode. This decomposes higher- order primitive types, like triangle strips, into lower-order types like indexed triangles. Normally there is no reason to do this, but it can be useful as an early preprocessing step, to allow a later call to unify() to proceed more quickly.

See also SceneGraphReducer.decompose(), which is the normal way this is called.

unify(max_indices: int, preserve_order: bool) → None

Attempts to unify all of the Geoms contained within this node into a single Geom, or at least as few Geoms as possible. In turn, the individual GeomPrimitives contained within each resulting Geom are also unified. The goal is to reduce the number of GeomPrimitives within the node as far as possible. This may result in composite primitives, such as triangle strips and triangle fans, being decomposed into triangles. See also Geom.unify().

max_indices represents the maximum number of indices that will be put in any one GeomPrimitive. If preserve_order is true, then the primitives will not be reordered during the operation, even if this results in a suboptimal result.

In order for this to be successful, the primitives must reference the same GeomVertexData, have the same fundamental primitive type, and have compatible shade models.

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

Writes a short description of all the Geoms in the node.

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

Writes a detailed description of all the Geoms in the node.

static getDefaultCollideMask() → CollideMask

Returns the default into_collide_mask assigned to new GeomNodes.

Return type

CollideMask

static getClassType() → TypeHandle
Return type

TypeHandle

getGeoms() → list
modifyGeoms() → list
getGeomStates() → list
property default_collide_mask

Returns the default into_collide_mask assigned to new GeomNodes.

Return type

CollideMask