Main : Movie Tab

Main Movie

1. This field identifies the SWF you want loaded when your application starts. You can supply an absolute path or a relative path to the SWF file. You can also populate this field by dropping an SWF file on the SWF Studio interface as described in Building Your First Application.

2. Opens a standard Windows File Open dialog that allows you to select an SWF file. If the main movie field is already populated, that value will be used to initialize the start directory for the File Open dialog, otherwise the system default folder will be used.

3. By default, SWF Studio loads your AS3 main movie directly out of EXE file. With multi-megabyte SWF files this process can take several seconds to complete. Enabling this option tells SWF Studio to first extract your SWF file temporarily to disk which allows it to load much faster. The temporary copy of your SWF file will be deleted as soon as is has been loaded into Flash.

4. When this option is enabled, the ActionScript API, your main movie, the Screensaver configuration movie from the Screensaver Tab and the expiry movie from the Expiry Tab will all be loaded using the secure loader. This ensures that any other movies you load will be able to communicate with these movies through the ActionScript API and their respective _global objects.

5. Enabling this option tells SWF Studio to upgrade your SWF file to SWF8 format. This allows you to take advantage of Flash 8 player features even if your movie was not authored using Flash 8. If you created your main movie With Flash MX (SWF6) or Flash MX 2004 (SWF7) then you need to enable this option to use SWF Studios synchronous calls. Before enabling this option, make sure you understand the side effects described in Upgrading to SWF8 Format

Scale Mode

The scale mode you select determines how the running Flash movie will be scaled to fit the SWF Studio playback window.

6. The default scale mode is to use no scaling, which means that the SWF is displayed at it's orginal published size in the player window. The movie will be centered in the playback window, even if it is larger or smaller than the playback window. If the movie is larger than the playback window, some parts of your movie will not be visble. If the movie is smaller than the playback window, there will be a visible border around the movie. This setting is equivalent to the "100%" option in MacromediaTM Flash projectors.

If you choose no scaling SWF Studio will assume that you will use the Flash Stage object (width , height and align) and window notifications (onResize) from SWF Studio to manage the size and position of the movie within the playback window. For all other scale modes, SWF Studio will automatically synchronize the size and position of the movie with the playback window as it is resized.

7. Selecting this mode will enlarge or shirnk the movie (as necessary) to fill the entire playback window. The movie may be scaled in different proportions in the X and Y directions to exactly fill the playback window. When using this scale mode the aspect ratio of your movie may not be preserved which can cause the movie to appear compressed in one direction when unequal scaling factors applied.

8. This scale mode will enlarge or shrink the movie (as necessary) using a "best fit" solution to fill as much of the playback window as possible. The movie will be centered in the playback window but unless the aspect ratio of the playback window matches the movie, a border will be visible at either the top and bottom of the movie or along the sides of the movie depending on the aspect ratios of the playback window and the movie.

Default Base Path

9. When you call something like loadMovie("file.swf") from a Flash projector, "file.swf" is assumed to be in the same folder as your projector. In most cases this is exactly the behavior that you want. This option (the default) makes your SWF Studio projector behave just like a normal Flash projector where relative references are resolved using the folder where the projector was started from as the base path.

10. If you have added files to the Files Tab from an existing project and don't want to convert all the relative links in your SWF files to absolute links then this option allows you to change the base path that Flash uses for resolving relative links. Instead of the folder where the projector is, this option changes the base path to the folder where you "internal" files are located. This is normally a temporary folder only accessible via ssGlobals.ssTempDir

In addition to these options you can also use ssCore.App.setBasePath to change the base path to any folder you require. This allows you to combine different projects into a single application without having to change the way the SWF files in each project load the other SWF files they depend on.

Script Limits

These settings allow you to overcome two major limitations the Flash player imposes on your scripts.

11. This option allows you to change the number of seconds before the player displays a dialog box to the user asking if your script should be stopped. By default, Flash sets this value at 15 seconds. CPU intensive calculations or loops on older machines can cause Flash to reach this limit easily. You can set the new script limit timeout value to anything from 15 to 65535 (a little over 18 hours). SWF Studio will generate a warning in the build results if you try to set this value to something below the default and will automatically adjust it back up to 15 seconds.

12. This option allows you to change the number of recursive calls that can be made before the player displays a dialog box to the user asking if your script should be stopped. By default, Flash sets this value at 256 calls. If you are using a recursive algorithm that requires more calls then you can can set the new recursion depth to anything from 256 to 65535. SWF Studio will generate a warning in the build results if you try to set this value to something below the default and will automatically adjust it back up to 256 calls.