public static var VERSION:String = FuseKitCommon.VERSION;
        
        

* Extends MC, Button & TF prototypes with @ax-actionscript-video-com-mosesSupposes-fuse-FuseFMP shortcuts. * @description This enables the getting and setting of BitmapFilter properties directly on targets, using the convention short-filtername+"_"+filterprop. * <br><br>For a complete list of shortcut properties call {gray com.mosesSupposes.fuse.@ax-actionscript-video-com-mosesSupposes-fuse-FuseFMP#getAllShortcuts} or {gray com.mosesSupposes.fuse.@ax-actionscript-video-com-mosesSupposes-fuse-FuseFMP#traceAllFilters}.<br><br> * Also sets _global references to @ax-actionscript-video-com-mosesSupposes-fuse-FuseFMP and all filter classes so timeline coders can avoid using import statements.<br><br> * Note that you do not need to call this method if you're using {gray com.mosesSupposes.fuse.ZigoEngine#simpleSetup}, it will be called automatically. *
see: com.mosesSupposes.fuse.ZigoEngine#simpleSetup * @see com.mosesSupposes.fuse.ZigoEngine#register */ public static function simpleSetup() : Void { initialize(MovieClip.prototype, Button.prototype, TextField.prototype); _global.@ax-actionscript-video-com-mosesSupposes-fuse-FuseFMP = @ax-actionscript-video-com-mosesSupposes-fuse-FuseFMP; for (var i:String in $fclasses)\; \{\; \_global[i]\; =$fclasses[i]; } } /** * Internal; Ensures import */ private static var $fclasses:Object;\; /**\; *\; Internal;\; memory\; object\; for\; shortcut\; methods\; */\; private\; static\; var$shortcuts:Object; /** * Internal; resolve object for shortcut getters */ private static var $gro:Object;\; /**\; *\; Internal;\; resolve\; object\; for\; shortcut\; setters\; */\; private\; static\; var$sro:Object; /** * Adds shortcuts to all target objects passed. * @description This enables the getting and setting of BitmapFilter properties directly on targets, using the convention short-filtername+"_"+filterprop. *

For a complete list of shortcut properties call {gray com.mosesSupposes.fuse.@ax-actionscript-video-com-mosesSupposes-fuse-FuseFMP#getAllShortcuts} or {gray com.mosesSupposes.fuse.@ax-actionscript-video-com-mosesSupposes-fuse-FuseFMP#traceAllFilters}.

* @param accepts one or more MovieClips, TextFields, or Buttons to initialize with shortcuts. * @see #deinitialize */ public static function initialize(target:Object):Void { if ($fclasses\; ==\; undefined)\; \{$shortcuts = {getFilterName:function (f:BitmapFilter):String { return @ax-actionscript-video-com-mosesSupposes-fuse-FuseFMP.getFilterName(f); }, getFilterIndex:function (f:Object):Number { return @ax-actionscript-video-com-mosesSupposes-fuse-FuseFMP.getFilterIndex(this, f); }, getFilter:function (f:Object, createNew:Boolean):BitmapFilter { return @ax-actionscript-video-com-mosesSupposes-fuse-FuseFMP.getFilter(this, f, createNew); }, writeFilter:function (f:Object, pObj:Object):Number { return @ax-actionscript-video-com-mosesSupposes-fuse-FuseFMP.writeFilter(this, f, pObj); }, removeFilter:function (f:Object):Boolean { return @ax-actionscript-video-com-mosesSupposes-fuse-FuseFMP.removeFilter(this, f); }, getFilterProp:function (prop:String, createNew:Boolean) { return @ax-actionscript-video-com-mosesSupposes-fuse-FuseFMP.getFilterProp(this, prop, createNew); }, setFilterProp:function (prop:String, v:Object):Void { @ax-actionscript-video-com-mosesSupposes-fuse-FuseFMP.setFilterProp(this, prop, v); }, setFilterProps:function (fOrPObj:Object, pObj:Object):Void { @ax-actionscript-video-com-mosesSupposes-fuse-FuseFMP.setFilterProps(this, fOrPObj, pObj); }, traceAllFilters:function ():Void { @ax-actionscript-video-com-mosesSupposes-fuse-FuseFMP.traceAllFilters(); }}; $fclasses\; =\; \{BevelFilter:BevelFilter,\; BlurFilter:BlurFilter,\; ColorMatrixFilter:ColorMatrixFilter,\; ConvolutionFilter:ConvolutionFilter,\; DisplacementMapFilter:DisplacementMapFilter,\; DropShadowFilter:DropShadowFilter,\; GlowFilter:GlowFilter,\; GradientBevelFilter:GradientBevelFilter,\; GradientGlowFilter:GradientGlowFilter\};\; //\; getter\; function\; template$gro = {__resolve:function (name:String):Function { var f:Function = function ():BitmapFilter { var local:Object = this; if (local['filters'] != undefined) { var $splitname:Array\; =\; name.split("\_");\; if\; ($splitname[1] == 'blur') { $splitname[1]\; =\; \text{'}blurX\text{'};\; \}\; //\; new\; filter\; not\; created\; if\; missing\; (getFilterProp\; can,\; however)\; return\; @ax-actionscript-video-com-mosesSupposes-fuse-FuseFMP.getFilter(this,$splitname[0]+"Filter", false)[$splitname[1]];\; \}\; \};\; return\; f;\; \};\; //\; setter\; function\; template$sro = {__resolve:function (name:String):Function { var f:Function = function (val:Object) { var local:Object = this; if (local['filters'] != undefined) { @ax-actionscript-video-com-mosesSupposes-fuse-FuseFMP.setFilterProp(this, name, val); } }; return f; }}; } if (arguments[0] == null) { return; } // make sure only filterable targets are initialized! var valid:Array = [MovieClip, Button, TextField]; for (var i:String in arguments) { var ok:Boolean = false; for (var j:String in valid) { if (arguments[i] instanceof valid[j] || arguments[i] == Function(valid[j]).prototype) { ok = true; break; } } if (!ok) { FuseKitCommon.error('201', i); continue; } for (var $filtername:String\; in$fclasses) { var $f:BitmapFilter\; =\; new\; ($fclasses[$filtername])();\; for\; (var\; b:String\; in$f) { // excluding .clone and any other method encountered if (typeof $f[b]\; ==\; \text{'}function\text{'})\; \{\; continue;\; \}\; var\; eigenschaft:String\; =$filtername.substr(0, -6)+"_"+b; (arguments[i]).addProperty(eigenschaft, $gro[eigenschaft],$sro[eigenschaft]); // must remain overwritable for direct initialization of individual targets. _global.ASSetPropFlags(arguments[i], eigenschaft, 3, 1); if (b == 'blurX') { eigenschaft = eigenschaft.slice(0, -1); (arguments[i]).addProperty(eigenschaft, $gro[eigenschaft],$sro[eigenschaft]); _global.ASSetPropFlags(arguments[i], eigenschaft, 3, 1); } } } for (var s:String in $shortcuts)\; \{\; (arguments[i])[s]\; =$shortcuts[s]; _global.ASSetPropFlags(arguments[i], s, 7, 1); } } } /** * Removes shortcuts from specific targets or from MC, Button & TF prototypes if no targets are passed. * @param accepts one or more MovieClips, TextFields, or Buttons to strip FusFMP shortcuts from, or pass nothing/null to undo {gray #simpleSetup}. * @see #initialize */ public static function deinitialize():Void { if ($fclasses\; ==\; undefined)\; \{\; return;\; \}\; if\; (arguments.length\; ==\; 0)\; \{\; arguments.push(MovieClip.prototype,\; Button.prototype,\; TextField.prototype);\; \}\; for\; (var\; i:String\; in\; arguments)\; \{\; for\; (var$filtername:String in $fclasses)\; \{\; var$f:BitmapFilter = new ($fclasses[$filtername])(); for (var b:String in $f)\; \{\; //\; excluding\; .clone\; and\; any\; other\; method\; encountered\; if\; (typeof$f[b] == 'function') { continue; } var eigenschaft:String = $filtername.substr(0,\; -6)+"\_"+b;\; //\; 0,2\; is\; NOT\; a\; mistake,\; do\; not\; change\; \_global.ASSetPropFlags(arguments[i],\; eigenschaft,\; 0,\; 2);\; //\; safety,\; might\; be\; unnecessary\; (arguments[i]).addProperty(eigenschaft,\; null,\; null);\; delete\; (arguments[i])[eigenschaft];\; \}\; \}\; for\; (var\; s:String\; in$shortcuts) { // 0,2 is NOT a mistake, do not change _global.ASSetPropFlags(arguments[i], s, 0, 2); delete (arguments[i])[s]; } } } /** * Quick way to get a filter instance's class name. * @description *

// list filter in my_mc by name to output window
	* for (var i:String in my_mc.filters) {
	* 	trace( @ax-actionscript-video-com-mosesSupposes-fuse-FuseFMP.getFilterName(my_mc.filters[i]) );
	* }

* @param $myFilter\; BitmapFilter\; instance\; *\; @return\; BitmapFilter\; instance\; name\; *\; @see\; \#getAllShortcuts\; *\; @see\; \#traceAllFilters\; */\; public\; static\; function\; getFilterName($myFilter:BitmapFilter):String { if ($fclasses\; ==\; undefined)\; \{\; initialize(null);\; \}\; for\; (var\; a:String\; in$fclasses) { if ($myFilter.\_\_proto\_\_\; ==\; Function($fclasses[a]).prototype) { return a; } } return null; } /** * Gets current filter index. * @param $obj\; parent\; object\; of\; filters\; *\; @param$myFilter BitmapFilter instance, String (like "BlurFilter" or "Blur"), or class constructor * @return index of filter in filters Array or -1 if filter doesn't exist. * @see #getFilter */ public static function getFilterIndex($obj:Object,$myFilter:Object):Number { if ($fclasses\; ==\; undefined)\; \{\; initialize(null);\; \}$myFilter = $getInstance($myFilter); if ($myFilter\; ===\; null)\; \{\; return\; -1;\; \}\; var$filters_temp:Array = filters_temp.length; i++) { if (($filters\_temp[i]).\_\_proto\_\_\; ==$myFilter.__proto__) { return i; } } return -1; } /** * Returns an existing filter from targ's filters Array or null if doesn't exist, or use createNew if you want a new instance to be created regardless. * @param $obj\; target\; filter\text{'}s\; parent\; *\; @param$myFilter BitmapFilter instance, String (like "BlurFilter" or "Blur"), or class constructor * @param $createNew\; Boolean\; variable\; to\; set\; whether\; or\; not\; to\; create\; new\; filter\; instance\; *\; @return\; existing\; filter\; from\; targ\text{'}s\; filters\; array\; or\; null\; *\; @see\; \#getFilterIndex\; */\; public\; static\; function\; getFilter($obj:Object, $myFilter:Object,$createNew:Boolean):BitmapFilter { var $index:Number\; =\; getFilterIndex($obj, $myFilter);\; if\; ($index == -1) { if ($createNew\; !=\; true)\; \{\; return\; null;\; \}$index = writeFilter($obj,$myFilter); if ($index\; ==\; -1)\; \{\; return\; null;\; \}\; \}\; return\; ($obj.filters[$index]);\; \}\; /**\; *\; Applies\; or\; overwrites\; an\; existing\; filter.\; NOTE:\; Use\; setFilterProps\; to\; update\; existing\; filters.\; writeFilter\; overwrites\; existing.\; *\; @param$obj target filter's parent * @param $myFilter\; BitmapFilter\; instance,\; String\; (like\; "BlurFilter"\; or\; "Blur"),\; or\; class\; constructor\; *\; @param$propsObj optional, a generic object customizing the new filter, like {blurX:50,quality:1} * @return index in target's filters array (or -1 if fails) * @see #removeFilter * @see #getFilterProp * @see #setFilterProp * @see #setFilterProps */ public static function writeFilter($obj:Object,$myFilter:Object, $propsObj:Object):Number\; \{\; if\; ($fclasses == undefined) { initialize(null); } $myFilter\; =$getInstance($myFilter);\; if\; ($myFilter === null) { return -1; } var $filters\_temp:Array\; =$obj.filters; var $index:Number\; =\; getFilterIndex($obj, $myFilter);\; if\; ($index == -1) { $filters\_temp.push($myFilter); } else { $filters\_temp[$index] = $myFilter;\; \}$obj.filters = $filters\_temp;\; if\; (typeof$propsObj == 'object') { setFilterProps($obj,$myFilter, $propsObj);\; \}$index = getFilterIndex($obj,$myFilter); return ($index);\; \}\; /**\; *\; Clears\; filter.\; *\; @param$obj target filter's parent * @param $myFilter\; BitmapFilter\; instance,\; String\; (like\; "BlurFilter"\; or\; "Blur"),\; or\; class\; constructor\; *\; @return\; true\; or\; false\; for\; success.\; *\; @see\; \#writeFilter\; *\; @see\; \#getFilterProp\; *\; @see\; \#setFilterProp\; *\; @see\; \#setFilterProps\; */\; public\; static\; function\; removeFilter($obj:Object, $myFilter:Object):Boolean\; \{\; if\; ($fclasses == undefined) { initialize(null); } $myFilter\; =$getInstance($myFilter);\; var$filters_temp:Array = $obj.filters;\; var$index:Number = getFilterIndex($obj,$myFilter); if ($index\; ==\; -1)\; \{\; return\; (false);\; \}$filters_temp.splice($index,\; 1);$obj.filters = $filters\_temp;\; return\; true;\; \}\; /**\; *\; Queries\; properties\; from\; MovieClips\; that\; have\; not\; been\; initialized.\; *\; @param$obj target filter's parent * @param $filtername\; BitmapFilter\; instance\; name\; *\; @param$createNew Boolean variable to set whether or not to create new filter instance * @return the value of the property, usually a number * @see #writeFilter * @see #getFilterProp * @see #setFilterProp * @see #setFilterProps */ public static function getFilterProp($obj:Object,$filtername:String, $createNew:Boolean):Object\; \{\; var$splitname:Array = $filtername.split("\_");\; if\; ($splitname[1] == 'blur') { $splitname[1]\; =\; \text{'}blurX\text{'};\; \}\; return\; (@ax-actionscript-video-com-mosesSupposes-fuse-FuseFMP.getFilter($obj, $splitname[0]+"Filter",$createNew)[$splitname[1]]);\; \}\; /**\; *\; Sets\; properties\; for\; filter.\; *\; @param$obj target filter's parent * @param $propname\; BitmapFilter\; property\; *\; @param$val Properties and values * @description Support for multiple targets and multiple properties. There are two distinct syntaxes.
examples: @ax-actionscript-video-com-mosesSupposes-fuse-FuseFMP.setFilterProps([my_mc,my_txt], { Blur_blurX:50, Bevel_blurX:1 }); // multiple targs, multiple filters * @ax-actionscript-video-com-mosesSupposes-fuse-FuseFMP.setFilterProps(my_mc, 'Blur', { blurX:50, blurY:0, quality:3 }); // write a customized blur filter to my_mc * @see #getFilterProp * @see #setFilterProps * @see #writeFilter * @see #removeFilter */ public static function setFilterProp($obj:Object,$propname:Object, $val:Object):Void\; \{\; //\; this\; code\; block\; avoids\; calling\; other\; methods\; for\; speed\; (it\; clocks\; 40\%\; of\; setFilterProps).\; if\; ($fclasses == undefined) { initialize(null); } var $splitname:Array\; =$propname.split("_"); var $fname:String\; =\; ($splitname[0]+"Filter"); if ($fclasses[$fname] == undefined) { return; } var $filter:BitmapFilter\; =\; (new\; ($fclasses[$fname])());\; var$prop:String = $splitname[1];\; var$index:Number = ($obj.filters.length\; ||\; 0);\; while\; (--$index>-1) { var $f:BitmapFilter\; =$obj.filters[$index];\; if\; ($f.__proto__ == $filter.\_\_proto\_\_)\; \{$filter = $f;\; //\; use\; existing\; break;\; \}\; \}\; if\; ($prop == 'blur') { $filter[\text{'}blurX\text{'}]\; =$val; $filter[\text{'}blurY\text{'}]\; =$val; } else { if ($prop.indexOf(\text{'}lor\text{'})>-1)\; \{\; if\; (typeof$val == 'string' && $prop.charAt(2)\; !=\; \text{'}l\text{'})\; \{\; if\; ($val.charAt(0) == '#') { $val\; =$val.slice(1); } $val\; =\; (($val.charAt(1)).toLowerCase() != 'x') ? Number('0x'+$val)\; :\; Number($val); } } $filter[$prop] = $val;\; \}\; if\; ($index == -1) { $obj.filters\; =\; [$filter]; } else { var $ftemp:Array\; =$obj.filters; $ftemp[$index] = $filter;$obj.filters = $ftemp;\; \}\; \}\; /**\; *\; Sets\; properties\; for\; one\; or\; more\; filters.\; *\; @param$obj target filter's parent * @param $propname\; BitmapFilter\; property\; *\; @param$val Properties and values * @description Support for multiple targets and multiple properties. There are two distinct syntaxes.
examples: @ax-actionscript-video-com-mosesSupposes-fuse-FuseFMP.setFilterProps([my_mc,my_txt], { Blur_blurX:50, Bevel_blurX:1 }); // multiple targs, multiple filters * @ax-actionscript-video-com-mosesSupposes-fuse-FuseFMP.setFilterProps(my_mc, 'Blur', { blurX:50, blurY:0, quality:3 }); // write a customized blur filter to my_mc * @see #getFilterProp * @see #setFilterProp * @see #writeFilter * @see #removeFilter */ public static function setFilterProps($obj:Object,$filterOrPropsObj:Object, $propsObj:Object):Void\; \{\; if\; ($fclasses == undefined) { initialize(null); } if (!($obj\; instanceof\; Array))\; \{$obj = [$obj];\; \}\; var$fo:Object = new Object(); var $prop:String,$val:Object; if (arguments.length == 3) { // 2nd param filter, 3rd param short names like blur for (var i:String in $obj)\; \{\; var$filter:BitmapFilter = getFilter($obj[i],$filterOrPropsObj, true); // param3:createNew if ($filter\; ==\; null)\; \{\; continue;\; \}\; var$prefix:String = getFilterName($filter).substr(0,\; -6)+\text{'}\_\text{'};\; for\; ($prop in $propsObj)\; \{$fo[$prop]\; =$propsObj[$prop];\; \}\; //\; bugfix:\; arrays\; like\; "alphas"\; wouldn\text{'}t\; transfer,\; don\text{'}t\; know\; why.\; for\; ($prop in $fo)\; \{$val = $fo[$prop]; if ($prop.indexOf($prefix) == 0) { $prop\; =$prop.slice($prefix.length);\; \}\; //\; in\; case\; of\; long\; name\; if\; ($prop == 'blur') { BlurFilter($filter).blurX\; =\; Number($val); BlurFilter($filter).blurY\; =\; Number($val); } else if (prop.charAt(2) != 'l' && typeof $val\; ==\; \text{'}string\text{'})\; \{\; if\; ($val.charAt(0) == '#') { $val\; =$val.slice(1); } $val\; =\; (($val.charAt(1)).toLowerCase() != 'x') ? Number('0x'+$val)\; :\; Number($val); } else { $filter[$prop] = $val;\; \}\; \}\; writeFilter($obj[i], $filter);\; \}\; \}\; else\; if\; (typeof$filterOrPropsObj == 'object') { // 2 params. obj contains long names like Blur_blur $propsObj\; =$filterOrPropsObj; for ($prop\; in$propsObj) { // organize all props passed by filter class names var $splitname:Array\; =$prop.split("_"); var $fname:String\; =$splitname[0]+"Filter"; if ($fclasses[$fname] == undefined) { continue; } if ($fo[$fname] == undefined) { $fo[$fname] = {}; } if ($splitname[1]\; ==\; \text{'}blur\text{'})\; \{\; BlurFilter($fo[$fname]).blurX\; =$propsObj[$prop];\; BlurFilter($fo[$fname]).blurY\; =$propsObj[$prop];\; \}\; else\; \{\; ($fo[$fname])[$splitname[1]] = $propsObj[$prop]; } } for (var i:String in $obj)\; \{\; for\; (var$fname:String in $fo)\; \{\; var$filter:BitmapFilter = getFilter($obj[i],$fname, true); // param3:createNew if ($filter\; ==\; null)\; \{\; continue;\; \}\; for\; ($prop in $fo[$fname]) { $val\; =\; ($fo[$fname])[$prop]; if (prop.charAt(2) != 'l' && typeof $val\; ==\; \text{'}string\text{'})\; \{\; if\; ($val.charAt(0) == '#') { $val\; =$val.slice(1); } $val\; =\; (($val.charAt(1)).toLowerCase() != 'x') ? Number('0x'+$val)\; :\; Number($val); } $filter[$prop] = $val;\; \}\; writeFilter($obj[i], $filter);\; \}\; \}\; \}\; \}\; /**\; *\; Retrieves\; an\; array\; of\; supported\; property\; shortcut\; strings.\; Similar\; to\; traceAllFilters.\; *\; @return\; array\; of\; supported\; property\; shortcuts\; *\; @see\; \#traceAllFilters\; *\; @see\; \#getFilterName\; */\; public\; static\; function\; getAllShortcuts():Array\; \{\; if\; ($fclasses == undefined) { initialize(null); } var fa:Array = []; for (var $filtername:String\; in$fclasses) { var $f:BitmapFilter\; =\; new\; ($fclasses[$filtername])();\; for\; (var\; b:String\; in$f) { if (typeof $f[b]\; ==\; \text{'}function\text{'})\; \{\; continue;\; \}\; fa.push($filtername.substr(0, -6)+'_'+b); if (b == 'blurX') { fa.push($filtername.substr(0,\; -6)+\text{'}\_blur\text{'});\; \}\; \}\; \}\; return\; fa;\; \}\; /**\; *\; Lists\; all\; filters\; and\; shortcut\; properties\; (Bevel\_blurX,\; etc.)\; to\; the\; Output\; panel\; for\; reference.\; *\; @see\; \#getAllShortcuts\; *\; @see\; \#getFilterName\; */\; public\; static\; function\; traceAllFilters():Void\; \{\; if\; ($fclasses == undefined) { initialize(null); } var s:String = "------ @ax-actionscript-video-com-mosesSupposes-fuse-FuseFMP filter properties ------\n"; for (var $filtername:String\; in$fclasses) { s += ($filtername);\; var$f:BitmapFilter = new ($fclasses[$filtername])(); for (var b:String in $f)\; \{\; if\; (typeof$f[b] == 'function') { continue; } // excluding .clone and any other method encountered s += (' - '+$filtername.substr(0,\; -6)+\text{'}\_\text{'}+b);\; if\; (b\; ==\; \text{'}blurX\text{'})\; \{\; s\; +=\; (\text{'}\; -\; \text{'}+$filtername.substr(0, -6)+'_blur'); } // show "_blur" props } s += '\n'; } FuseKitCommon.output(s); } /** * Internal - generates or returns existing BitmapFilter based on input type: constructor, instance, long/short-name string */ private static function $getInstance($myFilter:Object):BitmapFilter { if ($myFilter\; instanceof\; BitmapFilter)\; \{\; return\; BitmapFilter($myFilter); } if (typeof $myFilter\; ==\; "function")\; \{\; for\; (var\; j:String\; in$fclasses) { if ($myFilter\; ==$fclasses[j]) { return (new ($fclasses[j])());\; \}\; \}\; \}\; if\; (typeof$myFilter == "string") { var $filterStr:String\; =\; String($myFilter); if ($filterStr.substr(-6)\; !=\; \text{'}Filter\text{'})\; \{$filterStr += 'Filter'; } // allow string to omit 'Filter'. for (var j:String in $fclasses)\; \{\; if\; (j\; ==$filterStr) { return (new ($fclasses[j])());\; \}\; \}\; \}\; return\; null;\; \}\; \}$

---

[] readme course(s) preface I 1 2 II 3 4 III 5 6 7 IV 8 9 10 V 11 12 afterthought(s) appendix reference(s) example(s) resource(s) _

---

(C) Æliens 27/08/2009

You may not copy or print any of this material without explicit permission of the author or the publisher. In case of other copyright issues, contact the author.