Panda3D
|
This object manages the process of recording the user's runtime inputs to a bam file so that the session can be recreated later. More...
#include "recorderController.h"
Public Types | |
typedef Factory< RecorderBase > | RecorderFactory |
Public Member Functions | |
void | add_recorder (const string &name, RecorderBase *recorder) |
Adds the named recorder to the set of recorders that are in use. | |
TypedObject * | as_typed_object () |
Returns the object, upcast (if necessary) to a TypedObject pointer. | |
const TypedObject * | as_typed_object () const |
Returns the object, upcast (if necessary) to a TypedObject pointer. | |
bool | begin_playback (const Filename &filename) |
Begins playing back data from the indicated filename. | |
bool | begin_record (const Filename &filename) |
Begins recording data to the indicated filename. | |
void | close () |
Finishes recording data to the indicated filename. | |
virtual TypeHandle | force_init_type () |
int | get_best_parent_from_Set (const std::set< int > &) const |
double | get_clock_offset () const |
Returns the delta offset between the actual frame time and the frame time written to the log. | |
const Filename & | get_filename () const |
Returns the filename that was passed to the most recent call to begin_record() or begin_playback(). | |
int | get_frame_offset () const |
Returns the delta offset between the actual frame count and the frame count written to the log. | |
bool | get_frame_tie () const |
See set_frame_tie(). | |
int | get_random_seed () const |
Returns the random seed that was set by a previous call to set_random_seed(), or the number read from the session file after begin_playback() has been called. | |
RecorderBase * | get_recorder (const string &name) const |
Returns the recorder with the indicated name, or NULL if there is no such recorder. | |
int | get_ref_count () const |
Returns the current reference count. | |
time_t | get_start_time () const |
Returns the time (and date) at which the current session was originally recorded (or, in recording mode, the time at which the current session began). | |
virtual TypeHandle | get_type () const |
int | get_type_index () const |
Returns the internal index number associated with this object's TypeHandle, a unique number for each different type. | |
WeakReferenceList * | get_weak_list () const |
Returns the WeakReferenceList associated with this ReferenceCount object. | |
bool | has_recorder (const string &name) const |
Returns true if the named recorder has been added to the table by a previous call to add_recorder(), false otherwise. | |
bool | has_weak_list () const |
Returns true if this particular ReferenceCount object has a WeakReferenceList created, false otherwise. | |
bool | is_error () |
Returns true if the controller has been opened for input or output output and there is an error on the stream, or false if the controller is closed or if there is no problem. | |
bool | is_exact_type (TypeHandle handle) const |
Returns true if the current object is the indicated type exactly. | |
bool | is_of_type (TypeHandle handle) const |
Returns true if the current object is or derives from the indicated type. | |
bool | is_open () const |
Returns true if the controller has been opened for either input or output, false otherwise. | |
bool | is_playing () const |
Returns true if the controller has been opened for input, false otherwise. | |
bool | is_recording () const |
Returns true if the controller has been opened for output, false otherwise. | |
void | local_object () |
This function should be called, once, immediately after creating a new instance of some ReferenceCount-derived object on the stack. | |
void | operator delete (void *ptr) |
void | operator delete (void *ptr, void *) |
void | operator delete (void *ptr) |
void | operator delete (void *ptr, void *) |
void | operator delete[] (void *ptr) |
void | operator delete[] (void *, void *) |
void | operator delete[] (void *ptr) |
void | operator delete[] (void *, void *) |
void * | operator new (size_t size) |
void * | operator new (size_t size, void *ptr) |
void * | operator new (size_t size) |
void * | operator new (size_t size, void *ptr) |
void * | operator new[] (size_t size) |
void * | operator new[] (size_t size, void *ptr) |
void * | operator new[] (size_t size) |
void * | operator new[] (size_t size, void *ptr) |
void | play_frame () |
Gets the next frame of data from all of the active recorders and adds it to the output file. | |
void | record_frame () |
Gets the next frame of data from all of the active recorders and adds it to the output file. | |
void | ref () const |
Explicitly increments the reference count. | |
bool | remove_recorder (const string &name) |
Removes the named recorder from the table. | |
void | set_frame_tie (bool frame_tie) |
Sets the frame_tie flag. | |
void | set_random_seed (int random_seed) |
Indicates an arbitrary number to be recorded in the session file as a random seed, should the application wish to take advantage of it. | |
bool | test_ref_count_integrity () const |
Does some easy checks to make sure that the reference count isn't completely bogus. | |
bool | test_ref_count_nonzero () const |
Does some easy checks to make sure that the reference count isn't zero, or completely bogus. | |
virtual bool | unref () const |
Explicitly decrements the reference count. | |
void | weak_ref (WeakPointerToVoid *ptv) |
Adds the indicated PointerToVoid as a weak reference to this object. | |
void | weak_unref (WeakPointerToVoid *ptv) |
Removes the indicated PointerToVoid as a weak reference to this object. | |
Static Public Member Functions | |
static TypeHandle | get_class_type () |
static RecorderFactory * | get_factory () |
Returns the global RecorderFactory for generating TypedWritable objects. | |
static void | init_type () |
This function is declared non-inline to work around a compiler bug in g++ 2.96. | |
Protected Member Functions | |
bool | do_test_ref_count_integrity () const |
Does some easy checks to make sure that the reference count isn't completely bogus. | |
bool | do_test_ref_count_nonzero () const |
Returns true if the reference count is nonzero, false otherwise. | |
Friends | |
class | RecorderFrame |
This object manages the process of recording the user's runtime inputs to a bam file so that the session can be recreated later.
Definition at line 35 of file recorderController.h.
void RecorderController::add_recorder | ( | const string & | name, |
RecorderBase * | recorder | ||
) | [inline] |
Adds the named recorder to the set of recorders that are in use.
If the controller is in recording mode, the named recorder will begin recording its status to the session file. If the controller is in playback mode and the name and type matches a recorder in the session file, the recorder will begin receiving data.
Definition at line 151 of file recorderController.I.
References RecorderTable::add_recorder(), and is_recording().
Referenced by PandaFramework::get_mouse().
const TypedObject * TypedObject::as_typed_object | ( | ) | const [inline, inherited] |
Returns the object, upcast (if necessary) to a TypedObject pointer.
Definition at line 110 of file typedObject.I.
TypedObject * TypedObject::as_typed_object | ( | ) | [inline, inherited] |
Returns the object, upcast (if necessary) to a TypedObject pointer.
Definition at line 99 of file typedObject.I.
bool RecorderController::begin_playback | ( | const Filename & | filename | ) |
Begins playing back data from the indicated filename.
All of the recorders in use should already have been added, although this may define additional recorders if they are present in the file (these new recorders will not be used). This may also undefine recorders that were previously added but are not present in the file.
Definition at line 122 of file recorderController.cxx.
References close(), ClockObject::get_frame_count(), ClockObject::get_frame_time(), ClockObject::get_global_clock(), BamReader::init(), TypedObject::is_of_type(), DatagramInputFile::open(), DatagramInputFile::read_header(), BamReader::read_object(), and BamReader::resolve().
Referenced by PandaFramework::open_framework().
bool RecorderController::begin_record | ( | const Filename & | filename | ) |
Begins recording data to the indicated filename.
All of the recorders in use should already have been added.
Definition at line 64 of file recorderController.cxx.
References close(), ClockObject::get_frame_count(), ClockObject::get_frame_time(), ClockObject::get_global_clock(), BamWriter::init(), DatagramOutputFile::open(), DatagramOutputFile::write_header(), and BamWriter::write_object().
Referenced by PandaFramework::open_framework().
void RecorderController::close | ( | ) |
Finishes recording data to the indicated filename.
Definition at line 191 of file recorderController.cxx.
References DatagramInputFile::close(), and DatagramOutputFile::close().
Referenced by begin_playback(), begin_record(), and play_frame().
bool ReferenceCount::do_test_ref_count_integrity | ( | ) | const [protected, inherited] |
Does some easy checks to make sure that the reference count isn't completely bogus.
Returns true if ok, false otherwise.
Reimplemented in NodeReferenceCount, CachedTypedWritableReferenceCount, and NodeCachedReferenceCount.
Definition at line 29 of file referenceCount.cxx.
Referenced by ReferenceCount::do_test_ref_count_nonzero(), and ReferenceCount::test_ref_count_integrity().
bool ReferenceCount::do_test_ref_count_nonzero | ( | ) | const [protected, inherited] |
Returns true if the reference count is nonzero, false otherwise.
Definition at line 56 of file referenceCount.cxx.
References ReferenceCount::do_test_ref_count_integrity().
Referenced by ReferenceCount::test_ref_count_nonzero().
double RecorderController::get_clock_offset | ( | ) | const [inline] |
Returns the delta offset between the actual frame time and the frame time written to the log.
This is essentially the time at which the recording (or playback) started.
Definition at line 120 of file recorderController.I.
RecorderController::RecorderFactory * RecorderController::get_factory | ( | ) | [inline, static] |
Returns the global RecorderFactory for generating TypedWritable objects.
Definition at line 274 of file recorderController.I.
Referenced by RecorderTable::fillin(), and MouseRecorder::register_with_read_factory().
const Filename & RecorderController::get_filename | ( | ) | const [inline] |
Returns the filename that was passed to the most recent call to begin_record() or begin_playback().
Definition at line 94 of file recorderController.I.
int RecorderController::get_frame_offset | ( | ) | const [inline] |
Returns the delta offset between the actual frame count and the frame count written to the log.
This is essentially the frame number at which the recording (or playback) started.
Definition at line 133 of file recorderController.I.
bool RecorderController::get_frame_tie | ( | ) | const [inline] |
See set_frame_tie().
Definition at line 263 of file recorderController.I.
int RecorderController::get_random_seed | ( | ) | const [inline] |
Returns the random seed that was set by a previous call to set_random_seed(), or the number read from the session file after begin_playback() has been called.
Definition at line 50 of file recorderController.I.
RecorderBase * RecorderController::get_recorder | ( | const string & | name | ) | const [inline] |
Returns the recorder with the indicated name, or NULL if there is no such recorder.
If the controller is in playback mode, this may return the recorder matching the indicated name as read from the session file, even if it was never added to the table by the user. In this case, has_recorder() may return false, but get_recorder() will return a non-NULL value.
Definition at line 195 of file recorderController.I.
References RecorderTable::get_recorder(), and is_playing().
int ReferenceCount::get_ref_count | ( | ) | const [inline, inherited] |
Returns the current reference count.
Definition at line 155 of file referenceCount.I.
References ReferenceCount::test_ref_count_integrity().
Referenced by TransformState::clear_cache(), RenderState::clear_cache(), RenderState::finalize(), RenderEffects::finalize(), RenderEffect::finalize(), RenderAttrib::finalize(), InternalName::finalize(), TransformState::get_num_unused_states(), RenderState::get_num_unused_states(), TransformState::list_cycles(), RenderState::list_cycles(), GeomVertexFormat::remove_column(), TransformState::unref(), RenderState::unref(), RenderState::~RenderState(), and TransformState::~TransformState().
time_t RecorderController::get_start_time | ( | ) | const [inline] |
Returns the time (and date) at which the current session was originally recorded (or, in recording mode, the time at which the current session began).
Definition at line 24 of file recorderController.I.
int TypedObject::get_type_index | ( | ) | const [inline, inherited] |
Returns the internal index number associated with this object's TypeHandle, a unique number for each different type.
This is equivalent to get_type().get_index().
Definition at line 52 of file typedObject.I.
References TypeHandle::get_index().
WeakReferenceList * ReferenceCount::get_weak_list | ( | ) | const [inline, inherited] |
Returns the WeakReferenceList associated with this ReferenceCount object.
If there has never been a WeakReferenceList associated with this object, creates one now.
Definition at line 307 of file referenceCount.I.
Referenced by ReferenceCount::weak_ref().
bool RecorderController::has_recorder | ( | const string & | name | ) | const [inline] |
Returns true if the named recorder has been added to the table by a previous call to add_recorder(), false otherwise.
If the controller is in playback mode, this will also return false for a recorder that was found in the session file but was never explicitly added via add_recorder(); see get_recorder().
Definition at line 177 of file recorderController.I.
References RecorderTable::get_recorder().
bool ReferenceCount::has_weak_list | ( | ) | const [inline, inherited] |
Returns true if this particular ReferenceCount object has a WeakReferenceList created, false otherwise.
In general, this will be true if there was ever a WeakPointerTo created for this object (even if there is not any for it now).
Definition at line 294 of file referenceCount.I.
Referenced by ReferenceCount::weak_unref().
static void RecorderController::init_type | ( | ) | [inline, static] |
This function is declared non-inline to work around a compiler bug in g++ 2.96.
Making it inline seems to cause problems in the optimizer.
Reimplemented from TypedReferenceCount.
Definition at line 113 of file recorderController.h.
References TypedReferenceCount::init_type().
bool RecorderController::is_error | ( | ) | [inline] |
Returns true if the controller has been opened for input or output output and there is an error on the stream, or false if the controller is closed or if there is no problem.
Definition at line 107 of file recorderController.I.
References DatagramInputFile::is_error(), and DatagramOutputFile::is_error().
bool TypedObject::is_exact_type | ( | TypeHandle | handle | ) | const [inline, inherited] |
Returns true if the current object is the indicated type exactly.
Definition at line 74 of file typedObject.I.
References TypeHandle::get_name().
Referenced by GraphicsStateGuardian::async_reload_texture(), PortalNode::combine_with(), PandaNode::combine_with(), GeomNode::combine_with(), CollisionNode::combine_with(), Character::combine_with(), PGItem::cull_callback(), FactoryParams::get_param_of_type(), CollisionHandlerPusher::handle_entries(), SceneGraphReducer::r_flatten(), ConnectionWriter::send(), FltToEggLevelState::set_transform(), and VirtualFileSystem::unmount().
bool TypedObject::is_of_type | ( | TypeHandle | handle | ) | const [inline, inherited] |
Returns true if the current object is or derives from the indicated type.
Definition at line 63 of file typedObject.I.
References TypeHandle::is_derived_from().
Referenced by EggSliderData::add_back_pointer(), EggJointData::add_back_pointer(), CIntervalManager::add_c_interval(), XFileNode::add_child(), CollisionTraverser::add_collider(), CollisionHandlerPhysical::add_collider(), EggXfmSAnim::add_data(), CharacterJointBundle::add_node(), NonlinearImager::add_screen(), EggGroupNode::apply_first_attribute(), EggGroupNode::apply_last_attribute(), DeferredNodeProperty::apply_to_node(), begin_playback(), NodePath::clear_clip_plane(), EggGroupNode::clear_connected_shading(), NodePath::clear_light(), EggBase::convert_paths(), NodePath::decode_from_bam_stream(), VrpnClient::disconnect_device(), PhysicsManager::do_physics(), GraphicsStateGuardian::fetch_specified_part(), EggRenderState::fill_state(), AnimBundleNode::find_anim_bundle(), EggGroupNode::find_coordsys_entry(), XFile::find_data_object(), Character::find_joint(), EggGroupNode::find_materials(), Character::find_slider(), XFile::find_template(), EggGroupNode::find_textures(), EggMaterialCollection::find_used_materials(), EggTextureCollection::find_used_textures(), EggGroupNode::force_filenames(), EggJointData::force_initial_rest_frame(), WindowFramework::get_aspect_2d(), EggPoolUniquifier::get_category(), EggGroupUniquifier::get_category(), EggGroupNode::get_connected_shading(), PandaFramework::get_mouse(), FactoryParams::get_param_of_type(), EggGroupNode::has_absolute_pathnames(), NodePath::has_clip_plane(), NodePath::has_clip_plane_off(), NodePath::has_light(), PandaFramework::hide_collision_solids(), x11GraphicsWindow::open_window(), eglGraphicsWindow::open_window(), EggNode::parse_egg(), CharacterMaker::part_to_node(), EggGroupNode::post_apply_flat_attribute(), EggBinner::prepare_node(), PortalClipper::prepare_portal(), NodePath::project_texture(), EggMatrixTablePointer::quantize_channels(), ParametricCurveCollection::r_add_curves(), SceneGraphReducer::r_collect_vertex_data(), EggGroupNode::r_load_externals(), EggGroupNode::rebuild_vertex_pools(), EggGroupNode::recompute_polygon_normals(), EggGroupNode::remove_invalid_primitives(), EggGroupNode::remove_unused_vertices(), EggLoader::reparent_decals(), EggMaterialCollection::replace_materials(), EggTextureCollection::replace_textures(), EggGroupNode::resolve_filenames(), EggGroupNode::reverse_vertex_ordering(), NodePath::set_clip_plane(), NodePath::set_clip_plane_off(), NodePath::set_light(), ProjectionScreen::set_projector(), NonlinearImager::set_source_camera(), EggXfmSAnim::set_value(), NonlinearImager::set_viewer_camera(), PandaFramework::show_collision_solids(), BamCache::store(), XFileToEggConverter::strip_nodes(), EggGroupNode::strip_normals(), DataGraphTraverser::traverse(), DataGraphTraverser::traverse_below(), EggGroupNode::triangulate_polygons(), EggGroupNode::unify_attributes(), EggNameUniquifier::uniquify(), NodeCullCallbackData::upcall(), PhysicsCollisionHandler::validate_target(), EggXfmSAnim::write(), EggGroup::write(), EggToDXFLayer::write_3d_face(), and EggToDXFLayer::write_entities().
bool RecorderController::is_open | ( | ) | const [inline] |
Returns true if the controller has been opened for either input or output, false otherwise.
Definition at line 83 of file recorderController.I.
References is_playing(), and is_recording().
bool RecorderController::is_playing | ( | ) | const [inline] |
Returns true if the controller has been opened for input, false otherwise.
Definition at line 72 of file recorderController.I.
Referenced by get_recorder(), is_open(), play_frame(), and remove_recorder().
bool RecorderController::is_recording | ( | ) | const [inline] |
Returns true if the controller has been opened for output, false otherwise.
Definition at line 61 of file recorderController.I.
Referenced by add_recorder(), is_open(), record_frame(), and remove_recorder().
void ReferenceCount::local_object | ( | ) | [inline, inherited] |
This function should be called, once, immediately after creating a new instance of some ReferenceCount-derived object on the stack.
This allows the object to be passed to functions that will increment and decrement the object's reference count temporarily, and it will prevent the object from being deleted (inappropriately), when the reference count returns to zero. It actually achieves this by setting a large positive value in the reference count field.
Definition at line 276 of file referenceCount.I.
Referenced by PGTop::cull_callback(), BoundingSphere::extend_by_hexahedron(), AsyncTaskManager::find_task(), AsyncTaskManager::find_tasks(), and AsyncTaskManager::find_tasks_matching().
void RecorderController::play_frame | ( | ) |
Gets the next frame of data from all of the active recorders and adds it to the output file.
Definition at line 259 of file recorderController.cxx.
References close(), ClockObject::get_frame_count(), ClockObject::get_frame_time(), ClockObject::get_global_clock(), BamReader::is_eof(), is_playing(), RecorderTable::merge_from(), and RecorderFrame::play_frame().
void RecorderController::record_frame | ( | ) |
Gets the next frame of data from all of the active recorders and adds it to the output file.
Definition at line 239 of file recorderController.cxx.
References ClockObject::get_frame_count(), ClockObject::get_frame_time(), ClockObject::get_global_clock(), is_recording(), and BamWriter::write_object().
void ReferenceCount::ref | ( | ) | const [inline, inherited] |
Explicitly increments the reference count.
User code should avoid using ref() and unref() directly, which can result in missed reference counts. Instead, let a PointerTo object manage the reference counting automatically.
This function is const, even though it changes the object, because generally fiddling with an object's reference count isn't considered part of fiddling with the object. An object might be const in other ways, but we still need to accurately count the number of references to it.
Definition at line 179 of file referenceCount.I.
References ReferenceCount::test_ref_count_integrity().
Referenced by CachedTypedWritableReferenceCount::cache_ref(), TypedWritable::decode_raw_from_bam_stream(), NodeCachedReferenceCount::node_ref(), NodeReferenceCount::node_ref(), BamCacheRecord::set_data(), CullableObject::set_draw_callback(), and ModelRoot::set_reference().
bool RecorderController::remove_recorder | ( | const string & | name | ) | [inline] |
Removes the named recorder from the table.
Returns true if successful, false if there was no such recorder.
If the controller is in recording mode, the named recorder will stop recording. If the controller is in playback mode, the named recorder will disassociate itself from the session file (but if the session file still has data for this name, a default recorder will take its place to decode the data from the session file).
Definition at line 219 of file recorderController.I.
References RecorderTable::get_recorder(), is_playing(), is_recording(), and RecorderTable::remove_recorder().
void RecorderController::set_frame_tie | ( | bool | frame_tie | ) | [inline] |
Sets the frame_tie flag.
When this is true, sessions are played back frame-for-frame, based on the frame count of the recorded session. This gives the most accurate playback, but the playback rate will vary according to the frame rate of the playback machine.
When this is false, sessions are played back at real time, based on the clock of the recorded session. This may introduce playback discrepencies if the frames do not fall at exactly the same times as they did in the original.
Definition at line 253 of file recorderController.I.
void RecorderController::set_random_seed | ( | int | random_seed | ) | [inline] |
Indicates an arbitrary number to be recorded in the session file as a random seed, should the application wish to take advantage of it.
This must be set before begin_record() is called.
Definition at line 37 of file recorderController.I.
bool ReferenceCount::test_ref_count_integrity | ( | ) | const [inline, inherited] |
Does some easy checks to make sure that the reference count isn't completely bogus.
Returns true if ok, false otherwise.
Reimplemented in NodeReferenceCount, CachedTypedWritableReferenceCount, and NodeCachedReferenceCount.
Definition at line 236 of file referenceCount.I.
References ReferenceCount::do_test_ref_count_integrity().
Referenced by EggGroupNode::add_child(), InternalName::find_ancestor(), InternalName::get_ancestor(), ReferenceCount::get_ref_count(), InternalName::get_top(), ReferenceCount::ref(), EggVertex::test_gref_integrity(), EggVertex::test_pref_integrity(), EggNode::test_under_integrity(), EggPrimitive::test_vref_integrity(), EggGroup::test_vref_integrity(), MouseWatcher::throw_event_pattern(), ReferenceCount::unref(), and EggNode::update_under().
bool ReferenceCount::test_ref_count_nonzero | ( | ) | const [inline, inherited] |
Does some easy checks to make sure that the reference count isn't zero, or completely bogus.
Returns true if ok, false otherwise.
Definition at line 252 of file referenceCount.I.
References ReferenceCount::do_test_ref_count_nonzero().
Referenced by CopyOnWritePointer::test_ref_count_nonzero().
bool ReferenceCount::unref | ( | ) | const [inline, virtual, inherited] |
Explicitly decrements the reference count.
Note that the object will not be implicitly deleted by unref() simply because the reference count drops to zero. (Having a member function delete itself is problematic.) However, see the helper function unref_delete().
User code should avoid using ref() and unref() directly, which can result in missed reference counts. Instead, let a PointerTo object manage the reference counting automatically.
This function is const, even though it changes the object, because generally fiddling with an object's reference count isn't considered part of fiddling with the object. An object might be const in other ways, but we still need to accurately count the number of references to it.
The return value is true if the new reference count is nonzero, false if it is zero.
Reimplemented in GeomVertexArrayFormat, GeomVertexFormat, InternalName, RenderAttrib, RenderEffects, RenderState, and TransformState.
Definition at line 214 of file referenceCount.I.
References ReferenceCount::test_ref_count_integrity().
Referenced by CachedTypedWritableReferenceCount::cache_unref(), TypedWritable::decode_raw_from_bam_stream(), RenderEffect::finalize(), NodeCachedReferenceCount::node_unref(), NodeReferenceCount::node_unref(), TransformState::unref(), RenderState::unref(), RenderEffects::unref(), RenderAttrib::unref(), InternalName::unref(), GeomVertexFormat::unref(), and GeomVertexArrayFormat::unref().
void ReferenceCount::weak_ref | ( | WeakPointerToVoid * | ptv | ) | [inline, inherited] |
Adds the indicated PointerToVoid as a weak reference to this object.
Definition at line 321 of file referenceCount.I.
References WeakReferenceList::add_reference(), and ReferenceCount::get_weak_list().
void ReferenceCount::weak_unref | ( | WeakPointerToVoid * | ptv | ) | [inline, inherited] |
Removes the indicated PointerToVoid as a weak reference to this object.
It must have previously been added via a call to weak_ref().
Definition at line 334 of file referenceCount.I.
References WeakReferenceList::clear_reference(), and ReferenceCount::has_weak_list().