GeomNode

from panda3d.core import GeomNode

class GeomNode

Bases:

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

__init__(name: str)

add_geom(geom: Geom, state: RenderState)

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

add_geoms_from(other: GeomNode)

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

check_valid() → 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()

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.

property default_collide_mask → CollideMask

Returns the default into_collide_mask assigned to new GeomNodes.

static get_class_type() → TypeHandle

static get_default_collide_mask() → CollideMask

Returns the default into_collide_mask assigned to new GeomNodes.

get_geom(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 modify_geom().

get_geom_state(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.

get_geom_states() → list

get_geoms() → list

get_num_geoms() → int

Returns the number of geoms in the node.

get_preserved() → bool

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

modify_geom(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.

modify_geoms() → list

remove_all_geoms()

Removes all the geoms from the node at once.

remove_geom(n: int)

Removes the nth geom from the node.

set_geom(n: int, geom: Geom)

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.

set_geom_state(n: int, state: RenderState)

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.

set_preserved(value: bool)

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

unify(max_indices: int, preserve_order: bool)

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.

write_geoms(out: ostream, indent_level: int)

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

write_verbose(out: ostream, indent_level: int)

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