User Guide

14 Client-Side ActionScript Language Reference
See also
Camera.fps, Camera.setMode()
Camera.fps
Availability
■ Flash Player 6.
■ Flash Media Server (not required).
Usage
public fps : Number [read-only]
Description
Property (read-only); the maximum rate at which you want the camera to capture data, in
frames per second. The maximum rate possible depends on the capabilities of the camera; that
is, if the camera doesn’t support the value you set here, this frame rate will not be achieved.
■ To set a desired value for this property, use Camera.setMode().
■ To determine the rate at which the camera is currently capturing data, use
Camera.currentFps.
Example
The following example detects the rate in frames per second that the camera captures data,
using the
currentFps property and a ProgressBar instance. Create a new video instance by
selecting New Video from the Library options menu. Add an instance to the Stage and give it
the instance name
my_video. Add a ProgressBar component instance to the Stage and give it
the instance name
fps_pb. Then add the following ActionScript to Frame 1 of the Timeline:
var my_video:Video;
var fps_pb:mx.controls.ProgressBar;
var my_cam:Camera = Camera.get();
my_video.attachVideo(my_cam);
this.onEnterFrame = function() {
fps_pb.setProgress(my_cam.fps-my_cam.currentFps, my_cam.fps);
};
fps_pb.setStyle("fontSize", 10);
fps_pb.setStyle("themeColor", "haloOrange");
fps_pb.labelPlacement = "top";
fps_pb.mode = "manual";
fps_pb.label = "FPS: %2 (%3%% dropped)";
NOTE
The setMode() method does not guarantee the requested fps setting; it sets the fps you
requested or the fastest fps available.