ACTIONSCRIPT 3 Developer’s Guide en

ACTIONSCRIPT 3.0 DEVELOPER’S GUIDE
Display programming
Mouse locking is disabled automatically and the mouse cursor is made visible again when:
The user exits full-screen mode by using the Escape key (all platforms), Control-W (Windows), Command-W
(Mac), or Alt-F4 (Windows).
The application window loses focus.
Any settings UI is visible, including all privacy dialog boxes.
A native dialog box is shown, such as a file upload dialog box.
Events associated with mouse movement, such as the mouseMove event, use the MouseEvent class to represent the
event object. When mouse locking is disabled, use the MouseEvent.localX and MouseEvent.localY properties to
determine the location of the mouse.When mouse locking is enabled, use the MouseEvent.movementX and
MouseEvent.movementY properties to determine the location of the mouse. The movementX and movementY
properties contain changes in the position of the mouse since the last event, instead of absolute coordinates of the
mouse location.
Hardware scaling in full-screen mode
You can use the Stage class’s fullScreenSourceRect property to set Flash Player or AIR to scale a specific region of
the stage to full-screen mode. Flash Player and AIR scale in hardware, if available, using the graphics and video card
on a user's computer, and generally display content more quickly than software scaling.
To take advantage of hardware scaling, you set the whole stage or part of the stage to full-screen mode. The following
ActionScript 3.0 code sets the whole stage to full-screen mode:
import flash.geom.*;
{
stage.fullScreenSourceRect = new Rectangle(0,0,320,240);
stage.displayState = StageDisplayState.FULL_SCREEN;
}
When this property is set to a valid rectangle and the displayState property is set to full-screen mode, Flash Player
and AIR scale the specified area. The actual Stage size in pixels within ActionScript does not change. Flash Player and
AIR enforce a minimum limit for the size of the rectangle to accommodate the standard “Press Esc to exit full-screen
mode” message. This limit is usually around 260 by 30 pixels but can vary depending on platform and Flash Player
version.
The fullScreenSourceRect property can only be set when Flash Player or AIR is not in full-screen mode. To use
this property correctly, set this property first, then set the displayState property to full-screen mode.
To enable scaling, set the fullScreenSourceRect property to a rectangle object.
stage.fullScreenSourceRect = new Rectangle(0,0,320,240);
To disable scaling, set the fullScreenSourceRect property to null.
stage.fullScreenSourceRect = null;
To take advantage of all hardware acceleration features with Flash Player, enable it through the Flash Player Settings
dialog box. To load the dialog box, right-click (Windows) or Control-click (Mac) inside Flash Player content in your
browser. Select the Display tab, which is the first tab, and click the checkbox: Enable hardware acceleration.
Direct and GPU-compositing window modes
Flash Player 10 introduces two window modes, direct and GPU compositing, which you can enable through the
publish settings in the Flash authoring tool. These modes are not supported in AIR. To take advantage of these modes,
you must enable hardware acceleration for Flash Player.
Last updated 6/6/2012
170