org.xj3d.sai
Interface Xj3DStatusListener

public interface Xj3DStatusListener

Listener for basic status information from the browser internals.

Status information is not the same as messages that are reported using the error reporter interface. These are for simple single-line messages.

Version:

$Revision: 1.2 $

Author:

Justin Couch

Method Summary

void	progressUpdate(java.lang.String id, java.lang.String msg, float perc) Notification of a progress update.
void	updateFramesPerSecond(float fps) Notification that the calculated frames per second has changed to this new value.
void	updateStatusMessage(java.lang.String msg) Notification that a single line status message has changed to the new string.

Method Detail

updateStatusMessage

void updateStatusMessage(java.lang.String msg)

Notification that a single line status message has changed to the new string. A null string means to clear the currently displayed message.

Parameters:

msg - The new message string to display for the status

updateFramesPerSecond

void updateFramesPerSecond(float fps)

Notification that the calculated frames per second has changed to this new value. It is expected that this is called frequently.

progressUpdate

void progressUpdate(java.lang.String id,
                    java.lang.String msg,
                    float perc)

Notification of a progress update. There may be several items in progression at once (eg multithreaded texture and scripting loading) so implementers should work appropriately for this situation. To keep this aligned, each item that is reporting progress will have a unique ID string (for this session) associated with it so you can keep track of the multiples. Once 100% has been reached you can assume that the tracking is complete for that object.

Parameters:

id - A unique ID string for the given item

msg - A message to accompany the update

perc - A percentage from 0-100 of the progress completion