User Guide

496 Chapter 7: ActionScript for Flash

Camera.fps

Availability

Flash Player 6.

Usage

active_cam.fps:Number

Description

Read-only property; 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 the

Camera.currentFps property.

Example

The following example detects the rate in frames per second that the camera captures data, using

the

currentFps property:

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() function does not guarantee the requested fps setting; it sets the fps you

requested or the fastest fps available.