Jsfl学习

　JSFL指Flash JavaScript，是JavaScript脚本文件，是用来扩展Flash IDE的重要工具。学会它、熟练使用它之后你会惊讶的发现，哇，原来可以这么高效率的做Flash啊！下面我们来看一看怎么使用JSFL：
  不知道各位朋友有没有使用过Flash IDE中的“历史记录面板”？如果没有用过的话，赶紧Ctrl+F10调出来看一看吧，因为本文的内容将从它身上开始。
  在Flash IDE中（本人使用Flash CS3 Professional）按下R键（矩形绘制工具的快捷键），在舞台上拖动鼠标绘制出一个矩形。观察“历史记录面板”，你会发现面板中添加了一个名为“矩形”的动作。选中“矩形”动作，“历史记录面板”右下角那个磁盘图标按钮将被激活，点击该按钮保存命令为“DrawRect”。 接下来，删除刚刚在舞台上绘制的那个矩形，然后选择Flash菜单栏的 “命令”菜单，你会发现弹出菜单中多了一个名为“DrawRect”的选项，点击“DrawRect”选项看看效果吧。
  如果你以前从来没接触过JSFL，你肯定会疑问：“DrawRect”选项是怎么跑到“命令”菜单中去的？点击它后舞台上立即绘制出了一个矩形，这是什么原理？下面我们就来探索一下其中的奥秘。
  打开C:\Documents and Settings\Brant\Local Settings\Application Data\Adobe\Flash CS3\zh_cn\Configuration\Commands （注意，Local Settings文件夹默认是隐藏的，你需要显示隐藏文件才可以看到）。在这个文件夹中你会发现一个名为“DrawRect.jsfl”的文件，用文本编辑工具打开它（本人使用FlashDevelop或UtrlEdit打开），看看里面的内容，看不懂没关系，先了解一下里面的代码可以在舞台上绘制一个矩形就OK，这个东西就是jsfl。接下来，你该在Flash IDE中按F1输入“jsfl”查看一下相关帮助文档了。首先看一下有关JSFL的作用说明，然后重点关注“扩展Flas -> 对象”里的内容，看得差不多了之后，在帮助里输入“library” （或Document、Item、outputPanel等等词汇），仔细认真的看一看“扩展Flas -> 对象”里的东西。不要惊讶“居然有如此多的内容！”。嗯，这部分知识点的内容的确挺多的，都是Flash IDE的JavaScript API，使用这些API可以实现Flash IDE环境中的所有动作。要完全研究透它，需要学习一下JavaScript，不过不用紧张，很简单，因为JS跟AS基本上一样，关键字、语法、结构都是统一遵循ECMA Script标准的，跟据AS习惯，你猜着写也能写出JS代码来，学习曲线会比较平滑。好了，那些内容你自己慢慢研究吧，这里我就不等你看完，下面我将写两个简单的例子来示范一下怎么使用JSFL：
【注】 下文中目录C:\Documents and Settings\Brant\Local Settings\Application Data\Adobe\Flash CS3\zh_cn\Configuration\Commands统一简称为Commands
　　示例一、BitmapBatRename(给库中的图片批量命名)：
第一步：新建一个文本文档，粘贴如下代码到文档中，保存到Commands目录下，保存名字为“BitmapBatRename.jsfl”。注意扩展名是jsfl而不是txt哦。
var doc = fl.getDocumentDOM();
var uxi = doc.xmlPanel(fl.configURI + "Commands/Rename.xml");
if(uxi.dismiss == "accept")
{
var items = doc.library.getSelectedItems();
for(var i = 0; i<items.length; i++)
{
items[i].name = uxi.prefixName + i;
}
}
第二步：新建一个文本文档，粘贴如下代码到文档中，保存到Commands目录下，保存名字为“Rename.xml”。注意扩展名是xml哦。
<?xml version="1.0" encoding="utf-8"?>
<dialog buttons="accept,cancel" title="Bat Rename Tool" >
<label value="请输入名称前缀"/>
<textbox id="prefixName"/>
</dialog>
第三步：新建一个Flash文档，导入一组图片到库里，选中库中的一张、几张或者全部图片，选择“命令-> BitmapBatRename”，在弹出的对话框里输入一个想要的名字，然后点击确　　　　　　　定，看一看库中的图片的名字有什么变化。OK，示例一结束。
　　示例二，GetLibraryItemProperty(将库中的元件的属性输出到输出面板，并允许保存为xml)：
第一步：新建一个文本文档，粘贴如下代码到文档中，保存到Commands目录下，保存名字为“GetLibraryItemProperty.jsfl”。
var doc = fl.getDocumentDOM();
var lib = doc.library;
var items = lib.items;
fl.outputPanel.clear();
fl.trace("<?xml version=\"1.0\" encoding=\"utf-8\"?>");
fl.trace("<list>");
for(var i = 0; i < items.length; i++)
{
var type = items[i].itemType;
var name = items[i].name;
var className = items[i].linkageClassName;
fl.trace("    <item type=" + "\"" + type + "\"" + " name=" + "\"" + name + "\""+ " className=" + "\"" + className + "\"" + "/>");
}
fl.trace("</list>");
var xui = doc.xmlPanel(fl.configURI + "Commands/saveOutputPanel.xml");
if(xui.dismiss == "accept")
{
fl.outputPanel.save(xui.url);
}
第二步：新建一个文本文档，粘贴如下代码到文档中，保存到Commands目录下，保存名字为“saveOutputPanel.xml”。
<dialog buttons="accept, cancel"  title="保存输出面板信息" >
<hbox>
<label value="URL:" />
<textbox id = "url" size="30" multiline="false"/>
<buttons="accept, cancel"/>
<hbox>
</dialog>
第三步：新建一个Flash文档，导入一组图片到库里，先给它们都取上名字，添加好导出Action类，然后选择“命令-> GetLibraryItemProperty”。 在保存文件的对话框中填入文件　　　　　　路径，点击保存之后在指定的路径下就可以看到一个xml了， 它记录了库中所有元件的“元件类型”、“元件名称”和“链接类名”。【注意】保存文件的时候填入的文件路径的写法哦：例　　如，你想将生成的xml保存到F盘下的myxml文件夹中，保存的文件名为“list.xml”，则路径如下填写：file:///F|/myxml/list.xml。OK，示例二结束。
         JSFL功能很强大，更多功能请各位自己去慢慢探索，本文仅仅作为不懂的朋友入门之用。在学习JSFL的过程中有一个窍门——在IDE中随意操作，保存历史记录，然后观察生成的JSFL代码来学习。