- Specify publish settings for SWF files (CS5)
- Specify publish settings for HTML wrapper files (CS5)
- Specify publish settings for Flash Player detection (CS5)
- Specify publish settings for GIF files (CS5)
- Specify publish settings for JPEG files (CS5)
- Specify publish settings for PNG files (CS5)
- Preview the publishing format and settings (CS5)
- Using publish profiles (CS5)
Specify publish settings for HTML wrapper files (CS5)
Playing Flash Professional content in a web browser requires an HTML document that activates the SWF file and specifies browser settings. The Publish command automatically generates this document from HTML parameters in a template document.
The template document can be any text file that contains the appropriate template variables—including a plain HTML file, a file that includes code for special interpreters such as ColdFusion® or Active Server Pages (ASP), or a template included with Flash Professional.
To manually enter HTML parameters for Flash Professional or customize a built‑in template, use an HTML editor.
HTML parameters determine where the content appears in the window, the background color, the size of the SWF file, and so on, and set attributes for the object and embed tags. Change these and other settings in the HTML panel of the Publish Settings dialog box. Changing these settings overrides options you’ve set in the SWF file.
Parameters and attributes for object and embed tags
The following tag attributes and parameters describe the HTML code that the Publish command creates. Refer to this list as you write custom HTML to show Flash Professional content. Unless noted, all items apply to both the object and embed tags. Optional entries are noted. Internet Explorer recognizes parameters used with the object tag; Netscape recognizes the embed tag. Attributes are used with both the object and embed tags. When you customize a template, you can substitute a template variable (identified in the Value section for each parameter in the following list) for the value.
- devicefont attribute/parameter
- (Optional)
Specifies whether static text objects are rendered in device fonts,
even if the Device Font option is not selected. This attribute applies
when the necessary fonts are available from the operating system.
Value: true | false
Template variable: $DE
- src attribute
- Specifies the
name of the SWF file to be loaded. Applies to the embed tag
only.
Value: movieName.swf
Template variable: $MO
- movie parameter
- Specifies
the name of the SWF file to be loaded. Applies to the object tag
only.
Value: movieName.swf
Template variable: $MO
- classid attribute
- Identifies
the ActiveX control for the browser. The value must be entered exactly
as shown. Applies to the object tag only.
Value: clsid:d27cdb6e-ae6d-11cf-96b8-444553540000
- width attribute
- Specifies
the width of the application either in pixels or as a percentage
of the browser window.
Value: n or n%
Template variable: $WI
- height attribute
- Specifies
the height of the application either in pixels or as a percentage
of the browser window. Note: Because Flash Professional applications are scalable, quality doesn’t degrade at different sizes if the aspect ratio is maintained. (For example, the following sizes all have a 4:3 aspect ratio: 640 x 480 pixels, 320 x 240 pixels, and 240 x 180 pixels.)
Value: n or n%
Template variable: $HE
- codebase attribute
- Identifies
the location of the Flash Player ActiveX control so that the browser
can automatically download it if it is not already installed. The value
must be entered exactly as shown. Applies to the object tag
only.
Value: http://fpdownload.adobe.com/pub/shockwave/cabs/flash/swflash.cab#version=7,0,0,0
- pluginspage attribute
- Identifies
the location of the Flash Player plug‑in so that the user can download
it if it is not already installed. The value must be entered exactly
as shown. Applies to the embed tag only.
Value: http://www.adobe.com/shockwave/download/index.cgi?P1_Prod_Version=ShockwaveFlash
- swliveconnect attribute
- (Optional)
Specifies whether the browser should start Java™ when
loading Flash Player for the first time. The default value is false if this
attribute is omitted. If you use JavaScript and Flash
Professional on the same page, Java must be
running for the fscommand() function to work. However,
if you use JavaScript only for browser detection or another purpose
unrelated to fscommand() actions, you can prevent
Java from starting by setting SWLIVECONNECT to false.
To force Java to start when you are not using JavaScript, explicitly
set the SWLIVECONNECT attribute to true.
Starting Java substantially increases the startup time for a SWF
file; set this tag to true only when necessary.
Applies to the embed tag only.
Use the fscommand() action to start Java from a stand-alone projector file.
Value: true | false
- play attribute/parameter
- (Optional)
Specifies whether the application begins playing immediately on
loading in the web browser. If your Flash
Professional application
is interactive, let the user initiate play by clicking a button
or performing another task. In this case, set the play attribute
to false to prevent the application from starting
automatically. The default value is true if this attribute
is omitted.
Value: true | false
Template variable: $PL
- loop attribute/parameter
- (Optional)
Specifies whether the content repeats indefinitely or stops when
it reaches the last frame. The default value is true if this
attribute is omitted.
Value: true | false
Template variable: $LO
- quality attribute/parameter
- (Optional)
Specifies the level of anti-aliasing to be used. Because anti-aliasing
requires a faster processor to smooth each frame of the SWF file
before it is rendered on the viewer’s screen, select one of the following
values based on whether your priority is speed or appearance:
- Low
- Favors playback speed over appearance and never uses anti-aliasing.
- Autolow
- Emphasizes speed at first but improves appearance whenever possible. Playback begins with anti-aliasing turned off. If Flash Player detects that the processor can handle it, anti-aliasing is turned on. Note: SWF files authored using ActionScript 3.0 do not recognize the autolow value.
- Autohigh
- Initially emphasizes playback speed and appearance equally, but sacrifices appearance for playback speed if necessary. Playback begins with anti-aliasing turned on. If the frame rate drops below the specified frame rate, anti-aliasing is turned off to improve playback speed. Use this setting to emulate the Antialias command (View > Preview Mode > Antialias).
- Medium
- Applies some anti-aliasing and does not smooth bitmaps. It produces a better quality than the Low setting but a lower quality than the High setting.
- High
- Favors appearance over playback speed and always applies anti-aliasing. If the SWF file does not contain animation, bitmaps are smoothed; if the SWF file has animation, bitmaps are not smoothed.
- Best
- Provides the best display quality and does not consider playback
speed. All output is anti‑aliased, and all bitmaps are smoothed.
The default value for quality is high if this attribute is omitted.
Value: low | medium | high | autolow | autohigh | best
Template variable: $QU
- bgcolor attribute/parameter
- (Optional)
Specifies the background color of the application. Use this attribute
to override the background color setting that the SWF file specifies.
This attribute does not affect the background color of the HTML
page.
Value: #RRGGBB (hexadecimal RGB value)
Template variable: $BG
- scale attribute/parameter
- (Optional)
Defines how the application is placed in the browser window when width and height values
are percentages.
- Showall (Default)
- Makes the entire content visible in the specified area without distortion while maintaining the original aspect ratio of the application. Borders can appear on two sides of the application.
- Noborder
- Scales the content to fill the specified area, without distortion but possibly with some cropping, while maintaining the original aspect ratio of the application.
- Exactfit
- Makes the entire content visible in the specified area without
trying to preserve the original aspect ratio. Distortion can occur.
The default value is showall if this attribute is omitted (and width and height values are percentages).
Value: showall | noborder | exactfit
Template variable: $SC
- align attribute
- Specifies
the align value for the object, embed,
and img tags and determines how the SWF file is
positioned within the browser window.
- Default
- Centers the application in the browser window and crops edges if the browser window is smaller than the application.
- L, R, and T
- Align the application along the left, right, or top edge, respectively, of the browser window and crop the remaining three sides as needed.
Value: Default | L | R | T
Template variable: $HA
- salign parameter
- (Optional)
Specifies where a scaled SWF file is positioned in the area that
the width and height settings
define.
- L, R, and T
- Align the application along the left, right, or top edge, respectively, of the browser window and crop the remaining three sides as needed.
- TL and TR
- Align the application to the top-left and top-right corner, respectively, of the browser window and crop the bottom and remaining right or left side as needed.
If this attribute is omitted, the content is centered in the browser window.
Value: L | R | T | B | TL | TR
Template variable: $SA
- base attribute
- (Optional)
Specifies the base directory or URL used to resolve all relative
path statements in the SWF file. This attribute is helpful when
you keep SWF files in a different folder from your other files.
Value: base directory or URL
- menu attribute or parameter
- (Optional)
Specifies what type of menu appears when the viewer right-clicks
(Windows) or Command-clicks (Macintosh) the application area in
the browser.
- true
- shows the full menu, which gives the user several options to enhance or control playback.
- false
- shows a menu that contains only the About Adobe Flash Player
6 option and the Settings option.
The default value is true if this attribute is omitted.
Value: true | false
Template variable: $ME
- wmode attribute or parameter
- (Optional)
Lets you use the transparent Flash
Professional content,
absolute positioning, and layering capabilities available in Internet
Explorer 4.0. For a list of browsers this attribute/parameter supports,
see Publishing Flash documents. The wmode paramater
is also used for hardware acceleration in Flash Player 9 and later.
- Window
- Plays the application in its own rectangular window on a web page. Window indicates that the Flash Professional application has no interaction with HTML layers and is always the top-most item.
- Opaque
- Makes the application hide everything behind it on the page.
- Transparent
- Makes the background of the HTML page show through all the transparent portions of the application and can slow animation performance.
- Opaque windowless and Transparent windowless
- Both interact with HTML layers, letting layers above the SWF file block out the application. Transparent allows transparency so that HTML layers below the SWF file can be seen through the background of the SWF file; opaque does not.
- Direct
- Level 1 - Direct mode hardware acceleration is turned on. The other window mode settings apply only when hardware acceleration is turned off.
- GPU
- Level 2 - GPU mode hardware acceleration is turned on. The other window mode settings apply only when hardware acceleration is turned off.
For more information about hardware acceleration, see Specify publish settings for SWF files (CS5).
The default value is Window if this attribute is omitted. Applies to object only.
Value: Window | Opaque | Transparent | Direct | GPU
Template variable: $WM
- allowscriptaccess attribute or parameter
- Use allowscriptaccess to
let your Flash
Professional application communicate
with the HTML page hosting it. The fscommand() and getURL() operations
can cause JavaScript to use the permissions of the HTML page, which
can be different from the permissions of your Flash
Professional application. This has important
implications for cross-domain security.
- always
- Permits scripting operations at all times.
- never
- Forbids all scripting operations.
- samedomain
- Permits scripting operations only if the Flash
Professional application is from the same
domain as the HTML page.
The default value that all HTML publish templates use is samedomain.
Value: always | never | samedomain
- SeamlessTabbing parameter
- (Optional) Lets you set the ActiveX control to perform seamless
tabbing, so that the user can tab out of a Flash
Professional application.
This parameter works only in Windows with the Flash Player ActiveX control,
version 7 and higher.
- true
- (or omitted) Sets the ActiveX control to perform seamless tabbing: After users tab through the Flash Professional application, the next tab keypress moves the focus out of the Flash Professional application and into the surrounding HTML content or to the browser status bar if nothing can have focus in the HTML following the Flash Professional application.
- false
- Sets the ActiveX control to behave as it did in version 6 and earlier: After users tab through the Flash Professional application, the next tab keypress wraps the focus around to the beginning of the Flash Professional application. In this mode, you cannot use the tab key to advance the focus past the Flash Professional application.
Value: true | false
Examples using object and embed tags
For object, four settings (height, width, classid, and codebase) are attributes that appear in the object tag; all others are parameters that appear in separate, named param tags, as shown in the following example:
<object classid="clsid:d27cdb6e-ae6d-11cf-96b8-444553540000" width="100" height="100" codebase="http://fpdownload.adobe.com/pub/shockwave/cabs/flash/swflash.cab#version=9,0,0,0"> <param name="movie" value="moviename.swf"> <param name="play" value="true"> <param name="loop" value="true"> <param name="quality" value="high"> </object>
For the embed tag, all settings (such as height, width, quality, and loop) are attributes that appear between the angle brackets of the opening embed tag, as shown in the following example:
<embed src="moviename.swf" width="100" height="100" play="true" loop="true" quality="high" pluginspage="http://www.adobe.com/shockwave/download/index.cgi?P1_Prod_Version=ShockwaveFlash"> </embed>
To use both tags, position the embed tag before the closing object tag, as shown in the following example:
<object classid="clsid:d27cdb6e-ae6d-11cf-96b8-444553540000" width="100" height="100" codebase="http://fpdownload.adobe.com/pub/shockwave/cabs/flash/swflash.cab#version=9,0,0,0"> <param name="movie" value="moviename.swf"> <param name="play" value="true"> <param name="loop" value="true"> <param name="quality" value="high"> <embed src="moviename.swf" width="100" height="100" play="true" loop="true" quality="high" pluginspage="http://www.adobe.com/shockwave/download/index.cgi?P1_Prod_Version=ShockwaveFlash"> </embed> </object>
Browsers that support windowless modes
For detailed information about web browser support for the WMODE attribute, see the table in TechNote 12701: Flash OBJECT Tag Attributes.
Specify publish settings for Flash Player detection (CS5)
Flash Version Detection configures your document to detect the version of Flash Player that the user has and sends the user to an alternative HTML page if the user does not have the targeted player. The alternative HTML page contains a link to download the latest version of Flash Player
Flash Player detection is available only for publish settings set to Flash Player 4 or later (CS5) or Flash Player 5 or later (CS5.5), and for SWF files embedded in the Flash Only or Flash HTTPS templates.
The following HTML templates do not support Flash Player detection because the JavaScript in these templates conflicts with the JavaScript used to detect the Flash Player:
Flash Professional for PocketPC 2003
Flash Professional with AICC Tracking
Flash Professional with FSCommand
Flash Professional with Named Anchors
Flash Professional with SCORM Tracking
Specify publish settings for GIF files (CS5)
Use GIF files to export drawings and simple animations for use in web pages. Standard GIF files are compressed bitmaps.
An animated GIF file (sometimes referred to as a GIF89a) offers a simple way to export short animation sequences. Flash Professional optimizes an animated GIF file, storing only frame-to-frame changes.
Flash Professional exports the first frame in the SWF file as a GIF file, unless you mark a different keyframe for export by entering the #Static frame label in the Property inspector. Flash Professional exports all the frames in the current SWF file to an animated GIF file unless you specify a range of frames for export by entering the #First and #Last frame labels in the appropriate keyframes.
Flash Professional can generate an image map for a GIF file to maintain URL links for buttons in the original document. Use the Property inspector to place the frame label #Map in the keyframe in which to create the image map. If you don’t create a frame label, Flash Professional creates an image map using the buttons in the last frame of the SWF file. Create an image map only if the $IM template variable is present in the template you select.
Specify publish settings for JPEG files (CS5)
The JPEG format lets you save an image as a highly compressed, 24‑bit bitmap. Generally, GIF format is better for exporting line art, and JPEG format is better for images with continuous tones, such as photographs, gradients, or embedded bitmaps.
Flash Professional exports the first frame in the SWF file as a JPEG, unless you mark a different keyframe for export by entering the #Static frame label.
Specify publish settings for PNG files (CS5)
PNG is the only cross-platform bitmap format that supports transparency (an alpha channel). It is also the native file format for Adobe® Fireworks®.
Flash Professional exports the first frame in the SWF file as a PNG file, unless you mark a different keyframe for export by entering the #Static frame label.
Preview the publishing format and settings (CS5)
The Publish Preview command exports the file and opens the preview in the default browser. If you preview a QuickTime video, Publish Preview starts the QuickTime video Player. If you preview a projector, Flash Professional starts the projector.
Select File > Publish Preview, and
select the file format to preview. Using the current Publish Settings values, Flash Professional creates a file of the specified type in the same location as the FLA file. This file remains in this location until you overwrite or delete it.
Using publish profiles (CS5)
Publish profiles let you:
Save a publish settings configuration, export it, and import the publish profile to other documents or for others to use.
Import publish profiles to use in your document.
Create profiles to publish in several media formats.
Create a publish profile for in-house use that differs from the way you’d publish the files for a client.
Create a standard publish profile for your company to ensure files are published uniformly.
Publish profiles are saved at the document rather than application level.
Create a publish profile
- In the Publish Settings dialog box,
click the Create New Profile button
. - Name the publish profile, and click OK.
- Specify the publish settings for your document, and click OK.
Duplicate, modify, or delete a publish profile
From the Current Profile pop‑up menu
(File > Publish Settings), select the publish profile
to use:To create a duplicate profile, click the Duplicate Profile button
. Enter
the profile name in the Duplicate Name text field, and click OK.To modify a publish profile, specify the new publish settings for your document, and click OK.
To delete a publish profile, click the Delete Profile button
, and
click OK.
Export a publish profile
- From the Current Profile pop‑up menu (File > Publish Settings), select the publish profile to export.
- Click the Import/Export Profile button
, and
select Export. Export a publish profile as an XML file for import
into other documents. - Either accept the default location in which to save the publish profile or browse to a new location, and click Save.
