libbluray
 All Classes Files Functions Macros
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 hpi1
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 
36 #define TITLES_ALL 0
37 #define TITLES_FILTER_DUP_TITLE 0x01
38 #define TITLES_FILTER_DUP_CLIP 0x02
40 #define TITLES_RELEVANT \
41  (TITLES_FILTER_DUP_TITLE | TITLES_FILTER_DUP_CLIP)
44 typedef struct bluray BLURAY;
45 
46 typedef enum {
47  BLURAY_STREAM_TYPE_VIDEO_MPEG1 = 0x01,
48  BLURAY_STREAM_TYPE_VIDEO_MPEG2 = 0x02,
49  BLURAY_STREAM_TYPE_AUDIO_MPEG1 = 0x03,
50  BLURAY_STREAM_TYPE_AUDIO_MPEG2 = 0x04,
51  BLURAY_STREAM_TYPE_AUDIO_LPCM = 0x80,
52  BLURAY_STREAM_TYPE_AUDIO_AC3 = 0x81,
53  BLURAY_STREAM_TYPE_AUDIO_DTS = 0x82,
54  BLURAY_STREAM_TYPE_AUDIO_TRUHD = 0x83,
55  BLURAY_STREAM_TYPE_AUDIO_AC3PLUS = 0x84,
56  BLURAY_STREAM_TYPE_AUDIO_DTSHD = 0x85,
57  BLURAY_STREAM_TYPE_AUDIO_DTSHD_MASTER = 0x86,
58  BLURAY_STREAM_TYPE_VIDEO_VC1 = 0xea,
59  BLURAY_STREAM_TYPE_VIDEO_H264 = 0x1b,
60  BLURAY_STREAM_TYPE_SUB_PG = 0x90,
61  BLURAY_STREAM_TYPE_SUB_IG = 0x91,
62  BLURAY_STREAM_TYPE_SUB_TEXT = 0x92,
63  BLURAY_STREAM_TYPE_AUDIO_AC3PLUS_SECONDARY = 0xa1,
64  BLURAY_STREAM_TYPE_AUDIO_DTSHD_SECONDARY = 0xa2
65 } bd_stream_type_e;
66 
67 typedef enum {
68  BLURAY_VIDEO_FORMAT_480I = 1, // ITU-R BT.601-5
69  BLURAY_VIDEO_FORMAT_576I = 2, // ITU-R BT.601-4
70  BLURAY_VIDEO_FORMAT_480P = 3, // SMPTE 293M
71  BLURAY_VIDEO_FORMAT_1080I = 4, // SMPTE 274M
72  BLURAY_VIDEO_FORMAT_720P = 5, // SMPTE 296M
73  BLURAY_VIDEO_FORMAT_1080P = 6, // SMPTE 274M
74  BLURAY_VIDEO_FORMAT_576P = 7 // ITU-R BT.1358
75 } bd_video_format_e;
76 
77 typedef enum {
78  BLURAY_VIDEO_RATE_24000_1001 = 1, // 23.976
79  BLURAY_VIDEO_RATE_24 = 2,
80  BLURAY_VIDEO_RATE_25 = 3,
81  BLURAY_VIDEO_RATE_30000_1001 = 4, // 29.97
82  BLURAY_VIDEO_RATE_50 = 6,
83  BLURAY_VIDEO_RATE_60000_1001 = 7 // 59.94
84 } bd_video_rate_e;
85 
86 typedef enum {
87  BLURAY_ASPECT_RATIO_4_3 = 2,
88  BLURAY_ASPECT_RATIO_16_9 = 3
89 } bd_video_aspect_e;
90 
91 typedef enum {
92  BLURAY_AUDIO_FORMAT_MONO = 1,
93  BLURAY_AUDIO_FORMAT_STEREO = 3,
94  BLURAY_AUDIO_FORMAT_MULTI_CHAN = 6,
95  BLURAY_AUDIO_FORMAT_COMBO = 12 // Stereo ac3/dts,
96 } bd_audio_format_e;
97  // multi mlp/dts-hd
98 
99 typedef enum {
100  BLURAY_AUDIO_RATE_48 = 1,
101  BLURAY_AUDIO_RATE_96 = 4,
102  BLURAY_AUDIO_RATE_192 = 5,
103  BLURAY_AUDIO_RATE_192_COMBO = 12, // 48 or 96 ac3/dts
104  // 192 mpl/dts-hd
105  BLURAY_AUDIO_RATE_96_COMBO = 14 // 48 ac3/dts
106  // 96 mpl/dts-hd
107 } bd_audio_rate_e;
108 
109 typedef enum {
110  BLURAY_TEXT_CHAR_CODE_UTF8 = 0x01,
111  BLURAY_TEXT_CHAR_CODE_UTF16BE = 0x02,
112  BLURAY_TEXT_CHAR_CODE_SHIFT_JIS = 0x03,
113  BLURAY_TEXT_CHAR_CODE_EUC_KR = 0x04,
114  BLURAY_TEXT_CHAR_CODE_GB18030_20001 = 0x05,
115  BLURAY_TEXT_CHAR_CODE_CN_GB = 0x06,
116  BLURAY_TEXT_CHAR_CODE_BIG5 = 0x07
117 } bd_char_code_e;
118 
119 typedef enum {
120  BLURAY_STILL_NONE = 0x00,
121  BLURAY_STILL_TIME = 0x01,
122  BLURAY_STILL_INFINITE = 0x02,
123 } bd_still_mode_e;
124 
125 typedef struct bd_stream_info {
126  uint8_t coding_type;
127  uint8_t format;
128  uint8_t rate;
129  uint8_t char_code;
130  uint8_t lang[4];
131  uint16_t pid;
132  uint8_t aspect;
133  uint8_t subpath_id;
135 
136 typedef struct bd_clip {
137  uint32_t pkt_count;
138  uint8_t still_mode;
139  uint16_t still_time; /* seconds */
140  uint8_t video_stream_count;
141  uint8_t audio_stream_count;
142  uint8_t pg_stream_count;
143  uint8_t ig_stream_count;
144  uint8_t sec_audio_stream_count;
145  uint8_t sec_video_stream_count;
146  BLURAY_STREAM_INFO *video_streams;
147  BLURAY_STREAM_INFO *audio_streams;
148  BLURAY_STREAM_INFO *pg_streams;
149  BLURAY_STREAM_INFO *ig_streams;
150  BLURAY_STREAM_INFO *sec_audio_streams;
151  BLURAY_STREAM_INFO *sec_video_streams;
152 
153  uint64_t start_time;
154  uint64_t in_time;
155  uint64_t out_time;
157 
158 typedef struct bd_chapter {
159  uint32_t idx;
160  uint64_t start;
161  uint64_t duration;
162  uint64_t offset;
163  unsigned clip_ref;
165 
166 typedef struct bd_mark {
167  uint32_t idx;
168  int type;
169  uint64_t start;
170  uint64_t duration;
171  uint64_t offset;
172  unsigned clip_ref;
174 
175 typedef struct bd_title_info {
176  uint32_t idx;
177  uint32_t playlist;
178  uint64_t duration;
179  uint32_t clip_count;
180  uint8_t angle_count;
181  uint32_t chapter_count;
182  BLURAY_CLIP_INFO *clips;
183  BLURAY_TITLE_CHAPTER *chapters;
184 
185  uint32_t mark_count;
186  BLURAY_TITLE_MARK *marks;
188 
189 typedef struct bd_sound_effect {
190  uint8_t num_channels; /* 1 - mono, 2 - stereo */
191  uint32_t num_frames;
192  const int16_t *samples; /* 48000 Hz, 16 bit LPCM. interleaved if stereo */
194 
199 void bd_get_version(int *major, int *minor, int *micro);
200 
212 uint32_t bd_get_titles(BLURAY *bd, uint8_t flags, uint32_t min_title_length);
213 
223 BLURAY_TITLE_INFO* bd_get_title_info(BLURAY *bd, uint32_t title_idx, unsigned angle);
224 
234 BLURAY_TITLE_INFO* bd_get_playlist_info(BLURAY *bd, uint32_t playlist, unsigned angle);
235 
242 void bd_free_title_info(BLURAY_TITLE_INFO *title_info);
243 
251 BLURAY *bd_open(const char* device_path, const char* keyfile_path);
252 
258 void bd_close(BLURAY *bd);
259 
267 int64_t bd_seek(BLURAY *bd, uint64_t pos);
268 
277 int64_t bd_seek_time(BLURAY *bd, uint64_t tick);
278 
288 int bd_read(BLURAY *bd, unsigned char *buf, int len);
289 
297 int bd_read_skip_still(BLURAY *bd);
298 
307 int64_t bd_seek_chapter(BLURAY *bd, unsigned chapter);
308 
317 int64_t bd_chapter_pos(BLURAY *bd, unsigned chapter);
318 
326 uint32_t bd_get_current_chapter(BLURAY *bd);
327 
336 int64_t bd_seek_mark(BLURAY *bd, unsigned mark);
337 
346 int64_t bd_seek_playitem(BLURAY *bd, unsigned clip_ref);
347 
356 int bd_select_playlist(BLURAY *bd, uint32_t playlist);
357 
366 int bd_select_title(BLURAY *bd, uint32_t title);
367 
376 int bd_select_angle(BLURAY *bd, unsigned angle);
377 
385 void bd_seamless_angle_change(BLURAY *bd, unsigned angle);
386 
396 uint64_t bd_get_title_size(BLURAY *bd);
397 
405 uint32_t bd_get_current_title(BLURAY *bd);
406 
414 unsigned bd_get_current_angle(BLURAY *bd);
415 
423 uint64_t bd_tell(BLURAY *bd);
424 
432 uint64_t bd_tell_time(BLURAY *bd);
433 
434 /*
435  * Disc info
436  */
437 
438 /* AACS error codes */
439 #define BD_AACS_CORRUPTED_DISC -1
440 #define BD_AACS_NO_CONFIG -2
441 #define BD_AACS_NO_PK -3
442 #define BD_AACS_NO_CERT -4
443 #define BD_AACS_CERT_REVOKED -5
444 #define BD_AACS_MMC_FAILED -6
445 
446 typedef struct {
447  uint8_t bluray_detected;
449  uint8_t first_play_supported;
450  uint8_t top_menu_supported;
451 
452  uint32_t num_hdmv_titles;
453  uint32_t num_bdj_titles;
454  uint32_t num_unsupported_titles;
455 
456  uint8_t aacs_detected;
457  uint8_t libaacs_detected;
458  uint8_t aacs_handled;
459 
460  uint8_t bdplus_detected;
461  uint8_t libbdplus_detected;
462  uint8_t bdplus_handled;
463 
464  /* aacs error code */
465  int aacs_error_code;
466  /* aacs MKB version */
467  int aacs_mkbv;
468 
469  /* Disc ID */
470  uint8_t disc_id[20];
471 
473 
481 const BLURAY_DISC_INFO *bd_get_disc_info(BLURAY*);
482 
483 /*
484  * player settings
485  */
486 
487 typedef enum {
488  BLURAY_PLAYER_SETTING_PARENTAL = 13, /* Age for parental control (years) */
489  BLURAY_PLAYER_SETTING_AUDIO_CAP = 15, /* Player capability for audio (bit mask) */
490  BLURAY_PLAYER_SETTING_AUDIO_LANG = 16, /* Initial audio language: ISO 639-2 string, ex. "eng" */
491  BLURAY_PLAYER_SETTING_PG_LANG = 17, /* Initial PG/SPU language: ISO 639-2 string, ex. "eng" */
492  BLURAY_PLAYER_SETTING_MENU_LANG = 18, /* Initial menu language: ISO 639-2 string, ex. "eng" */
493  BLURAY_PLAYER_SETTING_COUNTRY_CODE = 19, /* Player country code: ISO 3166-1 string, ex. "de" */
494  BLURAY_PLAYER_SETTING_REGION_CODE = 20, /* Player region code: 1 - region A, 2 - B, 4 - C */
495  BLURAY_PLAYER_SETTING_OUTPUT_PREFER = 21, /* output mode preference: 0 - 2D, 1 - 3D */
496  BLURAY_PLAYER_SETTING_DISPLAY_CAP = 23, /* Display capability (bit mask) */
497  BLURAY_PLAYER_SETTING_3D_CAP = 24, /* 3D capability (bit mask) */
498  BLURAY_PLAYER_SETTING_VIDEO_CAP = 29, /* Player capability for video (bit mask) */
499  BLURAY_PLAYER_SETTING_TEXT_CAP = 30, /* Player capability for text subtitle (bit mask) */
500  BLURAY_PLAYER_SETTING_PLAYER_PROFILE = 31, /* Profile1: 0, Profile1+: 1, Profile2: 3, Profile3: 8 */
501 
502  BLURAY_PLAYER_SETTING_DECODE_PG = 0x100, /* enable/disable PG (subtitle) decoder */
503 } bd_player_setting;
504 
515 int bd_set_player_setting(BLURAY *bd, uint32_t idx, uint32_t value);
516 int bd_set_player_setting_str(BLURAY *bd, uint32_t idx, const char *s);
517 
518 /*
519  * Java
520  */
521 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)
522 void bd_stop_bdj(BLURAY *bd); // shutdown BD-J and clean up resources
523 
524 /*
525  * events
526  */
527 
528 typedef enum {
529 
530  BD_EVENT_NONE = 0, /* no pending events */
531 
532  /*
533  * errors
534  */
535 
536  BD_EVENT_ERROR = 1, /* Fatal error. Playback can't be continued. */
537  BD_EVENT_READ_ERROR = 2, /* Reading of .m2ts aligned unit failed. Next call to read will try next block. */
538  BD_EVENT_ENCRYPTED = 3, /* .m2ts file is encrypted and can't be played */
539 
540  /*
541  * current playback position
542  */
543 
544  BD_EVENT_ANGLE = 4, /* current angle, 1...N */
545  BD_EVENT_TITLE = 5, /* current title, 1...N (0 = top menu) */
546  BD_EVENT_PLAYLIST = 6, /* current playlist (xxxxx.mpls) */
547  BD_EVENT_PLAYITEM = 7, /* current play item, 0...N-1 */
548  BD_EVENT_CHAPTER = 8, /* current chapter, 1...N */
549  BD_EVENT_PLAYMARK = 30, /* playmark reached */
550  BD_EVENT_END_OF_TITLE = 9,
551 
552  /*
553  * stream selection
554  */
555 
556  BD_EVENT_AUDIO_STREAM = 10, /* 1..32, 0xff = none */
557  BD_EVENT_IG_STREAM = 11, /* 1..32 */
558  BD_EVENT_PG_TEXTST_STREAM = 12, /* 1..255, 0xfff = none */
559  BD_EVENT_PIP_PG_TEXTST_STREAM = 13, /* 1..255, 0xfff = none */
560  BD_EVENT_SECONDARY_AUDIO_STREAM = 14, /* 1..32, 0xff = none */
561  BD_EVENT_SECONDARY_VIDEO_STREAM = 15, /* 1..32, 0xff = none */
562 
563  BD_EVENT_PG_TEXTST = 16, /* 0 - disable, 1 - enable */
564  BD_EVENT_PIP_PG_TEXTST = 17, /* 0 - disable, 1 - enable */
565  BD_EVENT_SECONDARY_AUDIO = 18, /* 0 - disable, 1 - enable */
566  BD_EVENT_SECONDARY_VIDEO = 19, /* 0 - disable, 1 - enable */
567  BD_EVENT_SECONDARY_VIDEO_SIZE = 20, /* 0 - PIP, 0xf - fullscreen */
568 
569  /*
570  * playback control
571  */
572 
573  /* discontinuity in the stream (non-seamless connection). Reset demuxer PES buffers. */
574  BD_EVENT_DISCONTINUITY = 28, /* new timestamp (45 kHz) */
575 
576  /* HDMV VM or JVM seeked the stream. Next read() will return data from new position. Flush all buffers. */
577  BD_EVENT_SEEK = 21,
578 
579  /* still playback (pause) */
580  BD_EVENT_STILL = 22, /* 0 - off, 1 - on */
581 
582  /* Still playback for n seconds (reached end of still mode play item).
583  * Playback continues by calling bd_read_skip_still(). */
584  BD_EVENT_STILL_TIME = 23, /* 0 = infinite ; 1...300 = seconds */
585 
586  /* Play sound effect */
587  BD_EVENT_SOUND_EFFECT = 24, /* effect ID */
588 
589  /*
590  * status
591  */
592 
593  /* Nothing to do. Playlist is not playing, but title applet is running. */
594  BD_EVENT_IDLE = 29,
595 
596  /* Pop-Up menu available */
597  BD_EVENT_POPUP = 25, /* 0 - no, 1 - yes */
598 
599  /* Interactive menu visible */
600  BD_EVENT_MENU = 26, /* 0 - no, 1 - yes */
601 
602  /* 3D */
603  BD_EVENT_STEREOSCOPIC_STATUS = 27, /* 0 - 2D, 1 - 3D */
604 
605  /*BD_EVENT_LAST = 30, */
606 
607 } bd_event_e;
608 
609 typedef struct {
610  uint32_t event; /* bd_event_e */
611  uint32_t param;
612 } BD_EVENT;
613 
614 #define BLURAY_TITLE_FIRST_PLAY 0xffff
615 #define BLURAY_TITLE_TOP_MENU 0
616 
624 int bd_get_event(BLURAY *bd, BD_EVENT *event);
625 
626 /*
627  * navigaton mode
628  */
629 
639 int bd_play(BLURAY *bd);
640 
653 int bd_read_ext(BLURAY *bd, unsigned char *buf, int len, BD_EVENT *event);
654 
667 int bd_play_title(BLURAY *bd, unsigned title);
668 
679 int bd_menu_call(BLURAY *bd, int64_t pts);
680 
681 /*
682  * User interaction and On-screen display controller
683  */
684 
685 struct bd_overlay_s; /* defined in overlay.h */
686 struct bd_argb_overlay_s; /* defined in overlay.h */
687 struct bd_argb_buffer_s; /* defined in overlay.h */
688 typedef void (*bd_overlay_proc_f)(void *, const struct bd_overlay_s * const);
689 typedef void (*bd_argb_overlay_proc_f)(void *, const struct bd_argb_overlay_s * const);
690 
691 
710 void bd_register_overlay_proc(BLURAY *bd, void *handle, bd_overlay_proc_f func);
711 
727 void bd_register_argb_overlay_proc(BLURAY *bd, void *handle, bd_argb_overlay_proc_f func, struct bd_argb_buffer_s *buf);
728 
736 void bd_set_scr(BLURAY *bd, int64_t pts);
737 
749 int bd_user_input(BLURAY *bd, int64_t pts, uint32_t key);
750 
761 int bd_mouse_select(BLURAY *bd, int64_t pts, uint16_t x, uint16_t y);
762 
772 int bd_get_sound_effect(BLURAY *bd, unsigned sound_id, struct bd_sound_effect *effect);
773 
774 /*
775  *
776  */
777 
778 struct meta_dl;
786 const struct meta_dl *bd_get_meta(BLURAY *bd);
787 
788 
789 struct clpi_cl;
798 struct clpi_cl *bd_get_clpi(BLURAY *bd, unsigned clip_ref);
799 
806 void bd_free_clpi(struct clpi_cl *cl);
807 
808 #ifdef __cplusplus
809 };
810 #endif
811 
812 #endif /* BLURAY_H_ */
uint32_t bd_get_current_chapter(BLURAY *bd)
void bd_set_scr(BLURAY *bd, int64_t pts)
void bd_register_overlay_proc(BLURAY *bd, void *handle, bd_overlay_proc_f func)
int bd_user_input(BLURAY *bd, int64_t pts, uint32_t key)
int64_t bd_chapter_pos(BLURAY *bd, unsigned chapter)
int bd_read_ext(BLURAY *bd, unsigned char *buf, int len, BD_EVENT *event)
Definition: bluray.h:177
BLURAY * bd_open(const char *device_path, const char *keyfile_path)
int bd_select_title(BLURAY *bd, uint32_t title)
int64_t bd_seek_mark(BLURAY *bd, unsigned mark)
Definition: bluray.h:168
unsigned bd_get_current_angle(BLURAY *bd)
uint32_t bd_get_current_title(BLURAY *bd)
void bd_register_argb_overlay_proc(BLURAY *bd, void *handle, bd_argb_overlay_proc_f func, struct bd_argb_buffer_s *buf)
int bd_play_title(BLURAY *bd, unsigned title)
int bd_select_angle(BLURAY *bd, unsigned angle)
void bd_close(BLURAY *bd)
Definition: bluray.h:138
uint64_t bd_get_title_size(BLURAY *bd)
struct clpi_cl * bd_get_clpi(BLURAY *bd, unsigned clip_ref)
struct meta_dl * bd_get_meta(BLURAY *bd)
Definition: bluray.h:191
Definition: bluray.h:448
int bd_set_player_setting(BLURAY *bd, uint32_t idx, uint32_t value)
int bd_menu_call(BLURAY *bd, int64_t pts)
Definition: bluray.h:127
BLURAY_TITLE_INFO * bd_get_title_info(BLURAY *bd, uint32_t title_idx, unsigned angle)
uint64_t bd_tell(BLURAY *bd)
int bd_read_skip_still(BLURAY *bd)
int bd_read(BLURAY *bd, unsigned char *buf, int len)
int64_t bd_seek_playitem(BLURAY *bd, unsigned clip_ref)
uint32_t bd_get_titles(BLURAY *bd, uint8_t flags, uint32_t min_title_length)
BLURAY_TITLE_INFO * bd_get_playlist_info(BLURAY *bd, uint32_t playlist, unsigned angle)
int bd_play(BLURAY *bd)
Definition: bluray.h:160
uint64_t bd_tell_time(BLURAY *bd)
void bd_seamless_angle_change(BLURAY *bd, unsigned angle)
int bd_get_sound_effect(BLURAY *bd, unsigned sound_id, struct bd_sound_effect *effect)
int64_t bd_seek(BLURAY *bd, uint64_t pos)
void bd_get_version(int *major, int *minor, int *micro)
int bd_select_playlist(BLURAY *bd, uint32_t playlist)
const BLURAY_DISC_INFO * bd_get_disc_info(BLURAY *)
int bd_get_event(BLURAY *bd, BD_EVENT *event)
void bd_free_title_info(BLURAY_TITLE_INFO *title_info)
void bd_free_clpi(struct clpi_cl *cl)
int bd_mouse_select(BLURAY *bd, int64_t pts, uint16_t x, uint16_t y)
Definition: bluray.h:611
int64_t bd_seek_chapter(BLURAY *bd, unsigned chapter)
int64_t bd_seek_time(BLURAY *bd, uint64_t tick)