PGTop

class PGTop

Bases: PandaNode

The “top” node of the new Panda GUI system. This node must be parented to the 2-d scene graph, and all PG objects should be parented to this node or somewhere below it. PG objects not parented within this hierarchy will not be clickable.

This node begins the special traversal of the PG objects that registers each node within the MouseWatcher and forces everything to render in a depth-first, left-to-right order, appropriate for 2-d objects.

Inheritance diagram

Inheritance diagram of PGTop

explicit PGTop(std::string const &name)
static TypeHandle get_class_type(void)
MouseWatcherGroup *get_group(void) const

Returns the MouseWatcherGroup pointer that the PGTop object registers its PG items with, or NULL if the MouseWatcher has not yet been set.

MouseWatcher *get_mouse_watcher(void) const

Returns the MouseWatcher pointer that the PGTop object registers its PG items with, or NULL if the MouseWatcher has not yet been set.

int get_start_sort(void) const

Returns the sort index that is assigned during the traversal to the first PGItem that is discovered during traversal. See set_start_sort().

void set_mouse_watcher(MouseWatcher *watcher)

Sets the MouseWatcher pointer that the PGTop object registers its PG items with. This must be set before the PG items are active.

void set_start_sort(int start_sort)

Specifies the sort index that is assigned during the traversal to the first PGItem that is discovered during traversal. Subsequent PGItems will be assigned consecutively higher sort indexes.

This number is used by the MouseWatcher system to rank the clickable mouse regions in the same order in which the items are rendered, so that items on top will receive mouse priority.

Normally, it makes the most sense to leave this initial value at its default value of 0, unless you need the PGItems to have a particular sort value with respect to some other objects in the scene (particularly with a second PGTop node).