Controlling DVDs with variables and functions

DVDCurrentTime

Contains the current time, measured in seconds, of the current DVD title.

DVDState

Represents the current playback state of the DVD.

DVDTotalTime

Contains the total time, measured in seconds, of the current DVD title.

0 = the window exists, but the DVD is not playing

1 = the DVD is playing

2 = the DVD is paused

 3 = the DVD is scanning forward or backward

4 = the DVD window does not exist

DVDWindowHeight

Contains the height of the DVD window.

DVDWindowWidth

Contains the width of the DVD window.

DVDAction

Affects DVD playback based on the symbol specified:

#Play = put in play mode

#Pause = put in pause mode

#Stop = stop playback

#End = close window and free all resources

#Rewind = put in rewind mode

#Fastforward = put in fast-forward mode

#Framestep = step to the next frame

#Nextchapter = skip to the next chapter

#Prevchapter = skip to the previous chapter

#Replaychapter = replay the current chapter

#Fullscreen = play in full screen mode

#Titlemenu = switch to title menu of DVD

#Rootmenu = switch to root menu of DVD

DVDCaptions

Turns on the DVD captions when TRUE (if they are present). Specify FALSE to turn captions off.

DVDChapterNum

Returns the number of the current chapter.

DVDCreate

Creates the DVD playback window at the window positions and sizes specified. DVDFilename is the full drive letter, path, and filename of the file to open when creating the DVD window. All of the parameters are optional.

If you do not specify both WindowLeft and WindowTop (or they are 0), the window origin will be at 0, 0. If you do not specify WindowHeight and WindowWidth (or they are 0), it creates the DVD window at a size to match the current size of the Authorware presentation window. If you omit DVDFilename (or pass a null string), DVDCreate finds the first DVD disc in a DVD drive on the system and attempts to load that disc.

The initial window is created hidden, to allow for audio-only playback. To display the DVD window, use DVDShowWindow(TRUE).

Returns TRUE if successful.

DVDCurrentTitleNum

Returns the current title number.

DVDDirectX

Returns the version number of Microsoft Windows DirectX support installed.

DVDGetDrive

Returns the drive letter of the first DVD drive it finds on the system with a DVD disc loaded. DVDGetDrive begins its search from the drive letter specified. Returns a null string if no DVD drive with a disc is found.

DVDGetVolume

Returns the DVD audio level as a percentage. 100 is full volume, while 0 is no volume.

DVDMute

Mutes the DVD audio when TRUE. Specify FALSE to restore the sound.

DVDNumChapters

Returns the number of chapters in the specified title. If TitleNumber is omitted, it returns the number of chapters in the current title.

DVDNumTitles

Returns the number of titles on the current DVD.

DVDPlayChapter

Plays the specified chapter in the specified title. If TitleNumber is 0, the chapter is played from the current title.

DVDPlaytime

Plays the specified Title number from the specified start time to the specified end time. If Title is 0, the selection plays from the current title number. If the end time is omitted, the playback continues to the end of the title.

DVDSelectButton

Selects the specified button number from the DVD menu.

DVDSetVolume

Sets the DVD audio level as a percentage. 100 is full volume, while 0 is no volume.

Returns TRUE if successful; FALSE if not.

DVDShowWindow

Creates the DVD window in a hidden state.

Use DVDShowWindow(TRUE) to show the window.

Use DVDShowWindow(FALSE) to hide the DVD window if it is displayed.