动画教程之ActionScript的API文档天生工具ASDoc-Flash actionscript
借助令人兴奋的全新3D平移和旋转工具,通过3D空间为2D对象创作动画,您可以沿x、y、z轴创作动画。使用ASDoc工具
原文地点:http://livedocs.adobe.com/flex/3/html/asdoc_9.html
译者注：
ASDoc是adobe官方供应的ActionScript的API文档天生工具，如今已集成在FlexBuilder3中
翻开ASDoc工具的办法：
1.安装FlexBuilder3后，
翻开入手下手—>程序—>Adobe—>AdobeFlex3SDKCommandPrompt
2.此时会进进cmd命令行界面，用cd命令进进你的工程目次下
比方我的工程目次是E:flexwork
以后是cmd指向在C:ProgramFilesAdobeFLexBuilder3
3.起首输出E:进进E:
然后输出cdflexwork
屏幕显现E:flexwork>后便可利用asdoc命令编译API文档了
编译后的asdoc文档会在E:flexwork路径下输入一个asdoc-output文件夹，运转内里的index.html就是API文档主页
你可使用以下的ASDoc命令参数来制订类文件列表
doc-classesdoc-sourcessdoc-namespaces
doc-classes和doc-namespaces请求用source-path指定类文件文件地点的根目次
以下是一个最基础的列子，用doc-classes参数指定类文件列表：
asdoc–source-path.–doc-classescomps.CraphingWidgetcomps.GraphingWidgetTwo
这个例子中，类文件必需是compsGraphingWidget.as和compsGraphingWidgetTwo.as,而且comps必需是位于运转asdoc命令地点地位下的一个子文件夹。doc-classes的参数顶用‘.’对应类地点的包(package)名
译者注：假如类文件就在以后目次下，source-pathh参数前面的内容必要填写’.’
假如类文件没有在以后目次下，能够用source-path参数指定该目次。
上面的例子，假如两个类文件在C:flexclass_dircomps下，能够像如许利用asdoc命令：
asdoc–source-pathC:flexclass_dircomps–doc-classescomps.CraphingWidgetcomps.GraphingWidgetTwo
假如你的程序里援用了包括有swc文件的库。
鄙人例中，可使用–library-path参数指定要包括的swc文件：
asdoc–source-path.–doc-classesmyComponents.BlueButton–library-pathC:myLibs
用doc-sources参数能够指定源文件夹。经由过程该参数，asdoc会递回征采目次。
上面的命令会天生以后目次及其子目次下一切的类：
asdoc–source-path.–doc-sources
用doc-namespaces参数能够指定要输入的定名空间。
上面的命令会把coreframework下的一切类文件输入成文档：
asdoc-source-pathframeworks-namespacehttp://frameworkframeworks/core-framework-manifest.xml-doc-namespaceshttp://framework
扫除类文件
用doc-classes,doc-sources和doc-namespaces命令输入一切的类文件时，
会有以下三点破例：
[*]用exclude-classes参数指定的类不会输入
[*]类中包括了@private标签的不会被输入
[*]SWC中的类，不会被输入
以下的例子中，会输入以后目次及其子目次下一切类文件，除compsPageWidget和compsScreenWidget.as：
asdoc-source-path.-doc-sources.-exclude-classescomps.PageWidgetcomps.ScreenWidget
注重：
这些被扫除的类，仍旧会同其他类一样被编译，只是内容不会被输入
假如将exclude-dependecies参数设为true，当编译类时所依附的相干类不会被输入。
该参数默许值是false，意味着一切与指定类相干联的类城市被一般输入成文档。
比方：你用doc-classes指定了类A,假如类A中import了类B，那末类A和类B城市被输入。
asdoc命令参数列表：
asdoc命令参数利用办法同等于mxmlc和compc
更多的mxmlc和comp信息，拜见UsingtheflexCompilers
参数功效列表以下：
OptionDescription-doc-classespath-element[...]指定必要被输入成文档的类文件，这些类文件必需放在资本路径下[默许参数]
该参数利用办法同等于compc组件编译器的-include-classes参数，更多信息拜见Usingcompc,thecomponentcompiler-doc-namespacesurimanifest请求被输入成文档的类文件URIs列表，这些类文件必需放在资本路径下。
必需包括最少一个URI并指出定名空间内容的明白地位
该参数利用办法同等于compc组件编译器的-include-namespaces参数，更多信息拜见Usingcompc,thecomponentcompiler-doc-sourcespath-element[...]必要被输入成文档的文件目次，而且其子目次也会被递回输入
该参数利用办法同等于compc组件编译器的-include-sources参数，更多信息拜见Usingcompc,thecomponentcompilerexclude-classesstring不必要被输入的类文件列表，必需指定类名
大概，该类中的ASDoc命令里包括了@private标签，一样也不会被输入
-exclude-dependenciestrue|false决意是不是一切的相干类城市输入，假如设true，与输入类相干的类不回被输入。默许值为false-footerstring文档中HTML页面底部的显现信息-left-frameset-widthint把持文档右边目次宽度的整数值。你能够依据你的包名来改动这个值
默许值是210px-main-title"string"文档中HTML页面头部显现信息
默许值是"APIDocumentation".-outputstring输入文档的目次名.默许值"asdoc-output".-packagename"description"输入文档中对应的包名。你能够指定一个以上的包
下例中，输入了两个包：
asdoc-doc-sourcesmy_dir-outputmyDoc-packagecom.my.business"Containsbusinessclassesandinterfaces"-packagecom.my.commands"Containscommandbaseclassesandinterfaces"-templates-pathstringASDoc模板目次的路径.默许值是ASDoc安装目次下的asdoc/templates。该目次包括了用于输入成文档的一切的HTML,CSS,XSL文件image-window-title"string"文档中扫瞄器顶部显现信息
默许值是"APIDocumentation".
以下asdoc命令合用于compc组件编译器:
[*]-source-path
[*]-library-path
[*]-namespace
[*]-load-config
[*]-actionscript-file-encoding
[*]-help
[*]-advanced
[*]-benchmark
[*]-strict
[*]-warnings
更多信息，拜见Usingmxmlc,theapplicationcompiler另有良多其他程序编译参数可使用，这里不再详加论述，在ASDoctool中你能够像利用mxmlcandcompc一样利用一样的命令机关文件。
要在Flash中构建应用程序，可以使用Flash绘图工具创建图形，并将其它媒体元素导入Flash文档。接下来，定义如何以及何时使用各个元素来创建设想中的应用程序。 富媒体可应用于各种网络服务中，如网站设计、电子邮件、BANNER、BUTTON、弹出式广告、插播式广告等。 Rich Media并不是一种具体的互联网媒体形式，而是指具有动画、声音、视频和/或交互性的信息传播方法。 用户在观看广告的时候，无法通过正常点击鼠标来查看广告的尺寸、字节数、所链接的URL广告本身信息。 中坚的程序员趋向于嘲笑脚本语言，但是对于那些没有计算机科学学位的人来说，脚本语言可能使他们头疼。 缺点方面~有些技术不能实现，不过FLASH技术在发展在进步，相信在以后FLASH可以取代，大部分的视频编辑软件，视频制作软件。 随着动漫发展趋势，我国也越来越重视动漫产业的发展，各种制作动画软件应运而生，其中flash比较突出。 传播上的优势——无国界跨媒体；创作群体的形成；媒体及比赛的推进 富媒体广告的概念：富媒体 Rich Media，是由英文翻译而来,从字面上很难理解Rich Media到底是什么。
页:
[1]