Camera.setquality() - MACROMEDIA FLASH MX 2004-ACTIONSCRIPT LANGUAGE Reference

Camera.setQuality()

Availability
Flash Player 6.
Usage
active_cam.setQuality(bandwidth:Number, frameQuality:Number) : Void
Parameters
An integer that specifies the maximum amount of bandwidth that the current
bandwidth
outgoing video feed can use, in bytes per second. To specify that Flash video can use as much
bandwidth as needed to maintain the value of
value is 16384.
frameQuality
the amount of compression being applied to each video frame. Acceptable values range from 1
(lowest quality, maximum compression) to 100 (highest quality, no compression). To specify that
picture quality can vary as needed to avoid exceeding bandwidth, pass 0 for
default value is 0.
Returns
Nothing.
Description
Method; sets the maximum amount of bandwidth per second or the required picture quality of
the current outgoing video feed. This method is generally applicable only if you are transmitting
video using Flash Communication Server.
Use this method to specify which element of the outgoing video feed is more important to your
application—bandwidth use or picture quality.
•
To indicate that bandwidth use takes precedence, pass a value for
frameQuality
bandwidth. If necessary, Flash will reduce picture quality to avoid exceeding the specified
bandwidth. In general, as motion increases, quality decreases.
•
To indicate that quality takes precedence, pass 0 for
frameQuality
If necessary, Flash will reduce the frame rate to maintain picture quality. In general, as motion
increases, bandwidth use also increases.
•
To specify that both bandwidth and quality are equally important, pass numeric values for
both parameters. Flash will transmit video that achieves the specified quality and that doesn't
exceed the specified bandwidth. If necessary, Flash will reduce the frame rate to maintain
picture quality without exceeding the specified bandwidth.
198 Chapter 2: ActionScript Language Reference
An integer that specifies the required level of picture quality, as determined by
. Flash will transmit video at the highest quality possible within the specified
. Flash will use as much bandwidth as required to maintain the specified quality.
, pass 0 for
frameQuality
and a numeric value for
bandwidth
. The default
bandwidth
frameQuality
and 0 for
bandwidth
. The