1.7.1Copyright © 2010 John Stebbins et al.
This documentation is licensed and distributed under the Creative Commons Attribution-ShareAlike 3.0 Unported License.
00001 /* 00002 * This file is part of libbluray 00003 * Copyright (C) 2009-2010 Obliter0n 00004 * Copyright (C) 2009-2010 John Stebbins 00005 * Copyright (C) 2010 hpi1 00006 * 00007 * This library is free software; you can redistribute it and/or 00008 * modify it under the terms of the GNU Lesser General Public 00009 * License as published by the Free Software Foundation; either 00010 * version 2.1 of the License, or (at your option) any later version. 00011 * 00012 * This library is distributed in the hope that it will be useful, 00013 * but WITHOUT ANY WARRANTY; without even the implied warranty of 00014 * MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the GNU 00015 * Lesser General Public License for more details. 00016 * 00017 * You should have received a copy of the GNU Lesser General Public 00018 * License along with this library. If not, see 00019 * <http://www.gnu.org/licenses/>. 00020 */ 00021 00022 #ifndef BLURAY_H_ 00023 #define BLURAY_H_ 00024 00025 #ifdef __cplusplus 00026 extern "C" { 00027 #endif 00028 00034 #include <stdint.h> 00035 00036 #define TITLES_ALL 0 00037 #define TITLES_FILTER_DUP_TITLE 0x01 00038 #define TITLES_FILTER_DUP_CLIP 0x02 00040 #define TITLES_RELEVANT \ 00041 (TITLES_FILTER_DUP_TITLE | TITLES_FILTER_DUP_CLIP) 00044 typedef struct bluray BLURAY; 00045 00046 typedef enum { 00047 BLURAY_STREAM_TYPE_VIDEO_MPEG1 = 0x01, 00048 BLURAY_STREAM_TYPE_VIDEO_MPEG2 = 0x02, 00049 BLURAY_STREAM_TYPE_AUDIO_MPEG1 = 0x03, 00050 BLURAY_STREAM_TYPE_AUDIO_MPEG2 = 0x04, 00051 BLURAY_STREAM_TYPE_AUDIO_LPCM = 0x80, 00052 BLURAY_STREAM_TYPE_AUDIO_AC3 = 0x81, 00053 BLURAY_STREAM_TYPE_AUDIO_DTS = 0x82, 00054 BLURAY_STREAM_TYPE_AUDIO_TRUHD = 0x83, 00055 BLURAY_STREAM_TYPE_AUDIO_AC3PLUS = 0x84, 00056 BLURAY_STREAM_TYPE_AUDIO_DTSHD = 0x85, 00057 BLURAY_STREAM_TYPE_AUDIO_DTSHD_MASTER = 0x86, 00058 BLURAY_STREAM_TYPE_VIDEO_VC1 = 0xea, 00059 BLURAY_STREAM_TYPE_VIDEO_H264 = 0x1b, 00060 BLURAY_STREAM_TYPE_SUB_PG = 0x90, 00061 BLURAY_STREAM_TYPE_SUB_IG = 0x91, 00062 BLURAY_STREAM_TYPE_SUB_TEXT = 0x92, 00063 BLURAY_STREAM_TYPE_AUDIO_AC3PLUS_SECONDARY = 0xa1, 00064 BLURAY_STREAM_TYPE_AUDIO_DTSHD_SECONDARY = 0xa2 00065 } bd_stream_type_e; 00066 00067 typedef enum { 00068 BLURAY_VIDEO_FORMAT_480I = 1, // ITU-R BT.601-5 00069 BLURAY_VIDEO_FORMAT_576I = 2, // ITU-R BT.601-4 00070 BLURAY_VIDEO_FORMAT_480P = 3, // SMPTE 293M 00071 BLURAY_VIDEO_FORMAT_1080I = 4, // SMPTE 274M 00072 BLURAY_VIDEO_FORMAT_720P = 5, // SMPTE 296M 00073 BLURAY_VIDEO_FORMAT_1080P = 6, // SMPTE 274M 00074 BLURAY_VIDEO_FORMAT_576P = 7 // ITU-R BT.1358 00075 } bd_video_format_e; 00076 00077 typedef enum { 00078 BLURAY_VIDEO_RATE_24000_1001 = 1, // 23.976 00079 BLURAY_VIDEO_RATE_24 = 2, 00080 BLURAY_VIDEO_RATE_25 = 3, 00081 BLURAY_VIDEO_RATE_30000_1001 = 4, // 29.97 00082 BLURAY_VIDEO_RATE_50 = 6, 00083 BLURAY_VIDEO_RATE_60000_1001 = 7 // 59.94 00084 } bd_video_rate_e; 00085 00086 typedef enum { 00087 BLURAY_ASPECT_RATIO_4_3 = 2, 00088 BLURAY_ASPECT_RATIO_16_9 = 3 00089 } bd_video_aspect_e; 00090 00091 typedef enum { 00092 BLURAY_AUDIO_FORMAT_MONO = 1, 00093 BLURAY_AUDIO_FORMAT_STEREO = 3, 00094 BLURAY_AUDIO_FORMAT_MULTI_CHAN = 6, 00095 BLURAY_AUDIO_FORMAT_COMBO = 12 // Stereo ac3/dts, 00096 } bd_audio_format_e; 00097 // multi mlp/dts-hd 00098 00099 typedef enum { 00100 BLURAY_AUDIO_RATE_48 = 1, 00101 BLURAY_AUDIO_RATE_96 = 4, 00102 BLURAY_AUDIO_RATE_192 = 5, 00103 BLURAY_AUDIO_RATE_192_COMBO = 12, // 48 or 96 ac3/dts 00104 // 192 mpl/dts-hd 00105 BLURAY_AUDIO_RATE_96_COMBO = 14 // 48 ac3/dts 00106 // 96 mpl/dts-hd 00107 } bd_audio_rate_e; 00108 00109 typedef enum { 00110 BLURAY_TEXT_CHAR_CODE_UTF8 = 0x01, 00111 BLURAY_TEXT_CHAR_CODE_UTF16BE = 0x02, 00112 BLURAY_TEXT_CHAR_CODE_SHIFT_JIS = 0x03, 00113 BLURAY_TEXT_CHAR_CODE_EUC_KR = 0x04, 00114 BLURAY_TEXT_CHAR_CODE_GB18030_20001 = 0x05, 00115 BLURAY_TEXT_CHAR_CODE_CN_GB = 0x06, 00116 BLURAY_TEXT_CHAR_CODE_BIG5 = 0x07 00117 } bd_char_code_e; 00118 00119 typedef enum { 00120 BLURAY_STILL_NONE = 0x00, 00121 BLURAY_STILL_TIME = 0x01, 00122 BLURAY_STILL_INFINITE = 0x02, 00123 } bd_still_mode_e; 00124 00125 typedef struct bd_stream_info { 00126 uint8_t coding_type; 00127 uint8_t format; 00128 uint8_t rate; 00129 uint8_t char_code; 00130 uint8_t lang[4]; 00131 uint16_t pid; 00132 uint8_t aspect; 00133 uint8_t subpath_id; 00134 } BLURAY_STREAM_INFO; 00135 00136 typedef struct bd_clip { 00137 uint32_t pkt_count; 00138 uint8_t still_mode; 00139 uint16_t still_time; /* seconds */ 00140 uint8_t video_stream_count; 00141 uint8_t audio_stream_count; 00142 uint8_t pg_stream_count; 00143 uint8_t ig_stream_count; 00144 uint8_t sec_audio_stream_count; 00145 uint8_t sec_video_stream_count; 00146 BLURAY_STREAM_INFO *video_streams; 00147 BLURAY_STREAM_INFO *audio_streams; 00148 BLURAY_STREAM_INFO *pg_streams; 00149 BLURAY_STREAM_INFO *ig_streams; 00150 BLURAY_STREAM_INFO *sec_audio_streams; 00151 BLURAY_STREAM_INFO *sec_video_streams; 00152 00153 uint64_t start_time; 00154 uint64_t in_time; 00155 uint64_t out_time; 00156 } BLURAY_CLIP_INFO; 00157 00158 typedef struct bd_chapter { 00159 uint32_t idx; 00160 uint64_t start; 00161 uint64_t duration; 00162 uint64_t offset; 00163 unsigned clip_ref; 00164 } BLURAY_TITLE_CHAPTER; 00165 00166 typedef struct bd_mark { 00167 uint32_t idx; 00168 int type; 00169 uint64_t start; 00170 uint64_t duration; 00171 uint64_t offset; 00172 unsigned clip_ref; 00173 } BLURAY_TITLE_MARK; 00174 00175 typedef struct bd_title_info { 00176 uint32_t idx; 00177 uint32_t playlist; 00178 uint64_t duration; 00179 uint32_t clip_count; 00180 uint8_t angle_count; 00181 uint32_t chapter_count; 00182 BLURAY_CLIP_INFO *clips; 00183 BLURAY_TITLE_CHAPTER *chapters; 00184 00185 uint32_t mark_count; 00186 BLURAY_TITLE_MARK *marks; 00187 } BLURAY_TITLE_INFO; 00188 00189 typedef struct bd_sound_effect { 00190 uint8_t num_channels; /* 1 - mono, 2 - stereo */ 00191 uint32_t num_frames; 00192 const int16_t *samples; /* 48000 Hz, 16 bit LPCM. interleaved if stereo */ 00193 } BLURAY_SOUND_EFFECT; 00194 00199 void bd_get_version(int *major, int *minor, int *micro); 00200 00212 uint32_t bd_get_titles(BLURAY *bd, uint8_t flags, uint32_t min_title_length); 00213 00223 BLURAY_TITLE_INFO* bd_get_title_info(BLURAY *bd, uint32_t title_idx, unsigned angle); 00224 00234 BLURAY_TITLE_INFO* bd_get_playlist_info(BLURAY *bd, uint32_t playlist, unsigned angle); 00235 00242 void bd_free_title_info(BLURAY_TITLE_INFO *title_info); 00243 00251 BLURAY *bd_open(const char* device_path, const char* keyfile_path); 00252 00258 void bd_close(BLURAY *bd); 00259 00267 int64_t bd_seek(BLURAY *bd, uint64_t pos); 00268 00277 int64_t bd_seek_time(BLURAY *bd, uint64_t tick); 00278 00288 int bd_read(BLURAY *bd, unsigned char *buf, int len); 00289 00297 int bd_read_skip_still(BLURAY *bd); 00298 00307 int64_t bd_seek_chapter(BLURAY *bd, unsigned chapter); 00308 00317 int64_t bd_chapter_pos(BLURAY *bd, unsigned chapter); 00318 00326 uint32_t bd_get_current_chapter(BLURAY *bd); 00327 00336 int64_t bd_seek_mark(BLURAY *bd, unsigned mark); 00337 00346 int64_t bd_seek_playitem(BLURAY *bd, unsigned clip_ref); 00347 00356 int bd_select_playlist(BLURAY *bd, uint32_t playlist); 00357 00366 int bd_select_title(BLURAY *bd, uint32_t title); 00367 00376 int bd_select_angle(BLURAY *bd, unsigned angle); 00377 00385 void bd_seamless_angle_change(BLURAY *bd, unsigned angle); 00386 00396 uint64_t bd_get_title_size(BLURAY *bd); 00397 00405 uint32_t bd_get_current_title(BLURAY *bd); 00406 00414 unsigned bd_get_current_angle(BLURAY *bd); 00415 00423 uint64_t bd_tell(BLURAY *bd); 00424 00432 uint64_t bd_tell_time(BLURAY *bd); 00433 00447 #define BLURAY_PG_TEXTST_STREAM 1 00448 00449 void bd_select_stream(BLURAY *bd, uint32_t stream_type, uint32_t stream_id, uint32_t enable_flag); 00450 00451 /* 00452 * Disc info 00453 */ 00454 00455 /* AACS error codes */ 00456 #define BD_AACS_CORRUPTED_DISC -1 00457 #define BD_AACS_NO_CONFIG -2 00458 #define BD_AACS_NO_PK -3 00459 #define BD_AACS_NO_CERT -4 00460 #define BD_AACS_CERT_REVOKED -5 00461 #define BD_AACS_MMC_FAILED -6 00462 00463 typedef struct { 00464 uint8_t bluray_detected; 00465 00466 uint8_t first_play_supported; 00467 uint8_t top_menu_supported; 00468 00469 uint32_t num_hdmv_titles; 00470 uint32_t num_bdj_titles; 00471 uint32_t num_unsupported_titles; 00472 00473 uint8_t aacs_detected; 00474 uint8_t libaacs_detected; 00475 uint8_t aacs_handled; 00476 00477 uint8_t bdplus_detected; 00478 uint8_t libbdplus_detected; 00479 uint8_t bdplus_handled; 00480 00481 /* aacs error code */ 00482 int aacs_error_code; 00483 /* aacs MKB version */ 00484 int aacs_mkbv; 00485 00486 /* Disc ID */ 00487 uint8_t disc_id[20]; 00488 00489 } BLURAY_DISC_INFO; 00490 00498 const BLURAY_DISC_INFO *bd_get_disc_info(BLURAY*); 00499 00500 /* 00501 * player settings 00502 */ 00503 00504 typedef enum { 00505 BLURAY_PLAYER_SETTING_PARENTAL = 13, /* Age for parental control (years) */ 00506 BLURAY_PLAYER_SETTING_AUDIO_CAP = 15, /* Player capability for audio (bit mask) */ 00507 BLURAY_PLAYER_SETTING_AUDIO_LANG = 16, /* Initial audio language: ISO 639-2 string, ex. "eng" */ 00508 BLURAY_PLAYER_SETTING_PG_LANG = 17, /* Initial PG/SPU language: ISO 639-2 string, ex. "eng" */ 00509 BLURAY_PLAYER_SETTING_MENU_LANG = 18, /* Initial menu language: ISO 639-2 string, ex. "eng" */ 00510 BLURAY_PLAYER_SETTING_COUNTRY_CODE = 19, /* Player country code: ISO 3166-1 string, ex. "de" */ 00511 BLURAY_PLAYER_SETTING_REGION_CODE = 20, /* Player region code: 1 - region A, 2 - B, 4 - C */ 00512 BLURAY_PLAYER_SETTING_OUTPUT_PREFER = 21, /* output mode preference: 0 - 2D, 1 - 3D */ 00513 BLURAY_PLAYER_SETTING_DISPLAY_CAP = 23, /* Display capability (bit mask) */ 00514 BLURAY_PLAYER_SETTING_3D_CAP = 24, /* 3D capability (bit mask) */ 00515 BLURAY_PLAYER_SETTING_VIDEO_CAP = 29, /* Player capability for video (bit mask) */ 00516 BLURAY_PLAYER_SETTING_TEXT_CAP = 30, /* Player capability for text subtitle (bit mask) */ 00517 BLURAY_PLAYER_SETTING_PLAYER_PROFILE = 31, /* Profile1: 0, Profile1+: 1, Profile2: 3, Profile3: 8 */ 00518 00519 BLURAY_PLAYER_SETTING_DECODE_PG = 0x100, /* enable/disable PG (subtitle) decoder */ 00520 } bd_player_setting; 00521 00532 int bd_set_player_setting(BLURAY *bd, uint32_t idx, uint32_t value); 00533 int bd_set_player_setting_str(BLURAY *bd, uint32_t idx, const char *s); 00534 00535 /* 00536 * Java 00537 */ 00538 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) 00539 void bd_stop_bdj(BLURAY *bd); // shutdown BD-J and clean up resources 00540 00541 /* 00542 * events 00543 */ 00544 00545 typedef enum { 00546 00547 BD_EVENT_NONE = 0, /* no pending events */ 00548 00549 /* 00550 * errors 00551 */ 00552 00553 BD_EVENT_ERROR = 1, /* Fatal error. Playback can't be continued. */ 00554 BD_EVENT_READ_ERROR = 2, /* Reading of .m2ts aligned unit failed. Next call to read will try next block. */ 00555 BD_EVENT_ENCRYPTED = 3, /* .m2ts file is encrypted and can't be played */ 00556 00557 /* 00558 * current playback position 00559 */ 00560 00561 BD_EVENT_ANGLE = 4, /* current angle, 1...N */ 00562 BD_EVENT_TITLE = 5, /* current title, 1...N (0 = top menu) */ 00563 BD_EVENT_PLAYLIST = 6, /* current playlist (xxxxx.mpls) */ 00564 BD_EVENT_PLAYITEM = 7, /* current play item, 0...N-1 */ 00565 BD_EVENT_CHAPTER = 8, /* current chapter, 1...N */ 00566 BD_EVENT_PLAYMARK = 30, /* playmark reached */ 00567 BD_EVENT_END_OF_TITLE = 9, 00568 00569 /* 00570 * stream selection 00571 */ 00572 00573 BD_EVENT_AUDIO_STREAM = 10, /* 1..32, 0xff = none */ 00574 BD_EVENT_IG_STREAM = 11, /* 1..32 */ 00575 BD_EVENT_PG_TEXTST_STREAM = 12, /* 1..255, 0xfff = none */ 00576 BD_EVENT_PIP_PG_TEXTST_STREAM = 13, /* 1..255, 0xfff = none */ 00577 BD_EVENT_SECONDARY_AUDIO_STREAM = 14, /* 1..32, 0xff = none */ 00578 BD_EVENT_SECONDARY_VIDEO_STREAM = 15, /* 1..32, 0xff = none */ 00579 00580 BD_EVENT_PG_TEXTST = 16, /* 0 - disable, 1 - enable */ 00581 BD_EVENT_PIP_PG_TEXTST = 17, /* 0 - disable, 1 - enable */ 00582 BD_EVENT_SECONDARY_AUDIO = 18, /* 0 - disable, 1 - enable */ 00583 BD_EVENT_SECONDARY_VIDEO = 19, /* 0 - disable, 1 - enable */ 00584 BD_EVENT_SECONDARY_VIDEO_SIZE = 20, /* 0 - PIP, 0xf - fullscreen */ 00585 00586 /* 00587 * playback control 00588 */ 00589 00590 /* discontinuity in the stream (non-seamless connection). Reset demuxer PES buffers. */ 00591 BD_EVENT_DISCONTINUITY = 28, /* new timestamp (45 kHz) */ 00592 00593 /* HDMV VM or JVM seeked the stream. Next read() will return data from new position. Flush all buffers. */ 00594 BD_EVENT_SEEK = 21, 00595 00596 /* still playback (pause) */ 00597 BD_EVENT_STILL = 22, /* 0 - off, 1 - on */ 00598 00599 /* Still playback for n seconds (reached end of still mode play item). 00600 * Playback continues by calling bd_read_skip_still(). */ 00601 BD_EVENT_STILL_TIME = 23, /* 0 = infinite ; 1...300 = seconds */ 00602 00603 /* Play sound effect */ 00604 BD_EVENT_SOUND_EFFECT = 24, /* effect ID */ 00605 00606 /* 00607 * status 00608 */ 00609 00610 /* Nothing to do. Playlist is not playing, but title applet is running. */ 00611 BD_EVENT_IDLE = 29, 00612 00613 /* Pop-Up menu available */ 00614 BD_EVENT_POPUP = 25, /* 0 - no, 1 - yes */ 00615 00616 /* Interactive menu visible */ 00617 BD_EVENT_MENU = 26, /* 0 - no, 1 - yes */ 00618 00619 /* 3D */ 00620 BD_EVENT_STEREOSCOPIC_STATUS = 27, /* 0 - 2D, 1 - 3D */ 00621 00622 /*BD_EVENT_LAST = 30, */ 00623 00624 } bd_event_e; 00625 00626 typedef struct { 00627 uint32_t event; /* bd_event_e */ 00628 uint32_t param; 00629 } BD_EVENT; 00630 00631 #define BLURAY_TITLE_FIRST_PLAY 0xffff 00632 #define BLURAY_TITLE_TOP_MENU 0 00633 00641 int bd_get_event(BLURAY *bd, BD_EVENT *event); 00642 00643 /* 00644 * navigaton mode 00645 */ 00646 00656 int bd_play(BLURAY *bd); 00657 00670 int bd_read_ext(BLURAY *bd, unsigned char *buf, int len, BD_EVENT *event); 00671 00684 int bd_play_title(BLURAY *bd, unsigned title); 00685 00696 int bd_menu_call(BLURAY *bd, int64_t pts); 00697 00698 /* 00699 * User interaction and On-screen display controller 00700 */ 00701 00702 struct bd_overlay_s; /* defined in overlay.h */ 00703 struct bd_argb_overlay_s; /* defined in overlay.h */ 00704 struct bd_argb_buffer_s; /* defined in overlay.h */ 00705 typedef void (*bd_overlay_proc_f)(void *, const struct bd_overlay_s * const); 00706 typedef void (*bd_argb_overlay_proc_f)(void *, const struct bd_argb_overlay_s * const); 00707 00708 00727 void bd_register_overlay_proc(BLURAY *bd, void *handle, bd_overlay_proc_f func); 00728 00744 void bd_register_argb_overlay_proc(BLURAY *bd, void *handle, bd_argb_overlay_proc_f func, struct bd_argb_buffer_s *buf); 00745 00753 void bd_set_scr(BLURAY *bd, int64_t pts); 00754 00766 int bd_user_input(BLURAY *bd, int64_t pts, uint32_t key); 00767 00778 int bd_mouse_select(BLURAY *bd, int64_t pts, uint16_t x, uint16_t y); 00779 00789 int bd_get_sound_effect(BLURAY *bd, unsigned sound_id, struct bd_sound_effect *effect); 00790 00791 /* 00792 * 00793 */ 00794 00795 struct meta_dl; 00803 const struct meta_dl *bd_get_meta(BLURAY *bd); 00804 00805 00806 struct clpi_cl; 00815 struct clpi_cl *bd_get_clpi(BLURAY *bd, unsigned clip_ref); 00816 struct clpi_cl *bd_read_clpi(const char *clpi_file); 00817 00824 void bd_free_clpi(struct clpi_cl *cl); 00825 00826 #ifdef __cplusplus 00827 }; 00828 #endif 00829 00830 #endif /* BLURAY_H_ */
1.7.1