學習電腦信息DirectMediaXtra用戶指南

Page7DirectMediaXtra用戶指南介紹

DirectMediaXtra?是一種SpriteXtra?。SpriteXtra?可以用計算圖標進行限制，而且屬性也可以通過腳本指定，就像Authorware中的內置媒體文件一樣。

假如回放的系統(tǒng)允許，DirectMediaXtra?還支持Microsoft’sDirectDraw?andDirectSound?。它總能夠依據(jù)機器的不同選擇最佳的播放效果，即使顯示設置為256色，也能運用高彩色來播放媒體文件。DirectDraw?引擎利用干脆寫顯存的技術增加回放效果。

要建立一個圖標，打開INSERT菜單，選擇TABULEIROXTRAS->DirectMediaXtra，這時會顯示一個DirectMediaXtra?屬性對話框，單擊browsefile，打開另一個對話框，提示你選擇一個媒體文件。它所支持的媒體類型有Mpeg,AVI,Quicktime?,WAV,AIF,MP2和MIDI。文件可以在本地機器，也可以在局域網(wǎng)上其他計算機上，甚至可以用輸入URL鏈接一個互聯(lián)網(wǎng)上的文件。選好文件，點擊OK，返回屬性對話框，文件的長度（時間），尺寸等信息應能正確的顯示出來。

你可以預覽文件，標注提示點并設置播放選項（工具條，音量，速率，平衡等等），單擊OK完成。在流程線上就出現(xiàn)一個名為DirectMediaXtra的圖標，可以重新調整播放的位置和尺寸。

提示點

每一個DirectMediaXtra可以有最多64個提示點，以毫秒位單位，每一個提示點的名字最多可以運用32個字符。要建立一個提示點就要在屬性對話框中預覽文件時確定時間，然后選擇“ADD”，顯示一個窗口定義提示點的名字。假如以后想修改提示點，在列表中雙擊名字就可以干脆編輯了。運用"GOTO"檢查提示點的定位，"REMOVE"用來刪除一個提示點。

用腳本建立提示點

CallIcon(@"IconName",#addcuepoint,cuepointtime,"cuepointname")-這個函數(shù)建立一個新的提示點，cuepointtime是時間cuepointname是名字，自動排列依次。

Example:

CallIcon(@"DirectMediaXtra",#addcuepoint,10000,"newcue")

CallIcon(@"IconName",#removecuepoint,cuepointindex)-刪除一個提示點，須要指定提示點的序號。

Example:

CallIcon(@"DirectMediaXtra",#removecuepoint,1)

運用提示點

DirectMediaXtra?的提示點被用來在回放時幾個方面的限制。下面是它的幾個屬性：

isPastCuePoint(sprite)à經(jīng)過的提示點

themostRecentCuePointofspriteà最近的提示點

thecuepointtimesoficonà指定提示點的時間

thecuepointnamesoficonà指定提示點的名字

當媒體文件播放時，你必需設置一個事務響應以獲得提示點，請參考所附帶的例子程序。主要步驟是：建立一個“Event”類型的響應，在屬性對話框中選擇一個“Sender”圖標名，再雙擊“EventName”框中的“CuePointPassed”事務。這樣，每當經(jīng)過一個新的提示點，就觸發(fā)這個響應。后面將要介紹的EventLastMatched變量會讓你更多地了解這個事務。

Properties屬性

DirectMediaXtra?全部的屬性都可以很便利地在屬性對話框中進行設置，這個對話框在你創(chuàng)建圖標或者雙擊該圖標時出現(xiàn)。同時，也可以通過腳本進行設置。

IconProperties圖標屬性

file被運用的媒體文件的全路徑名

例如:result:=GetIconProperty(@"DirectMediaXtra",#file)

Trace(result)

--“C:\myfile\file.mpg”

SetIconProperty(@"DirectMediaXtra",#file,”C:\myfile2.mpg”)

title媒體文件名，不帶路徑。這個屬性用于在原書目找不到文件的時候。

例如:result:=GetIconProperty(@"DirectMediaXtra",#title)

Trace(result)

--“file.mpg”

注：基于HTTP的文件鏈接，DMX不會在啟動時自動定位。

showlocatefiledialogDirectMediaXtra在運行時會自動定位媒體文件，假如文件沒有找到，運用這個屬性可以顯示一個指定文件的對話框，否則，就是一片空白。

例如:SetIconProperty(@"DirectMediaXtra",#showlocatefiledialog,TRUE)

linkedmedialocated這個屬性可以自動設置，用來表明媒體文件是否被正確調用。假如屬性的值為False，DirectMediaXtra就不會進行初始化播放。

例如:result:=GetIconProperty(@"DirectMediaXtra",#linkedmedialocated)

Trace(result)

--“1”

duration媒體文件的持續(xù)播放的時間，單位為毫秒。

例如:result:=GetIconProperty(@"DirectMediaXtra",#duration)

Trace(result)

--45200

videowidth媒體文件的播放寬度，單位為像素。

例如:result:=GetIconProperty(@"DirectMediaXtra",#videowidth)

Trace(result)

--352

videoheight媒體文件的播放高度，單位為像素

例如:result:=GetIconProperty(@"DirectMediaXtra",#videoheight)

Trace(result)

--240

volume回放音頻的音量。值的范圍從-100到0（dB即分貝）

例如:result:=GetIconProperty(@"DirectMediaXtra",#volume)

Trace(result)

---10

SetIconProperty(@"DirectMediaXtra",#volume,0)

balance音頻回放平衡，值的范圍從-100到100（dB即分貝）

例如:result:=GetIconProperty(@"DirectMediaXtra",#balance)

Trace(result)

---100

SetIconProperty(@"DirectMediaXtra",#balance,0)

rate回放速率。值的范圍從0到200，是原來標準播放速度的百分比例。

例如:result:=GetIconProperty(@"DirectMediaXtra",#rate)

Trace(result)

--100

SetIconProperty(@"DirectMediaXtra",#rate,80)

cpuboost由于DirectShow?技術要占用比較多的CPU時間，因此DirectMediaXtra?會使Authorware?的運行變慢。假如你遇到回放緩慢或者斷續(xù)的狀況，可以運用這個屬性設置。合法的取值范圍是0到95（百分比），一般來說，超過60就可以解決問題了。

例如:SetIconProperty(@"DirectMediaXtra",#cpuboost,60)

adjustdurationbeforeplayback假如這項屬性的值為真，DirectMediaXtra?就會在起先播放的同時確定媒體文件的可持續(xù)播放時間。這是非常必要的，因為對于同一個文件，不同的DirectShow過濾器會報告不同的可持續(xù)播放時間。這樣一來，當你把一個成品放到另一臺機器運行的時候，DirectMediaXtra?就有可能無法達到指定的提示點，或者它會認為文件還沒有播放完。運用這個屬性可以保證正常播放，因此你應當在大多數(shù)狀況下都運用。

例如:SetIconProperty(@"DirectMediaXtra",#adjustdurationbeforeplayback,1)

hastoolbar指出是否在播放窗口附帶一個工具條。值為0（假）或1（真）。

例如:SetIconProperty(@"DirectMediaXtra",#hastoolbar,1)

loop指出是否自動循環(huán)播放文件。值為0（假）或1（真）。

例如:SetIconProperty(@"DirectMediaXtra",#loop,1)

playsegment指出是否只播放文件的一個片斷。值為0（假）或1（真）。

例如:SetIconProperty(@"DirectMediaXtra",#playsegment,1)

segmentstart指定文件播放的起始時間，單位是毫秒。只在playsegment的值為真時有效。

例如:SetIconProperty(@"DirectMediaXtra",#segmentstart,10700)

segmentend指定文件播放的結束時間，單位是毫秒。只在playsegment的值為真時有效。

例如:SetIconProperty(@"DirectMediaXtra",#segmentend,45800)

pausedatstart指出是否在打開文件的時候暫停，不播放。值為0（假）或1（真）。

例如:SetIconProperty(@"DirectMediaXtra",#pausedatstart,1)

cuepointtimes與該圖標有關的提示點時間的列表。

例如:result:=GetIconProperty(@"DirectMediaXtra",#cuepointtimes)

Trace(result)

--[4500,12300,34650,67321]

cuepointnames與該圖標有關的提示點名字的列表

例如:result:=GetIconProperty(@"DirectMediaXtra",#cuepointnames)

Trace(result)

--["Cue1","NewCuePoint","StartPoint","Secondpart"]

Sprite屬性

currenttime媒體文件當前播放位置，單位是毫秒。

例如:result:=GetSpriteProperty(@"DirectMediaXtra",#currenttime)

Trace(result)

--22345

mediabusy表明媒體文件是否正在播放。值為0（假）或1（真）。

例如:result:=GetSpriteProperty(@"DirectMediaXtra",#mediabusy)

Trace(result)

--1

mostrecentcuepoint最終經(jīng)過的提示點的序號。

例如:result:=GetSpriteProperty(@"DirectMediaXtra",#mostrecentcuepoint)

Trace(result)

--2

Functions函數(shù)

DirectMediaXtra?供應了幾種函數(shù)功能，可以用腳本的方式運用來限制媒體文件的回放。

IconFunctions圖標函數(shù)

CallIcon(@"IconName",#isDirectShowInstalled)返回0（假）或1（真）。用來推斷用戶機上是否安裝了DirectShow?。在正式版中有效。

例如:result:=CallIcon(@"DirectMediaXtra",#isDirectShowInstalled)

Trace(result)

--1

CallIcon(@"IconName",#addcuepoint,cuepointtime,"cuepointname")這個函數(shù)可以通過腳本語言建立一個新的提示點，提示點會自動排列依次。

例如:CallIcon(@"DirectMediaXtra",#addcuepoint,10000,"newcue")

CallIcon(@"IconName",#removecuepoint,cuepointindex)這個函數(shù)可以把你指定序號的提示點刪除。

例如:CallIcon(@"DirectMediaXtra",#removecuepoint,1)

CallIcon(@"IconName",#scanfile)當通過腳本語言變更要播放的媒體文件時，這個函數(shù)可以確定文件長度和可持續(xù)播放時間。它將自動查詢文件并變更自身屬性。Adjustdurationbeforeplayback也可以用來校對播放時間，我們建議運用這個屬性來代替scanfile()，因為它更精確。

例如:CallIcon(@"DirectMediaXtra",#scanfile)

CallIcon(@"IconName",#register,registrationnumber)在運行時對DirectMediaXtra?進行注冊。這個函數(shù)不常用。

例如:CallIcon(@"DirectMediaXtra",#register,"SERIALNUMBERHERE”)

Sprite函數(shù)

CallSprite(@"IconName",#videoplay)用于起先或是復原播放媒體文件。通常在調用時會自動播放文件，除非選擇了"PausedatStart"（在起先時暫停）

例如:CallSprite(@"DirectMediaXtra",#videoplay)

CallSprite(@"IconName",#videopause)暫停播放。

例如:CallSprite(@"DirectMediaXtra",#videopause)

CallSprite(@"IconName",#videoseek,time)查找并暫停在指定的時間位置。時間單位是毫秒。

例如:CallSprite(@"DirectMediaXtra",#videoseek,15000)

CallSprite(@"IconName",#videoplaysegment,starttime,endtime)播放文件的一個片斷。請留意這個選項事實上限制了對片斷以外其他部分的限制，因此應當再用另一個videoplaysegment()定位到其他的時間點上，跳出這個片斷。

例如:CallSprite(@"DirectMediaXtra",#videoplaysegment,10000,20000)

--thefollowingcommandpausesthevideointimelocation30000

CallSprite(@"DirectMediaXtra",#videoplaysegment,30000,30000)

CallSprite(@"IconName",#isPastCuePoint,cuepointindex)推斷指定序號的提示點是否已經(jīng)經(jīng)過了。返回值為0（假）或1（真）。

例如:result:=CallSprite(@"DirectMediaXtra",#isPastCuePoint,2)

Trace(result)

1

CallSprite(@"IconName",#setvolume,volume)設置音頻回放的音量。賦值范圍從-100到0（dB/分貝）。

例如:CallSprite(@"DirectMediaXtra",#setvolume,0)

CallSprite(@"IconName",#getvolume)返回當前音頻播放的音量值，單位是dB/分貝。

例如:result:=CallSprite(@"DirectMediaXtra",#getvolume)

Trace(result)

---20

CallSprite(@"IconName",#setbalance,balance)設置音頻回放的平衡。賦值范圍從-100到100（dB/分貝）。

例如:CallSprite(@"DirectMediaXtra",#setvolume,0)

CallSprite(@"IconName",#getbalance)返回當前音頻播放的平衡值，單位是dB/分貝。

例如:result:=CallSprite(@"DirectMediaXtra",#getbalance)

Trace(result)

---100

CallSprite(@"IconName",#setrate,rate)設置播放速率。賦值范圍從0到200（%）

例如:CallSprite