1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71
72
73
74
75
76
77
78
79
80
81
82
83
84
85
86
87
88
89
90
91
92
93
94
95
96
97
98
99
100
101
102
103
104
105
106
107
108
109
110
111
112
113
114
115
116
117
118
119
120
121
122
123
124
125
126
127
128
129
130
131
132
133
134
135
136
137
138
139
140
141
142
143
144
145
146
147
148
149
150
151
152
153
154
155
156
157
158
159
160
161
162
163
164
165
166
167
168
169
170
171
172
173
174
175
176
177
178
179
180
181
182
183
184
185
186
187
188
189
190
191
192
193
194
195
196
197
198
199
200
201
202
203
204
205
206
207
208
209
210
211
212
213
214
215
216
217
218
219
220
221
222
223
224
225
226
227
228
229
230
231
232
233
234
235
236
237
238
239
240
241
|
/*
* Copyright (C) 2001 Rich Wareham <richwareham@users.sourceforge.net>
*
* This file is part of libdvdnav, a DVD navigation library.
*
* libdvdnav is free software; you can redistribute it and/or modify
* it under the terms of the GNU General Public License as published by
* the Free Software Foundation; either version 2 of the License, or
* (at your option) any later version.
*
* libdvdnav is distributed in the hope that it will be useful,
* but WITHOUT ANY WARRANTY; without even the implied warranty of
* MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the
* GNU General Public License for more details.
*
* You should have received a copy of the GNU General Public License
* along with this program; if not, write to the Free Software
* Foundation, Inc., 51 Franklin Street, Fifth Floor, Boston, MA 02110-1301, USA
*
* $Id: dvdnav_events.h,v 1.11 2003/04/07 18:10:48 mroi Exp $
*
*/
/*
* This header defines events and event types
*/
#ifndef DVDNAV_EVENTS_H_INCLUDED
#define DVDNAV_EVENTS_H_INCLUDED
#include "common.h"
/*
* DVDNAV_BLOCK_OK
*
* A regular data block from the DVD has been returned.
* This one should be demuxed and decoded for playback.
*/
#define DVDNAV_BLOCK_OK 0
/*
* DVDNAV_NOP
*
* Just ignore this.
*/
#define DVDNAV_NOP 1
/*
* DVDNAV_STILL_FRAME
*
* We have reached a still frame. The player application should wait
* the amount of time specified by the still's length while still handling
* user input to make menus and other interactive stills work.
* The last delivered frame should be kept showing.
* Once the still has timed out, call dvdnav_skip_still().
* A length of 0xff means an infinite still which has to be skipped
* indirectly by some user interaction.
*/
#define DVDNAV_STILL_FRAME 2
typedef struct {
/* The length (in seconds) the still frame should be displayed for,
* or 0xff if infinite. */
int length;
} dvdnav_still_event_t;
/*
* DVDNAV_SPU_STREAM_CHANGE
*
* Inform the SPU decoding/overlaying engine to switch SPU channels.
*/
#define DVDNAV_SPU_STREAM_CHANGE 3
typedef struct {
/* The physical (MPEG) stream number for widescreen SPU display.
* Use this, if you blend the SPU on an anamorphic image before
* unsqueezing it. */
int physical_wide;
/* The physical (MPEG) stream number for letterboxed display.
* Use this, if you blend the SPU on an anamorphic image after
* unsqueezing it. */
int physical_letterbox;
/* The physical (MPEG) stream number for pan&scan display.
* Use this, if you blend the SPU on an anamorphic image after
* unsqueezing it the pan&scan way. */
int physical_pan_scan;
/* The logical (DVD) stream number. */
int logical;
} dvdnav_spu_stream_change_event_t;
/*
* DVDNAV_AUDIO_STREAM_CHANGE
*
* Inform the audio decoder to switch channels.
*/
#define DVDNAV_AUDIO_STREAM_CHANGE 4
typedef struct {
/* The physical (MPEG) stream number. */
int physical;
/* The logical (DVD) stream number. */
int logical;
} dvdnav_audio_stream_change_event_t;
/*
* DVDNAV_VTS_CHANGE
*
* Some status information like video aspect and video scale permissions do
* not change inside a VTS. Therefore this event can be used to query such
* information only when necessary and update the decoding/displaying
* accordingly.
*/
#define DVDNAV_VTS_CHANGE 5
typedef struct {
int old_vtsN; /* the old VTS number */
dvd_read_domain_t old_domain; /* the old domain */
int new_vtsN; /* the new VTS number */
dvd_read_domain_t new_domain; /* the new domain */
} dvdnav_vts_change_event_t;
/*
* DVDNAV_CELL_CHANGE
*
* Some status information like the current Title and Part numbers do not
* change inside a cell. Therefore this event can be used to query such
* information only when necessary and update the decoding/displaying
* accordingly.
* Some useful information for accurate time display is also reported
* together with this event.
*/
#define DVDNAV_CELL_CHANGE 6
typedef struct {
int cellN; /* the new cell number */
int pgN; /* the current program number */
int64_t cell_length; /* the length of the current cell in PTS ticks */
int64_t pg_length; /* the length of the current program in PTS ticks */
int64_t pgc_length; /* the length of the current program chain in PTS ticks */
int64_t cell_start; /* the start time of the current cell relatively to the PGC in PTS ticks */
int64_t pg_start; /* the start time of the current PG relatively to the PGC in PTS ticks */
} dvdnav_cell_change_event_t;
/*
* DVDNAV_NAV_PACKET
*
* NAV packets are useful for various purposes. They define the button
* highlight areas and VM commands of DVD menus, so they should in any
* case be sent to the SPU decoder/overlaying engine for the menus to work.
* NAV packets also provide a way to detect PTS discontinuities, because
* they carry the start and end PTS values for the current VOBU.
* (pci.vobu_s_ptm and pci.vobu_e_ptm) Whenever the start PTS of the
* current NAV does not match the end PTS of the previous NAV, a PTS
* discontinuity has occured.
* NAV packets can also be used for time display, because they are
* timestamped relatively to the current Cell.
*/
#define DVDNAV_NAV_PACKET 7
/*
* DVDNAV_STOP
*
* Applications should end playback here. A subsequent dvdnav_get_next_block()
* call will restart the VM from the beginning of the DVD.
*/
#define DVDNAV_STOP 8
/*
* DVDNAV_HIGHLIGHT
*
* The current button highlight changed. Inform the overlaying engine to
* highlight a different button. Please note, that at the moment only mode 1
* highlights are reported this way. That means, when the button highlight
* has been moved around by some function call, you will receive an event
* telling you the new button. But when a button gets activated, you have
* to handle the mode 2 highlighting (that is some different colour the
* button turns to on activation) in your application.
*/
#define DVDNAV_HIGHLIGHT 9
typedef struct {
/* highlight mode: 0 - hide, 1 - show, 2 - activate, currently always 1 */
int display;
/* FIXME: these fields are currently not set */
uint32_t palette; /* The CLUT entries for the highlight palette
(4-bits per entry -> 4 entries) */
uint16_t sx,sy,ex,ey; /* The start/end x,y positions */
uint32_t pts; /* Highlight PTS to match with SPU */
/* button number for the SPU decoder/overlaying engine */
uint32_t buttonN;
} dvdnav_highlight_event_t;
/*
* DVDNAV_SPU_CLUT_CHANGE
*
* Inform the SPU decoder/overlaying engine to update its colour lookup table.
* The CLUT is given as 16 uint32_t's in the buffer.
*/
#define DVDNAV_SPU_CLUT_CHANGE 10
/*
* DVDNAV_HOP_CHANNEL
*
* A non-seamless operation has been performed. Applications can drop all
* their internal fifo's content, which will speed up the response.
*/
#define DVDNAV_HOP_CHANNEL 12
/*
* DVDNAV_WAIT
*
* We have reached a point in DVD playback, where timing is critical.
* Player application with internal fifos can introduce state
* inconsistencies, because libdvdnav is always the fifo's length
* ahead in the stream compared to what the application sees.
* Such applications should wait until their fifos are empty
* when they receive this type of event.
* Once this is achieved, call dvdnav_skip_wait().
*/
#define DVDNAV_WAIT 13
#endif /* DVDNAV_EVENTS_H_INCLUDED */
|
