FileIO Xtra for Macromedia Authorware 7.0
Copyright 2003 Macromedia, Inc.
FileIO provides a set of functions allowing users of Macromedia Authorware to programmatically access files using scripting.
Using FileIO
============
As an Xtra the FileIO Xtra must be in your application's Xtras folder.
Each instance of FileIO can reference a single open file. If multiple files are to be opened simultaneously, a new instance of FileIO is required for each opened file. A single instance can be used to open multiple files, as long as the file is closed before a new file is opened. To create a new instance use NewObject, defined below. To dispose of an instance, set the instance variable to 0. All functions that read from or write to the file must be called after the file has been opened using openFile. If a new file is to be opened using the same instance, the old file must first be closed using closeFile. Files can be opened in three different modes: Read, Write and Read/Write. When writing to a file, the contents of the file after the current position are overwritten.
Example Script:
-- Create an instance of FileIO
myFile := NewObject("fileio")
-- Display an "open" dialog and return the file name to Authorware
myFileName := CallObject(myFile, "displayOpen")
-- Open the file
CallObject(myFile, "openFile", myFileName, 1)
-- Read the file and return a string to Authorware
theFile := CallObject(myFile, "readFile")
-- Close the file
CallObject(myFile, "closeFile")
-- Dispose of the instance
myFile := 0
In this example, a new instance was created and stored in the variable myFile. Next, a call to displayOpen is used to display an open dialog to allow a file to be selected. The file name is returned as a fully qualified path string to Authorware. The file is then opened in read-only mode, the contents of the file are read, and the file is closed. Lastly, the instance is disposed.
There is also an Authorware Show Me (xtraio.a7p) which demonstrates how to use the Xtra. It can be found in the Show Mes installed with Authorware.
Known Problems
==============
The FileIO Xtra cannot use a net-based file when supplied with a URL for the file name. It is limited to accessing files available via file systems mounted on the local system.
Function Reference
==================
closeFile
CallObject(object, "closeFile")
Closes a file that has been previously opened using openFile.
createFile
CallObject(object, "createFile", "fileName")
Creates a file. The fileName must be either a fileName to be created in the current directory, or a fully qualified path and fileName. Relative paths are not supported. After creating the new file, the file must be opened before it can be written to.
delete
CallObject(object, "delete")
Deletes the currently opened file. The file must be open to use this function.
displayOpen
CallObject(object, "displayOpen")
Displays a platform specific "open" dialog allowing a user to select a file. Returns a fully qualified path and fileName to Authorware. The setFilterMask function can be used to control what file types are displayed in the dialog.
displaySave
CallObject(object, "displaySave", "title", "defaultFileName")
Displays a platform specific "save" dialog allowing a user to specify a file. Returns a fully qualified path and fileName to Authorware. The setFilterMask function can be used to control what file types are displayed in the dialog. The title and defaultFileName parameters allow you to specify a default filename to be displayed, as well as title text for the save dialog.
error
CallObject(object, "error", status)
Returns a readable error string. A numeric error code is passed in as the third argument. (Also refer to the 'status' function.) The errors returned can be any of the following:
"OK"
"Memory allocation failure"
"File directory full"
"Volume full"
"Volume not found"
"I/O Error"
"Bad file name"
"File not open"
"Too many files open"
"File not found"
"No such drive"
"No disk in drive"
"Directory not found"
"Instance has an open file"
"File already exists"
"File is opened read-only"
"File is opened write-only"
"Unknown error"
fileName
CallObject(object, "fileName")
Returns the file name string of the current open file. The file must be open use this function.
getFinderInfo
CallObject(object, "getFinderInfo")
Returns the Type and Creator of the current file as a string. This function does nothing when used under Windows. The file must be open to use this function.
getLength
CallObject(object, "getLength")
Gets the length of the currently opened file. Returned as an integer. The file must be open to use this function. The value returned is the length of the file in bytes.
getOSDirectory
getOSDirectory()
A function that returns the full path to either the Windows directory, or the System Folder depending on which OS is currently being used. Does not require a child instance to call.
getPosition
CallObject(object, "getPosition")
Gets the file position of the current open file. Returned as an integer. The file must be open to use this function.
NewObject
NewObject("fileio")
This is called to create a new instance of FileIO. It returns an instance variable used to reference the instance.
openFile
CallObject(object, "openFile", "fileName", mode)
Opens the named file. This call must be used before any read/write operations can take place. The filename can be either a fully qualified path and filename, or a relative filename. The openMode parameter specifies whether to open the file in Read, Write or Read Write mode. Valid Flags are: 0 Read/Write, 1 Read, 2 Write.
readChar
CallObject(object, "readChar")
Reads the character (either single or double-byte) at the current position and then increments the position. The character is returned to Authorware as a string. The file must be open in read or read/write mode to use this function.
readFile
CallObject(object, "readFile")
Reads from the current position to the end of the file and returns the file to Authorware as a string. The file must be open in read or read/write mode to use this function.
readLine
CallObject(object, "readLine")
Reads from the current position up to and including the next Return, increments the position, and returns the string to Authorware. The file must be open in read or read/write mode to use this function.
readToken
CallObject(object, "readToken", "skip", "break")
Reads the next 'token' starting at the current position. Characters matching the 'skip' parameter are "skipped" and the file is read until 'break' is encountered. The file must be open in read or read/write mode to use this function. This function will read double-byte tokens as long as the skip and break are single-byte characters. It will not detect double-byte skip or break characters.
readWord
CallObject(object, "readWord")
Reads the next word starting at the current position. The file must be open in read or read/write mode to use this function.
setFilterMask
Sets the filter mask used by calls to displayOpen and displaySave. The filter mask determines what files to show when displaying an "open" or "save" dialog. The third parameter is a string representing the filter mask to set.
On Windows, this is a comma-separated string of file types and associated extensions (e.g. "All Files,*.*,Text Files,*.TXT"), and a string of types on the Macintosh (e.g. "TEXTPICT"). On Windows, the filter mask string is limited to 256 characters.
If a file type has more than one associated extension, separate the extensions with a semi-colon, rather than a comma (e.g. "All Available Sound,*.WAV;*.MP3;*.SWA;*.VOX").
On the Macintosh, you are limited to four four-character types.
When a new instance of FileIO is created, the filter masks defaults to all files. To reset the filter mask to display all files after it has been set, just pass in an empty string, e.g. CallObject(object, "setFilterMask", "").
setFinderInfo
CallObject(object, "setFinderInfo", "attributes")
Sets the Type and Creator of the current file. The string takes the form of a space-separated set of TYPE and CREATOR codes (e.g. "TEXT TTXT"). This function does nothing when used under Windows. The file must be open to use this function.
setPosition
CallObject(object, "setPosition", position)
Sets the file position of the current open file. The file must be open to use this function.
status
CallObject(object, "status")
Returns the error code returned by the last function called. The value is returned as an integer. (Also refer to the 'error' function.)
version
CallParentObject("fileio", "version")
Returns FileIO version and build information. Useful when filing bug reports, or determining installed version while authoring. No practical use beyond this.
writeChar
CallObject(object, "writeChar", "theChar")
Writes a single character to the file at the current position. The file must be open in write or read/write mode to use this function.
writeString
CallObject(object, "writeString", "theString")
Writes a string to the file at the current position. The file must be open in write or read/write mode to use this function.
===第一节 大洲和大洋
出示宇航员照片：
师：你知道宇航员在宇宙中看到的地球是什么样子的吗？（什么颜色的？）（出示图）
生：蔚蓝色的美丽星球。（）
师：为什么是蔚蓝色的呢？
生：因为海洋面积大于陆地面积。
师：因此，有人说地球应该叫水球，到底是地球还是水球，咱回头再说，请同学们打开课本，自学课本P27、27，圈画出你认为应该掌握的知识，2分钟后向大家展示自学的结果。
生：自学课本。
师：完成的同学小组内先交流一下。
师：请各小组派代表展示。
生：展示。
师：请填写学案第一题。齐读。
探究（一）： 按以下步骤操作，小组合作完成：
用彩绳沿赤道绕一圈，观察分成的北半球和南半球分别是陆地面积大还是海洋面积大？
用彩绳将地球仪任意分成两个相等的半球，观察每一个半球分别是陆地面积大还是海洋面积大？
尽可能多地将陆地分到一个半球，观察这个半球是陆地面积大还是海洋面积大？
师：你能将以上观察的结果概括成一句话吗？
生：……….
出示：地球的任何两个大小相等的半球都是海洋面积大于陆地面积。
活动（一）： 出示图2.3：谈谈你的看法 （小组讨论）。
过渡：从地球仪上看，地球上陆地的大小、形状一样吗？（不一样）它们有不同的名称。
出示图2.5： ①学生自学讨论 ②同桌互查（利用学案） ③指名讲图 ④生指图齐答
过渡：大陆和它周围的岛屿合起来叫大洲，全球陆地共分为七大洲，地球上的海洋被陆地分成四大洋。（板：七大洲 四大洋）
出示图2.6：
师：第一章我们学过西经20度和东经160组成的经线圈把地球划分为东半球和西半球，…
请用3分钟时间把七大洲、四大洋的名称、位置、轮廓记住。
自查（看学案上的图）
小组内互查（看学案上的图）
指名上台讲（出示空白图）
一生指图，其余回答
在这幅图上你还认识吗？（出示世界地图）
把各大洲单摘出来你还认识吗？你是怎样记住它们的？（出示各大洲图）
师：你知道吗？各大洲的名称都是有来历的，请阅读P29阅读材料。
活动（二）： 读图2.6，完成以下内容：
主要分布在东半球的大洲主要有（ ）
主要分布在西半球的大洲主要有（ ）
2、被赤道穿过的大洲有（ ）
3、全部在北半球的大洲有（ ）
4、南极洲周围被哪几个大洋包围？（ ）
5、亚洲周围有哪几个大洋？（ ）
①各组做题 ②各组展示（指图讲） ③
探究（四）： 读图2.6、2.7和教材后面的世界地形图，看看那些大洲是相连的，找出它们之间的分界线。（发挥集体的力量，小组合作探究）
①小组合作探究 ②各小组汇报展示 ③小结
探究（五）：考考你的眼力：观察图2.6，给七大洲和四大洋面积排序。
①小组观察、讨论 ②指名展示（多媒体操作） ③出示正确结果 ④编顺口溜记忆 ⑤四大洋排序
你发现了吗？出示图2.8 ：图中有两大发现？
小结：针对板书小结
练习：1、出示两半球图，齐读。
竞选国际高级导游：看牛识大洲大洋、追寻郑和的足迹、与哥伦布一起发现
拖拽大洲
课堂总结：这节课你学到了那些知识？
课外作业：
板书： 第一节 大洲和大洋
陆29% 七大洲
海71% 四大洋
各小组重点完成小组对应的题目，1组
2组
3组
4组
5组
6组
7组
8组
9组
10组
11组
12组
13组
14组
15组
16组directtransition3d破解版
毛毛的自由乐园
http://ntmaoyf.
2002.6第一节 《大洲和大洋》学案
一、填空：
1、地球表面，海洋占（ ）%，陆地占（ ）%。概括地说，地球上（ ）分是海洋，（ ）分是陆地。
2、世界海陆分布很不均匀，陆地主要集中在（ ）半球，海洋大多分布在（ ）半球。
3、北极地区是一片（ ），南极地区是一块（ ）。
二、指出下图中哪些是大陆、岛屿、半岛、洋、海、海峡。
三、看下图指出七大洲、四大洋的名称：
四、读图2.6填空：
1、主要分布在西半球的大洲有（ ）洲、（ ）洲。
2、被赤道穿过的大洲有（ ）洲、（ ）洲、（ ）洲、（ ）洲。
3、全部在北半球的大洲有（ ）洲、（ ）洲。
4、与亚洲相邻的大洋有（ ）洋、（ ）洋、（ ）洋。
五、寻找大洲分界线：
1、亚洲与欧洲的分界线是： 。
2、亚洲与非洲的分界线是 运河。
3、北美洲与南美洲的分界线是 运河。
4、亚洲与北美洲隔 海峡相望。
2
⑨
海
洋Disclaimer
----------
WHEREAS, DirectXtras Inc. has designed and developed proprietary software
included in this folder and known henceforth as the Program;
DirectXtras Inc. owns all right, title and interest in and to the Program.
By installing the Program, you agree that;
THE PROGRAM AND DOCUMENTATION IS PROVIDED
TO USER IN AN "AS IS" CONDITION. IT IS UNDERSTOOD BY YOU THAT
THE PROGRAM HAS NOT BEEN TESTED OR DEBUGGED AND THAT
DIRECTXTRAS INC. MAKES NO REPRESENTATIONS OR WARRANTIES REGARDING ITS
USE. YOU ACKNOWLEDGE THAT THE INSTALLATION OF THE
PROGRAM'S SOFTWARE INTO YOUR COMPUTER OR DISK MAY CAUSE VARIOUS
MALFUNCTIONS IN ITS SYSTEM. YOU HEREBY RELEASE DIRECTXTRAS INC. FROM ALL
RESPONSIBILITY FOR ANY DAMAGE CAUSED, DIRECTLY OR INDIRECTLY, BY
THE INSTALLATION OF SAID PROGRAM INTO YOUR, OR ANY OTHER COMPUTER.
DIRECTXTRAS INC. MAKES NO WARRANTIES, EXPRESS OR IMPLIED,
INCLUDING, BUT NOT LIMITED TO, THE IMPLIED WARRANTY OF
MERCHANTABILITY OR FITNESS FOR A PARTICULAR PURPOSE OR THAT THE
USE OF THE PROGRAM OR ANY INFORMATION RELATING THERE TO
OR CONTAINED THERE IN WILL NOT INFRINGE ANY INTELLECTUAL PROPERTY
RIGHT OF ANY THIRD PERSON.
IN NO EVENT SHALL DIRECTXTRAS INC. BE LIABLE FOR SPECIAL OR
CONSEQUENTIAL DAMAGES ARISING FROM USE OF THIS PROGRAM.
YOU SHALL HAVE THE SOLE RESPONSIBILITY FOR ADEQUATE
PROTECTION AND BACK-UP OF YOUR DATA USED IN CONNECTION WITH THE
PROGRAM AND YOU SHALL NOT HAVE ANY CLAIM AGAINST
DIRECTXTRAS INC. FOR LOST DATA, RE-RUN TIME, INACCURATE INPUT, WORK
DELAYS OR LOST PROFITS RESULTING FROM THE USE OF THE
PROGRAM.
(C) DirectXtras Inc. 1999
www.XtrAgent Trial Version 2.0
--------------------------
Developed by Tomer Berda, DirectXtras Inc.
Copyright 1998-99.
Last updated: 10 May 1999.
This is a trial version of XtrAgent. You can use it to see if it
provides you with the features you are looking for.
The trial version does not operate under projectors, packages
and Shockwave. In addition, the 'File' member/icon property
and the ability to create new XtrAgent members/icons on the fly
are not available in this trial version.
You have to license the Xtra to obtain the disabled features,
run-time capability, and the license to use and freely distribute
XtrAgent along with your applications.
Product Information
-------------------
XtrAgent is an Asset Xtra which enables the use of Microsoft's revolutionary
"Agent" technology in Director, Authorware and Shockwave applications, that
provides a foundation for more natural ways for people to communicate with
their computers.
XtrAgent adds a new type of member to your cast - Agent.
Agent is an interactive animated character that can be drawn on top
of all other sprites and windows and even outside of the stage area.
It can speak, via a text-to-speech engine or recorded audio, and accept
spoken voice commands.
Agents can be used as guides, coaches, entertainers, or other types of
assistants or specialists.
Using XtrAgent, developers can utilize Text-To-Speech & Speech Recognition
engines and freely distribute them with their applications!
In addition, XtrAgent provides powerful animation capability and interactivity,
with support for high-quality lip-synching at an incredible ease of development.
It comes with ready-to-use characters and also support custom characters that
developers can create using the Microsoft Agent character editor.
XtrAgent is available for Windows 9X & NT. It is possible to use it along with
the MacOS version of Xpress Xtra to have a cross-platform Text-To-Speech solution.
System requirements
-------------------
- Microsoft Windows 95, Windows 98, Windows NT 4.0 (x86) or later
- Internet Explorer version 3.02 or later
- Personal computer with a Pentium 100 MHz or higher processor
- At least 16 MB of memory
- Microsoft Agent core components 2.0 or later
- Hard-disk space for core components: 1 MB
- Text-To-Speech and Speech recognition engines (recommended)
- Windows compatible sound card (recommended)
- Compatible speakers and microphone (recommended)
- Microsoft Mouse or compatible pointing device (recommended)
- Hard-disk space for optional components:
Lernout & Hauspie TruVoice Text-to-Speech engine for speech output: 1.6 MB
Microsoft Speech Recognition Engine for speech input: 22 MB
Characters installed locally: 2-4 MB per character
Explanation of licensing-availability:
--------------------------------------
XtrAgent is a commercial product.
You can license it from http://www. for
$399 per developer, one-time licensing fee.
Along with the Xtra, you will receive full documentation, sample
codes and direct support by e-mail.
The licensed product includes a runtime version of the Xtra
that can be freely distributed along with your applications.
Auto-downloadable Shockwave safe version can be licensed seperately.
History
-------
May 10, 1999;
Version 2.0 released.
- The Xtra is now compatible with Authorware and Shockwave.
- Auto-downloadable Director Shockwave safe version is available.
- New Sprite functions: Think, Listen, Activate, ShowPopupMenu, GestureAt, Interrupt
- New Member/Icon properties: PopupMenu, TTSModeID, SRModeID, SRStatus
- New Member/Icon functions: ShowDefaultCharacterProperties
- New Events: VisibleState, ActivateInputState, Move, ActiveClientChange,
DefaultCharacterChange, ListeningState
- The new version requires Microsoft Agent core components 2.0 or later.
- Creating a new Member/Icon without specifying a filename loads the default
character (if available). If XtrAgent cannot find a linked character file using
Director/Authorware standard filename resolution algorithm, it searches the
Agent's characters directory for it.
See the File Member/Icon property for more info and changes.
- StopAll() can now stop only Show requests.
- SREngine Member/Icon property was removed. Use SRModeID instead.
- 'Suspended' Member/Icon property was removed. Microsoft Agent 2.0 or later
cannot be in a suspended mode anymore.
- Restart and ShutDown events were removed, Microsoft Agent 2.0 or later
cannot be shutdown or restarted anymore.
- Multiple cast Members/Icons for the same character are supported for Authoring
convenience purposes, though you still can't display the same character more
than once on the screen.
April 18, 1999;
Version 1.0.1 released.
- VisibleState event was added.
- Fixed crash that sometimes occured with Microsoft Agent 2.0 under Director 7,
when you quit the application with visible Agent character(s) that has some
uncompleted requests.
- Fixed some other minor issues related to Microsoft Agent 2.0 and Director 7.
June 1, 1998;
Version 1.0 released.
- XtrAgent built-in error messages replaced with error codes that can be handled
from lingo. See the sample movie for code that checks whether the character files
were loaded properly, if there is a compatible speech recognition engine
installed, and whether Microsoft Agent is installed and working properly.
- Speech output tags and animations for Genie, Robby and Merlin are now documented.
- New XtrAgent Member/Icon Properties: SREngine, SRHotKey
- New XtrAgent Sprite Event: Bookmark
- New XtrAgent Sprite Function : Stop
Bugs found & fixed:
- ExtraData property returned the Description property and was corrected.
May 18, 1998;
- Version 1.0 beta/preview released.
DirectXtras Inc.
P.O Box 423417 San Francisco, CA 94142-3417
Voice: +1-415-505-8249, Fax: +1-650-9384633
E-mail General information: info@
E-mail Technical Support: supp@
-----------------------------------------------------------------------------
Please send comments, suggestions and bug reports to :
supp@
Further information on Microsoft Agent technology can be found at
http://msdn./workshop/imedia/agent/default.asp and in
the XtrAgent HomePage located at http://www./
Xtra is a trademark of Macromedia, Inc.大洲和大洋
临沂市沂州实验学校 黄旭东
教学目标：
知识与技能：使学生理解地球表面海陆面积比、海陆分布特征；能正确分辨大陆、岛屿、半岛、海、洋、海峡等地理事物；熟记七大洲、四大洋的名称、位置、轮廓及分布特征；了解大洲分界线。培养学生的读图能力、综合分析问题的能力；培养学生的自学能力、合作探究能力。
过程与方法：本节课采用分组教学，让学生通过读图、观察、合作探究、比赛等手段掌握知识、提高能力。
情感、态度、价值观：通过事例、教学活动，培养学生的集体意识，努力拼搏、不怕困苦、百折不绕的科学探究精神，爱护我们居住的美丽星球的意识。
教学重点：地理表面的海陆分布特征和七大洲四大洋的名称、分布特征。
教具学具准备：学生每个小组准备一个地球仪和一根彩绳。教师准备多媒体课件。
教学过程：
导入
引导学生观察地球仪，地球表面分为陆地和海洋两部分，导入课题。
地球？水球？
多媒体出示发射“神七”的视频和宇航员照片，问学生宇航员在太空中看到的地球是什么样的。引出地球表面海洋面积大于陆地面积，记住海陆面积比；观察地球仪，得出海陆分布特征。
阅读“阅读材料”，引导学生体会探险家、航海家表现出的不怕困难、勇往直前的拼博精神。
引导学生观察探究“把地球任意分成两个相等的半球，分别是陆地面积大还是海洋面积大。”
学生讨论：地球？水球？
七大洲、四大洋
创设情景，引出图2.5。①自学大陆、岛屿、半岛、海、洋、海峡。②学生展示自学成果。
创设情境：引出图2.6。①自学七大洲、四大洋的名称、分布、轮廓、面积大小。②学生展示自学成果。
引导学生探究相邻大洲间的分界线。①学生合作探究；②汇报展示。
巩固提高
创设情境，学生完成一系列练习。
1、看图指出七大洲四大洋的名称。
2、说出图中大洲间的分界线。
3、判断对错。
4、一架航天飞机从非洲出发，沿赤道向东飞行，经过的大洲大洋。
5、在牛身上找出七大洲、四大洋。
6、追寻郑和的足迹。
7、与哥伦布“一起”探险。
8、大洲与轮廓匹配。
五、课堂总结
六、板书设计：
第一节 大洲和大洋
陆地29% 七大洲
海洋71% 四大洋
