libbluray
|
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 } BLURAY_STREAM_INFO; 00134 00135 typedef struct bd_clip { 00136 uint32_t pkt_count; 00137 uint8_t still_mode; 00138 uint16_t still_time; /* seconds */ 00139 uint8_t video_stream_count; 00140 uint8_t audio_stream_count; 00141 uint8_t pg_stream_count; 00142 uint8_t ig_stream_count; 00143 uint8_t sec_audio_stream_count; 00144 uint8_t sec_video_stream_count; 00145 BLURAY_STREAM_INFO *video_streams; 00146 BLURAY_STREAM_INFO *audio_streams; 00147 BLURAY_STREAM_INFO *pg_streams; 00148 BLURAY_STREAM_INFO *ig_streams; 00149 BLURAY_STREAM_INFO *sec_audio_streams; 00150 BLURAY_STREAM_INFO *sec_video_streams; 00151 } BLURAY_CLIP_INFO; 00152 00153 typedef struct bd_chapter { 00154 uint32_t idx; 00155 uint64_t start; 00156 uint64_t duration; 00157 uint64_t offset; 00158 } BLURAY_TITLE_CHAPTER; 00159 00160 typedef struct bd_title_info { 00161 uint32_t idx; 00162 uint32_t playlist; 00163 uint64_t duration; 00164 uint32_t clip_count; 00165 uint8_t angle_count; 00166 uint32_t chapter_count; 00167 BLURAY_CLIP_INFO *clips; 00168 BLURAY_TITLE_CHAPTER *chapters; 00169 } BLURAY_TITLE_INFO; 00170 00175 void bd_get_version(int *major, int *minor, int *micro); 00176 00188 uint32_t bd_get_titles(BLURAY *bd, uint8_t flags, uint32_t min_title_length); 00189 00199 BLURAY_TITLE_INFO* bd_get_title_info(BLURAY *bd, uint32_t title_idx, unsigned angle); 00200 00210 BLURAY_TITLE_INFO* bd_get_playlist_info(BLURAY *bd, uint32_t playlist, unsigned angle); 00211 00218 void bd_free_title_info(BLURAY_TITLE_INFO *title_info); 00219 00227 BLURAY *bd_open(const char* device_path, const char* keyfile_path); 00228 00234 void bd_close(BLURAY *bd); 00235 00243 int64_t bd_seek(BLURAY *bd, uint64_t pos); 00244 00253 int64_t bd_seek_time(BLURAY *bd, uint64_t tick); 00254 00264 int bd_read(BLURAY *bd, unsigned char *buf, int len); 00265 00273 int bd_read_skip_still(BLURAY *bd); 00274 00283 int64_t bd_seek_chapter(BLURAY *bd, unsigned chapter); 00284 00293 int64_t bd_chapter_pos(BLURAY *bd, unsigned chapter); 00294 00302 uint32_t bd_get_current_chapter(BLURAY *bd); 00303 00312 int64_t bd_seek_mark(BLURAY *bd, unsigned mark); 00313 00322 int bd_select_playlist(BLURAY *bd, uint32_t playlist); 00323 00332 int bd_select_title(BLURAY *bd, uint32_t title); 00333 00342 int bd_select_angle(BLURAY *bd, unsigned angle); 00343 00351 void bd_seamless_angle_change(BLURAY *bd, unsigned angle); 00352 00362 uint64_t bd_get_title_size(BLURAY *bd); 00363 00371 uint32_t bd_get_current_title(BLURAY *bd); 00372 00380 unsigned bd_get_current_angle(BLURAY *bd); 00381 00389 uint64_t bd_tell(BLURAY *bd); 00390 00398 uint64_t bd_tell_time(BLURAY *bd); 00399 00400 /* 00401 * Disc info 00402 */ 00403 00404 typedef struct { 00405 uint8_t bluray_detected; 00406 00407 uint8_t first_play_supported; 00408 uint8_t top_menu_supported; 00409 00410 uint32_t num_hdmv_titles; 00411 uint32_t num_bdj_titles; 00412 uint32_t num_unsupported_titles; 00413 00414 uint8_t aacs_detected; 00415 uint8_t libaacs_detected; 00416 uint8_t aacs_handled; 00417 00418 uint8_t bdplus_detected; 00419 uint8_t libbdplus_detected; 00420 uint8_t bdplus_handled; 00421 00422 } BLURAY_DISC_INFO; 00423 00431 const BLURAY_DISC_INFO *bd_get_disc_info(BLURAY*); 00432 00433 /* 00434 * player settings 00435 */ 00436 00437 typedef enum { 00438 BLURAY_PLAYER_SETTING_PARENTAL = 13, /* Age for parental control (years) */ 00439 BLURAY_PLAYER_SETTING_AUDIO_CAP = 15, /* Player capability for audio (bit mask) */ 00440 BLURAY_PLAYER_SETTING_AUDIO_LANG = 16, /* Initial audio language: ISO 639-2 string, ex. "eng" */ 00441 BLURAY_PLAYER_SETTING_PG_LANG = 17, /* Initial PG/SPU language: ISO 639-2 string, ex. "eng" */ 00442 BLURAY_PLAYER_SETTING_MENU_LANG = 18, /* Initial menu language: ISO 639-2 string, ex. "eng" */ 00443 BLURAY_PLAYER_SETTING_COUNTRY_CODE = 19, /* Player country code: ISO 3166-1 string, ex. "de" */ 00444 BLURAY_PLAYER_SETTING_REGION_CODE = 20, /* Player region code: 1 - region A, 2 - B, 4 - C */ 00445 BLURAY_PLAYER_SETTING_VIDEO_CAP = 29, /* Player capability for video (bit mask) */ 00446 BLURAY_PLAYER_SETTING_TEXT_CAP = 30, /* Player capability for text subtitle (bit mask) */ 00447 BLURAY_PLAYER_SETTING_PLAYER_PROFILE = 31, /* Profile1: 0, Profile1+: 1, Profile2: 3, Profile3: 8 */ 00448 } bd_player_setting; 00449 00460 int bd_set_player_setting(BLURAY *bd, uint32_t idx, uint32_t value); 00461 int bd_set_player_setting_str(BLURAY *bd, uint32_t idx, const char *s); 00462 00463 /* 00464 * Java 00465 */ 00466 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) 00467 void bd_stop_bdj(BLURAY *bd); // shutdown BD-J and clean up resources 00468 00469 /* 00470 * events 00471 */ 00472 00473 typedef enum { 00474 BD_EVENT_NONE = 0, 00475 BD_EVENT_ERROR, /* Fatal error. Playback can't be continued. */ 00476 BD_EVENT_READ_ERROR, /* Reading of .m2ts aligned unit failed. Next call to read will try next block. */ 00477 BD_EVENT_ENCRYPTED, /* .m2ts file is encrypted and can't be played */ 00478 00479 /* current playback position */ 00480 BD_EVENT_ANGLE, /* current angle, 1...N */ 00481 BD_EVENT_TITLE, /* current title, 1...N (0 = top menu) */ 00482 BD_EVENT_PLAYLIST, /* current playlist (xxxxx.mpls) */ 00483 BD_EVENT_PLAYITEM, /* current play item */ 00484 BD_EVENT_CHAPTER, /* current chapter, 1...N */ 00485 BD_EVENT_END_OF_TITLE, 00486 00487 /* stream selection */ 00488 BD_EVENT_AUDIO_STREAM, /* 1..32, 0xff = none */ 00489 BD_EVENT_IG_STREAM, /* 1..32 */ 00490 BD_EVENT_PG_TEXTST_STREAM, /* 1..255, 0xfff = none */ 00491 BD_EVENT_PIP_PG_TEXTST_STREAM, /* 1..255, 0xfff = none */ 00492 BD_EVENT_SECONDARY_AUDIO_STREAM, /* 1..32, 0xff = none */ 00493 BD_EVENT_SECONDARY_VIDEO_STREAM, /* 1..32, 0xff = none */ 00494 00495 BD_EVENT_PG_TEXTST, /* 0 - disable, 1 - enable */ 00496 BD_EVENT_PIP_PG_TEXTST, /* 0 - disable, 1 - enable */ 00497 BD_EVENT_SECONDARY_AUDIO, /* 0 - disable, 1 - enable */ 00498 BD_EVENT_SECONDARY_VIDEO, /* 0 - disable, 1 - enable */ 00499 BD_EVENT_SECONDARY_VIDEO_SIZE, /* 0 - PIP, 0xf - fullscreen */ 00500 00501 /* HDMV VM or JVM seeked the stream. Next read() will return data from new position. */ 00502 BD_EVENT_SEEK, 00503 00504 /* still playback (pause) */ 00505 BD_EVENT_STILL, /* 0 - off, 1 - on */ 00506 00507 /* Still playback for n seconds (reached end of still mode play item) */ 00508 BD_EVENT_STILL_TIME, /* 0 = infinite ; 1...300 = seconds */ 00509 00510 } bd_event_e; 00511 00512 typedef struct { 00513 uint32_t event; /* bd_event_e */ 00514 uint32_t param; 00515 } BD_EVENT; 00516 00517 #define BLURAY_TITLE_FIRST_PLAY 0xffff 00518 #define BLURAY_TITLE_TOP_MENU 0 00519 00527 int bd_get_event(BLURAY *bd, BD_EVENT *event); 00528 00529 /* 00530 * navigaton mode 00531 */ 00532 00542 int bd_play(BLURAY *bd); 00543 00556 int bd_read_ext(BLURAY *bd, unsigned char *buf, int len, BD_EVENT *event); 00557 00570 int bd_play_title(BLURAY *bd, unsigned title); 00571 00582 int bd_menu_call(BLURAY *bd, int64_t pts); 00583 00584 /* 00585 * User interaction and On-screen display controller 00586 */ 00587 00588 struct bd_overlay_s; /* defined in overlay.h */ 00589 typedef void (*bd_overlay_proc_f)(void *, const struct bd_overlay_s * const); 00590 00600 void bd_register_overlay_proc(BLURAY *bd, void *handle, bd_overlay_proc_f func); 00601 00613 int bd_user_input(BLURAY *bd, int64_t pts, uint32_t key); 00614 00625 int bd_mouse_select(BLURAY *bd, int64_t pts, uint16_t x, uint16_t y); 00626 00627 /* 00628 * 00629 */ 00630 00631 struct meta_dl; 00639 struct meta_dl *bd_get_meta(BLURAY *bd); 00640 00641 00642 struct clpi_cl; 00651 struct clpi_cl *bd_get_clpi(BLURAY *bd, unsigned clip_ref); 00652 00659 void bd_free_clpi(struct clpi_cl *cl); 00660 00661 #ifdef __cplusplus 00662 }; 00663 #endif 00664 00665 #endif /* BLURAY_H_ */