MACROMEDIA FLASH MX 2004 - ACTIONSCRIPT Reference Manual page 324

Camera.setMode()
Availability
Flash Player 6.
Usage
active_cam.setMode(width, height, fps [,favorSize])
Parameters
The requested capture width, in pixels. The default value is 160.
width
The requested capture height, in pixels. The default value is 120.
height
The requested rate at which the camera should capture data, in frames per second. The
fps
default value is 15.
Optional: a Boolean value that specifies how to manipulate the width, height, and
favorSize
frame rate if the camera does not have a native mode that meets the specified requirements. The
default value is
true
selects the mode that most closely matches
affects performance by reducing the frame rate. To maximize frame rate at the expense of camera
height and width, pass
Returns
Nothing.
Description
Method; sets the camera capture mode to the native mode that best meets the specified
requirements. If the camera does not have a native mode that matches all the parameters you pass,
Flash selects a capture mode that most closely synthesizes the requested mode. This manipulation
may involve cropping the image and dropping frames.
By default, Flash drops frames as needed to maintain image size. To minimize the number of
dropped frames, even if this means reducing the size of the image, pass
parameter.
favorSize
When choosing a native mode, Flash tries to maintain the requested aspect ratio whenever
possible. For example, if you issue the command
maximum width and height values available on the camera are 320 and 288, Flash sets both the
width and height at 288; by setting these properties to the same value, Flash maintains the 1:1
aspect ratio you requested.
To determine the values assigned to these properties after Flash selects the mode that most closely
matches your requested values, use
Example
The following example sets the width, height, and fps based on the user's input if the user clicks
the button. The optional parameter,
will provide the settings closest to the user's preference without sacrificing the picture quality,
although the fps may then be sacrificed. The user interface is then updated with the new settings.
324 Chapter 12: ActionScript Dictionary
, which means that maintaining capture size is favored; using this parameter
for the
false favorSize
Camera.width
favorSize
and values, even if doing so adversely
width height
parameter.
active_cam.setMode(400, 400, 30)
,
Camera.height
is not included, because the default value,
for the
false
, and the
, and .
Camera.fps
,
true