A simple, scrolling-text stats monitor. More...
#include "textMonitor.h"
Public Member Functions | |
TextMonitor (TextStats *server, ostream *outStream, bool show_raw_data) | |
virtual string | get_monitor_name () |
Should be redefined to return a descriptive name for the type of PStatsMonitor this is. More... | |
TextStats * | get_server () |
Returns the server that owns this monitor. More... | |
virtual void | got_bad_version (int client_major, int client_minor, int server_major, int server_minor) |
Like got_hello(), this is called when the "hello" message has been received from the client. More... | |
virtual void | got_hello () |
Called when the "hello" message has been received from the client. More... | |
virtual bool | is_thread_safe () |
Should be redefined to return true if this monitor class can handle running in a sub-thread. More... | |
virtual void | lost_connection () |
Called whenever the connection to the client has been lost. More... | |
virtual void | new_data (int thread_index, int frame_number) |
Called as each frame's data is made available. More... | |
void | show_level (const PStatViewLevel *level, int indent_level) |
void | show_ms (const PStatViewLevel *level, int indent_level) |
![]() | |
PStatMonitor (PStatServer *server) | |
void | bad_version (const string &hostname, const string &progname, int client_major, int client_minor, int server_major, int server_minor) |
Called shortly after startup time with the greeting from the client. More... | |
void | close () |
Closes the client connection if it is active. More... | |
const PStatClientData * | get_client_data () const |
Returns the client data associated with this monitor. More... | |
string | get_client_hostname () const |
Returns the hostname of the client we're connected to, if known. More... | |
string | get_client_progname () const |
Returns the program name of the client we're connected to, if known. More... | |
const LRGBColor & | get_collector_color (int collector_index) |
Returns the color associated with the indicated collector. More... | |
string | get_collector_name (int collector_index) |
Returns the name of the indicated collector, if it is known. More... | |
PStatView & | get_level_view (int collector_index, int thread_index) |
Returns a view on the level value (as opposed to elapsed time) for the given collector over the given thread. More... | |
PStatServer * | get_server () |
Returns the server that owns this monitor. More... | |
PStatView & | get_view (int thread_index) |
Returns a view on the given thread index. More... | |
virtual bool | has_idle () |
Should be redefined to return true if you want to redefine idle() and expect it to be called. More... | |
void | hello_from (const string &hostname, const string &progname) |
Called shortly after startup time with the greeting from the client. More... | |
virtual void | idle () |
If has_idle() returns true, this will be called periodically to allow the monitor to update its display or whatever it needs to do. More... | |
virtual void | initialized () |
Called after the monitor has been fully set up. More... | |
bool | is_alive () const |
Returns true if the client is alive and connected, false otherwise. More... | |
bool | is_client_known () const |
Returns true if we've yet received the "hello" message from the client indicating its name, etc. More... | |
virtual void | new_collector (int collector_index) |
Called whenever a new Collector definition is received from the client. More... | |
virtual void | new_thread (int thread_index) |
Called whenever a new Thread definition is received from the client. More... | |
void | set_client_data (PStatClientData *client_data) |
Called by the PStatServer at setup time to set the new data pointer for the first time. More... | |
virtual void | user_guide_bars_changed () |
Called when the user guide bars have been changed. More... | |
![]() | |
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... | |
Additional Inherited Members | |
![]() | |
static TypeHandle | get_class_type () |
static void | init_type () |
A simple, scrolling-text stats monitor.
Guaranteed to compile on every platform.
Definition at line 32 of file textMonitor.h.
|
virtual |
Should be redefined to return a descriptive name for the type of PStatsMonitor this is.
Implements PStatMonitor.
Definition at line 50 of file textMonitor.cxx.
TextStats * TextMonitor::get_server | ( | ) |
Returns the server that owns this monitor.
Definition at line 39 of file textMonitor.cxx.
References PStatMonitor::get_server().
|
virtual |
Like got_hello(), this is called when the "hello" message has been received from the client.
At this time, the client's hostname and program name will be known. However, the client appears to be an incompatible version and the connection will be terminated; the monitor should issue a message to that effect.
Reimplemented from PStatMonitor.
Definition at line 79 of file textMonitor.cxx.
References PStatMonitor::get_client_hostname(), and PStatMonitor::get_client_progname().
|
virtual |
Called when the "hello" message has been received from the client.
At this time, the client's hostname and program name will be known.
Reimplemented from PStatMonitor.
Definition at line 62 of file textMonitor.cxx.
References PStatMonitor::get_client_hostname(), and PStatMonitor::get_client_progname().
|
virtual |
Should be redefined to return true if this monitor class can handle running in a sub-thread.
This is not related to the question of whether it can handle multiple different PStatThreadDatas; this is strictly a question of whether or not the monitor itself wants to run in a sub-thread.
Reimplemented from PStatMonitor.
Definition at line 186 of file textMonitor.cxx.
|
virtual |
Called whenever the connection to the client has been lost.
This is a permanent state change. The monitor should update its display to represent this, and may choose to close down automatically.
Reimplemented from PStatMonitor.
Definition at line 170 of file textMonitor.cxx.
|
virtual |
Called as each frame's data is made available.
There is no gurantee the frames will arrive in order, or that all of them will arrive at all. The monitor should be prepared to accept frames received out-of-order or missing.
Reimplemented from PStatMonitor.
Definition at line 100 of file textMonitor.cxx.
References PStatView::all_collectors_known(), PStatViewLevel::get_child(), PStatMonitor::get_client_data(), PStatClientData::get_collector_fullname(), PStatClientData::get_collector_has_level(), PStatThreadData::get_frame(), PStatThreadData::get_frame_rate(), PStatThreadData::get_latest_frame_number(), PStatMonitor::get_level_view(), PStatView::get_net_value(), PStatViewLevel::get_num_children(), PStatFrameData::get_num_events(), PStatClientData::get_num_toplevel_collectors(), PStatView::get_thread_data(), PStatClientData::get_thread_name(), PStatFrameData::get_time(), PStatFrameData::get_time_collector(), PStatView::get_top_level(), PStatClientData::get_toplevel_collector(), PStatMonitor::get_view(), PStatClientData::has_collector(), PStatFrameData::is_start(), and PStatView::set_to_frame().