Automation with Fireworks CS4 Commands – Reflections

/*
 * CreateReflection is a Fireworks Command that creates a vertical reflection [of the currently selected items].
 *
 * This is an incredible timesaver and allows the designer to quickly create reflections for anything.
 * When 1 or more items are selected in the current canvas area, those items are:
 *   1) Duplicated, flipped vertically, and flatten (original items are unchanged and deselected)
 *   2) The flattened copy is cropped to the top 40 pixels
 *   3) A gradient alpha mask is applied to the cropped image
 *   4) Both the mask and image are flattened and opacity set to 20%
 *
 * TODOs:
 *    1) Add support to skew/distort the selected images and reflection (for 3D perspective effect)
 *    2) Create runtime UI dialog to request clip height, offset, opacity, and skew parameters
 *    3) Check for no items currently selected and posting feedback to designer
 *
 * Author:  Thomas Burleson, Flex/Groovy Consultant
 *
 *          Blog    @ http://www.gridlinked.info
 *          Profile @ http://www.LinkedIn.com/in/ThomasBurleson
 *          eMail   @ ThomasBurleson@gmail.com
 *
 *
 * Date:  Feb 24, 2009
 */ 
 
var OFFSET         = 4;
var REFLECT_HEIGHT = 40;
 
var dom            = fw.getDocumentDOM();
var reflections    = new Array();
 
// Copy and flip selection, move to OFFSET below the original, and flatten to bitmap 
dom.clipCopy();
dom.clipPaste();
 
dom.group();
dom.reflectSelection(false, true, "autoTrimImages transformAttributes");
dom.flattenSelection();
 
var bounds = dom.getSelectionBounds();
dom.moveSelectionBy({x:0, y:bounds.bottom-bounds.top+OFFSET}, false, false);
 
// Clip image to REFLECT_HEIGHT,
bounds = dom.getSelectionBounds();
bounds.bottom = bounds.top + REFLECT_HEIGHT;
dom.setSelectionMask( {  maskBounds:bounds, 
                                       maskKind:"rectangle", 
                                       maskEdgeMode:"hard edge", 
                                       featherAmount:0, 
                                       maskData:null }, 
                                    "replace");
dom.exitPaintMode();
dom.cropSelection(bounds);
 
// Cache the reflection...
reflections.push(fw.selection[0]);
 
// Build an alpha clip mask and set transparency to 20%
dom.addNewRectanglePrimitive(bounds, 0);
dom.setBrushNColor(null, "#ffffff00");
dom.setFillVectorStart({x:bounds.left, y:bounds.top});
dom.setFill( { category     :"fc_Linear", 
			   ditherColors :[ "#000000", "#000000" ],
			   edgeType     :"antialiased", 
			   feather      :0, 
			   gradient     :{ name:"cn_Custom", nodes:[ { color:"#ffffff",  isOpacityNode:false, position:0 }, { color:"#ffffff",  isOpacityNode:false, position:1 }], opacityNodes:[ { color:"#000000",  isOpacityNode:true,  position:0 }, { color:"#00000000",isOpacityNode:true,  position:1 }] }, 
			   name         :"fn_Linear", 
			   pattern      :null, 
			   shape        :"linear", 
			   stampingMode :"blend opaque", 
			   textureBlend :0, 
			   webDitherTransparent:false });
 
// Cache the alpha mask
reflections.push(fw.selection[0]);
 
// Select the reflection and alpha mask, then group and set opacity...
fw.selection = reflections; 
dom.group("mask to image");
dom.flattenSelection();
dom.setOpacity(20);
 
// DONE!