panda3d.egg.EggGroup

from panda3d.egg import EggGroup

class EggGroup

Bases: EggGroupNode, EggRenderMode, EggTransform

The main glue of the egg hierarchy, this corresponds to the <Group>, <Instance>, and <Joint> type nodes.

Inheritance diagram

__init__(copy: EggGroup) → None

__init__(name: str) → None

assign(copy: EggGroup) → EggGroup

Return type

EggGroup

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

Writes the group and all of its children to the indicated output stream in Egg format.

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

Writes just the <Billboard> entry and related fields to the indicated ostream.

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

Writes just the <Collide> entry and related fields to the indicated ostream.

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

Writes the <Model> flag and related flags to the indicated ostream.

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

Writes the <Switch> flag and related flags to the indicated ostream.

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

Writes just the <ObjectTypes> entries, if any, to the indicated ostream.

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

Writes the flags related to decaling, if any.

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

Writes just the <Tag> entries, if any, to the indicated ostream.

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

Writes the flags inherited from EggRenderMode and similar flags that control obscure render effects.

isJoint() → bool

Returns true if this particular node represents a <Joint> entry or not. This is a handy thing to know since Joints are sorted to the end of their sibling list when writing an egg file. See EggGroupNode::write().

determineAlphaMode() → EggRenderMode

Walks back up the hierarchy, looking for an EggGroup or EggPrimitive or some such object at this level or above this group that has an alpha_mode other than AM_unspecified. Returns a valid EggRenderMode pointer if one is found, or NULL otherwise.

Return type

EggRenderMode

determineDepthWriteMode() → EggRenderMode

Walks back up the hierarchy, looking for an EggGroup or EggPrimitive or some such object at this level or above this group that has a depth_write_mode other than DWM_unspecified. Returns a valid EggRenderMode pointer if one is found, or NULL otherwise.

Return type

EggRenderMode

determineDepthTestMode() → EggRenderMode

Walks back up the hierarchy, looking for an EggGroup or EggPrimitive or some such object at this level or above this group that has a depth_test_mode other than DTM_unspecified. Returns a valid EggRenderMode pointer if one is found, or NULL otherwise.

Return type

EggRenderMode

determineVisibilityMode() → EggRenderMode

Walks back up the hierarchy, looking for an EggGroup or EggPrimitive or some such object at this level or above this group that has a visibility_mode other than VM_unspecified. Returns a valid EggRenderMode pointer if one is found, or NULL otherwise.

Return type

EggRenderMode

determineDepthOffset() → EggRenderMode

Walks back up the hierarchy, looking for an EggGroup or EggPrimitive or some such object at this level or above this group that has a depth_offset specified. Returns a valid EggRenderMode pointer if one is found, or NULL otherwise.

Return type

EggRenderMode

determineDrawOrder() → EggRenderMode

Walks back up the hierarchy, looking for an EggGroup or EggPrimitive or some such object at this level or above this group that has a draw_order specified. Returns a valid EggRenderMode pointer if one is found, or NULL otherwise.

Return type

EggRenderMode

determineBin() → EggRenderMode

Walks back up the hierarchy, looking for an EggGroup or EggPrimitive or some such object at this level or above this group that has a bin specified. Returns a valid EggRenderMode pointer if one is found, or NULL otherwise.

Return type

EggRenderMode

determineIndexed() → bool

Walks back up the hierarchy, looking for an EggGroup at this level or above that has the “indexed” scalar set. Returns the value of the indexed scalar if it is found, or false if it is not.

In other words, returns true if the “indexed” flag is in effect for the indicated node, false otherwise.

determineDecal() → bool

Walks back up the hierarchy, looking for an EggGroup at this level or above that has the “decal” flag set. Returns the value of the decal flag if it is found, or false if it is not.

In other words, returns true if the “decal” flag is in effect for the indicated node, false otherwise.

setGroupType(type: GroupType) → None

getGroupType() → GroupType

Return type

GroupType

isInstanceType() → bool

Returns true if this group is an instance type node; i.e. it begins the root of a local coordinate space. This is not related to instancing (multiple copies of a node in a scene graph).

This also includes the case of the node including a billboard flag without an explicit center, which implicitly makes the node behave like an instance.

setBillboardType(type: BillboardType) → None

getBillboardType() → BillboardType

Return type

BillboardType

setBillboardCenter(billboard_center: LPoint3d) → None

Sets the point around which the billboard will rotate, if this node contains a billboard specification.

If a billboard type is given but no billboard_center is specified, then the group node is treated as an <Instance>, and the billboard rotates around the origin. If, however, a billboard_center is specified, then the group node is not treated as an <Instance>, and the billboard rotates around the specified point.

The point is in the same coordinate system as the vertices of this node: usually global, but possibly local if there is an <Instance> somewhere above. Specifically, this is the coordinate system defined by get_vertex_frame().

clearBillboardCenter() → None

hasBillboardCenter() → bool

getBillboardCenter() → LPoint3d

Return type

LPoint3d

setCsType(type: CollisionSolidType) → None

getCsType() → CollisionSolidType

Return type

CollisionSolidType

setCollideFlags(flags: int) → None

getCollideFlags() → CollideFlags

Return type

CollideFlags

setCollisionName(collision_name: str) → None

clearCollisionName() → None

hasCollisionName() → bool

getCollisionName() → str

setDcsType(type: DCSType) → None

getDcsType() → DCSType

Return type

DCSType

hasDcsType() → bool

Returns true if the specified DCS type is not DC_none and not DC_unspecified.

setDartType(type: DartType) → None

getDartType() → DartType

Return type

DartType

setSwitchFlag(flag: bool) → None

getSwitchFlag() → bool

setSwitchFps(fps: float) → None

getSwitchFps() → float

addObjectType(object_type: str) → None

clearObjectTypes() → None

getNumObjectTypes() → int

getObjectType(index: int) → str

hasObjectType(object_type: str) → bool

Returns true if the indicated object type has been added to the group, or false otherwise.

removeObjectType(object_type: str) → bool

Removes the first instance of the indicated object type from the group if it is present. Returns true if the object type was found and removed, false otherwise.

setModelFlag(flag: bool) → None

getModelFlag() → bool

setTexlistFlag(flag: bool) → None

getTexlistFlag() → bool

setNofogFlag(flag: bool) → None

getNofogFlag() → bool

setDecalFlag(flag: bool) → None

getDecalFlag() → bool

setDirectFlag(flag: bool) → None

getDirectFlag() → bool

setPortalFlag(flag: bool) → None

getPortalFlag() → bool

setOccluderFlag(flag: bool) → None

getOccluderFlag() → bool

setPolylightFlag(flag: bool) → None

getPolylightFlag() → bool

setIndexedFlag(flag: bool) → None

If this flag is true, geometry at this node and below will be generated as indexed geometry.

clearIndexedFlag() → None

hasIndexedFlag() → bool

getIndexedFlag() → bool

setCollideMask(mask: CollideMask) → None

clearCollideMask() → None

hasCollideMask() → bool

getCollideMask() → CollideMask

Return type

CollideMask

setFromCollideMask(mask: CollideMask) → None

clearFromCollideMask() → None

hasFromCollideMask() → bool

getFromCollideMask() → CollideMask

Return type

CollideMask

setIntoCollideMask(mask: CollideMask) → None

clearIntoCollideMask() → None

hasIntoCollideMask() → bool

getIntoCollideMask() → CollideMask

Return type

CollideMask

setBlendMode(blend_mode: BlendMode) → None

getBlendMode() → BlendMode

Return type

BlendMode

setBlendOperandA(blend_operand_a: BlendOperand) → None

getBlendOperandA() → BlendOperand

Return type

BlendOperand

setBlendOperandB(blend_operand_b: BlendOperand) → None

getBlendOperandB() → BlendOperand

Return type

BlendOperand

setBlendColor(blend_color: LColor) → None

clearBlendColor() → None

Removes the blend color specification.

hasBlendColor() → bool

Returns true if the blend color has been specified, false otherwise.

getBlendColor() → LColor

Returns the blend color if one has been specified, or (0, 0, 0, 0) if one has not.

Return type

LColor

setLod(lod: EggSwitchCondition) → None

clearLod() → None

hasLod() → bool

getLod() → EggSwitchCondition

Return type

EggSwitchCondition

setTag(key: str, value: str) → None

Associates a user-defined value with a user-defined key which is stored on the node. This value has no meaning to Panda; but it is stored indefinitely on the node until it is requested again. This value will be copied to the PandaNode that is created for this particular EggGroup if the egg file is loaded as a scene.

Each unique key stores a different string value. There is no effective limit on the number of different keys that may be stored or on the length of any one key’s value.

getTag(key: str) → str

Retrieves the user-defined value that was previously set on this node for the particular key, if any. If no value has been previously set, returns the empty string.

hasTag(key: str) → bool

Returns true if a value has been defined on this node for the particular key (even if that value is the empty string), or false if no value has been set.

clearTag(key: str) → None

Removes the value defined for this key on this particular node. After a call to clearTag(), hasTag() will return false for the indicated key.

getDefaultPose() → EggTransform

Returns a read-only accessor to the initial pose transform. This is the <DefaultPose> entry for a Joint, and defines only the initial transform pose for the unanimated joint; it has nothing to do with the group’s <Transform> entry, which defines the (eventual) space of the group’s vertices.

Return type

EggTransform

modifyDefaultPose() → EggTransform

Returns a writable accessor to the initial pose transform. This is the <DefaultPose> entry for a Joint, and defines only the initial transform pose for the unanimated joint; it has nothing to do with the group’s <Transform> entry, which defines the (eventual) space of the group’s vertices.

Return type

EggTransform

setDefaultPose(transform: EggTransform) → None

Replaces the initial pose transform. This is the <DefaultPose> entry for a Joint, and defines only the initial transform pose for the unanimated joint; it has nothing to do with the group’s <Transform> entry, which defines the (eventual) space of the group’s vertices.

clearDefaultPose() → None

Removes the initial pose transform. See setDefaultPose().

setScrollU(u_speed: float) → None

setScrollV(v_speed: float) → None

setScrollW(w_speed: float) → None

setScrollR(r_speed: float) → None

getScrollU() → float

getScrollV() → float

getScrollW() → float

getScrollR() → float

hasScrollingUvs() → bool

refVertex(vert: EggVertex, membership: float) → None

Adds the vertex to the set of those referenced by the group, at the indicated membership level. If the vertex is already being referenced, increases the membership amount by the indicated amount.

unrefVertex(vert: EggVertex) → None

Removes the vertex from the set of those referenced by the group. Does nothing if the vertex is not already reffed.

unrefAllVertices() → None

Removes all vertices from the reference list.

getVertexMembership(vert: EggVertex) → float

Returns the amount of membership of the indicated vertex in this group. If the vertex is not reffed by the group, returns 0.

setVertexMembership(vert: EggVertex, membership: float) → None

Explicitly sets the net membership of the indicated vertex in this group to the given value.

stealVrefs(other: EggGroup) → None

Moves all of the vertex references from the indicated other group into this one. If a given vertex was previously shared by both groups, the relative memberships will be summed.

testVrefIntegrity() → None

addGroupRef(group: EggGroup) → None

Adds a new <Ref> entry to the group. This declares an internal reference to another node, and is used to implement scene-graph instancing; it is only valid if the group_type is GT_instance.

getNumGroupRefs() → int

Returns the number of <Ref> entries within this group. See addGroupRef().

getGroupRef(n: int) → EggGroup

Returns the nth <Ref> entry within this group. See addGroupRef().

Return type

EggGroup

removeGroupRef(n: int) → None

Removes the nth <Ref> entry within this group. See addGroupRef().

clearGroupRefs() → None

Removes all of the <Ref> entries within this group. See addGroupRef().

static stringGroupType(strval: str) → GroupType

Returns the GroupType value associated with the given string representation, or GT_invalid if the string does not match any known GroupType value.

Return type

GroupType

static stringDartType(strval: str) → DartType

Returns the DartType value associated with the given string representation, or DT_none if the string does not match any known DartType value.

Return type

DartType

static stringDcsType(strval: str) → DCSType

Returns the DCSType value associated with the given string representation, or DC_unspecified if the string does not match any known DCSType value.

Return type

DCSType

static stringBillboardType(strval: str) → BillboardType

Returns the BillboardType value associated with the given string representation, or BT_none if the string does not match any known BillboardType value.

Return type

BillboardType

static stringCsType(strval: str) → CollisionSolidType

Returns the CollisionSolidType value associated with the given string representation, or CST_none if the string does not match any known CollisionSolidType value.

Return type

CollisionSolidType

static stringCollideFlags(strval: str) → CollideFlags

Returns the CollideFlags value associated with the given string representation, or CF_none if the string does not match any known CollideFlags value. This only recognizes a single keyword; it does not attempt to parse a string of keywords.

Return type

CollideFlags

static stringBlendMode(strval: str) → BlendMode

Returns the BlendMode value associated with the given string representation, or BM_none if the string does not match any known BlendMode.

Return type

BlendMode

static stringBlendOperand(strval: str) → BlendOperand

Returns the BlendOperand value associated with the given string representation, or BO_none if the string does not match any known BlendOperand.

Return type

BlendOperand

static getClassType() → TypeHandle

Return type

TypeHandle

getObjectTypes() → list

getGroupRefs() → list

property group_type

Getter Setter

Return type

GroupType

property billboard_type

Getter Setter

Return type

BillboardType

property billboard_center

Getter Setter

Sets the point around which the billboard will rotate, if this node contains a billboard specification.

If a billboard type is given but no billboard_center is specified, then the group node is treated as an <Instance>, and the billboard rotates around the origin. If, however, a billboard_center is specified, then the group node is not treated as an <Instance>, and the billboard rotates around the specified point.

The point is in the same coordinate system as the vertices of this node: usually global, but possibly local if there is an <Instance> somewhere above. Specifically, this is the coordinate system defined by get_vertex_frame().

Return type

LPoint3d

property cs_type

Getter Setter

Return type

CollisionSolidType

property collide_flags

Getter Setter

Return type

CollideFlags

property collision_name

Getter Setter

Return type

string

property dcs_type

Getter Setter

Return type

DCSType

property dart_type

Getter Setter

Return type

DartType

property switch_flag

Getter Setter

Return type

bool

property switch_fps

Getter Setter

Return type

float

property object_types

Return type

Sequence[string]

property model_flag

Getter Setter

Return type

bool

property texlist_flag

Getter Setter

Return type

bool

property nofog_flag

Getter Setter

Return type

bool

property decal_flag

Getter Setter

Return type

bool

property direct_flag

Getter Setter

Return type

bool

property portal_flag

Getter Setter

Return type

bool

property occluder_flag

Getter Setter

Return type

bool

property indexed_flag

Getter Setter

If this flag is true, geometry at this node and below will be generated as indexed geometry.

Return type

bool

property collide_mask

Getter Setter

Return type

CollideMask

property from_collide_mask

Getter Setter

Return type

CollideMask

property into_collide_mask

Getter Setter

Return type

CollideMask

property blend_mode

Getter Setter

Return type

BlendMode

property blend_operand_a

Getter Setter

Return type

BlendOperand

property blend_operand_b

Getter Setter

Return type

BlendOperand

property blend_color

Getter

Returns the blend color if one has been specified, or (0, 0, 0, 0) if one has not.

Setter

Return type

LColor

property lod

Getter Setter

Return type

EggSwitchCondition

property default_pose

Getter

Returns a read-only accessor to the initial pose transform. This is the <DefaultPose> entry for a Joint, and defines only the initial transform pose for the unanimated joint; it has nothing to do with the group’s <Transform> entry, which defines the (eventual) space of the group’s vertices.

Setter

Replaces the initial pose transform. This is the <DefaultPose> entry for a Joint, and defines only the initial transform pose for the unanimated joint; it has nothing to do with the group’s <Transform> entry, which defines the (eventual) space of the group’s vertices.

Return type

EggTransform

property scroll_u

Return type

float

property scroll_v

Return type

float

property scroll_w

Return type

float

property scroll_r

Return type

float

VertexRef

alias of map_PT_EggVertex_double

TagData

alias of map_string_string

enum GroupType

These bits are all stored somewhere in _flags.

enumerator GT_invalid = -1

The bits here must correspond to those in Flags, below.

enumerator GT_group = 0

enumerator GT_instance = 1

enumerator GT_joint = 2

enum DCSType

enumerator DC_unspecified = 0

The bits here must correspond to those in Flags2, below.

enumerator DC_none = 16

enumerator DC_local = 32

enumerator DC_net = 48

enumerator DC_no_touch = 64

enumerator DC_default = 80

enum BillboardType

enumerator BT_none = 0

The bits here must correspond to those in Flags, below.

enumerator BT_axis = 32

enumerator BT_point_camera_relative = 64

enumerator BT_point_world_relative = 128

enum CollisionSolidType

enumerator CST_none = 0

The bits here must correspond to those in Flags, below, and they must fit within F_cs_type.

enumerator CST_plane = 65536

enumerator CST_polygon = 131072

enumerator CST_polyset = 196608

enumerator CST_sphere = 262144

enumerator CST_tube = 327680

enumerator CST_inv_sphere = 393216

enumerator CST_box = 458752

enumerator CST_floor_mesh = 524288

enum CollideFlags

enumerator CF_none = 0

The bits here must correspond to those in Flags, below, and they must fit within F_collide_flags.

enumerator CF_descend = 1048576

enumerator CF_event = 2097152

enumerator CF_keep = 4194304

enumerator CF_solid = 8388608

enumerator CF_center = 16777216

enumerator CF_turnstile = 33554432

enumerator CF_level = 67108864

enumerator CF_intangible = 134217728

enum DartType

enumerator DT_none = 0

The bits here must correspond to those in Flags, below.

enumerator DT_structured = 268435456

enumerator DT_sync = 536870912

enumerator DT_nosync = 805306368

enumerator DT_default = 1073741824

enum BlendMode

These correspond to ColorBlendAttrib::Mode (but not numerically).

enumerator BM_unspecified = 0

enumerator BM_none = 1

enumerator BM_add = 2

enumerator BM_subtract = 3

enumerator BM_inv_subtract = 4

enumerator BM_min = 5

enumerator BM_max = 6

enum BlendOperand

These correspond to ColorBlendAttrib::Operand (but not numerically).

enumerator BO_unspecified = 0

enumerator BO_zero = 1

enumerator BO_one = 2

enumerator BO_incoming_color = 3

enumerator BO_one_minus_incoming_color = 4

enumerator BO_fbuffer_color = 5

enumerator BO_one_minus_fbuffer_color = 6

enumerator BO_incoming_alpha = 7

enumerator BO_one_minus_incoming_alpha = 8

enumerator BO_fbuffer_alpha = 9

enumerator BO_one_minus_fbuffer_alpha = 10

enumerator BO_constant_color = 11

enumerator BO_one_minus_constant_color = 12

enumerator BO_constant_alpha = 13

enumerator BO_one_minus_constant_alpha = 14

enumerator BO_incoming_color_saturate = 15

enumerator BO_color_scale = 16

enumerator BO_one_minus_color_scale = 17

enumerator BO_alpha_scale = 18

enumerator BO_one_minus_alpha_scale = 19