libbluray
bluray.h
Go to the documentation of this file.
1 /*
2  * This file is part of libbluray
3  * Copyright (C) 2009-2010 Obliter0n
4  * Copyright (C) 2009-2010 John Stebbins
5  * Copyright (C) 2010-2017 Petri Hintukainen
6  *
7  * This library is free software; you can redistribute it and/or
8  * modify it under the terms of the GNU Lesser General Public
9  * License as published by the Free Software Foundation; either
10  * version 2.1 of the License, or (at your option) any later version.
11  *
12  * This library is distributed in the hope that it will be useful,
13  * but WITHOUT ANY WARRANTY; without even the implied warranty of
14  * MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the GNU
15  * Lesser General Public License for more details.
16  *
17  * You should have received a copy of the GNU Lesser General Public
18  * License along with this library. If not, see
19  * <http://www.gnu.org/licenses/>.
20  */
21 
22 #ifndef BLURAY_H_
23 #define BLURAY_H_
24 
25 #ifdef __cplusplus
26 extern "C" {
27 #endif
28 
34 #include <stdint.h>
35 #include "bdnav/clpi_data.h"
36 
37 #define TITLES_ALL 0
38 #define TITLES_FILTER_DUP_TITLE 0x01
39 #define TITLES_FILTER_DUP_CLIP 0x02
41 #define TITLES_RELEVANT \
42  (TITLES_FILTER_DUP_TITLE | TITLES_FILTER_DUP_CLIP)
45 typedef struct bluray BLURAY;
46 
47 /*
48  * Disc info
49  */
50 
51 /* AACS error codes */
52 #define BD_AACS_CORRUPTED_DISC -1
53 #define BD_AACS_NO_CONFIG -2
54 #define BD_AACS_NO_PK -3
55 #define BD_AACS_NO_CERT -4
56 #define BD_AACS_CERT_REVOKED -5
57 #define BD_AACS_MMC_FAILED -6
58 
59 /* HDMV / BD-J title */
60 typedef struct {
61  const char *name; /* optional title name in preferred language */
62  uint8_t interactive; /* 1 if title is interactive (title length and playback position should not be shown in UI) */
63  uint8_t accessible; /* 1 if it is allowed to jump into this title */
64  uint8_t hidden; /* 1 if title number should not be shown during playback */
65 
66  uint8_t bdj; /* 0 - HDMV title. 1 - BD-J title */
67  uint32_t id_ref; /* Movie Object number / bdjo file number */
68 } BLURAY_TITLE;
69 
70 typedef struct {
71  uint8_t bluray_detected;
72 
73  /* Disc ID */
74  const char *disc_name; /* optional disc name in preferred language */
75  const char *udf_volume_id; /* optional UDF volume identifier */
76  uint8_t disc_id[20];
77 
78  /* HDMV / BD-J titles */
79  uint8_t no_menu_support; /* 1 if this disc can't be played using on-disc menus */
80  uint8_t first_play_supported;
81  uint8_t top_menu_supported;
82 
83  uint32_t num_titles;
84  const BLURAY_TITLE *const *titles; /* index is title number 1 ... N */
85  const BLURAY_TITLE *first_play; /* titles[N+1]. NULL if not present on the disc. */
86  const BLURAY_TITLE *top_menu; /* titles[0]. NULL if not present on the disc. */
87 
88  uint32_t num_hdmv_titles;
89  uint32_t num_bdj_titles;
90  uint32_t num_unsupported_titles;
91 
92  /* BD-J info (valid only if disc uses BD-J) */
93  uint8_t bdj_detected; /* 1 if disc uses BD-J */
94  uint8_t bdj_supported; /* 1 if BD-J support was compiled in */
95  uint8_t libjvm_detected; /* 1 if usable Java VM was found */
96  uint8_t bdj_handled; /* 1 if usable Java VM + libbluray.jar was found */
97 
98  char bdj_org_id[9]; /* (BD-J) disc organization ID */
99  char bdj_disc_id[33]; /* (BD-J) disc ID */
100 
101  /* disc application info */
102  uint8_t video_format; /* bd_video_format_e */
103  uint8_t frame_rate; /* bd_frame_rate_e */
104  uint8_t content_exist_3D;
105  uint8_t initial_output_mode_preference; /* 0 - 2D, 1 - 3D */
106  uint8_t provider_data[32];
107 
108  /* AACS info (valid only if disc uses AACS) */
109  uint8_t aacs_detected; /* 1 if disc is using AACS encoding */
110  uint8_t libaacs_detected; /* 1 if usable AACS decoding library was found */
111  uint8_t aacs_handled; /* 1 if disc is using supported AACS encoding */
112 
113  int aacs_error_code; /* AACS error code (BD_AACS_*) */
114  int aacs_mkbv; /* AACS MKB version */
115 
116  /* BD+ info (valid only if disc uses BD+) */
117  uint8_t bdplus_detected; /* 1 if disc is using BD+ encoding */
118  uint8_t libbdplus_detected; /* 1 if usable BD+ decoding library was found */
119  uint8_t bdplus_handled; /* 1 if disc is using supporred BD+ encoding */
120 
121  uint8_t bdplus_gen; /* BD+ content code generation */
122  uint32_t bdplus_date; /* BD+ content code relese date ((year<<16)|(month<<8)|day) */
123 
124  /* disc application info (libbluray > 1.2.0) */
125  uint8_t initial_dynamic_range_type; /* bd_dynamic_range_type_e */
126 
128 
129 /*
130  * Playlist info
131  */
132 
133 typedef enum {
134  BLURAY_STREAM_TYPE_VIDEO_MPEG1 = 0x01,
135  BLURAY_STREAM_TYPE_VIDEO_MPEG2 = 0x02,
136  BLURAY_STREAM_TYPE_AUDIO_MPEG1 = 0x03,
137  BLURAY_STREAM_TYPE_AUDIO_MPEG2 = 0x04,
138  BLURAY_STREAM_TYPE_AUDIO_LPCM = 0x80,
139  BLURAY_STREAM_TYPE_AUDIO_AC3 = 0x81,
140  BLURAY_STREAM_TYPE_AUDIO_DTS = 0x82,
141  BLURAY_STREAM_TYPE_AUDIO_TRUHD = 0x83,
142  BLURAY_STREAM_TYPE_AUDIO_AC3PLUS = 0x84,
143  BLURAY_STREAM_TYPE_AUDIO_DTSHD = 0x85,
144  BLURAY_STREAM_TYPE_AUDIO_DTSHD_MASTER = 0x86,
145  BLURAY_STREAM_TYPE_VIDEO_VC1 = 0xea,
146  BLURAY_STREAM_TYPE_VIDEO_H264 = 0x1b,
147  BLURAY_STREAM_TYPE_VIDEO_HEVC = 0x24,
148  BLURAY_STREAM_TYPE_SUB_PG = 0x90,
149  BLURAY_STREAM_TYPE_SUB_IG = 0x91,
150  BLURAY_STREAM_TYPE_SUB_TEXT = 0x92,
151  BLURAY_STREAM_TYPE_AUDIO_AC3PLUS_SECONDARY = 0xa1,
152  BLURAY_STREAM_TYPE_AUDIO_DTSHD_SECONDARY = 0xa2
153 } bd_stream_type_e;
154 
155 typedef enum {
156  BLURAY_VIDEO_FORMAT_480I = 1, // ITU-R BT.601-5
157  BLURAY_VIDEO_FORMAT_576I = 2, // ITU-R BT.601-4
158  BLURAY_VIDEO_FORMAT_480P = 3, // SMPTE 293M
159  BLURAY_VIDEO_FORMAT_1080I = 4, // SMPTE 274M
160  BLURAY_VIDEO_FORMAT_720P = 5, // SMPTE 296M
161  BLURAY_VIDEO_FORMAT_1080P = 6, // SMPTE 274M
162  BLURAY_VIDEO_FORMAT_576P = 7, // ITU-R BT.1358
163  BLURAY_VIDEO_FORMAT_2160P = 8, //
164 } bd_video_format_e;
165 
166 typedef enum {
167  BLURAY_VIDEO_RATE_24000_1001 = 1, // 23.976
168  BLURAY_VIDEO_RATE_24 = 2,
169  BLURAY_VIDEO_RATE_25 = 3,
170  BLURAY_VIDEO_RATE_30000_1001 = 4, // 29.97
171  BLURAY_VIDEO_RATE_50 = 6,
172  BLURAY_VIDEO_RATE_60000_1001 = 7 // 59.94
173 } bd_video_rate_e;
174 
175 typedef enum {
176  BLURAY_ASPECT_RATIO_4_3 = 2,
177  BLURAY_ASPECT_RATIO_16_9 = 3
178 } bd_video_aspect_e;
179 
180 typedef enum {
181  BLURAY_AUDIO_FORMAT_MONO = 1,
182  BLURAY_AUDIO_FORMAT_STEREO = 3,
183  BLURAY_AUDIO_FORMAT_MULTI_CHAN = 6,
184  BLURAY_AUDIO_FORMAT_COMBO = 12 // Stereo ac3/dts,
185 } bd_audio_format_e;
186  // multi mlp/dts-hd
187 
188 typedef enum {
189  BLURAY_AUDIO_RATE_48 = 1,
190  BLURAY_AUDIO_RATE_96 = 4,
191  BLURAY_AUDIO_RATE_192 = 5,
192  BLURAY_AUDIO_RATE_192_COMBO = 12, // 48 or 96 ac3/dts
193  // 192 mpl/dts-hd
194  BLURAY_AUDIO_RATE_96_COMBO = 14 // 48 ac3/dts
195  // 96 mpl/dts-hd
196 } bd_audio_rate_e;
197 
198 typedef enum {
199  BLURAY_TEXT_CHAR_CODE_UTF8 = 0x01,
200  BLURAY_TEXT_CHAR_CODE_UTF16BE = 0x02,
201  BLURAY_TEXT_CHAR_CODE_SHIFT_JIS = 0x03,
202  BLURAY_TEXT_CHAR_CODE_EUC_KR = 0x04,
203  BLURAY_TEXT_CHAR_CODE_GB18030_20001 = 0x05,
204  BLURAY_TEXT_CHAR_CODE_CN_GB = 0x06,
205  BLURAY_TEXT_CHAR_CODE_BIG5 = 0x07
206 } bd_char_code_e;
207 
208 typedef enum {
209  BLURAY_STILL_NONE = 0x00,
210  BLURAY_STILL_TIME = 0x01,
211  BLURAY_STILL_INFINITE = 0x02,
212 } bd_still_mode_e;
213 
214 typedef enum {
215  BLURAY_MARK_ENTRY = 0x01, /* entry mark for chapter search */
216  BLURAY_MARK_LINK = 0x02, /* link point */
217 } bd_mark_type_e;
218 
219 typedef enum {
220  BLURAY_DYNAMIC_RANGE_SDR = 0,
221  BLURAY_DYNAMIC_RANGE_HDR10 = 1,
222  BLURAY_DYNAMIC_RANGE_DOLBY_VISION = 2
223 } bd_dynamic_range_type_e;
224 
225 typedef struct bd_stream_info {
226  uint8_t coding_type;
227  uint8_t format;
228  uint8_t rate;
229  uint8_t char_code;
230  uint8_t lang[4];
231  uint16_t pid;
232  uint8_t aspect;
233  uint8_t subpath_id;
235 
236 typedef struct bd_clip {
237  uint32_t idx;
238  uint32_t pkt_count;
239  uint8_t still_mode;
240  uint16_t still_time; /* seconds */
241  uint8_t video_stream_count;
242  uint8_t audio_stream_count;
243  uint8_t pg_stream_count;
244  uint8_t ig_stream_count;
245  uint8_t sec_audio_stream_count;
246  uint8_t sec_video_stream_count;
247  BLURAY_STREAM_INFO *video_streams;
248  BLURAY_STREAM_INFO *audio_streams;
249  BLURAY_STREAM_INFO *pg_streams;
250  BLURAY_STREAM_INFO *ig_streams;
251  BLURAY_STREAM_INFO *sec_audio_streams;
252  BLURAY_STREAM_INFO *sec_video_streams;
253 
254  uint64_t start_time; /* start media time, 90kHz, ("playlist time") */
255  uint64_t in_time; /* start timestamp, 90kHz */
256  uint64_t out_time; /* end timestamp, 90kHz */
257  char clip_id[6];
259 
260 typedef struct bd_chapter {
261  uint32_t idx;
262  uint64_t start; /* start media time, 90kHz, ("playlist time") */
263  uint64_t duration; /* duration */
264  uint64_t offset; /* distance from title start, bytes */
265  unsigned clip_ref;
267 
268 typedef struct bd_mark {
269  uint32_t idx;
270  int type; /* bd_mark_type_e */
271  uint64_t start; /* mark media time, 90kHz, ("playlist time") */
272  uint64_t duration; /* time to next mark */
273  uint64_t offset; /* mark distance from title start, bytes */
274  unsigned clip_ref;
276 
277 typedef struct bd_title_info {
278  uint32_t idx; /* filled only with bd_get_title_info() */
279  uint32_t playlist;
280  uint64_t duration;
281  uint32_t clip_count;
282  uint8_t angle_count;
283  uint32_t chapter_count;
284  uint32_t mark_count;
285  BLURAY_CLIP_INFO *clips;
286  BLURAY_TITLE_CHAPTER *chapters;
287  BLURAY_TITLE_MARK *marks;
288 
289  uint8_t mvc_base_view_r_flag;
291 
292 /*
293  * Sound effect data
294  */
295 
296 typedef struct bd_sound_effect {
297  uint8_t num_channels; /* 1 - mono, 2 - stereo */
298  uint32_t num_frames;
299  const int16_t *samples; /* 48000 Hz, 16 bit LPCM. interleaved if stereo */
301 
302 
307 void bd_get_version(int *major, int *minor, int *micro);
308 
309 /*
310  * Disc functions
311  */
312 
322 BLURAY *bd_open(const char *device_path, const char *keyfile_path);
323 
331 BLURAY *bd_init(void);
332 
341 int bd_open_disc(BLURAY *bd, const char *device_path, const char *keyfile_path);
342 
351 int bd_open_stream(BLURAY *bd,
352  void *read_blocks_handle,
353  int (*read_blocks)(void *handle, void *buf, int lba, int num_blocks));
354 
364 struct bd_dir_s;
365 struct bd_file_s;
366 int bd_open_files(BLURAY *bd,
367  void *handle,
368  struct bd_dir_s *(*open_dir)(void *handle, const char *rel_path),
369  struct bd_file_s *(*open_file)(void *handle, const char *rel_path));
370 
376 void bd_close(BLURAY *bd);
377 
386 
400 struct meta_dl;
401 const struct meta_dl *bd_get_meta(BLURAY *bd);
402 
416 int bd_get_meta_file(BLURAY *bd, const char *file_name, void **data, int64_t *size);
417 
418 
419 /*
420  * Title selection without on-disc menus
421  */
422 
436 uint32_t bd_get_titles(BLURAY *bd, uint8_t flags, uint32_t min_title_length);
437 
446 int bd_get_main_title(BLURAY *bd);
447 
457 BLURAY_TITLE_INFO* bd_get_title_info(BLURAY *bd, uint32_t title_idx, unsigned angle);
458 
466 
475 int bd_select_title(BLURAY *bd, uint32_t title);
476 
485 int bd_select_playlist(BLURAY *bd, uint32_t playlist);
486 
494 uint32_t bd_get_current_title(BLURAY *bd);
495 
504 int64_t bd_find_seek_point(BLURAY *bd, uint64_t tick);
505 
515 int bd_read(BLURAY *bd, unsigned char *buf, int len);
516 
517 
518 /*
519  * Playback control functions
520  */
521 
529 int64_t bd_seek(BLURAY *bd, uint64_t pos);
530 
539 int64_t bd_seek_time(BLURAY *bd, uint64_t tick);
540 
549 int64_t bd_seek_chapter(BLURAY *bd, unsigned chapter);
550 
559 int64_t bd_seek_mark(BLURAY *bd, unsigned mark);
560 
569 int64_t bd_seek_playitem(BLURAY *bd, unsigned clip_ref);
570 
579 int bd_select_angle(BLURAY *bd, unsigned angle);
580 
588 void bd_seamless_angle_change(BLURAY *bd, unsigned angle);
589 
612 #define BLURAY_AUDIO_STREAM 0
613 #define BLURAY_PG_TEXTST_STREAM 1
614 
615 void bd_select_stream(BLURAY *bd, uint32_t stream_type, uint32_t stream_id, uint32_t enable_flag);
616 
617 
618 /*
619  * Playback status functions
620  */
621 
630 int64_t bd_chapter_pos(BLURAY *bd, unsigned chapter);
631 
639 uint32_t bd_get_current_chapter(BLURAY *bd);
640 
650 uint64_t bd_get_title_size(BLURAY *bd);
651 
659 unsigned bd_get_current_angle(BLURAY *bd);
660 
668 uint64_t bd_tell(BLURAY *bd);
669 
677 uint64_t bd_tell_time(BLURAY *bd);
678 
679 
680 /*
681  * player settings
682  */
683 
684 typedef enum {
685  BLURAY_PLAYER_SETTING_AUDIO_LANG = 16, /* Initial audio language. String (ISO 639-2/T). */
686  BLURAY_PLAYER_SETTING_PG_LANG = 17, /* Initial PG/SPU language. String (ISO 639-2/T). */
687  BLURAY_PLAYER_SETTING_MENU_LANG = 18, /* Initial menu language. String (ISO 639-2/T). */
688  BLURAY_PLAYER_SETTING_COUNTRY_CODE = 19, /* Player country code. String (ISO 3166-1/alpha-2). */
689  BLURAY_PLAYER_SETTING_REGION_CODE = 20, /* Player region code. Integer. */
690  BLURAY_PLAYER_SETTING_OUTPUT_PREFER = 21, /* Output mode preference. Integer. */
691  BLURAY_PLAYER_SETTING_PARENTAL = 13, /* Age for parental control. Integer. */
692  BLURAY_PLAYER_SETTING_AUDIO_CAP = 15, /* Audio capability. Bit mask. */
693  BLURAY_PLAYER_SETTING_VIDEO_CAP = 29, /* Video capability. Bit mask. */
694  BLURAY_PLAYER_SETTING_DISPLAY_CAP = 23, /* Display capability. Bit mask. */
695  BLURAY_PLAYER_SETTING_3D_CAP = 24, /* 3D capability. Bit mask. */
696  BLURAY_PLAYER_SETTING_UHD_CAP = 25, /* UHD capability. */
697  BLURAY_PLAYER_SETTING_UHD_DISPLAY_CAP = 26, /* UHD display capability. */
698  BLURAY_PLAYER_SETTING_HDR_PREFERENCE = 27, /* HDR preference. */
699  BLURAY_PLAYER_SETTING_SDR_CONV_PREFER = 28, /* SDR conversion preference. */
700  BLURAY_PLAYER_SETTING_TEXT_CAP = 30, /* Text Subtitle capability. Bit mask. */
701  BLURAY_PLAYER_SETTING_PLAYER_PROFILE = 31, /* Player profile and version. */
702 
703  BLURAY_PLAYER_SETTING_DECODE_PG = 0x100, /* Enable/disable PG (subtitle) decoder. Integer. Default: disabled. */
704  BLURAY_PLAYER_SETTING_PERSISTENT_STORAGE = 0x101, /* Enable/disable BD-J persistent storage. Integer. Default: enabled. */
705 
706  BLURAY_PLAYER_PERSISTENT_ROOT = 0x200, /* Root path to the BD_J persistent storage location. String. */
707  BLURAY_PLAYER_CACHE_ROOT = 0x201, /* Root path to the BD_J cache storage location. String. */
708  BLURAY_PLAYER_JAVA_HOME = 0x202, /* Location of JRE. String. Default: NULL (autodetect). */
709 } bd_player_setting;
710 
723 int bd_set_player_setting(BLURAY *bd, uint32_t idx, uint32_t value);
724 int bd_set_player_setting_str(BLURAY *bd, uint32_t idx, const char *value);
725 
726 
727 /*
728  * events
729  */
730 
731 typedef enum {
732 
733  BD_EVENT_NONE = 0, /* no pending events */
734 
735  /*
736  * errors
737  */
738 
739  BD_EVENT_ERROR = 1, /* Fatal error. Playback can't be continued. */
740  BD_EVENT_READ_ERROR = 2, /* Reading of .m2ts aligned unit failed. Next call to read will try next block. */
741  BD_EVENT_ENCRYPTED = 3, /* .m2ts file is encrypted and can't be played */
742 
743  /*
744  * current playback position
745  */
746 
747  BD_EVENT_ANGLE = 4, /* current angle, 1...N */
748  BD_EVENT_TITLE = 5, /* current title, 1...N (0 = top menu) */
749  BD_EVENT_PLAYLIST = 6, /* current playlist (xxxxx.mpls) */
750  BD_EVENT_PLAYITEM = 7, /* current play item, 0...N-1 */
751  BD_EVENT_CHAPTER = 8, /* current chapter, 1...N */
752  BD_EVENT_PLAYMARK = 9, /* playmark reached */
753  BD_EVENT_END_OF_TITLE = 10,
754 
755  /*
756  * stream selection
757  */
758 
759  BD_EVENT_AUDIO_STREAM = 11, /* 1..32, 0xff = none */
760  BD_EVENT_IG_STREAM = 12, /* 1..32 */
761  BD_EVENT_PG_TEXTST_STREAM = 13, /* 1..255, 0xfff = none */
762  BD_EVENT_PIP_PG_TEXTST_STREAM = 14, /* 1..255, 0xfff = none */
763  BD_EVENT_SECONDARY_AUDIO_STREAM = 15, /* 1..32, 0xff = none */
764  BD_EVENT_SECONDARY_VIDEO_STREAM = 16, /* 1..32, 0xff = none */
765 
766  BD_EVENT_PG_TEXTST = 17, /* 0 - disable, 1 - enable */
767  BD_EVENT_PIP_PG_TEXTST = 18, /* 0 - disable, 1 - enable */
768  BD_EVENT_SECONDARY_AUDIO = 19, /* 0 - disable, 1 - enable */
769  BD_EVENT_SECONDARY_VIDEO = 20, /* 0 - disable, 1 - enable */
770  BD_EVENT_SECONDARY_VIDEO_SIZE = 21, /* 0 - PIP, 0xf - fullscreen */
771 
772  /*
773  * playback control
774  */
775 
776  /* HDMV VM or JVM stopped playlist playback. Flush all buffers. */
777  BD_EVENT_PLAYLIST_STOP = 22,
778 
779  /* discontinuity in the stream (non-seamless connection). Reset demuxer PES buffers. */
780  BD_EVENT_DISCONTINUITY = 23, /* new timestamp (45 kHz) */
781 
782  /* HDMV VM or JVM seeked the stream. Next read() will return data from new position. Flush all buffers. */
783  BD_EVENT_SEEK = 24, /* new media time (45 kHz) */
784 
785  /* still playback (pause) */
786  BD_EVENT_STILL = 25, /* 0 - off, 1 - on */
787 
788  /* Still playback for n seconds (reached end of still mode play item).
789  * Playback continues by calling bd_read_skip_still(). */
790  BD_EVENT_STILL_TIME = 26, /* 0 = infinite ; 1...300 = seconds */
791 
792  /* Play sound effect */
793  BD_EVENT_SOUND_EFFECT = 27, /* effect ID */
794 
795  /*
796  * status
797  */
798 
799  /* Nothing to do. Playlist is not playing, but title applet is running.
800  * Application should not call bd_read*() immediately again to avoid busy loop. */
801  BD_EVENT_IDLE = 28,
802 
803  /* Pop-Up menu available */
804  BD_EVENT_POPUP = 29, /* 0 - no, 1 - yes */
805 
806  /* Interactive menu visible */
807  BD_EVENT_MENU = 30, /* 0 - no, 1 - yes */
808 
809  /* 3D */
810  BD_EVENT_STEREOSCOPIC_STATUS = 31, /* 0 - 2D, 1 - 3D */
811 
812  /* BD-J key interest table changed */
813  BD_EVENT_KEY_INTEREST_TABLE = 32, /* bitmask, BLURAY_KIT_* */
814 
815  /* UO mask changed */
816  BD_EVENT_UO_MASK_CHANGED = 33, /* bitmask, BLURAY_UO_* */
817 
818  /*BD_EVENT_LAST = 33, */
819 
820 } bd_event_e;
821 
822 typedef struct {
823  uint32_t event; /* bd_event_e */
824  uint32_t param;
825 } BD_EVENT;
826 
827 /* BD_EVENT_ERROR param values */
828 #define BD_ERROR_HDMV 1
829 #define BD_ERROR_BDJ 2
830 
831 /* BD_EVENT_ENCRYPTED param vlues */
832 #define BD_ERROR_AACS 3
833 #define BD_ERROR_BDPLUS 4
834 
835 /* BD_EVENT_TITLE special titles */
836 #define BLURAY_TITLE_FIRST_PLAY 0xffff
837 #define BLURAY_TITLE_TOP_MENU 0
838 
839 /* BD_EVENT_KEY_INTEREST flags */
840 #define BLURAY_KIT_PLAY 0x1
841 #define BLURAY_KIT_STOP 0x2
842 #define BLURAY_KIT_FFW 0x4
843 #define BLURAY_KIT_REW 0x8
844 #define BLURAY_KIT_TRACK_NEXT 0x10
845 #define BLURAY_KIT_TRACK_PREV 0x20
846 #define BLURAY_KIT_PAUSE 0x40
847 #define BLURAY_KIT_STILL_OFF 0x80
848 #define BLURAY_KIT_SEC_AUDIO 0x100
849 #define BLURAY_KIT_SEC_VIDEO 0x200
850 #define BLURAY_KIT_PG_TEXTST 0x400
851 
852 /* BD_EVENT_UO_MASK flags */
853 #define BLURAY_UO_MENU_CALL 0x1
854 #define BLURAY_UO_TITLE_SEARCH 0x2
855 
864 int bd_get_event(BLURAY *bd, BD_EVENT *event);
865 
866 const char *bd_event_name(uint32_t /* bd_event_e */ event);
867 
868 /*
869  * On-screen display
870  */
871 
872 struct bd_overlay_s; /* defined in overlay.h */
873 struct bd_argb_overlay_s; /* defined in overlay.h */
874 struct bd_argb_buffer_s; /* defined in overlay.h */
875 typedef void (*bd_overlay_proc_f)(void *, const struct bd_overlay_s * const);
876 typedef void (*bd_argb_overlay_proc_f)(void *, const struct bd_argb_overlay_s * const);
877 
897 void bd_register_overlay_proc(BLURAY *bd, void *handle, bd_overlay_proc_f func);
898 
914 void bd_register_argb_overlay_proc(BLURAY *bd, void *handle, bd_argb_overlay_proc_f func, struct bd_argb_buffer_s *buf);
915 
916 
917 /*
918  * Playback with on-disc menus
919  */
920 
930 int bd_play(BLURAY *bd);
931 
944 int bd_play_title(BLURAY *bd, unsigned title);
945 
956 int bd_menu_call(BLURAY *bd, int64_t pts);
957 
970 int bd_read_ext(BLURAY *bd, unsigned char *buf, int len, BD_EVENT *event);
971 
979 int bd_read_skip_still(BLURAY *bd);
980 
990 BLURAY_TITLE_INFO* bd_get_playlist_info(BLURAY *bd, uint32_t playlist, unsigned angle);
991 
1001 int bd_get_sound_effect(BLURAY *bd, unsigned sound_id, struct bd_sound_effect *effect);
1002 
1003 
1004 /*
1005  * User interaction
1006  */
1007 
1015 void bd_set_scr(BLURAY *bd, int64_t pts);
1016 
1030 #define BLURAY_RATE_PAUSED 0
1031 #define BLURAY_RATE_NORMAL 90000
1032 int bd_set_rate(BLURAY *bd, uint32_t rate);
1033 
1049 int bd_user_input(BLURAY *bd, int64_t pts, uint32_t key);
1050 
1063 int bd_mouse_select(BLURAY *bd, int64_t pts, uint16_t x, uint16_t y);
1064 
1065 
1066 /*
1067  * Testing and debugging
1068  */
1069 
1070 /* access to internal information */
1071 
1080 struct clpi_cl *bd_get_clpi(BLURAY *bd, unsigned clip_ref);
1081 struct clpi_cl *bd_read_clpi(const char *clpi_file);
1082 
1089 void bd_free_clpi(struct clpi_cl *cl);
1090 
1091 
1092 struct mpls_pl;
1093 struct mpls_pl *bd_read_mpls(const char *mpls_file);
1094 void bd_free_mpls(struct mpls_pl *);
1095 
1096 struct mobj_objects;
1097 struct mobj_objects *bd_read_mobj(const char *mobj_file);
1098 void bd_free_mobj(struct mobj_objects *);
1099 
1100 struct bdjo_data;
1101 struct bdjo_data *bd_read_bdjo(const char *bdjo_file);
1102 void bd_free_bdjo(struct bdjo_data *);
1103 
1104 /* BD-J testing */
1105 
1106 int bd_start_bdj(BLURAY *bd, const char* start_object); // start BD-J from the specified BD-J object (should be a 5 character string)
1107 void bd_stop_bdj(BLURAY *bd); // shutdown BD-J and clean up resources
1108 
1122 int bd_read_file(BLURAY *, const char *path, void **data, int64_t *size);
1123 
1141 struct bd_dir_s *bd_open_dir(BLURAY *, const char *dir);
1142 struct bd_file_s *bd_open_file_dec(BLURAY *, const char *path);
1143 
1155 int bd_get_clip_infos(BLURAY *bd, unsigned clip, uint64_t *clip_start_time, uint64_t *stream_start_time, uint64_t *pos, uint64_t *duration);
1156 
1165 struct mpls_pl* bd_get_title_mpls(BLURAY * bd);
1166 
1167 #ifdef __cplusplus
1168 }
1169 #endif
1170 
1171 #endif /* BLURAY_H_ */
int64_t bd_chapter_pos(BLURAY *bd, unsigned chapter)
void bd_set_scr(BLURAY *bd, int64_t pts)
int64_t bd_seek_mark(BLURAY *bd, unsigned mark)
const BLURAY_DISC_INFO * bd_get_disc_info(BLURAY *bd)
int bd_read_file(BLURAY *, const char *path, void **data, int64_t *size)
BLURAY_TITLE_INFO * bd_get_title_info(BLURAY *bd, uint32_t title_idx, unsigned angle)
uint64_t bd_get_title_size(BLURAY *bd)
struct mpls_pl * bd_get_title_mpls(BLURAY *bd)
int64_t bd_find_seek_point(BLURAY *bd, uint64_t tick)
struct bd_dir_s * bd_open_dir(BLURAY *, const char *dir)
int64_t bd_seek_playitem(BLURAY *bd, unsigned clip_ref)
int64_t bd_seek_time(BLURAY *bd, uint64_t tick)
uint32_t bd_get_current_title(BLURAY *bd)
void bd_free_clpi(struct clpi_cl *cl)
int bd_get_event(BLURAY *bd, BD_EVENT *event)
int bd_read_skip_still(BLURAY *bd)
void bd_free_title_info(BLURAY_TITLE_INFO *title_info)
BLURAY_TITLE_INFO * bd_get_playlist_info(BLURAY *bd, uint32_t playlist, unsigned angle)
int bd_get_main_title(BLURAY *bd)
BLURAY * bd_open(const char *device_path, const char *keyfile_path)
int bd_read_ext(BLURAY *bd, unsigned char *buf, int len, BD_EVENT *event)
int bd_read(BLURAY *bd, unsigned char *buf, int len)
struct clpi_cl * bd_get_clpi(BLURAY *bd, unsigned clip_ref)
uint32_t bd_get_titles(BLURAY *bd, uint8_t flags, uint32_t min_title_length)
unsigned bd_get_current_angle(BLURAY *bd)
void bd_close(BLURAY *bd)
void bd_seamless_angle_change(BLURAY *bd, unsigned angle)
int bd_select_angle(BLURAY *bd, unsigned angle)
int bd_set_player_setting(BLURAY *bd, uint32_t idx, uint32_t value)
int bd_play(BLURAY *bd)
int64_t bd_seek_chapter(BLURAY *bd, unsigned chapter)
int bd_open_disc(BLURAY *bd, const char *device_path, const char *keyfile_path)
uint32_t bd_get_current_chapter(BLURAY *bd)
int bd_get_clip_infos(BLURAY *bd, unsigned clip, uint64_t *clip_start_time, uint64_t *stream_start_time, uint64_t *pos, uint64_t *duration)
void bd_register_overlay_proc(BLURAY *bd, void *handle, bd_overlay_proc_f func)
int bd_select_title(BLURAY *bd, uint32_t title)
uint64_t bd_tell(BLURAY *bd)
int bd_get_meta_file(BLURAY *bd, const char *file_name, void **data, int64_t *size)
int64_t bd_seek(BLURAY *bd, uint64_t pos)
void bd_get_version(int *major, int *minor, int *micro)
int bd_user_input(BLURAY *bd, int64_t pts, uint32_t key)
int bd_select_playlist(BLURAY *bd, uint32_t playlist)
int bd_open_stream(BLURAY *bd, void *read_blocks_handle, int(*read_blocks)(void *handle, void *buf, int lba, int num_blocks))
void bd_register_argb_overlay_proc(BLURAY *bd, void *handle, bd_argb_overlay_proc_f func, struct bd_argb_buffer_s *buf)
BLURAY * bd_init(void)
uint64_t bd_tell_time(BLURAY *bd)
int bd_menu_call(BLURAY *bd, int64_t pts)
int bd_play_title(BLURAY *bd, unsigned title)
int bd_mouse_select(BLURAY *bd, int64_t pts, uint16_t x, uint16_t y)
int bd_get_sound_effect(BLURAY *bd, unsigned sound_id, struct bd_sound_effect *effect)
Definition: bluray.h:822
Definition: bluray.h:70
Definition: bluray.h:60
Definition: bluray.h:260
Definition: bluray.h:236
Definition: bluray.h:268
Definition: bluray.h:296
Definition: bluray.h:225
Definition: bluray.h:277