a5wmme中的函数说明

下载　

　

此U32中包括了对各种媒体播放的控制函数，这些媒体包括Wave、CD、MIDI、Vdieo等，还提供了一些MCI控制函数，详细如下。

AnimAudio
语法：number:=AnimAudio(state)
说明：指定是否播放当前动画的声音。若参数state为on，表示可以播放。若为off，则表示不播放当前声音。
若该函数调用成功，则返回值为0。若调用失败，则返回错误代码。

AnimClose
语法：number:= AnimClose()
说明：该函数关闭当前的动画文件。若该函数调用成功，则返回值为0。若调用失败，则返回错误代码。

AnimCurrentFrame
语法：number:= AnimCurrentFrame()
说明：该函数返回动画文件的当前播放帧数。若该函数调用失败，则返回值为0。

AnimFrame
语法：number:= AnimFrame()
说明：该函数返回动画文件的总帧数。若该函数调用失败，则返回值为0。

AnimGetDestination
语法：string:= AnimGetDestination()
说明：该函数返回当前动画文件在演示窗口中的位置。
该函数的返回值是一个字符串，格式为“距演示窗口上边界的像素数、距演示窗口左边界的像素数、宽度、高度”。

若该函数调用失败，则返回值为0。

AnimOpen

语法：number:= AnimOpen(filename,windowstyle)

说明：该打开由“filename”指定的动画文件，而参数windowstyle则是以字符串的方式表现动画所播放的窗口属性，主要设定的是这个播放窗口的层次，参照下表：

overlapped——表示播放窗口是重叠模式。

Popup——表示播放窗口是浮在所有窗口之上的模式。

caption——表示播放窗口留有空间给字幕。

nocaption——表示播放窗口不留空间给字幕。

noframe——表示播放窗口没有边框。

thinframe——表示播放窗口的边框是细线。

thickframe——表示播放窗口的边框是粗线。

maxbox——表示播放窗口可以最大化显示。

nomaxbox——表示播放窗口不能最大化显示。

sysmenu——表示播放窗口有系统菜单。

nosysmenu——表示播放窗口没有系统菜单。

At <top><left>——表示播放窗口相对于演示窗口的位置（距离演示窗口上边界和左边界的像素数）。

Size <width><height>——表示播放窗口的大小（宽度和高度）。

zoomed——表示播放窗口一出现就是最大化显示。

usefullcolor——表示播放窗口能够使用更多的色彩。

若该函数调用成功，则返回值为0。若该函数调用失败，则返回错误代码。

AnimPaletteHandle

语法：string:= AnimPaletteHandle()

说明：该动画返回动画所使用调色板的句柄。若该函数调用失败，则返回句柄为0。

AnimPause

语法：number:= AnimPause()

说明：该函数暂停动画的播映。

若该函数调用成功，则返回值为0。若该函数调用失败，则返回错误代码。

AnimPlay

语法：number:=AnimPlay(speed,wait)

说明：该函数设置动画的播放速度。

若speed参数为100，则表示正常播映，若speed参数为负数，则表示倒放该动画文件；若wait参数为true，表示等动画播映结束后，authorware应用程序才继续执行。

若该函数调用成功，则返回值为0。若该函数调用失败，则返回错误代码。

AnimPlaying

语法：condition:=AnimPlaying

说明：该函数查询目前是否有动画在播映。

AnimPlaySegment

语法：number:= AnimPlaySegment(fromframe,forframe,speed,wait)

说明：该函数指定播放动画的长度，参数fromframe表示开始播映的帧数，从头播映时，可以设此参数值为0；参数forframes表示播放的长度（总帧数）；若speed参数为100，则表示正常播映，若speed参数为负数，则表示倒放该动画文件；若wait参数为true，表示等动画播映结束后，authorware应用程序才继续执行。

若该函数调用成功，则返回值为0。若该函数调用失败，则返回错误代码。

AnimResume

语法：number:= AnimResume()

说明：该函数将已暂停的动画继续播放。

若该函数调用成功，则返回值为0。若该函数调用失败，则返回错误代码。

AnimSetCaption

语法：number:= AnimSetCaption(captionstring)

说明：该函数为动画打字幕，将参数captionstring指定的字符串作为字幕显示在动画窗口中。

若该函数调用成功，则返回值为0。若该函数调用失败，则返回错误代码。

AnimSetDestination

语法：number:= AnimSetDestination(top,left,width,height)

说明：该函数设置动画窗口的大小。参数格式为“距演示窗口上边界的像素数、距演示窗口左边界的像素数、宽度、高度”。

AnimShowWindow

语法：number:= AnimShowWindow(state)

说明：该函数显示或者隐藏动画窗口。

若参数state为True，则表示窗口不隐藏。若参数为False，则表示隐藏窗口。

若该函数调用成功，则返回值为0。若调用失败，则返回错误代误。

AnimStop

语法：number:=AnimStop()

说明：该函数停止当前动画的播放。

若该函数调用成功，则返回值为0。若调用失败，则返回错误代误。

AnimWindowHandle

语法：number:= AnimWindowHandle()

说明：该函数当前动画窗口的句柄。

若该函数调用失败，则返回一个空的句柄。

CDPlay

语法：number:=CDPlay(track,wait)

说明：该函数用来播放CD唱片，可以指定播放参数track指定的CD音轨。若参数wait为True，则表示等到动画播映结束后Authorware应用程序才继续执行，否则一开始播放CD音轨Authorware就继续往下执行。

若该函数调用成功，则返回值为0。若调用失败，则返回错误代码。

CDPlaySegment

语法：

number:= CDPlaySegment(track,fromseconds,forseconds,wait)

说明：该函数指定播放的CD的音轨的长度。参数track指定播放的音轨；参数fromseconds指定开始播放的时间位置；参数forseconds指定播放的时间长度，若forseconds为0，则表示播放到该音轨的结尾。若forseconds为-1，则表示播放整个CD唱片。若参数wait为True，则表示等动画播映结束后，Authorware应用程序才继续执行，否则一开始播放CD音轨Authorware就继续往下执行。

若该函数调用成功，则返回值为0。若调用失败，则返回错误代码。

CDStop

语法：number:=CDStop()

说明：该函数停止当前CD音轨的播放。

若该函数调用成功，则返回值为0。若调用失败，则返回错误代码。

CDPause

语法：number:=CDPause()

说明：该函数暂停当前CD音轨的播放。

若该函数调用成功，则返回值为0。若调用失败，则返回错误代码。

CDResumenumber:=CDResume()

说明：当使用CDPause暂停当前音乐播放时，使用CDResume可以让音乐继续播放。

若该函数调用成功，则返回值为0。若调用失败，则返回错误代码。

CDPlaying

语法：condition:=CDPlaying

说明：目前是否有CD音轨正在播放，则该函数返回值为True。

CDCurrentPosition

语法：string:= CDCurrentPosition()

说明：该函数查询当前CD音轨播放的时间。

格式为tt:mm:ss:ff。tt表示轨数，mm表示分钟数，ss表示秒数，ff表示帧数。

CDEject

语法：number:=CDEject()

说明：该函数可弹出当前使用的CD光盘机。

若该函数调用成功，则返回值为0。若调用失败，则返回错误代码。

CDRetract

语法：number:= CDRetract ()

说明：当使用CDEject函数弹出当前光盘机后，可以使用CDRetract使光盘托盘收回光盘机中。

若该函数调用成功，则返回值为0。若调用失败，则返回错误代码。

CDDiscPresent

语法：condition:= CDDiscPresent()

说明：若当前光盘机中有CD唱片，则该函数返回值为True，否则返回值为False。

CDLength

语法：number:= CDLength()

说明：该函数可查询所有的CD音轨的歌曲长度。

若该函数调用失败，则返回值为0。

CDTracks

语法：number:= CDTracks()

说明：该函数查询当前CD唱片的音轨数，即的歌曲的数目。

若该函数调用失败，则返回值为0。

CDTrackLength

语法：number:= CDTrackLength(track)

说明：该函数返回track指定音轨的歌曲长度。

若该函数调用失败，则返回值为0。

MCISendString

语法：number:= MCISendString(cmdstring)

说明：该函数向MCI设备发送一个MCI的指令。

若该函数调用成功，则返回值为0。若调用失败，则返回错误代码。可以通过函数MCIGetReturnstring()获得从MCI设备返回的字符串。

MCIGetReturnString

语法：string:= MCIGetReturnString()

说明：该函数获得从MCI设备返回的字符串。

MCIGetErrorString

语法：string:= MCIGetErrorString(errorcode)

说明：当使用MCISendString传送指令后，若有错误无法执行，可以将错误放置在errorcode之中，而本函数以字符形式返回错误代码。

MCIExecute

语法：condition:= MCIExecute(cmdstring)

说明：该函数与MCISendString最大的不同就是返回值，该函数返回的值是一个逻辑值，若为True则表示MCI指令成功，若为 False则表示MCI的指令无法执行。

MCIShowErrors

语法：MCIShowErrors(showerrors)

说明：该函数打开或关闭MCI的错误信息，若showerrors的值为True，则表示打开MCI的错误信息，这样当执行MCI指令出错时会显示错误的信息。

MIDIPlay

语法：number:= MIDIPlay(filename,tempo,wait)

说明：该函数播放参数filename指定的MIDI文件，参数tempo表示播放的节拍，若数值为100则表示正常播放。参数wait的值为一个逻辑值，为True表示声音在播放时，Authorware暂停执行，等MIDI音乐播放结束后再继续；为False则表示当MIDI音乐在播放时，Authorware继续往下执行。

若该函数调用成功，则返回值为0。若调用失败，则返回错误代码。

示例：

MIDIPlay("cat.mid",100,True)

上式表示播放cat.mid这个MIDI文件，以正常的速度播放，并且在播放的同时，暂停其他Authorware命令的执行。

MIDIPlaySegment

语法：number:= MIDIPlaySegment(filename,tempo,fromseconds,forseconds,wait)

说明：该函数播放参数filename指定的MIDI文件，参数tempo表示播放的节拍，若数值为100则表示正常播放。参数fromseconds表示开始播放该MIDI文件的长度位置。参数forseconds表示播放该MIDI文件的时间。参数wait的值为一个逻辑值，为True表示声音在播放时，Authorware暂停执行，等MIDI音乐播放结束后再继续；为False则表示当MIDI音乐在播放时，Authorware继续往下执行。

若该函数调用成功，则返回值为0。若调用失败，则返回错误代码。

MIDIStop

语法：number:= MIDIStop()

说明：该函数停止当前MIDI音乐的播放。

若该函数调用成功，则返回值为0。若调用失败，则返回错误代码。

MIDIPause

语法：number:= MIDIPause()

说明：该函数暂停当前MIDI音乐的播放。

若该函数调用成功，则返回值为0。若调用失败，则返回错误代码。

MIDIResume

语法：number:= MIDIResume()

说明：使用MIDIPause暂停MIDI音乐的播放时MIDIResume可以让MIDI音乐继续播放。

若该函数调用成功，则返回值为0。若调用失败，则返回错误代码。

MIDIPlaying

语法：condition:= MIDIPlaying()

说明：该函数查询目前是否有MIDI音乐在播放，若有则函数的值为True。

WavePlay

语法：number:= wavePlay(filename, wait)

说明：该函数可以播放参数filename指定的wav声音文件，而且可以返回一个数值代表正确或错误，如果播放指定声音文件前尚有其他的音乐正在播放时系统会将其他的音乐关闭，然后再播放此音乐。

参数wait的值为一个逻辑值，为True表示声音在播放时，Authorware暂停执行，等指定WAVE声音文件播放结束后再继续执行；为False则表示当指定WAVE声音文件一开始播放，Authorware立即继续往下执行。

特别要注意的一点是指定的WAVE声音文件必须同时给出后缀，否则会出现错误的信息。

若该函数调用成功，则返回值为0。若调用失败，则返回错误代码。

WavePlaySegment

语法：number:= WavePlaySegment(filename,fromseconds,forseconds,wait)

说明：该函数播放参数filename指定的WAVE声音文件。

参数fromseconds表示开始播放该WAVE文件的长度位置。参数forseconds表示播放该WAVE文件的时间，若为0则表示播放整个声音文件。参数wait的值为一个逻辑值，为True表示声音在播放时，Authorware暂停执行，等WAVE文件播放结束后再继续；为False则表示当WAVE文件在播放时，Authorware继续往下执行。

若该函数调用成功，则返回值为0。若调用失败，则返回错误代码。

WaveStop

语法：number:= WaveStop()

说明：该函数停止当前WAVE声音文件的播放。

若该函数调用成功，则返回值为0。若调用失败，则返回错误代码。

WavePause

语法：number:= WavePause()

说明：该函数暂停当前WAVE声音文件的播放。

若该函数调用成功，则返回值为0。若调用失败，则返回错误代码。

WaveResume

语法：number:= WaveResume()

说明：若当前声音文件已被暂停，可以使用此函数继续播放该WAVE声音文件。

若该函数调用成功，则返回值为0。若调用失败，则返回错误代码。

WavePlaying

语法：condition:= WavePlaying()

说明：该函数检测当前是否正在播放WAVE声音文件，若是则返回值为True，否则返回值为False。