User Guide

on DVDeventNotification 165
on DVDeventNotification
Usage
-- Lingo syntax
on DVDeventNotification objectRef, event {, eventArg1} {, eventArg2} {,
eventArg3}
statement(s)
end
// JavaScript syntax
function DVDeventNotification (objectRef, event {, eventArg1} {, eventArg2} {,
eventArg3}) {
statement(s);
}
Description
Author-specified DVD event handler. Contains statements that run in response to events that
occur while a DVD is playing.
This handler can be used to track all DVD events. In the script examples above,
objectRef, the
first parameter passed to the DVDeventNotification handler, is a reference to the
DVDeventNotification object itself. The actual event that occurs is always passed as the second
parameter,
event. Some events contain additional information about them that is passed as a
third parameter,
eventArg1. In some cases, a fourth and fifth parameter, eventArg2 and
eventArg3, may contain additional event information.
The following table lists the events that can occur while a DVD is playing.
Event Description
angleChange
Occurs when either the number of available angles changed or the current
user angle number changed.
The following additional information is passed to
DVDeventNotification
when this event occurs:
•
eventArg2 - An integer that indicates the number of available angles.
When the number of available angles is 1, the current video is not
multiangle.
•
eventArg3 - An integer that indicates the current user angle number.
audioStreamChange
Occurs when the current user audio stream number changed for the main
title.
The following additional information is passed to
DVDeventNotification
when this event occurs:
•
eventArg2 - An integer that indicates the new user audio stream number.
Stream
0xFFFFFFFF indicates that no stream is selected.
buttonChange
Occurs when either the number of available buttons changed or the
currently selected button number changed.
The following additional information is passed to
DVDeventNotification
when this event occurs:
•
eventArg2 - An integer that indicates the number of available buttons.
•
eventArg3 - An integer that indicates the currently selected button
number. Selected button number 0 implies that no button is selected.
chapterAutoStop
Occurs when playback stopped as a result of an automatic stop.