Panda3D
|
This object performs a depth-first traversal of the scene graph, with optional view-frustum culling, collecting CullState and searching for GeomNodes. More...
#include "cullTraverser.h"
Public Member Functions | |
CullTraverser (const CullTraverser ©) | |
void | draw_bounding_volume (const BoundingVolume *vol, const TransformState *internal_transform) const |
Draws an appropriate visualization of the indicated bounding volume. More... | |
virtual void | end_traverse () |
Should be called when the traverser has finished traversing its scene, this gives it a chance to do any necessary finalization. More... | |
virtual TypeHandle | force_init_type () |
const DrawMask & | get_camera_mask () const |
Returns the visibility mask from the camera viewing the scene. More... | |
const TransformState * | get_camera_transform () const |
Returns the position of the camera relative to the starting node. More... | |
CullHandler * | get_cull_handler () const |
Returns the object that will receive the culled Geoms. More... | |
Thread * | get_current_thread () const |
Returns the currently-executing thread object, as passed to the CullTraverser constructor. More... | |
bool | get_depth_offset_decals () const |
Returns true, as depth offsets are the only way that we implement decals nowadays. More... | |
bool | get_effective_incomplete_render () const |
Returns true if the cull traversal is effectively in incomplete_render state, considering both the GSG's incomplete_render and the current DisplayRegion's incomplete_render flags. More... | |
GraphicsStateGuardianBase * | get_gsg () const |
Returns the GraphicsStateGuardian in effect. More... | |
const RenderState * | get_initial_state () const |
Returns the initial RenderState at the top of the scene graph we are traversing, or the empty state if the initial state was never set. More... | |
PortalClipper * | get_portal_clipper () const |
Returns the _portal_clipper pointer. More... | |
SceneSetup * | get_scene () const |
Returns the SceneSetup object. More... | |
const string & | get_tag_state_key () const |
Returns the tag state key that has been specified for the scene's camera, if any. More... | |
virtual TypeHandle | get_type () const |
GeometricBoundingVolume * | get_view_frustum () const |
Returns the bounding volume that corresponds to the view frustum, or NULL if the view frustum is not in use or has not been set. More... | |
const TransformState * | get_world_transform () const |
Returns the position of the starting node relative to the camera. More... | |
bool | has_tag_state_key () const |
Returns true if a nonempty tag state key has been specified for the scene's camera, false otherwise. More... | |
void | set_camera_mask (const DrawMask &camera_mask) |
Changes the visibility mask for the camera viewing the scene. More... | |
void | set_cull_handler (CullHandler *cull_handler) |
Specifies the object that will receive the culled Geoms. More... | |
void | set_portal_clipper (PortalClipper *portal_clipper) |
Specifies _portal_clipper object pointer that subsequent traverse() or traverse_below may use. More... | |
virtual void | set_scene (SceneSetup *scene_setup, GraphicsStateGuardianBase *gsg, bool dr_incomplete_render) |
Sets the SceneSetup object that indicates the initial camera position, etc. More... | |
void | set_view_frustum (GeometricBoundingVolume *view_frustum) |
Specifies the bounding volume that corresponds to the view frustum. More... | |
void | traverse (const NodePath &root) |
Begins the traversal from the indicated node. More... | |
void | traverse (CullTraverserData &data) |
Traverses from the next node with the given data, which has been constructed with the node but has not yet been converted into the node's space. More... | |
virtual void | traverse_below (CullTraverserData &data) |
Traverses all the children of the indicated node, with the given data, which has been converted into the node's space. More... | |
![]() | |
TypedReferenceCount (const TypedReferenceCount ©) | |
void | operator= (const TypedReferenceCount ©) |
![]() | |
TypedObject (const TypedObject ©) | |
TypedObject * | as_typed_object () |
Returns the object, upcast (if necessary) to a TypedObject pointer. More... | |
const TypedObject * | as_typed_object () const |
Returns the object, upcast (if necessary) to a TypedObject pointer. More... | |
int | get_best_parent_from_Set (const std::set< int > &) const |
int | get_type_index () const |
Returns the internal index number associated with this object's TypeHandle, a unique number for each different type. More... | |
bool | is_exact_type (TypeHandle handle) const |
Returns true if the current object is the indicated type exactly. More... | |
bool | is_of_type (TypeHandle handle) const |
Returns true if the current object is or derives from the indicated type. More... | |
void | operator= (const TypedObject ©) |
![]() | |
int | get_ref_count () const |
Returns the current reference count. More... | |
WeakReferenceList * | get_weak_list () const |
Returns the WeakReferenceList associated with this ReferenceCount object. More... | |
bool | has_weak_list () const |
Returns true if this particular ReferenceCount object has a WeakReferenceList created, false otherwise. More... | |
void | local_object () |
This function should be called, once, immediately after creating a new instance of some ReferenceCount-derived object on the stack. More... | |
void | ref () const |
Explicitly increments the reference count. More... | |
bool | test_ref_count_integrity () const |
Does some easy checks to make sure that the reference count isn't completely bogus. More... | |
bool | test_ref_count_nonzero () const |
Does some easy checks to make sure that the reference count isn't zero, or completely bogus. More... | |
virtual bool | unref () const |
Explicitly decrements the reference count. More... | |
void | weak_ref (WeakPointerToVoid *ptv) |
Adds the indicated PointerToVoid as a weak reference to this object. More... | |
void | weak_unref (WeakPointerToVoid *ptv) |
Removes the indicated PointerToVoid as a weak reference to this object. More... | |
Static Public Member Functions | |
static void | flush_level () |
Flushes the PStatCollectors used during traversal. More... | |
static TypeHandle | get_class_type () |
static void | init_type () |
![]() | |
static TypeHandle | get_class_type () |
static void | init_type () |
![]() | |
static TypeHandle | get_class_type () |
static void | init_type () |
This function is declared non-inline to work around a compiler bug in g++ 2.96. More... | |
![]() | |
static TypeHandle | get_class_type () |
static void | init_type () |
Static Public Attributes | |
static PStatCollector | _geom_nodes_pcollector |
static PStatCollector | _geoms_occluded_pcollector |
static PStatCollector | _geoms_pcollector |
static PStatCollector | _nodes_pcollector |
This object performs a depth-first traversal of the scene graph, with optional view-frustum culling, collecting CullState and searching for GeomNodes.
Each renderable Geom encountered is passed along with its associated RenderState to the CullHandler object.
Definition at line 48 of file cullTraverser.h.
void CullTraverser::draw_bounding_volume | ( | const BoundingVolume * | vol, |
const TransformState * | internal_transform | ||
) | const |
Draws an appropriate visualization of the indicated bounding volume.
Definition at line 254 of file cullTraverser.cxx.
References GeomVertexWriter::add_data3(), NodePath::any_path(), GeomNode::get_num_geoms(), BoundingHexahedron::get_point(), BoundingVolume::is_empty(), PandaNode::is_geom_node(), BoundingVolume::is_infinite(), TypedObject::is_of_type(), ReferenceCount::local_object(), and CullTraverserData::node().
Referenced by end_traverse().
|
virtual |
Should be called when the traverser has finished traversing its scene, this gives it a chance to do any necessary finalization.
Reimplemented in PipeOcclusionCullTraverser.
Definition at line 243 of file cullTraverser.cxx.
References draw_bounding_volume().
Referenced by PGTop::cull_callback(), PipeOcclusionCullTraverser::end_traverse(), and traverse_below().
|
inlinestatic |
Flushes the PStatCollectors used during traversal.
Definition at line 242 of file cullTraverser.I.
References Fog::adjust_to_camera(), CullTraverserData::apply_transform_and_state(), get_camera_transform(), PandaNodePipelineReader::get_effects(), FogAttrib::get_fog(), PandaNodePipelineReader::get_state(), RenderEffects::has_show_bounds(), RenderEffects::has_show_tight_bounds(), CullTraverserData::node(), CullTraverserData::node_reader(), and traverse_below().
Referenced by get_effective_incomplete_render(), and GraphicsEngine::render_frame().
|
inline |
Returns the visibility mask from the camera viewing the scene.
Definition at line 143 of file cullTraverser.I.
References set_view_frustum().
Referenced by set_camera_mask().
|
inline |
Returns the position of the camera relative to the starting node.
Definition at line 76 of file cullTraverser.I.
References get_world_transform().
Referenced by flush_level(), get_tag_state_key(), RopeNode::reset_bound(), and BillboardEffect::safe_to_transform().
|
inline |
Returns the object that will receive the culled Geoms.
Definition at line 196 of file cullTraverser.I.
References set_portal_clipper().
Referenced by CallbackNode::add_for_draw(), ComputeNode::add_for_draw(), SpeedTreeNode::add_for_draw(), GeomNode::combine_with(), OccluderNode::cull_callback(), PlaneNode::cull_callback(), RocketRenderInterface::render(), SheetNode::reset_bound(), RopeNode::reset_bound(), set_cull_handler(), and NodeCullCallbackData::upcall().
|
inline |
Returns the currently-executing thread object, as passed to the CullTraverser constructor.
Definition at line 33 of file cullTraverser.I.
References get_scene().
Referenced by FrameRateMeter::clear_window(), SceneGraphAnalyzerMeter::clear_window(), GeomNode::combine_with(), PortalNode::cull_callback(), get_gsg(), CullableObject::munge_geom(), and DrawCullHandler::record_object().
|
inline |
Returns true, as depth offsets are the only way that we implement decals nowadays.
Definition at line 117 of file cullTraverser.I.
References set_camera_mask().
Referenced by get_initial_state().
|
inline |
Returns true if the cull traversal is effectively in incomplete_render state, considering both the GSG's incomplete_render and the current DisplayRegion's incomplete_render flags.
This returns the flag during the cull traversal; see GSG::get_effective_incomplete_render() for this same flag during the draw traversal.
Definition at line 232 of file cullTraverser.I.
References flush_level().
Referenced by get_portal_clipper().
|
inline |
Returns the GraphicsStateGuardian in effect.
Definition at line 22 of file cullTraverser.I.
References get_current_thread().
Referenced by SpeedTreeNode::cull_callback(), and CullableObject::munge_geom().
|
inline |
Returns the initial RenderState at the top of the scene graph we are traversing, or the empty state if the initial state was never set.
Definition at line 106 of file cullTraverser.I.
References get_depth_offset_decals().
Referenced by get_world_transform().
|
inline |
Returns the _portal_clipper pointer.
Definition at line 216 of file cullTraverser.I.
References get_effective_incomplete_render().
Referenced by PortalNode::cull_callback(), and set_portal_clipper().
|
inline |
Returns the SceneSetup object.
Definition at line 43 of file cullTraverser.I.
References has_tag_state_key().
Referenced by CullTraverserData::apply_transform_and_state(), FadeLODNode::cull_callback(), LODNode::cull_callback(), PolylightEffect::cull_callback(), SpeedTreeNode::cull_callback(), Character::force_update(), get_current_thread(), PlaneNode::is_renderable(), CullableObject::munge_geom(), CullTraverserData::node_reader(), RocketRenderInterface::render(), and LODNode::verify_child_bounds().
|
inline |
Returns the tag state key that has been specified for the scene's camera, if any.
Definition at line 65 of file cullTraverser.I.
References get_camera_transform().
Referenced by CullTraverserData::apply_transform_and_state(), and has_tag_state_key().
|
inline |
Returns the bounding volume that corresponds to the view frustum, or NULL if the view frustum is not in use or has not been set.
Note that the view frustum returned here is always in the coordinate space of the starting node, not the current node, even if it is sampled during a traversal. To get the view frustum in the current node's coordinate space, check in the current CullTraverserData.
Definition at line 174 of file cullTraverser.I.
References set_cull_handler().
Referenced by PortalNode::cull_callback(), and set_view_frustum().
|
inline |
Returns the position of the starting node relative to the camera.
This is the inverse of the camera transform.
Note that this value is always the position of the starting node, not the current node, even if it is sampled during a traversal. To get the transform of the current node use CullTraverserData::get_modelview_transform().
Definition at line 94 of file cullTraverser.I.
References get_initial_state().
Referenced by get_camera_transform(), CullTraverserData::node_reader(), and RocketRenderInterface::render().
|
inline |
Returns true if a nonempty tag state key has been specified for the scene's camera, false otherwise.
Definition at line 54 of file cullTraverser.I.
References get_tag_state_key().
Referenced by CullTraverserData::apply_transform_and_state(), and get_scene().
|
inline |
Changes the visibility mask for the camera viewing the scene.
This is normally set automatically at the time setup_scene() is called; you should change this only if you want to render some set of objects different from what the camera normally would draw.
Definition at line 132 of file cullTraverser.I.
References get_camera_mask().
Referenced by get_depth_offset_decals().
|
inline |
Specifies the object that will receive the culled Geoms.
This must be set before calling traverse().
Definition at line 185 of file cullTraverser.I.
References get_cull_handler().
Referenced by GraphicsEngine::do_cull(), get_view_frustum(), and PipeOcclusionCullTraverser::set_scene().
|
inline |
Specifies _portal_clipper object pointer that subsequent traverse() or traverse_below may use.
Definition at line 206 of file cullTraverser.I.
References get_portal_clipper().
Referenced by get_cull_handler().
|
virtual |
Sets the SceneSetup object that indicates the initial camera position, etc.
This must be called before traversal begins.
Reimplemented in PipeOcclusionCullTraverser.
Definition at line 93 of file cullTraverser.cxx.
References Camera::get_camera_mask(), SceneSetup::get_camera_node(), Thread::get_current_thread(), SceneSetup::get_initial_state(), Camera::get_tag_state_key(), and traverse().
Referenced by PipeOcclusionCullTraverser::set_scene().
|
inline |
Specifies the bounding volume that corresponds to the view frustum.
Any primitives that fall entirely outside of this volume are not drawn.
Definition at line 155 of file cullTraverser.I.
References get_view_frustum().
Referenced by get_camera_mask().
void CullTraverser::traverse | ( | const NodePath & | root | ) |
Begins the traversal from the indicated node.
Definition at line 116 of file cullTraverser.cxx.
References PortalClipper::draw_camera_frustum(), PortalClipper::draw_lines(), NodePath::get_transform(), and TypedObject::is_of_type().
Referenced by TextNode::apply_attribs_to_vertices(), FadeLODNode::cull_callback(), LODNode::cull_callback(), CollisionNode::cull_callback(), PGEntry::cull_callback(), RigidBodyCombiner::cull_callback(), set_scene(), and LODNode::verify_child_bounds().
void CullTraverser::traverse | ( | CullTraverserData & | data | ) |
Traverses from the next node with the given data, which has been constructed with the node but has not yet been converted into the node's space.
Definition at line 178 of file cullTraverser.cxx.
References traverse_below().
|
virtual |
Traverses all the children of the indicated node, with the given data, which has been converted into the node's space.
Definition at line 190 of file cullTraverser.cxx.
References PandaNode::add_for_draw(), end_traverse(), PandaNode::Children::get_child(), PandaNodePipelineReader::get_effects(), PandaNode::get_first_visible_child(), PandaNode::get_next_visible_child(), PandaNode::Children::get_num_children(), RenderEffects::has_decal(), PandaNode::has_selective_visibility(), PandaNode::is_geom_node(), CullTraverserData::is_this_node_hidden(), CullTraverserData::node(), CullTraverserData::node_reader(), and PandaNodePipelineReader::release().
Referenced by PortalNode::cull_callback(), PGTop::cull_callback(), flush_level(), PipeOcclusionCullTraverser::get_texture(), traverse(), and NodeCullCallbackData::upcall().