Package | away3d.debug |
Class | public class AwayStats |
Inheritance | AwayStats flash.display.Sprite |
Stats monitor for Away3D or general use in any project. The widget was designed to display all the necessary data in ways that are easily readable, while maintaining a tiny size.
The following data is displayed by the widget, either graphically, through text, or both.
There are two display modes; standard and minimized, which are alternated by clicking the button in the upper right corner, at runtime. The widget can also be configured to start in minimized mode by setting the relevant constructor parameter.
All data can be reset at any time, by clicking the lower part of the widget (where the RAM and POLY counters are located. The average FPS can be reset separately by clicking it's displayed value. Furthermore, the stage frame rate can be increased or decreased by clicking the upper and lower parts of the graph, respectively. Clicking close to the center will increment in small values, and further away will increase the steps. The graph itself is only visible in standard (as opposed to minimized) display mode.
The average FPS is calculated using one of two methods, configurable via constructor parameters. By setting the meanDataLength to a non-zero value, the number of recorded frame rate values on which the average is based can be configured. This has a tiny impact on CPU usage, which is the reason why the default number is zero, denoting that the average is calculated from a running sum since the widget was last reset.
Property | Defined By | ||
---|---|---|---|
instance : AwayStats [static] [read-only]
Holds a reference to the stats widget (or if several have been created
during session, the one that was last instantiated.) Allows you to set
properties and register views from anywhere in your code. | AwayStats |
Method | Defined By | ||
---|---|---|---|
AwayStats(view3d:View3D = null, minimized:Boolean = false, transparent:Boolean = false, meanDataLength:uint = 0, enableClickToReset:Boolean = true, enableModifyFrameRate:Boolean = true)
Create an Away3D stats widget. | AwayStats | ||
registerView(view3d:View3D):void
Add a view to the list of those that are taken into account when
calculating on-screen and total poly counts. | AwayStats | ||
unregisterView(view3d:View3D):void
Remove a view from the list of those that are taken into account when
calculating on-screen and total poly counts. | AwayStats |
instance | property |
instance:AwayStats
[read-only] Holds a reference to the stats widget (or if several have been created during session, the one that was last instantiated.) Allows you to set properties and register views from anywhere in your code.
public static function get instance():AwayStats
AwayStats | () | Constructor |
public function AwayStats(view3d:View3D = null, minimized:Boolean = false, transparent:Boolean = false, meanDataLength:uint = 0, enableClickToReset:Boolean = true, enableModifyFrameRate:Boolean = true)
Create an Away3D stats widget. The widget can be added to the stage and positioned like any other display object. Once on the stage, you can drag the widget to re-position it at runtime.
If you pass a View3D instance, the widget will be able to display the total number of faces in your scene, and the amount of faces that were rendered during the last render() call. Views can also be registered after construction using the registerView() method. Omit the view constructor parameter to disable this feature altogether.
Parametersview3d:View3D (default = null ) — A reference to your Away3D view. This is required if you
want the stats widget to display polycounts.
| |
minimized:Boolean (default = false ) — Defines whether the widget should start up in minimized
mode. By default, it is shown in full-size mode on launch.
| |
transparent:Boolean (default = false ) — Defines whether to omit the background plate and print
statistics directly on top of the underlying stage.
| |
meanDataLength:uint (default = 0 ) — The number of frames on which to base the average
frame rate calculation. The default value of zero indicates that all
frames since the last reset will be used.
| |
enableClickToReset:Boolean (default = true ) — Enables interaction allowing you to reset all
counters by clicking the bottom bar of the widget. When activated, you
can also click the average frame rate trace-out to reset just that one
value.
| |
enableModifyFrameRate:Boolean (default = true ) — When enabled, allows you to click the upper
and lower parts of the graph area to increase and decrease SWF frame rate
respectively.
|
registerView | () | method |
public function registerView(view3d:View3D):void
Add a view to the list of those that are taken into account when calculating on-screen and total poly counts. Use this method when the stats widget is not instantiated in the same place as where you create your view, or when using several views, or when views are created and destroyed dynamically at runtime.
Parameters
view3d:View3D |
unregisterView | () | method |
public function unregisterView(view3d:View3D):void
Remove a view from the list of those that are taken into account when calculating on-screen and total poly counts. If the supplied view is the only one known to the stats widget, calling this will leave the list empty, disabling poly count statistics altogether.
Parameters
view3d:View3D |