Files.getExtension("birthday.png")
returns ".png". If the filename has no extension, an empty string is returned. A filename that is expressed as file://URL is acceptable.

getFilename(docname)

Returns just the filename from docname, which is expressed as file://URL. For example, Files.getFilename("file:/// work/logo.png") returns "logo.png". Returns the URL of the language directory associated with the currently running language.

getLanguageDirectory()

getLastErrorString()
If the last call to a method in a Files object resulted in an error, returns a string that describes the error. If the last call succeeded, returns null. The argument, if used, must be expressed as file://URL. Returns a file URL in the Temporary Files directory or in the specified directory. This method does not create a file; it simply returns a unique file URL that does not conflict with existing files in the directory. If dirname is passed and is not null, the URL that is returned indicates a file in the specified directory rather than in the Temporary Files directory. The argument must be expressed as file://URL. Returns true if the specified URL refers to a directory that exists; false otherwise. The first argument must be expressed as file://URL. Concatenates the two arguments to return a file URL that references the specified filename in the specified directory. For example,
Files.makePathFromDirAndFile("file:/ //work/reports", "logo.png") returns "file:///work/reports/logo.png".
getTempFilePath ({dirname})

isDirectory(dirname)

makePathFromDirAndFile(dirname, string, string plainFilename)

open(docname, bWrite)

string, Boolean
The first argument must be expressed as file://URL. Opens the specified file for reading or writing. If the second argument is true, the file opens for writing; otherwise it opens for reading. If the file cannot be opened, returns null; otherwise, returns a File Reference object.
rename(docname, newPlainFilename)
The docname argument is a file path or a file URL to the file that you want to rename. The newPlainFilename argument is the new name to assign to the file. The rename method returns a URL path of the newly renamed file if successful; otherwise Fireworks returns null. The first argument must be expressed as file://URL. Returns a file URL with docname replaced by newPlainFilename. For example,
Files.setFilename("file:///work/ logo.png", "oldlogo.png") returns "file:///work/oldlogo.png". This method does not affect the file on disk; it simply provides a convenient way to manipulate file URLs. To change the name on disk, use rename().
setFilename(docname, newPlainFilename)

swap(docname1, docname2)

Each argument must be expressed as a file://URL. Swaps the contents of the two specified files, so that each file contains the contents of the other file. Only files (not directories) can be swapped, and both files must reside on the same drive. Returns true if the swap is successful; false otherwise.

"Web 216".

paletteMode

paletteTransparencyType

string integer Boolean integer string integer Boolean Boolean integer integer
Acceptable values are "none" (the default),
"index", "index alpha", and "rgba".
percentScale progressiveJPEG savedAnimationRepeat sorting
1 to 100,000; default value is 100. The default value is false. The default value is 0. Acceptable values are "none" (the default),
"luminance", and "popularity".

transparencyIndex

-1 to 255; pass -1 to use the background colors index; default value is -1. The default value is true. The default value is true. The default value is 14. -100,000 to 100,000; default value is 0. For details on using xSize and ySize, see ExportOptions object on page 58. -100,000 to 100,000; default value is 0. For details on using xSize and ySize, see ExportOptions object on page 58.
useScale webSnapAdaptive webSnapTolerance xSize

ExportPaletteInfo object

The following table lists the properties of the ExportPaletteInfo object, along with their data types and, where appropriate, acceptable values and notes.

colorLocked

Set to true if the color is locked in the panel. The default value is false. Set to true if the color was edited. The default value is false. Set to true if the color is selected in the panel (selection is a temporary attribute). The default value is false. Set to true if the color is exported as transparent. The default value is false. If colorModified is set to true, specifies the color that will actually be used. The default value is "#000000".

colorModified

colorSelected

colorTransparent

newColorValue

ExportSettings object

The following table lists the properties of the ExportSettings object, along with their data types and, where appropriate, acceptable values and notes.

string Boolean string

The name from which all automatically named slice names are derived. If set to true, omits undefined slices from export operations. Determines the encoding standard for the HTML file that Fireworks generates during export. Use "iso-8859-1" for ASCII or "utf-8" for Unicode. Determines whether Fireworks outputs XHTML formatted files (true) or HTML formatted files (false) when the user exports a file.

discardUnspecifiedSlices

docHtmlEncoding

docXHTMLFormat

exportFileStyle

Acceptable values are:

HTML and Images Images Only Dreamweaver LBI "Director HTML" "CSS Layers" "Layers to Files" "Frames to Files" "Lotus Domino" "Macromedia Flash SWF" "Illustrator" "Photoshop"

fileExtension

string Boolean string Boolean
Defines the extension to append to the filename. If set to true, generates multiple HTML pages for button export. Acceptable values are "same", "custom", and "clipboard". If set to true, the user specifies the export settings. If set to false, the first time the file is exported, Fireworks chooses settings based on the data. Acceptable values are "none" (no shims),
"transparent" (one-pixel transparent

generateDemoHtml

htmlDestination

setByUser

shimGeneration
shims), and "nested tables" (no shims, but nested tables).

sliceAlongGuides

If set to true, use guides for slicing (and sliceUsingUrls should be set to false).
sliceAutoNaming1 through sliceAutoNaming6
Used to generate a name by concatenating six strings. If you need fewer than six strings, fill in the remaining strings with "none". Acceptable values are: "none" generates nothing. "row_col" generates a unique row and column index; 0_0 is first, 0_1 is second, and so on. "ALPHA" generates a unique uppercase letter: A is first, B is second, and so on. "alpha" generates a unique lowercase letter: a is first, b is second, and so on. "numeric1" generates a unique number: 1 is first, 2 is second, and so on. "numeric01" generates a unique two-digit number: 01 is first, 02 is second, and so on. "doc.name" name of the file being exported, without a path or extension, such as "image". "slice" the string "slice". "underscore" the underscore character (_) "period" the period character (.) "space" the space character ( ) "hyphen" the hyphen character (-) For example, to generate names of "image_slice01", "image_slice02", and so on from a document named "image", set the following properties:
sliceAutoNaming1: sliceAutoNaming2: sliceAutoNaming3: sliceAutoNaming4: sliceAutoNaming5: sliceAutoNaming6: "doc.name" "underscore" "slice" "numeric01" "none" "none"
sliceFrameNaming1 and sliceFrameNaming2
Used to generate a name by concatenating two strings; the resulting string is concatenated to the name specified by sliceAutoNaming. If you need fewer than two strings, fill in the remaining string with "none". Acceptable values are: "none" generates nothing. "frameNumber" generates frame number preceded by f, for example, f2. "number" generates frame number, for example, 2. "state" generates frame state, for example, "over", "down", or "overdown". "abbreviation" generates abbreviated state, for example, "o", "d", or "od". "underscore" the underscore character (_) "period" the period character (.) "space" the space character ( ) "hyphen" the hyphen character (-) If set to true, use slice objects for slicing (and sliceAlongGuides should be set to false). HTML style to be used during export. Acceptable values are "Dreamweaver", "Generic", "FrontPage", "GoLive", or a usercreated HTML style.

hasDhHRef

hasHref

hasStatusText

hasTargetFrame

hideOnMouseout

Boolean integer

horzOffset

hiliteColor
If action is set to 9 (Popup Menu), specifies the highlight color at the upper-left of the menu cells. If action is set to 9 (Popup Menu), specifies the name of the font family to use for the menu. If action is set to 9 (Popup Menu), specifies the height in points of the menu cell. If action is set to 9 (Popup Menu), specifies the path to the first image. If action is set to 9 (Popup Menu), specifies the path to the second image. If action is set to 9 (Popup Menu), specifies an array that lists the items in the menu. If action is set to 9 (Popup Menu), specifies the cell padding for the menu items. If action is set to 9 (Popup Menu), specifies the spacing between menu items in points. If action is set to 9 (Popup Menu), specifies the width in points of the menu cell. If action is set to 9 (Popup Menu), specifies if the menu cell background is opaque. If action is set to 2 (Swap Image), specifies if the image is to be preloaded. If action is set to 2 (Swap Image), specifies if the original image is restored on mouse out. If action is set to 9 (Popup Menu), specifies the shadow color at the lower-right of the menu cells. If action is set to 1 (Status Message), specifies the status message text. If action is set to 2 (Swap Image), specifies the column in the slices table that is swapped.

menuFontFamily

menuHeight
integer string string array integer integer integer Boolean Boolean Boolean

menuImagePath

menuImagePath2

menuItems

menuItemPadding

menuItemSpacing

menuWidth

opaqueBackground

preload

restoreOnMouseout

shadowColor

statusText

string zero-based index

targetColumnNum

targetFrameNum
zero-based index zero-based index object string
If action is set to 2 (Swap Image), specifies the frame number to be swapped if hasTargetFrame is set to true. If action is set to 2 (Swap Image), specifies the row in the slices table that is swapped. If action is set to 2 (Swap Image), specifies the table of slices in the target swap frame. If action is set to 9 (Popup Menu), specifies the alignment for the menu text. Acceptable values are "left", "center", and "right". If action is set to 9 (Popup Menu), true if the menu text is bold. If action is set to 9 (Popup Menu), specifies the font family to use for the menu text. If action is set to 9 (Popup Menu), specifies the left indent in points of the menu text. If action is set to 9 (Popup Menu), true if the menu text is italic. If action is set to 9 (Popup Menu), true if the pop-up menu is to be text only. If action is set to 9 (Popup Menu), specifies the menu text color for the over state. If action is set to 9 (Popup Menu), specifies the point size for the menu text. If action is set to 9 (Popup Menu), specifies the menu text color for the Up state. If action is set to 9 (Popup Menu), specifies whether the menu is vertical. If action is set to 9 (Popup Menu), vertOffset specifies the vertical pixel offset for the menu.

sliceName = fw.selection[0].baseName;
pathAttributes For the complete list of path attributes properties, see pathAttributes on page 97.
To return the value of the fill color for the currently selected path, type the following code:
fillColor = fw.selection[0].pathAttributes.fillColor
To return the number of objects in a selected group, type the following code:
numOfObjectsinGroup = fw.selection[0].elements.length;

Instance

To return the instanceType for the currently selected instance, type the following code:
instance = fw.selection[0].instanceType;
randSeed textureOffset contours

elements groupType

symbolID transformMode instanceType urlText altText targetText
antiAliased antiAliasMode autoKern orientation pathAttributes For the complete list of pathAttributes properties, see pathAttributes on page 97.
To return the antiAliasMode setting for the currently selected text block, type the following code:
antiAliasedSetting = fw.selection[0].antiAliasMode;

RectanglePrimitive

To return the roundness setting for the currently selected rectangle, type the following code:
roundness = fw.selection[0].roundness;

NO TE N OT E

randSeed textRuns textureOffset transformMode
Roundness pathAttributes For the complete list of path attributes properties, see pathAttributes on page 97.

originalSides transform

Several objects have the pathAttributes property. The following list is the valid set of pathAttributes subproperties that can be returned or set:
brushColor fillColor brush fill brushTexture fillTexture fillHandle1 fillHandle2 fillHandle3 brushPlacement fillOnTop
To return the name of brush on the current path, type the following code:
brush = fw.selection[0].pathAttributes.brush.name; (b

CHAPTER 3

Cross-Product Extensions
Cross-product extensions include any Fireworks-related extensions developed for, or in, another Macromedia application. These cross-product extensions include those written for other tools, such as Macromedia Dreamweaver 8 that use existing Fireworks 8 functionality. They may use JavaScript APIs for adding image-editing functionality to those applications as well as custom Fireworks panels developed in Macromedia Flash 8 to enhance the functionality of Fireworks. For example, a developer may want to create an ActionScript command so that a user can replace text in an image without leaving the current movie. Similarly, a Flash developer may create a panel so that a Fireworks user can easily create spirals and other nonstandard shapes repeatedly.

Calling the CreateAutoReleasePool() function marks the beginning of the auto-release block, and calling the DestroyAutoReleasePool() function marks the end. Any object allocated between these two calls is released by calling DestroyAutoReleasePool(). Using these two functions, you can write ActionScript code and not worry about memory management.

Accessing proxy objects

If you want to access a proxy object outside of an auto-release block, you must use the RemoveFromAutoReleasePool() function. The RemoveFromAutoReleasePool() function manually removes an object reference from the auto-release pool before exiting the auto-release block. In this example, the reference to the object defined as selObject is removed:
RPCMethods.CreateAutoReleasePool(); var selObject = fw.selection.get(0); RPCMethods.RemoveFromAutoReleasePool(selObject); RPCMethods.DestroyAutoReleasePool();
Now you can use the selObject object outside the auto-release block.
You must remember to release the selObject object when you are done with it.
Additionally, you can nest auto-release blocks, that is, you can create an auto-release block and then call a function that creates its own auto-release block. The ReleaseObject() function iterates through an objects properties and releases any proxy objects it finds.

A simple RPC example

This example creates a 200 x 200 pixel rectangle in Fireworks when a button in a Flash application is clicked.
To build a Flash application that uses RPC to create a Fireworks object:
Download the supporting ActionScript stub files (a series of supporting ActionScript files) from the Macromedia website, you need to put them in your working directory (where the new FLA file will reside). Open a new document in Flash 8.
In the first frame, add the following in the Actions panel to link the general fireworks stub file to the movie when it is published:
#include "fwstubs.as"

4. 5. 6.

Create a simple button which will activate the RPC script. Insert the button in the first frame, in the middle of the Stage. Attach the following ActionScript code to the button to activate the RPC code when the button is clicked:
on(press){ RPCMethods.CreateAutoReleasePool(); var fw = new Fireworks(); //Hide all panels - this function commented out as it will crash if run from inside Fireworks //fw.setHideAllFloaters(true); //Define the document objects the long way var res = new Object(); res.units = "inch"; res.pixelsPerUnit = 72; var size = new Object(); size.x = 220; size.y = 220; //Create new doc var fwdoc = fw.createFireworksDocument(size, res, "#0033FF"); //Define a rectangle object the short way var rect = {left:10, top:10, right:210, bottom:210}; //Add Rectangle fwdoc.addNewRectanglePrimitive(rect,0.20); //Set its color fwdoc.setFillColor("#00CC99");

Sent to the SWF file right after Fireworks has started (or restarted) the SWF file. Sent to the SWF file right before Fireworks stops the file (and possibly unloads it). Sent when the user changes the type of units (inches, pixels, centimeters) in the Info panel. Sent when the user switches the PI between two rows high and four rows high. Sent when the name of the current document changes (for example, when the user performs a save). Sent when the user selects a different frame. Sent when the user selects a different layer. Sent when the user creates an non-scriptable history step. Sent when Fireworks is in the first of a sequence of idle states. Because Fireworks may often go through a sequence of idle states, triggering functions by this event may impair application performance. Sent when Fireworks is in the second of a sequence of idle states. Because Fireworks may often go through a sequence of idle states, triggering functions by this event may impair application performance. Sent when Fireworks is in the third of a sequence of idle states. Because Fireworks may often go through a sequence of idle states, triggering functions by this event may impair application performance. Sent when the Fireworks application loses focus. Sent when the Fireworks application gains focus. Sent when the symbol library changes in some way. Sent when a new URL is added to the document. Sent when the favorite urls list is modified. Sent when the preferences are changed.

onFWIdle1

onFWIdle2
onFwApplicationDeactivate onFwApplicationActivate onFwSymbolLibraryChange onFwURLListChange onFwFavoritesChange onFwPreferencesChange
onFWDocuementOpen onFWDocumentClosed onFWDocumentSave onFwDocumentSizeChange onFwActiveViewChange onFwPixelSelectionChange onFwActiveSelectionChange onFwActiveDocumentChange
Sent when the document is opened. Sent when the document is closed. Sent when a save action is performed in the document. Sent when the document is resized. Sent when the active view changes. This happens when the user changes focus in 2- or 4-Up view. Sent when the pixel selection changes. Sent when the selection changes in a document. Sent when the user creates a new document, closes a document, opens a document, or switches between open documents.

function BeginDragControlPoint() { switch (smartShape.currentControlPointIndex) { case 0: var parms = smartShape.GetDefaultMoveParms(); smartShape.elem.controlPoints[0].RegisterMove(parms); smartShape.elem.elements[0].contours[0].nodes[0].RegisterMov e(parms); break; } }

EndDragInsert()

BeginDragControlPoint() Tells Fireworks what to do when the user clicks and holds the

DragControlPoint()

This function is called every time the mouse moves during a drag operation. Fireworks can change the object as the user moves the mouse or wait until the mouse event ends to change the object. If the BeginDragControlPoint() function specifies control points or other points, Fireworks will not call the DragControlPoint() function. Tells Fireworks how to draw the final Auto Shape, after a drag operation is complete. If Fireworks handled shape changes through the BeginDragControlPoint() function, then you can use the end result of that function as a starting point. In that case, the code need not reflect every change in shape, but just the changes that arent handled by BeginDragControlPoint(). This function is called when any changes have been made to the Auto Shape that might change the shapes behavior (such as removing a node inside an Auto Shape object).

EndDragControlPoint()

SmartShapeEdited()
These functions correspond directly with the messages listed in Fireworks messages on page 126. To invoke your own function names in response to Fireworks messages, you need to write a switch() statement.

Switch statements

If you take a look at some existing Auto Shapes (in the Configuration/Auto Shapes folder and in the Configuration/Auto Shape Tools folders), youll notice a switch() statement near the beginning of the file. The Auto Shape JavaScript code in these files uses a switch() statement as the initial message handler in the file. The switch() statement sorts the messages sent by Fireworks so each message (that is useful to the particular Auto Shape) invokes a corresponding function. You can see this switch statement in each of the Auto Shape JavaScript files. Again, a single Auto Shape object may not need to process every message Fireworks sends, so only the useful messages are written into the JavaScript file using the case qualifier. Effectively, the JavaScript file states in case of a certain message, or messages, perform the following function. In the Frame Auto Shape, this code is used to call PlaceControlPoints() when Fireworks sends a "SmartShapeEdited" message:

Sets a navigation bar restore behavior.
fw.getDocumentDOM().addBehavior("MM_nbGroup(\'out\')", "onMouseOut", -1);

MM_simpleRollover

Adds a simple rollover behavior.

MM_statusMessage

message message
is a string that specifies the status message to appear.
Sets a status bar message.
fw.getDocumentDOM().addBehavior("MM_statusMessage(\"Status Message!\")", "onMouseOver", -1);

MM_swapImage

target, swapFrame, fileName, preload, restoreOnMouseOut

target

specifies the slice to which the behavior is attached. Pass 1 for this value; all other values are used internally by Fireworks.
is a binary value that specifies whether to preload the swapped image (pass 1) or not (pass 0). is a binary value that specifies whether to restore on a mouse out action (pass 1) or not (pass 0).

restore

Adds a swap image behavior.
fw.getDocumentDOM().addBehavior("MM_swapImage(-1,1,\"\",1,1)", "onMouseOver", -1);

MM_swapImgRestore

fw.getDocumentDOM().addBehavior("MM_swapImgRestore()", "onMouseOut", -1);
Adds a swap image restore behavior.

dom.addElementMask()

Fireworks 4.
dom.addElementMask(mode, {bEnterMaskEditMode})
Acceptable values for mode are "reveal all", "hide all", "reveal selection", and "hide selection". If the user is not in bitmap mode, or if there is no pixel selection, "reveal selection" and "hide selection" operate the same as "reveal all" and "hide all", respectively.

mode bEnterMaskEditMode

If bEnterMaskEditMode (optional) is set to true, Fireworks enters mask-edit mode on the newly added mask; if omitted, it defaults to false.
Adds a new empty mask to the selected element. If the selection already has an element mask, it is replaced with the new one. Only one element can be selected when calling this function. If selecting more than one element (or none) at the time this function is called, Fireworks throws an exception.

dom.addFrames()

Fireworks 3, enhanced in Fireworks 4.
dom.addFrames(howMany, where, {bAdvanceActiveFrame})

howMany where

An integer that specifies how many frames to add.
"beginning", "before current", "after current", bAdvanceActiveFrame
The location where frames should be added. Acceptable values for where are and "end".
Added in Fireworks 4, specifies whether to change the active frame. If it is omitted or true, this function sets the active frame to the first frame added. If false, the active frame does not change. For example, if the user is adding frames at the end of a document that has two frames and bAdvanceActiveFrame is omitted or true, then the third frame becomes the active frame.

dom.replaceTextString()

dom.replaceTextString(newString, uniformAttrs)
Replaces the text of all selected text items with the specified string.

dom.resizeSelection()

dom.resizeSelection(width, height)

and height

Integers that specify the new width and height, in pixels.
Resizes the selection to the specified pixel width and height, keeping the top-left corner of the selection in place.

dom.restoreJPEGMask()

Restores the selection that is specified in dom.saveJPEGMask().

dom.saveJPEGMask()

dom.restoreSelection()
dom.restoreSelection(selectionName, fromDocument, {operation}, {invert})
selectionName User-specified name of the selection to restore. If selection name is not specified, the selection named "default" will be restored. fromDocument Index of a currently open document from which to load the selection. If the from document is not specified, the selection will be restored from the active document. operation
Operation to perform on the selection and on the document being loaded. Acceptable values are "new or replace", "add", "subtract", and "intersect". This parameter is optional. If the operation is not specified, Fireworks will behave as if "new or replace" is specified.
invert A Boolean value that determines if the selection should be inverted before performing the operation on it. This parameter is optional. If invert is not specified, defaults to false.
if the selection is inverted; otherwise false.
Restores the selection that is specified in dom.saveSelection().

dom.saveSelection()

dom.reversePathTextDirection()
For all text-on-a-path items in the selection, it reverses the direction of the text along the path.

dom.rotateDocument()

dom.rotateDocument(rotationAmount)
Acceptable values for rotationAmount are 90, 180, and 270.
Rotates the entire document 90, 180, or 270 clockwise. Rotating 270 is the same behavior as rotating 90 counterclockwise.

dom.rotateSelection()

dom.rotateSelection(rotationDegrees, opts)

rotationDegrees

A floating-point value that specifies the number of degrees to rotate

the selection.

Acceptable values are "transformAttributes", "autoTrimImages", and "autoTrimImages transformAttributes".
Rotates the selection clockwise by the specified number of degrees. Rotating 270 is the same behavior as rotating 90 counterclockwise.

dom.save()

dom.save({bOkToSaveAs})
If this optional argument is true or omitted and the file was never saved, then the Save As dialog box appears. If bOkToSaveAs is false and the file was never saved, the file is not saved.

altTagString

Sets the alt tag text to the specified value for the Hotspots and slices in the selection.
The following command sets the text attributes of the alt tag of the selected slices to "This is
my alt tag": fw.getDocumentDOM().setHotspotAltTag("slices","This is my alt tag");

dom.setHotspotColor()

dom.setHotSpotColor(whatToSet, color)

whatToSet color

Acceptable values are "hotspots", "slices", and "hotspots and slices".
Sets the color to the specified value for the Hotspots and slices in the selection.
The following command sets the color of the selected Hotspots to red:
fw.getDocumentDOM().setHotspotColor("hotspots", "#ff0000");
dom.setHotspotRectangle()
dom.setHotspotRectangle(boundingRectangle, bMakeCopy)
A rectangle that specifies the size of the new Hotspot or slice (see Rectangle data type on page 12).
bMakeCopy A Boolean value; if it is true, the selection is copied and resized instead of moved and resized.
If the selection is a single Hotspot or slice, this function moves or copies it to the specified location at the specified size.

dom.setHotspotShape()

dom.setHotspotShape(whatToSet, shape)

whatToSet shape

Acceptable values are "hotspots", "slices", or "hotspots and slices".
Acceptable values are "rectangle", "oval", or "polyline".
Sets the specified Hotspots and slices in the selection to the specified shape.

dom.setHotspotTarget()

dom.setHotspotTarget(whatToSet, targetTagString)
whatToSet, targetTagString whatToSet
Acceptable values are "hotspots", "slices", or "hotspots and slices". A string that specifies the text to be used for the target tag.

targetTagString

Sets the target tag text to the specified value for the Hotspots and slices in the selection.
The following command links the currently selected slices to the parent window:
fw.getDocumentDOM().setHotspotTarget("slices", "_parent");

dom.setSliceGuideColor(color)
Sets the color that is used to display slice guides. To set the color of normal guides, use dom.setGuideColor().

dom.setSliceHtml()

dom.setSliceHtml(htmlText)
A string that specifies the HTML text for the slice.
If a single slice is selected, this function sets the slices HTML text.

dom.setSliceIsHtml()

dom.setSliceIsHtml(bHtml)
If bHtml is true, sets the slices as HTML. If bHtml is false, sets the slices as Image.
Sets the selected slices as HTML or Image.

dom.setSnapToGrid()

dom.setSnapToGrid(bSnap)
If bSnap is true, the tools snap to the grid. If bSnap is false, they do not.
Specifies whether tools snap to the grid.

dom.setSnapToGuides()

dom.setSnapToGuides(bSnap)
If bSnap is true, the tools snap to all guides. If bSnap is false, they do not.
Specifies whether tools snap to guides.
dom.setSymbolProperties()
dom.setSymbolProperties(currentName, symbolType, newName)
currentName Specifies the current name of the symbol in the library. If more than one master exists with a name of currentName, only the first master is changed. If null is passed in for currentName, the name property is set for all selected symbols in the library (not the document). symbolType
Acceptable values are "graphic", "button", and "animation".

newName

Specifies the new name for the symbol.
Sets the name and symbol type of the specified symbol.

dom.setTextAlignment()

dom.setTextAlignment(alignment)

alignment justify",

Acceptable values alignment are "left", "center", "right", "justify", and "vertical stretch".
"stretch", "vertical left", "vertical center", "vertical right", "vertical
Sets the alignment of the selected text items.
dom.setTextAntiAliasing()
dom.setTextAntiAliasing(level)
Acceptable values are "crisp", "smooth", and "strong".
Sets the anti-aliasing level for the selected blocks of text.
To turn anti-aliasing on or off, call dom.enableTextAntiAliasing.

NO TE 292

dom.setTextAutoKern()
dom.setTextAutoKern(bKern)

bKern false,

If bKern is true, automatic kerning is on for the selected text items. If bKern is it is off.
Specifies whether automatic kerning is on or off for the selected text items.

dom.setTextCharSpacing()

dom.setTextCharSpacing(charSpace)

charSpace

A floating-point percentage of the default space to add to (positive values) or remove from (negative values) two adjacent characters. To increase the spacing by 15%, for example, pass 0.15.

NO TE 324 N OT E

Gets an array of arrays that indicates the tab-grouping of the panels (even hidden ones).

fw.getFloaterPosition()

fw.getFloaterPosition(panelName)
Acceptable values are "find", "project log", "object", "info", "url", "effect", "history", "mixer", "fill", "stroke", "swatches", "layers", "frames", "behaviors", "optimize", "library", "styles", "optimized colors", "options", and "toolbox".
panelName Any panels not specified in the list of valid arguments (like those in the Command Panels folder which are outside the Fireworks application) should be named exactly as they appear in the file system without their file extension. For example, the valid argument name for the Align panel (Align.swf) is "Align", and a valid name for a custom panel file mypanel.swf would be "mypanel".
A rectangle that specifies the bounds of the panel (see Rectangle data type on page 12).
Gets the screen position and size of the specified panel.
fw.getFloaterVisibility()
fw.getFloaterVisibility(panelName)

panelName

Acceptable values are "find", "project log", "object", "info", "url", and
"effect", "history", "mixer", "fill", "stroke", "swatches", "layers", "frames", "behaviors", "optimize", "library", "styles", "optimized colors", "options", "toolbox". Any panels not specified in the list of valid arguments (like those in the Command Panels folder which are outside the Fireworks application) should be named exactly as they appear in the file system without their file extension. For example, the valid argument name for the Align panel (Align.swf) is "Align", and a valid name for a custom panel file mypanel.swf would be "mypanel".
A Boolean value: true if the specified panel is visible, false otherwise.
Determines whether a specified panel is visible.

Chapter 11: Slices, Rollovers, and Hotspots. 251 Creating and editing slices. 252 Making slices interactive. 260 Preparing slices for export. 269 Working with hotspots and image maps. 275 Chapter 12: Creating Buttons and Pop-up Menus. 281 Creating button symbols. 282 Creating navigation bars. 293 Creating pop-up menus. 293 Chapter 13: Creating Animation. 307 Building animation. 308 Working with animation symbols. 308 Working with frames.313 Tweening.318 Previewing an animation.319 Exporting your animation. 320 Working with existing animations. 322 Using multiple files as one animation. 323 Chapter 14: Optimizing and Exporting. 325 About optimizing. 326 Using the Export Wizard. 326 Optimizing in the workspace.331 Exporting from Fireworks. 352 Sending a Fireworks document as an e-mail attachment. 370 Using the File Management button. 371 Chapter 15: Using Fireworks with Other Applications. 373 Working with Macromedia Dreamweaver. 374 Working with Macromedia Flash. 392 Working with Macromedia FreeHand MX. 399 Working with Macromedia Director MX. 405 Working with Macromedia HomeSite.410 Working with Adobe Photoshop.413 About working with Adobe GoLive.419 About working with HTML editors. 420 About extending Fireworks. 420
Chapter 16: Automating Repetitive Tasks. 421 Finding and replacing.422 Batch processing.426 Extending Fireworks. 437 Flash SWF movies used as Fireworks panels. 443 Chapter 17: Preferences and Keyboard Shortcuts. 445 Setting preferences. 445 Changing keyboard shortcut sets. 449 Working with configuration files. 451 About reinstalling Fireworks.453 Viewing package contents (Macintosh only).453 Index. 455

CHAPTER 1

Introduction
Macromedia Fireworks 8 is the definitive solution for professional web graphics design and production. It is the first production environment to address and solve the special challenges facing web graphics designers and developers. You can use Fireworks to create, edit, and animate web graphics, add advanced interactivity, and optimize images in a professional environment. In Fireworks, you can create and edit bitmap and vector graphics in a single application. Everything is editable, all the time. And you can automate the workflow to meet the demands of time-consuming updates and changes. Fireworks integrates with other Macromedia products such as Dreamweaver, Flash, FreeHand, and Director, as well as your other favorite graphics applications and HTML editors, to provide a truly integrated web solution. You can easily export Fireworks graphics with HTML and JavaScript code customized for the HTML editor youre using. This chapter covers the following topics:

Subtracting pixels from a selection
You can subtract pixels from a selection, or punch out parts of a selection, defining pixel areas inside the original marquee that will no longer be part of the selection.
To subtract pixels from a selection:
Hold down Alt (Windows) or Option (Macintosh) and use a bitmap selection tool to select the pixel area to be punched out.
Creating a marquee from intersecting marquees
You can select pixels in an existing marquee by drawing a marquee that overlaps the original.
To select a pixel area defined by the intersection of two marquees:
Hold down Alt+Shift (Windows) or Option+Shift (Macintosh) while creating a new marquee selection that overlaps the original marquee. Release the mouse button. Only the pixels in the intersection area of the two marquees are selected.
Using thumbnails and modifier keys to modify pixel selections
With a bitmap selected, you can create a pixel selection on that bitmap using the opacity of any object or mask in the Layers panel. For more information about the Layers panel, see Working with layers on page 204.
To create or replace a pixel selection on a selected bitmap using the opacity of an object:
In the Layers panel, position the pointer over the thumbnail of the object you want to use to create the pixel selection. Hold down Control (Windows) or Command (Macintosh). The pointer changes to indicate you are about to select the alpha channel, or the opaque area, of the object.
Click the thumbnail. A new pixel selection is created on the selected bitmap.
To add to the current pixel selection:
Control-Shift-click (Windows) or Command-Shift-click (Macintosh) the thumbnail of an object in the Layers panel to add the shape of its opaque area to the current pixel selection.
When you position the pointer over the thumbnail and hold down the specified modifier keys, the pointer indicates that you are about to add to the pixel selection.
To subtract from the current pixel selection:
Control-Alt-click (Windows) or Command-Option-click (Macintosh) the thumbnail of an object in the Layers panel to subtract the shape of its opaque area from the current pixel selection.
When you position the pointer over the thumbnail and hold down the specified modifier keys, the pointer indicates that you are about to subtract from the pixel selection.

If more than one object or group is selected, the objects move in front of or behind all unselected objects while maintaining their order relative to one another.

Aligning objects

The Align commands in the Modify menu give you a wide range of arrangement options, allowing you to do any of the following:
Align objects along a horizontal or vertical axis. Align selected objects vertically along their right edge, center, or left edge, or horizontally along their top edge, center, or bottom edge.
Edges are determined by the bounding boxes enclosing each selected object.
Distribute selected objects so that their centers or edges are evenly spaced.
You can apply one or more Align commands to selected objects.
To align selected objects, do one of the following:
Select Modify > Align > Left to align the objects to the leftmost selected object. Select Modify > Align > Center Vertical to align the center points of the objects along a vertical axis. Select Modify > Align > Right to align the objects to the rightmost selected object. Select Modify > Align > Top to align the objects to the topmost selected object. Select Modify > Align > Center Horizontal to align the center points of the objects along a horizontal axis. Select Modify > Align > Bottom to align the objects to the bottommost selected object.
To evenly distribute the widths or heights of three or more selected objects:
Select Modify > Align > Distribute Widths or Modify > Align > Distribute Heights.
About arranging objects among layers
The Layers panel offers another dimension of organizational control. You can move selected objects from one layer to another by dragging the object thumbnail or the blue selection indicator in the Layers panel to another layer. For more information, see Organizing layers on page 207.

CHAPTER 4

Working with Bitmaps
Bitmaps are graphics composed of small colored squares called pixels, which combine like the tiles of a mosaic to create an image. Examples of bitmap graphics include photographs, scanned images, and graphics created from paint programs. They are sometimes referred to as raster images. Macromedia Fireworks 8 combines the functionality of photo-editing, vector-drawing, and painting applications. You can create bitmap images by drawing and painting with bitmap tools, by converting vector objects to bitmap images, or by opening or importing images. Fireworks has a powerful set of Live Filters for tone and color adjustment, as well as a number of ways to retouch your bitmap images, including cropping, feathering, and duplicating or cloning images. In addition, Fireworks has a set of image-retouching toolsBlur, Sharpen, Dodge, Burn, and Smudge. For information on methods for selecting and transforming images and pixel areas, see Chapter 3, Selecting and Transforming Objects, on page 51. This chapter contains the following topics:

102 Chapter 4: Working with Bitmaps
Inverting an images color values
You can use Invert to change each color in an image to its inverse on the color wheel. For example, applying the filter to a red object (R=255, G=0, B=0) changes the color to light blue (R=0, G=255, B=255).
A monochrome image; after inverting
A color image; after inverting
Adjusting bitmap color and tone 103

To invert colors:

Select the image. Do one of the following:
In the Property inspector, click the Add Live Filters button, and then select Adjust Color > Invert from the Filters pop-up menu. Select Filters > Adjust Color > Invert.
Blurring and sharpening bitmaps
Fireworks has a set of blurring and sharpening options that you can apply as Live Filters or as irreversible, permanent filters.

Blurring an image

Blurring softens the look of a bitmap image. Fireworks has six blurring options:

Blur More

Gaussian Blur
Motion Blur creates Radial Blur Zoom Blur

To blur an image:

104 Chapter 4: Working with Bitmaps
softens the focus of selected pixels. blurs about three times as much as Blur. applies a weighted average of blur to each pixel to produce a hazy effect. the appearance that the image is moving.
creates the appearance that the image is spinning. creates the appearance that the image is moving toward or away from the viewer.
Applying filters from the Filters menu is destructive; that is, it cannot be undone except when Edit > Undo is an option. To maintain the ability to adjust, turn off, or remove a filter, apply it as a Live Filter, as described in the first bulleted option in each of the following procedures. For more information, see Chapter 8, Using Live Filters, on page 193.
In the Property inspector, click the Add Live Filters button, and then select Blur > Blur or Blur More from the Filters pop-up menu. Select Filters > Blur > Blur or Blur More.
To blur an image using Gaussian Blur:

Select one of the following from the Swatches panel Options menu:

Clear Swatches

clears the entire Swatches panel. the swatches by color value.

Sort by Color sorts

Creating colors in the Color Mixer
In the Color Mixer, you can create colors by dragging sliders or entering values for each component of a color model such as RGB, Hexadecimal, or CMY. The color you create is applied to the active Stroke Color or Fill Color box. The Color Mixer also has a color bar displaying the range of colors in the current color model. You can click anywhere in the color bar to apply a color. You can also click the system color picker button to select a Windows or Macintosh system color.
Although CMY is a color model option, graphics directly exported from Fireworks are not ideal for printing. To repurpose exported Fireworks graphics for print, you can import them into FreeHand MX, which automatically performs CMYK conversion of RGB images when output to digital color separations. For more information, see FreeHand documentation.
Mixing colors in the Color Mixer
You can use the Color Mixer to view the values of the active color and edit color values to create new colors.
By default, the Color Mixer identifies RGB colors as hexadecimal, displaying hexadecimal color values for red (R), green (G), and blue (B) color components. Hexadecimal RGB values are calculated based on a range of values from 00 to FF.

Color model

RGB Hexadecimal

Mode of color expression

Values of Red, Green, and Blue, where each component has a value from 0 to 255. 0-0-0 is black and 255-255-255 is white. RGB values of Red, Green, and Blue, where each component has a hexadecimal value from 00 to FF. 00-00-00 is black and FF-FF-FF is white. Values of Hue, Saturation, and Brightness, where Hue has a value from 0 to 360 degrees, and Saturation and Brightness have a value from 0 to 100%.
172 Chapter 7: Applying Color, Strokes, and Fills

CMY Grayscale

Values of Cyan, Magenta, and Yellow, where each component has a value from 0 to 255. 0-0-0 is white and 255-255-255 is black. A percentage of black. The single Black (K) component has a value from 0 to 100%, where 0 is white, 100 is black, and values in between are shades of gray.
You can select alternative color models from the Color Mixer Options menu. The current colors component values change with each new color model.
To display the Color Mixer:
Select Window > Color Mixer.
To apply a color from the color bar to a selected vector object:
Click the icon next to the Stroke Color or Fill Color box in the Color Mixer. Move the pointer over the color bar. The pointer becomes the eyedropper pointer. Click to pick a color. The color is applied to the selected object and becomes the active stroke or fill color.

Image with mask applied

The mask as it appears in the Layers panel
For more information about modifying a bitmap masks appearance by drawing on it, see Modifying a masks appearance on page 226.
218 Chapter 9: Layers, Masking, and Blending
Masking objects using the Reveal and Hide commands
The Modify > Mask submenu has several options for applying empty bitmap masks to objects:
Reveal All applies an empty, transparent mask to an object, revealing the entire object. To achieve the same effect, click the Add Mask button in the Layers panel. Hide All applies
an empty, opaque mask to an object, which hides the entire object.

Reveal Selection can

be used only with pixel selections. It applies a transparent pixel mask using the current pixel selection. The other pixels in the bitmap object are hidden. To achieve the same effect, make a pixel selection, then click the Add Mask button.

Hide Selection can

be used only with pixel selections. It applies an opaque pixel mask using the current pixel selection. The other pixels in the bitmap object are shown. To achieve the same effect, make a pixel selection, then Alt-click (Windows) or Option-click (Macintosh) the Add Mask button.
To use the Reveal All and Hide All commands to create a mask:
Select the object you want to mask. Do one of the following to create the mask:
Select Modify > Mask > Reveal All to show the object. Select Modify > Mask > Hide All to hide the object.
Select a bitmap painting tool from the Tools panel, such as the Brush, Pencil, or Paint Bucket. Set the desired tool options in the Property inspector. If youve applied a Hide All mask, you must select a color other than black. Draw on the empty mask. In the areas where you draw, the underlying masked object is either hidden or shown, depending on the type of mask you applied.

Masking images 219

To use Reveal Selection and Hide Selection commands to create a mask:
Select the Magic Wand or any marquee or lasso tool from the Tools panel. Select pixels in a bitmap.
Original image; pixels selected with the Magic Wand
Do one of the following to create the mask:
Select Modify > Mask > Reveal Selection to show the area defined by the pixel selection. Select Modify > Mask > Hide Selection to hide the area defined by the pixel selection.

To delete a style:

Select a style from the Styles panel. Shift-click to select multiple styles; Control-click (Windows) or Command-click (Macintosh) to select multiple noncontiguous styles.
Click the Delete Style button in the Styles panel.

Editing styles

If you want to change the attributes that a style contains, you can edit the style from the Styles panel.

To edit a style:

Choose Select > Deselect to deselect any objects on the canvas. Double-click a style in the Styles panel. In the Edit Style dialog box, select or deselect components of the attributes you wish to apply. The Edit Style dialog box contains the same options as the New Style dialog box. For details on choosing attributes to include in a style, see Creating and deleting styles on page 237. Click OK to apply the changes to the style.
Exporting and importing styles
You may want to share styles with other Fireworks users to save time and maintain consistency. You can share styles by exporting them for use on other computers.

To export styles:

2. 3. 4.
Select Export Styles from the Styles panel Options menu. Enter a name and location for the document that will contain the saved styles. Click Save.
238 Chapter 10: Using Styles, Symbols, and URLs

To import styles:

Select Import Styles from the Styles panel Options menu. Select a styles document to import. All styles in the styles document are imported and placed directly after the selected style in the Styles panel.

Using style defaults

If you want to delete all custom styles from the Styles panel and restore any deleted default styles, you can reset the Styles panel to its default state. You can also change the size of the icons displayed in the Styles panel.
To reset the Styles panel to the default styles:
Select Reset Styles from the Styles panel Options menu.
Resetting styles to the default removes any custom styles you may have saved.
To change the size of the style preview icons:
Select Large Icons from the Styles panel Options menu to switch between large and small preview sizes.
Applying attributes without creating a style
You can copy attributes from one object and apply them to other objects, without creating a new style in the Styles panel. You can use this method to quickly apply attributes to an object when you are not planning to reapply those attributes to other objects. Attributes that can be copied and applied include fills, strokes, filters, and text attributes.

Click on the blue behavior line you want to remove. Click OK to remove the swap image behavior.
Making slices interactive 265
Using the Behaviors panel to add interactivity to slices
In addition to rollovers, you can attach other types of interactivity to slices using the Behaviors panel. You can create custom interactions by editing existing behaviors.
Although you can create simple, disjoint, and complex rollovers with the Behaviors panel, the drag-and-drop rollover method is recommended. For more information, see Adding simple interactivity to slices on page 260.
The following behaviors are available in Fireworks:

Simple Rollover adds

a rollover behavior to the selected slice using Frame 1 as the Up state and Frame 2 as the Over state. After you select this behavior, you need to create an image in the second frame, under the same slice, to create the Over state. The Simple Rollover option is actually a behavior group containing the Swap Image and Swap Image Restore behaviors.
replaces the image under the specified slice with the contents of another frame or the contents of an external file.
Swap Image Restore restores Set Nav Bar Image sets

Swap Image

the target object to its default appearance in Frame 1.
a slice to be a part of a Fireworks navigation bar. Each slice that is part of the navigation bar must have this behavior. The Set Nav Bar Image option is actually a behavior group containing the Nav Bar Over, Nav Bar Down, and Nav Bar Restore behaviors. This behavior is automatically set for you by default when you use the Button Editor to create a button that includes an Include Over While Down state or Show Down Image Upon Load state. When you create a two-state button, a simple rollover behavior is assigned to its slice. When you create a three- or four-state button, a Set Nav Bar Image behavior is assigned to its slice. For more information on buttons, see Creating button symbols on page 282.
the Over state for the currently selected slice when it is part of a navigation bar and optionally specifies the Preload images state and Include Over While Down state.
Nav Bar Down specifies a Down state for the currently selected slice when it is part of a navigation bar and optionally specifies a Preload images state. Nav Bar Restore restores

Nav Bar Over specifies

If you select a color from the color pop-up window, it applies only to HTML slices; image slices continue to use the canvas color.
Select what to place in empty cells from the Contents pop-up menu:
causes empty cells to remain blank. places a small transparent image called spacer.gif in empty cells. places an HTML space tag in empty cells. The cell appears hollow.

Spacer Image

Non-breaking Space
Empty cells occur only if you deselect Include Areas Without Slices in the Export dialog box during export.
Click OK. For more information about specifying HTML export options, see Setting HTML export options on page 367.
You can specify unique table export settings for sliced objects for each document. Or you can use the Set Defaults button on the Document Specific tab of the HTML Setup dialog box to apply defaults for all new documents.
274 Chapter 11: Slices, Rollovers, and Hotspots
Working with hotspots and image maps
Web designers can use hotspots to make small parts of a larger graphic interactive, linking areas of web graphics to a URL. You can create an image map in Fireworks by exporting HTML from a document that contains hotspots.
An image map with hotspots Hotspots and image maps are often less resource-intensive than sliced graphics. Slicing can be more resource-intensive to web browsers because of the additional HTML code they must download and the processing power required to reassemble sliced graphics.
It is possible to create a sliced image map. Exporting a sliced image map typically generates many graphic files. For more information about slicing, see Creating slice objects on page 253.
Hotspots are ideal when you want areas of an image to link to other web pages, but you dont need those areas to highlight or produce rollover effects in response to mouse movement or actions. Hotspots and image maps are also ideal when the graphic onto which youve placed your hotspots would be best exported as a single graphic filein other words, the entire graphic would best be exported using the same file format and optimization settings.
Working with hotspots and image maps 275

Creating hotspots

After you identify areas on a source graphic that would make good navigation points, you create the hotspots and then assign URL links, pop-up menus, status bar messages, and alt text to them. There are two ways to create hotspots:
You can draw the hotspot around a target area in the graphic using the Rectangle, Circle, or Polygon (odd-shaped) Hotspot tools. You can select an object and insert the hotspot over it.

Click Copy Down Graphic to paste a copy of the Down state graphic into the Over While Down window, and then edit it to change its appearance. Drag and drop, import, or draw a graphic.
When you insert or create a graphic for the Over While Down State, the Include Nav Bar Over While Down State option is automatically chosen. This button state is for buttons that are part of navigation bars.
Using bevel filters to draw button states
As you create graphics for each button state, you can apply preset Live Filters to create common appearances for each state. For example, if you are creating a four-state button, you can apply the Raised filter to the Up state graphic, the Highlighted filter to the Down state graphic, and so on.
To apply preset Live Filters to a button symbol:
With the desired button symbol open in the Button Editor, select the graphic to which you want to add a Live Filter. Click the Add Live Filters button in the Property inspector. In the pop-up menu that appears, do one of the following:
Select Bevel and Emboss > Inner Bevel. Select Bevel and Emboss > Outer Bevel.
In the pop-up window that appears, select a button preset filter. These are described below.

Button preset filter

Raised
The bevel appears to rise from the underlying objects.

Highlighted

The buttons colors lighten.
The bevel appears to sink into the underlying objects.

Inverted

The bevel appears to sink into the underlying objects, and the colors lighten.
Repeat steps 1 through 4 for the remaining button states, giving each state a different button preset filter.
Converting Fireworks rollovers into buttons
You can create buttons from rollovers that you created in previous versions of Fireworks. The components convert to a button, and the new button is placed in the library. For more information about rollovers, see Making slices interactive on page 260.
Creating button symbols 285
To convert a Fireworks rollover into a button:
Delete the slice or hotspot covering the rollover images. Select Show All Frames from the Onion Skinning pop-up menu in the Frames panel. Select all the objects to be included in the button.
Use the Select Behind tool to select objects that are hidden behind others. For more information, see Using the Select Behind tool on page 53.
Select Modify > Symbol > Convert to Symbol. The Symbol Properties dialog box opens. Enter a name for the symbol in the Name text box. Select the Button symbol type. Click OK. The new button is added to the library.
You can also convert four-frame animations to buttons. Simply select all four objects, and each is placed on its own button state.

To import an animated GIF:
Select File > Import. Locate the file and click Open. Click Yes to add additional frames to your animation.
If you click Cancel, only the first frame of the animated GIF is displayed. Although the whole document is imported, you must add additional frames to view it.

To open an animated GIF:

Select File > Open and locate the GIF file.
322 Chapter 13: Creating Animation
Using multiple files as one animation
Fireworks can create an animation based on a group of image files. For example, you can create a banner ad based on several existing graphics by opening each graphic and placing it in a separate frame in the same document.
To open multiple files as an animation:
Select File > Open. Shift-click to select multiple files. Select Open as Animation and click OK. Fireworks opens the files in a new single document, placing each file in a separate frame in the order in which you selected it.
Using multiple files as one animation 323
324 Chapter 13: Creating Animation

CHAPTER 14

Optimizing and Exporting
The ultimate goal in web graphic design is to create great-looking images that download as fast as possible. To do that, you must select a file format with the best compression for your image while maintaining as much quality as possible. This balancing act is optimization finding the right mix of color, compression, and quality. Exporting graphics from Macromedia Fireworks 8 is a two-step process:
First, you prepare a document or individual sliced graphics for export by selecting optimization settings and comparing previews to determine an acceptable balance between quality and file size. Second, you export (or in some cases, save) the document or individual sliced graphics using export settings suitable for their destination on the web or elsewhere.
If you are new to optimizing and exporting web graphics, you can use the Export Wizard. The wizard guides you through the export process and suggests settings. It also displays the Image Preview, where you can optimize a document as part of the export process. If you are comfortable with the tasks of optimizing and exporting graphics, youll want to use the other tools available in Fireworks for optimizing and exporting. For optimizing, you use the Optimize panel and the preview buttons in the Document window. They offer you greater control over the optimization process. For exporting, you use the Export dialog box or the Quick Export button. In some cases, you can simply save the graphic without exporting. For more information, see Saving documents in other formats on page 27. The Quick Export button makes exporting graphics for use in other applications easy by automatically setting the appropriate options in the Export dialog box for you. If you use Fireworks with other applications, the Quick Export button can simplify your design workflow. This chapter covers the following topics:

Finding and replacing.422 Batch processing.426 Extending Fireworks. 437 Flash SWF movies used as Fireworks panels. 443

Finding and replacing

The Find and Replace feature helps you search for and replace elements, such as text, URLs, fonts, and colors. Find and Replace can search the current document or multiple files. Find and Replace works only in Fireworks PNG files or in files containing vector objects, such as FreeHand, uncompressed CorelDraw, and Illustrator files.
Search option Find option

Find panel

To select the source for the search:
Open the document. Do one of the following to open the Find panel:
Select Window > Find. Select Edit > Find. Press Control+F (Windows) or Command+F (Macintosh).
If the files you select are locked or checked in from a Macromedia Dreamweaver site, you are prompted to unlock them or check them out before proceeding.
From the Search pop-up menu, select a source for the search:

Search Selection

finds and replaces elements only among the currently selected objects

and text.

Search Frame
finds and replaces elements only in the current frame. finds and replaces elements in the active document.

Search Document

422 Chapter 16: Automating Repetitive Tasks
Search Files finds and replaces elements across multiple files. If this option is not already selected in the Search pop-up menu, selecting it opens a dialog box in which you can select which files to search. If Search Files is already selected in the Search pop-up menu, you have the option to select which files to search after you begin the search operation by clicking Find, Replace, or Replace All. 4. 5. 6.
From the Find pop-up menu, select an attribute to search for. The options in the panel change according to your selection. Set the options for the selected Find attribute. Select a find-and-replace operation:
locates the next instance of the element. Found elements appear selected in the document. changes a found element with the contents of the Change To option. finds and replaces every occurrence of a found element throughout the search range.
Replacing objects in multiple files automatically saves those files; you cannot reverse the change using Edit > Undo. For more information, see Finding and replacing during a batch process on page 432.

Replace

Replace All
Setting options for finding and replacing in multiple files
When finding and replacing among multiple files, you can determine how Fireworks handles multiple open files after the search.
To save, close, and back up each file after it is searched:
Select Replace Options from the Find panel Options menu. Select Save and Close Files to save and close each file after the find and replace. Only the originally active documents remain open.

Select File > Batch Process, and select the files to process. You can select files from different folders, and you can also include all currently open documents in the batch. As youre working through the wizard, you can use the Back button if you need to make any changes to your file selection.
You also have the option of not selecting any files at all while using the wizard if you only want to save the batch-process script for later use.

Batch processing 427

If the files you select are locked or checked in from a Dreamweaver site, you are prompted to unlock them or check them out before proceeding.
Click one of the following in the Batch (Windows) or Batch Process (Macintosh) dialog box:
Add adds selected files and folders to the list of files to batch-process. If a folder is selected,
all valid, readable files in the folder are added to the batch process.
Valid files are files that have been created, named, and saved. If the latest file version is not saved, you are asked to save it, and you can then continue the batch process. If you dont save the file, the entire batch process ends.

Add All

adds all valid files in the currently selected folder to the list of files to batchremoves selected files from the list of files to batch-process.

process.

Remove 3.
Select Include Current Open Files to add all currently open files. These files do not appear in the list of files to batch-process, but they are included in the process.
428 Chapter 16: Automating Repetitive Tasks
Click Next, then do one or both of the following:
To add a task to the batch, select it in the Batch Options list and click Add. Each task can be added only once. For more information on the Scale option, see Scaling graphics with a batch process on page 431. For more information on the Rename option, see Changing filenames with a batch process on page 433. For more information on adding commands, see Performing commands with a batch process on page 434.
To reorder the list, select the task in the Include in Batch list and click the up and down arrow buttons.
The order in which tasks appear in the Include in Batch list is the order in which the tasks are performed during the batch process, with the exception of Export and Rename, which are always performed last.