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 
27 #ifndef BLURAY_H_
28 #define BLURAY_H_
29 
30 #ifdef __cplusplus
31 extern "C" {
32 #endif
33 
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)
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
60 typedef struct {
61  const char *name;
62  uint8_t interactive;
63  uint8_t accessible;
64  uint8_t hidden;
66  uint8_t bdj;
67  uint32_t id_ref;
68 } BLURAY_TITLE;
69 
71 typedef struct {
72  uint8_t bluray_detected;
74  /* Disc ID */
75  const char *disc_name;
76  const char *udf_volume_id;
77  uint8_t disc_id[20];
80  uint8_t no_menu_support;
84  uint32_t num_titles;
85  const BLURAY_TITLE *const *titles;
89  uint32_t num_hdmv_titles;
90  uint32_t num_bdj_titles;
94  uint8_t bdj_detected;
95  uint8_t bdj_supported;
96  uint8_t libjvm_detected;
97  uint8_t bdj_handled;
99  char bdj_org_id[9];
100  char bdj_disc_id[33];
102  /* disc application info */
103  uint8_t video_format;
104  uint8_t frame_rate;
107  uint8_t provider_data[32];
109  /* AACS info (valid only if disc uses AACS) */
110  uint8_t aacs_detected;
112  uint8_t aacs_handled;
115  int aacs_mkbv;
117  /* BD+ info (valid only if disc uses BD+) */
118  uint8_t bdplus_detected;
120  uint8_t bdplus_handled;
122  uint8_t bdplus_gen;
123  uint32_t bdplus_date;
125  /* disc application info (libbluray > 1.2.0) */
129 
130 /*
131  * Playlist info
132  */
133 
135 typedef enum {
136  BLURAY_STREAM_TYPE_VIDEO_MPEG1 = 0x01,
137  BLURAY_STREAM_TYPE_VIDEO_MPEG2 = 0x02,
138  BLURAY_STREAM_TYPE_AUDIO_MPEG1 = 0x03,
139  BLURAY_STREAM_TYPE_AUDIO_MPEG2 = 0x04,
140  BLURAY_STREAM_TYPE_AUDIO_LPCM = 0x80,
141  BLURAY_STREAM_TYPE_AUDIO_AC3 = 0x81,
142  BLURAY_STREAM_TYPE_AUDIO_DTS = 0x82,
143  BLURAY_STREAM_TYPE_AUDIO_TRUHD = 0x83,
144  BLURAY_STREAM_TYPE_AUDIO_AC3PLUS = 0x84,
145  BLURAY_STREAM_TYPE_AUDIO_DTSHD = 0x85,
146  BLURAY_STREAM_TYPE_AUDIO_DTSHD_MASTER = 0x86,
147  BLURAY_STREAM_TYPE_VIDEO_VC1 = 0xea,
148  BLURAY_STREAM_TYPE_VIDEO_H264 = 0x1b,
149  BLURAY_STREAM_TYPE_VIDEO_HEVC = 0x24,
150  BLURAY_STREAM_TYPE_SUB_PG = 0x90,
151  BLURAY_STREAM_TYPE_SUB_IG = 0x91,
152  BLURAY_STREAM_TYPE_SUB_TEXT = 0x92,
153  BLURAY_STREAM_TYPE_AUDIO_AC3PLUS_SECONDARY = 0xa1,
154  BLURAY_STREAM_TYPE_AUDIO_DTSHD_SECONDARY = 0xa2
156 
158 typedef enum {
168 
170 typedef enum {
178 
180 typedef enum {
181  BLURAY_ASPECT_RATIO_4_3 = 2,
182  BLURAY_ASPECT_RATIO_16_9 = 3
184 
186 typedef enum {
187  BLURAY_AUDIO_FORMAT_MONO = 1,
188  BLURAY_AUDIO_FORMAT_STEREO = 3,
189  BLURAY_AUDIO_FORMAT_MULTI_CHAN = 6,
190  BLURAY_AUDIO_FORMAT_COMBO = 12 // Stereo ac3/dts,
192  // multi mlp/dts-hd
194 typedef enum {
195  BLURAY_AUDIO_RATE_48 = 1,
196  BLURAY_AUDIO_RATE_96 = 4,
197  BLURAY_AUDIO_RATE_192 = 5,
198  BLURAY_AUDIO_RATE_192_COMBO = 12, // 48 or 96 ac3/dts
199  // 192 mpl/dts-hd
200  BLURAY_AUDIO_RATE_96_COMBO = 14 // 48 ac3/dts
201  // 96 mpl/dts-hd
203 
205 typedef enum {
206  BLURAY_TEXT_CHAR_CODE_UTF8 = 0x01,
207  BLURAY_TEXT_CHAR_CODE_UTF16BE = 0x02,
208  BLURAY_TEXT_CHAR_CODE_SHIFT_JIS = 0x03,
209  BLURAY_TEXT_CHAR_CODE_EUC_KR = 0x04,
210  BLURAY_TEXT_CHAR_CODE_GB18030_20001 = 0x05,
211  BLURAY_TEXT_CHAR_CODE_CN_GB = 0x06,
212  BLURAY_TEXT_CHAR_CODE_BIG5 = 0x07
214 
216 typedef enum {
221 
223 typedef enum {
227 
229 typedef enum {
230  BLURAY_DYNAMIC_RANGE_SDR = 0,
231  BLURAY_DYNAMIC_RANGE_HDR10 = 1,
232  BLURAY_DYNAMIC_RANGE_DOLBY_VISION = 2
234 
236 typedef struct bd_stream_info {
237  uint8_t coding_type;
238  uint8_t format;
239  uint8_t rate;
240  uint8_t char_code;
241  uint8_t lang[4];
242  uint16_t pid;
243  uint8_t aspect;
244  uint8_t subpath_id;
246 
248 typedef struct bd_clip {
249  uint32_t pkt_count;
250  uint8_t still_mode;
251  uint16_t still_time;
254  uint8_t pg_stream_count;
255  uint8_t ig_stream_count;
265  uint64_t start_time;
266  uint64_t in_time;
267  uint64_t out_time;
268  char clip_id[6];
270 
272 typedef struct bd_chapter {
273  uint32_t idx;
274  uint64_t start;
275  uint64_t duration;
276  uint64_t offset;
277  unsigned clip_ref;
279 
281 typedef struct bd_mark {
282  uint32_t idx;
283  int type;
284  uint64_t start;
285  uint64_t duration;
286  uint64_t offset;
287  unsigned clip_ref;
289 
291 typedef struct bd_title_info {
292  uint32_t idx;
293  uint32_t playlist;
294  uint64_t duration;
295  uint32_t clip_count;
296  uint8_t angle_count;
297  uint32_t chapter_count;
298  uint32_t mark_count;
305 
307 typedef struct bd_sound_effect {
308  uint8_t num_channels;
309  uint32_t num_frames;
310  const int16_t *samples;
312 
313 
325 void bd_get_version(int *major, int *minor, int *micro);
326 
327 /*
328  * Disc functions
329  */
330 
331 struct bd_dir_s;
332 struct bd_file_s;
333 struct meta_dl;
334 
344 BLURAY *bd_open(const char *device_path, const char *keyfile_path);
345 
354 
363 int bd_open_disc(BLURAY *bd, const char *device_path, const char *keyfile_path);
364 
374  void *read_blocks_handle,
375  int (*read_blocks)(void *handle, void *buf, int lba, int num_blocks));
376 
387  void *handle,
388  struct bd_dir_s *(*open_dir)(void *handle, const char *rel_path),
389  struct bd_file_s *(*open_file)(void *handle, const char *rel_path));
390 
396 void bd_close(BLURAY *bd);
397 
406 
420 const struct meta_dl *bd_get_meta(BLURAY *bd);
421 
435 int bd_get_meta_file(BLURAY *bd, const char *file_name, void **data, int64_t *size);
436 
437 
438 /*
439  * Title selection without on-disc menus
440  */
441 
455 uint32_t bd_get_titles(BLURAY *bd, uint8_t flags, uint32_t min_title_length);
456 
466 
476 BLURAY_TITLE_INFO* bd_get_title_info(BLURAY *bd, uint32_t title_idx, unsigned angle);
477 
485 
494 int bd_select_title(BLURAY *bd, uint32_t title);
495 
504 int bd_select_playlist(BLURAY *bd, uint32_t playlist);
505 
514 
524 int bd_read(BLURAY *bd, unsigned char *buf, int len);
525 
526 
527 /*
528  * Playback control functions
529  */
530 
538 int64_t bd_seek(BLURAY *bd, uint64_t pos);
539 
548 int64_t bd_seek_time(BLURAY *bd, uint64_t tick);
549 
558 int64_t bd_seek_chapter(BLURAY *bd, unsigned chapter);
559 
568 int64_t bd_seek_mark(BLURAY *bd, unsigned mark);
569 
578 int64_t bd_seek_playitem(BLURAY *bd, unsigned clip_ref);
579 
588 int bd_select_angle(BLURAY *bd, unsigned angle);
589 
597 void bd_seamless_angle_change(BLURAY *bd, unsigned angle);
598 
621 void bd_select_stream(BLURAY *bd, uint32_t stream_type, uint32_t stream_id, uint32_t enable_flag);
622 
623 #define BLURAY_AUDIO_STREAM 0
624 #define BLURAY_PG_TEXTST_STREAM 1
627 /*
628  * Playback status functions
629  */
630 
639 int64_t bd_chapter_pos(BLURAY *bd, unsigned chapter);
640 
649 
659 uint64_t bd_get_title_size(BLURAY *bd);
660 
669 
677 uint64_t bd_tell(BLURAY *bd);
678 
686 uint64_t bd_tell_time(BLURAY *bd);
687 
688 
689 /*
690  * player settings
691  */
692 
694 typedef enum {
720 
733 int bd_set_player_setting(BLURAY *bd, uint32_t idx, uint32_t value);
734 
744 int bd_set_player_setting_str(BLURAY *bd, uint32_t idx, const char *value);
745 
746 
747 /*
748  * events
749  */
750 
752 typedef enum {
753 
756  /*
757  * errors
758  */
759 
764  /*
765  * current playback position
766  */
767 
776  /*
777  * stream selection
778  */
779 
793  /*
794  * playback control
795  */
796 
799 
816  /*
817  * status
818  */
819 
823 
839  /*BD_EVENT_LAST = 33, */
840 
841 } bd_event_e;
842 
844 typedef struct {
845  uint32_t event;
846  uint32_t param;
847 } BD_EVENT;
848 
849 /* BD_EVENT_ERROR param values */
850 #define BD_ERROR_HDMV 1
851 #define BD_ERROR_BDJ 2
853 /* BD_EVENT_ENCRYPTED param vlues */
854 #define BD_ERROR_AACS 3
855 #define BD_ERROR_BDPLUS 4
857 /* BD_EVENT_TITLE special titles */
858 #define BLURAY_TITLE_FIRST_PLAY 0xffff
859 #define BLURAY_TITLE_TOP_MENU 0
861 /* BD_EVENT_KEY_INTEREST flags */
862 #define BLURAY_KIT_PLAY 0x1
863 #define BLURAY_KIT_STOP 0x2
864 #define BLURAY_KIT_FFW 0x4
865 #define BLURAY_KIT_REW 0x8
866 #define BLURAY_KIT_TRACK_NEXT 0x10
867 #define BLURAY_KIT_TRACK_PREV 0x20
868 #define BLURAY_KIT_PAUSE 0x40
869 #define BLURAY_KIT_STILL_OFF 0x80
870 #define BLURAY_KIT_SEC_AUDIO 0x100
871 #define BLURAY_KIT_SEC_VIDEO 0x200
872 #define BLURAY_KIT_PG_TEXTST 0x400
874 /* BD_EVENT_UO_MASK flags */
875 #define BLURAY_UO_MENU_CALL 0x1
876 #define BLURAY_UO_TITLE_SEARCH 0x2
886 int bd_get_event(BLURAY *bd, BD_EVENT *event);
887 
895 const char *bd_event_name(uint32_t /* bd_event_e */ event);
896 
897 /*
898  * On-screen display
899  */
900 
901 struct bd_overlay_s; /* defined in overlay.h */
902 struct bd_argb_overlay_s; /* defined in overlay.h */
903 struct bd_argb_buffer_s; /* defined in overlay.h */
904 
911 typedef void (*bd_overlay_proc_f)(void *handle, const struct bd_overlay_s * const event);
912 
919 typedef void (*bd_argb_overlay_proc_f)(void *handle, const struct bd_argb_overlay_s * const event);
920 
940 void bd_register_overlay_proc(BLURAY *bd, void *handle, bd_overlay_proc_f func);
941 
957 void bd_register_argb_overlay_proc(BLURAY *bd, void *handle, bd_argb_overlay_proc_f func, struct bd_argb_buffer_s *buf);
958 
959 
960 /*
961  * Playback with on-disc menus
962  */
963 
973 int bd_play(BLURAY *bd);
974 
987 int bd_play_title(BLURAY *bd, unsigned title);
988 
999 int bd_menu_call(BLURAY *bd, int64_t pts);
1000 
1013 int bd_read_ext(BLURAY *bd, unsigned char *buf, int len, BD_EVENT *event);
1014 
1023 
1033 BLURAY_TITLE_INFO* bd_get_playlist_info(BLURAY *bd, uint32_t playlist, unsigned angle);
1034 
1044 int bd_get_sound_effect(BLURAY *bd, unsigned sound_id, struct bd_sound_effect *effect);
1045 
1046 
1047 /*
1048  * User interaction
1049  */
1050 
1058 void bd_set_scr(BLURAY *bd, int64_t pts);
1059 
1073 int bd_set_rate(BLURAY *bd, uint32_t rate);
1074 
1075 #define BLURAY_RATE_PAUSED 0
1076 #define BLURAY_RATE_NORMAL 90000
1093 int bd_user_input(BLURAY *bd, int64_t pts, uint32_t key);
1094 
1107 int bd_mouse_select(BLURAY *bd, int64_t pts, uint16_t x, uint16_t y);
1108 
1109 
1110 /*
1111  * Testing and debugging
1112  *
1113  * Note: parsing functions can't be used with UDF images.
1114  */
1115 
1116 /* access to internal information */
1117 
1118 struct clpi_cl;
1119 struct mpls_pl;
1120 struct bdjo_data;
1121 struct mobj_objects;
1122 
1131 struct clpi_cl *bd_get_clpi(BLURAY *bd, unsigned clip_ref);
1132 
1134 struct clpi_cl *bd_read_clpi(const char *clpi_file);
1135 
1142 void bd_free_clpi(struct clpi_cl *cl);
1143 
1144 
1146 struct mpls_pl *bd_read_mpls(const char *mpls_file);
1148 void bd_free_mpls(struct mpls_pl *);
1149 
1151 struct mobj_objects *bd_read_mobj(const char *mobj_file);
1153 void bd_free_mobj(struct mobj_objects *);
1154 
1156 struct bdjo_data *bd_read_bdjo(const char *bdjo_file);
1158 void bd_free_bdjo(struct bdjo_data *);
1159 
1160 /* BD-J testing */
1161 
1163 int bd_start_bdj(BLURAY *bd, const char* start_object);
1166 
1180 int bd_read_file(BLURAY *bd, const char *path, void **data, int64_t *size);
1181 
1192 struct bd_dir_s *bd_open_dir(BLURAY *bd, const char *dir);
1193 
1211 struct bd_file_s *bd_open_file_dec(BLURAY *bd, const char *path);
1212 
1213 
1214 #ifdef __cplusplus
1215 }
1216 #endif
1217 
1218 #endif /* BLURAY_H_ */
int64_t bd_chapter_pos(BLURAY *bd, unsigned chapter)
Find the byte position of a chapter.
void bd_set_scr(BLURAY *bd, int64_t pts)
Update current pts.
int64_t bd_seek_mark(BLURAY *bd, unsigned mark)
Seek to a playmark.
const BLURAY_DISC_INFO * bd_get_disc_info(BLURAY *bd)
Get information about current BluRay disc.
BLURAY_TITLE_INFO * bd_get_title_info(BLURAY *bd, uint32_t title_idx, unsigned angle)
Get information about a title.
const char * bd_event_name(uint32_t event)
Get name of event.
void(* bd_overlay_proc_f)(void *handle, const struct bd_overlay_s *const event)
YUV overlay handler function type.
Definition: bluray.h:911
uint64_t bd_get_title_size(BLURAY *bd)
Returns file size in bytes of currently selected title, 0 in no title selected.
struct clpi_cl * bd_read_clpi(const char *clpi_file)
Testing/debugging: Parse clip information (CLPI) file.
int64_t bd_seek_playitem(BLURAY *bd, unsigned clip_ref)
Seek to a playitem.
int64_t bd_seek_time(BLURAY *bd, uint64_t tick)
Seek to specific time in 90Khz ticks.
uint32_t bd_get_current_title(BLURAY *bd)
Returns the current title index.
bd_player_setting
Player setting.
Definition: bluray.h:694
@ BLURAY_PLAYER_SETTING_DISPLAY_CAP
Display capability.
Definition: bluray.h:704
@ BLURAY_PLAYER_SETTING_PERSISTENT_STORAGE
Enable/disable BD-J persistent storage.
Definition: bluray.h:714
@ BLURAY_PLAYER_SETTING_AUDIO_LANG
Initial audio language.
Definition: bluray.h:695
@ BLURAY_PLAYER_SETTING_COUNTRY_CODE
Player country code.
Definition: bluray.h:698
@ BLURAY_PLAYER_SETTING_OUTPUT_PREFER
Output mode preference.
Definition: bluray.h:700
@ BLURAY_PLAYER_CACHE_ROOT
Root path to the BD_J cache storage location.
Definition: bluray.h:717
@ BLURAY_PLAYER_SETTING_HDR_PREFERENCE
HDR preference.
Definition: bluray.h:708
@ BLURAY_PLAYER_SETTING_VIDEO_CAP
Video capability.
Definition: bluray.h:703
@ BLURAY_PLAYER_SETTING_TEXT_CAP
Text Subtitle capability.
Definition: bluray.h:710
@ BLURAY_PLAYER_SETTING_PLAYER_PROFILE
Player profile and version.
Definition: bluray.h:711
@ BLURAY_PLAYER_SETTING_REGION_CODE
Player region code.
Definition: bluray.h:699
@ BLURAY_PLAYER_SETTING_PG_LANG
Initial PG/SPU language.
Definition: bluray.h:696
@ BLURAY_PLAYER_SETTING_3D_CAP
3D capability.
Definition: bluray.h:705
@ BLURAY_PLAYER_SETTING_PARENTAL
Age for parental control.
Definition: bluray.h:701
@ BLURAY_PLAYER_SETTING_SDR_CONV_PREFER
SDR conversion preference.
Definition: bluray.h:709
@ BLURAY_PLAYER_SETTING_UHD_CAP
UHD capability.
Definition: bluray.h:706
@ BLURAY_PLAYER_SETTING_MENU_LANG
Initial menu language.
Definition: bluray.h:697
@ BLURAY_PLAYER_SETTING_DECODE_PG
Enable/disable PG (subtitle) decoder.
Definition: bluray.h:713
@ BLURAY_PLAYER_SETTING_UHD_DISPLAY_CAP
UHD display capability.
Definition: bluray.h:707
@ BLURAY_PLAYER_SETTING_AUDIO_CAP
Audio capability.
Definition: bluray.h:702
@ BLURAY_PLAYER_PERSISTENT_ROOT
Root path to the BD_J persistent storage location.
Definition: bluray.h:716
@ BLURAY_PLAYER_JAVA_HOME
Location of JRE.
Definition: bluray.h:718
void bd_free_clpi(struct clpi_cl *cl)
Free CLPI_CL object.
void bd_free_mobj(struct mobj_objects *)
Testing/debugging: Free parsed movie objects.
int bd_get_event(BLURAY *bd, BD_EVENT *event)
Get event from libbluray event queue.
int bd_read_skip_still(BLURAY *bd)
Continue reading after still mode clip.
void bd_free_title_info(BLURAY_TITLE_INFO *title_info)
Free BLURAY_TITLE_INFO object.
int bd_set_player_setting_str(BLURAY *bd, uint32_t idx, const char *value)
Update player setting (string)
void(* bd_argb_overlay_proc_f)(void *handle, const struct bd_argb_overlay_s *const event)
ARGB overlay handler function type.
Definition: bluray.h:919
BLURAY_TITLE_INFO * bd_get_playlist_info(BLURAY *bd, uint32_t playlist, unsigned angle)
Get information about a playlist.
bd_mark_type_e
Mark type.
Definition: bluray.h:223
@ BLURAY_MARK_ENTRY
entry mark for chapter search
Definition: bluray.h:224
@ BLURAY_MARK_LINK
link point
Definition: bluray.h:225
int bd_get_main_title(BLURAY *bd)
Get main title Returned number is an index to the list created by bd_get_titles()
bd_dynamic_range_type_e
Clip dynamic range.
Definition: bluray.h:229
BLURAY * bd_open(const char *device_path, const char *keyfile_path)
Open BluRay disc.
bd_video_rate_e
Stream video frame rate.
Definition: bluray.h:170
@ BLURAY_VIDEO_RATE_60000_1001
59.94 Hz
Definition: bluray.h:176
@ BLURAY_VIDEO_RATE_24000_1001
23.976 Hz
Definition: bluray.h:171
@ BLURAY_VIDEO_RATE_50
50 Hz
Definition: bluray.h:175
@ BLURAY_VIDEO_RATE_24
24 Hz
Definition: bluray.h:172
@ BLURAY_VIDEO_RATE_25
25 Hz
Definition: bluray.h:173
@ BLURAY_VIDEO_RATE_30000_1001
29.97 Hz
Definition: bluray.h:174
int bd_read_ext(BLURAY *bd, unsigned char *buf, int len, BD_EVENT *event)
Read from currently playing title.
int bd_read_file(BLURAY *bd, const char *path, void **data, int64_t *size)
Read a file from BluRay Virtual File System.
int bd_read(BLURAY *bd, unsigned char *buf, int len)
Read from currently selected title file, decrypt if possible.
struct bd_dir_s * bd_open_dir(BLURAY *bd, const char *dir)
Open a directory from BluRay Virtual File System.
struct clpi_cl * bd_get_clpi(BLURAY *bd, unsigned clip_ref)
Get copy of clip information for requested playitem.
uint32_t bd_get_titles(BLURAY *bd, uint8_t flags, uint32_t min_title_length)
Get number of titles (playlists)
unsigned bd_get_current_angle(BLURAY *bd)
Return the current angle.
void bd_close(BLURAY *bd)
Close BluRay disc.
void bd_seamless_angle_change(BLURAY *bd, unsigned angle)
Initiate seamless angle change.
struct bdjo_data * bd_read_bdjo(const char *bdjo_file)
Testing/debugging: Parse BD-J object file (BDJO)
bd_stream_type_e
Stream video coding type.
Definition: bluray.h:135
int bd_select_angle(BLURAY *bd, unsigned angle)
Set the angle to play.
struct mobj_objects * bd_read_mobj(const char *mobj_file)
Testing/debugging: Parse movie objects (MOBJ) file.
bd_char_code_e
Text subtitle charset.
Definition: bluray.h:205
int bd_set_player_setting(BLURAY *bd, uint32_t idx, uint32_t value)
Update player setting.
bd_video_format_e
Stream video format.
Definition: bluray.h:158
@ BLURAY_VIDEO_FORMAT_1080P
SMPTE 274M.
Definition: bluray.h:164
@ BLURAY_VIDEO_FORMAT_720P
SMPTE 296M.
Definition: bluray.h:163
@ BLURAY_VIDEO_FORMAT_576P
ITU-R BT.1358.
Definition: bluray.h:165
@ BLURAY_VIDEO_FORMAT_576I
ITU-R BT.601-4.
Definition: bluray.h:160
@ BLURAY_VIDEO_FORMAT_480P
SMPTE 293M.
Definition: bluray.h:161
@ BLURAY_VIDEO_FORMAT_1080I
SMPTE 274M.
Definition: bluray.h:162
@ BLURAY_VIDEO_FORMAT_480I
ITU-R BT.601-5.
Definition: bluray.h:159
@ BLURAY_VIDEO_FORMAT_2160P
BT.2020.
Definition: bluray.h:166
int bd_play(BLURAY *bd)
Start playing disc with on-disc menus.
const struct meta_dl * bd_get_meta(BLURAY *bd)
Get meta information about current BluRay disc.
int64_t bd_seek_chapter(BLURAY *bd, unsigned chapter)
Seek to a chapter.
int bd_open_files(BLURAY *bd, void *handle, struct bd_dir_s *(*open_dir)(void *handle, const char *rel_path), struct bd_file_s *(*open_file)(void *handle, const char *rel_path))
Open BluRay disc.
void bd_stop_bdj(BLURAY *bd)
Testing/debugging: shutdown BD-J and clean up resources.
int bd_open_disc(BLURAY *bd, const char *device_path, const char *keyfile_path)
Open BluRay disc.
void bd_free_bdjo(struct bdjo_data *)
Testing/debugging: Free parsed BDJO object.
uint32_t bd_get_current_chapter(BLURAY *bd)
Get the current chapter.
int bd_start_bdj(BLURAY *bd, const char *start_object)
Testing/debugging: start BD-J from the specified BD-J object (should be a 5 character string)
void bd_select_stream(BLURAY *bd, uint32_t stream_type, uint32_t stream_id, uint32_t enable_flag)
Select stream (PG / TextST track)
struct bluray BLURAY
This structure is opaque.
Definition: bluray.h:45
void bd_register_overlay_proc(BLURAY *bd, void *handle, bd_overlay_proc_f func)
Register handler for compressed YUV overlays.
int bd_select_title(BLURAY *bd, uint32_t title)
Select the title from the list created by bd_get_titles()
uint64_t bd_tell(BLURAY *bd)
Return current pos.
struct mpls_pl * bd_read_mpls(const char *mpls_file)
Testing/debugging: Parse playlist (MPLS) file.
int bd_get_meta_file(BLURAY *bd, const char *file_name, void **data, int64_t *size)
Read metadata file from BluRay disc.
int64_t bd_seek(BLURAY *bd, uint64_t pos)
Seek to pos in currently selected title.
void bd_get_version(int *major, int *minor, int *micro)
Get libbluray version.
int bd_user_input(BLURAY *bd, int64_t pts, uint32_t key)
Pass user input to graphics controller or BD-J.
int bd_select_playlist(BLURAY *bd, uint32_t playlist)
Select a playlist.
struct bd_file_s * bd_open_file_dec(BLURAY *bd, const char *path)
Open a file from BluRay Virtual File System.
int bd_open_stream(BLURAY *bd, void *read_blocks_handle, int(*read_blocks)(void *handle, void *buf, int lba, int num_blocks))
Open BluRay disc.
void bd_register_argb_overlay_proc(BLURAY *bd, void *handle, bd_argb_overlay_proc_f func, struct bd_argb_buffer_s *buf)
Register handler for ARGB overlays.
BLURAY * bd_init(void)
Initialize BLURAY object.
uint64_t bd_tell_time(BLURAY *bd)
Return current time.
bd_video_aspect_e
Stream video aspect ratio.
Definition: bluray.h:180
int bd_menu_call(BLURAY *bd, int64_t pts)
Open BluRay disc Top Menu.
bd_audio_format_e
Stream audio format.
Definition: bluray.h:186
void bd_free_mpls(struct mpls_pl *)
Testing/debugging: Free parsed playlist.
bd_audio_rate_e
Stream audio rate.
Definition: bluray.h:194
int bd_set_rate(BLURAY *bd, uint32_t rate)
Set current playback rate.
int bd_play_title(BLURAY *bd, unsigned title)
Play a title (from disc index).
int bd_mouse_select(BLURAY *bd, int64_t pts, uint16_t x, uint16_t y)
Select menu button at location (x,y).
bd_event_e
Event type.
Definition: bluray.h:752
@ BD_EVENT_SEEK
HDMV VM or JVM seeked the stream.
Definition: bluray.h:804
@ BD_EVENT_MENU
Interactive menu visible.
Definition: bluray.h:828
@ BD_EVENT_PIP_PG_TEXTST_STREAM
1..255, 0xfff = none
Definition: bluray.h:783
@ BD_EVENT_STILL_TIME
Still playback for n seconds (reached end of still mode play item).
Definition: bluray.h:811
@ BD_EVENT_SECONDARY_VIDEO_STREAM
1..32, 0xff = none
Definition: bluray.h:785
@ BD_EVENT_TITLE
current title, 1...N (0 = top menu)
Definition: bluray.h:769
@ BD_EVENT_PG_TEXTST_STREAM
1..255, 0xfff = none
Definition: bluray.h:782
@ BD_EVENT_STEREOSCOPIC_STATUS
3D
Definition: bluray.h:831
@ BD_EVENT_PIP_PG_TEXTST
0 - disable, 1 - enable
Definition: bluray.h:788
@ BD_EVENT_IDLE
Nothing to do.
Definition: bluray.h:822
@ BD_EVENT_PLAYLIST
current playlist (xxxxx.mpls)
Definition: bluray.h:770
@ BD_EVENT_PG_TEXTST
0 - disable, 1 - enable
Definition: bluray.h:787
@ BD_EVENT_CHAPTER
current chapter, 1...N
Definition: bluray.h:772
@ BD_EVENT_ANGLE
current angle, 1...N
Definition: bluray.h:768
@ BD_EVENT_PLAYITEM
current play item, 0...N-1
Definition: bluray.h:771
@ BD_EVENT_UO_MASK_CHANGED
UO mask changed.
Definition: bluray.h:837
@ BD_EVENT_ENCRYPTED
.m2ts file is encrypted and can't be played
Definition: bluray.h:762
@ BD_EVENT_POPUP
Pop-Up menu available.
Definition: bluray.h:825
@ BD_EVENT_PLAYLIST_STOP
HDMV VM or JVM stopped playlist playback.
Definition: bluray.h:798
@ BD_EVENT_SECONDARY_VIDEO
0 - disable, 1 - enable
Definition: bluray.h:790
@ BD_EVENT_KEY_INTEREST_TABLE
BD-J key interest table changed.
Definition: bluray.h:834
@ BD_EVENT_END_OF_TITLE
end of title reached
Definition: bluray.h:774
@ BD_EVENT_IG_STREAM
1..32
Definition: bluray.h:781
@ BD_EVENT_PLAYMARK
playmark reached
Definition: bluray.h:773
@ BD_EVENT_SECONDARY_AUDIO
0 - disable, 1 - enable
Definition: bluray.h:789
@ BD_EVENT_SOUND_EFFECT
Play sound effect.
Definition: bluray.h:814
@ BD_EVENT_SECONDARY_VIDEO_SIZE
0 - PIP, 0xf - fullscreen
Definition: bluray.h:791
@ BD_EVENT_STILL
still playback (pause)
Definition: bluray.h:807
@ BD_EVENT_DISCONTINUITY
discontinuity in the stream (non-seamless connection).
Definition: bluray.h:801
@ BD_EVENT_NONE
no pending events
Definition: bluray.h:754
@ BD_EVENT_SECONDARY_AUDIO_STREAM
1..32, 0xff = none
Definition: bluray.h:784
@ BD_EVENT_ERROR
Fatal error.
Definition: bluray.h:760
@ BD_EVENT_AUDIO_STREAM
1..32, 0xff = none
Definition: bluray.h:780
@ BD_EVENT_READ_ERROR
Reading of .m2ts aligned unit failed.
Definition: bluray.h:761
int bd_get_sound_effect(BLURAY *bd, unsigned sound_id, struct bd_sound_effect *effect)
Get sound effect.
bd_still_mode_e
Clip still mode type.
Definition: bluray.h:216
@ BLURAY_STILL_INFINITE
Infinite still.
Definition: bluray.h:219
@ BLURAY_STILL_TIME
Still playback for fixed time.
Definition: bluray.h:218
@ BLURAY_STILL_NONE
No still (normal playback)
Definition: bluray.h:217
Event.
Definition: bluray.h:844
uint32_t event
Event type (bd_event_e)
Definition: bluray.h:845
uint32_t param
Event data.
Definition: bluray.h:846
Clip information.
Definition: bluray.h:248
uint16_t still_time
Still time (seconds) if still_mode == BD_STILL_TIME.
Definition: bluray.h:251
uint8_t sec_video_stream_count
Number of secondary video streams.
Definition: bluray.h:257
BLURAY_STREAM_INFO * audio_streams
Audio streams information.
Definition: bluray.h:259
uint8_t pg_stream_count
Number of PG (Presentation Graphics) streams.
Definition: bluray.h:254
uint64_t start_time
start media time, 90kHz, ("playlist time")
Definition: bluray.h:265
BLURAY_STREAM_INFO * pg_streams
PG (Presentation Graphics) streams information.
Definition: bluray.h:260
uint8_t sec_audio_stream_count
Number of secondary audio streams.
Definition: bluray.h:256
uint64_t out_time
end timestamp, 90kHz
Definition: bluray.h:267
uint8_t audio_stream_count
Number of audio streams.
Definition: bluray.h:253
uint64_t in_time
start timestamp, 90kHz
Definition: bluray.h:266
uint32_t pkt_count
Number of mpeg-ts packets.
Definition: bluray.h:249
BLURAY_STREAM_INFO * video_streams
Video streams information.
Definition: bluray.h:258
uint8_t video_stream_count
Number of video streams.
Definition: bluray.h:252
uint8_t ig_stream_count
Number of IG (Interactive Graphics) streams.
Definition: bluray.h:255
BLURAY_STREAM_INFO * sec_audio_streams
Secondary audio streams information.
Definition: bluray.h:262
BLURAY_STREAM_INFO * ig_streams
IG (Interactive Graphics) streams information.
Definition: bluray.h:261
BLURAY_STREAM_INFO * sec_video_streams
Secondary video streams information.
Definition: bluray.h:263
uint8_t still_mode
Clip still mode (bd_still_mode_e)
Definition: bluray.h:250
BluRay disc information.
Definition: bluray.h:71
const BLURAY_TITLE * top_menu
titles[0].
Definition: bluray.h:87
uint8_t libjvm_detected
1 if usable Java VM was found
Definition: bluray.h:96
uint8_t frame_rate
bd_video_rate_e
Definition: bluray.h:104
uint8_t bdplus_detected
1 if disc is using BD+ encoding
Definition: bluray.h:118
const BLURAY_TITLE *const * titles
index is title number 1 ...
Definition: bluray.h:85
uint8_t content_exist_3D
1 if 3D content exists on the disc
Definition: bluray.h:105
uint8_t initial_dynamic_range_type
bd_dynamic_range_type_e
Definition: bluray.h:126
uint32_t bdplus_date
BD+ content code relese date ((year<<16)|(month<<8)|day)
Definition: bluray.h:123
uint8_t libaacs_detected
1 if usable AACS decoding library was found
Definition: bluray.h:111
uint8_t bdplus_gen
BD+ content code generation.
Definition: bluray.h:122
uint32_t num_unsupported_titles
number of unsupported titles
Definition: bluray.h:91
const char * disc_name
optional disc name in preferred language
Definition: bluray.h:75
uint8_t aacs_handled
1 if disc is using supported AACS encoding
Definition: bluray.h:112
uint8_t first_play_supported
1 if First Play title is present on the disc and can be played
Definition: bluray.h:81
uint8_t bdj_supported
(deprecated)
Definition: bluray.h:95
const char * udf_volume_id
optional UDF volume identifier
Definition: bluray.h:76
uint8_t no_menu_support
HDMV / BD-J titles.
Definition: bluray.h:80
uint8_t bdplus_handled
1 if disc is using supporred BD+ encoding
Definition: bluray.h:120
uint8_t bdj_detected
BD-J info (valid only if disc uses BD-J)
Definition: bluray.h:94
uint32_t num_hdmv_titles
number of HDMV titles
Definition: bluray.h:89
uint32_t num_bdj_titles
number of BD-J titles
Definition: bluray.h:90
uint8_t initial_output_mode_preference
0 - 2D, 1 - 3D
Definition: bluray.h:106
uint8_t bluray_detected
1 if BluRay disc was detected
Definition: bluray.h:72
const BLURAY_TITLE * first_play
titles[N+1].
Definition: bluray.h:86
int aacs_error_code
AACS error code (BD_AACS_*)
Definition: bluray.h:114
int aacs_mkbv
AACS MKB version.
Definition: bluray.h:115
uint8_t top_menu_supported
1 if Top Menu title is present on the disc and can be played
Definition: bluray.h:82
uint8_t libbdplus_detected
1 if usable BD+ decoding library was found
Definition: bluray.h:119
uint8_t bdj_handled
1 if usable Java VM + libbluray.jar was found
Definition: bluray.h:97
uint8_t aacs_detected
1 if disc is using AACS encoding
Definition: bluray.h:110
uint32_t num_titles
number of titles on the disc, not including "First Play" and "Top Menu"
Definition: bluray.h:84
uint8_t video_format
bd_video_format_e
Definition: bluray.h:103
Sound effect data.
Definition: bluray.h:307
const int16_t * samples
48000 Hz, 16 bit LPCM.
Definition: bluray.h:310
uint32_t num_frames
Number of audio frames.
Definition: bluray.h:309
uint8_t num_channels
1 - mono, 2 - stereo
Definition: bluray.h:308
Clip substream information.
Definition: bluray.h:236
uint8_t aspect
Stream video aspect ratio (bd_video_aspect_e)
Definition: bluray.h:243
uint8_t rate
Stream frame rate (bd_audio_rate_e or bd_video_rate_e)
Definition: bluray.h:239
uint8_t format
Stream format (bd_video_format_e or bd_audio_format_e)
Definition: bluray.h:238
uint8_t char_code
Text subtitle charachter code (bd_char_code_e)
Definition: bluray.h:240
uint8_t subpath_id
Sub path identifier (= separate mpeg-ts mux / .m2ts file)
Definition: bluray.h:244
uint8_t coding_type
Stream coding (bd_stream_type_e)
Definition: bluray.h:237
uint16_t pid
mpeg-ts PID
Definition: bluray.h:242
Chapter entry.
Definition: bluray.h:272
uint32_t idx
Chapter index (number - 1)
Definition: bluray.h:273
uint64_t start
start media time, 90kHz, ("playlist time")
Definition: bluray.h:274
unsigned clip_ref
Clip reference (index to playlist clips list)
Definition: bluray.h:277
uint64_t offset
distance from title start, bytes
Definition: bluray.h:276
uint64_t duration
duration
Definition: bluray.h:275
Playlist information.
Definition: bluray.h:291
uint8_t mvc_base_view_r_flag
MVC base view (0 - left, 1 - right)
Definition: bluray.h:303
BLURAY_CLIP_INFO * clips
Clip information.
Definition: bluray.h:299
uint32_t chapter_count
Number of chapters.
Definition: bluray.h:297
uint8_t angle_count
Number of angles.
Definition: bluray.h:296
BLURAY_TITLE_CHAPTER * chapters
Chapter information.
Definition: bluray.h:300
uint32_t mark_count
Number of playmarks.
Definition: bluray.h:298
uint32_t clip_count
Number of clips.
Definition: bluray.h:295
BLURAY_TITLE_MARK * marks
Playmark information.
Definition: bluray.h:301
uint64_t duration
Playlist duration, 90 kHz.
Definition: bluray.h:294
uint32_t idx
Playlist index number (filled only with bd_get_title_info())
Definition: bluray.h:292
uint32_t playlist
Playlist ID (mpls file name)
Definition: bluray.h:293
Playmark information.
Definition: bluray.h:281
unsigned clip_ref
Clip reference (index to playlist clips list)
Definition: bluray.h:287
uint64_t duration
time to next mark
Definition: bluray.h:285
uint64_t start
mark media time, 90kHz, ("playlist time")
Definition: bluray.h:284
uint32_t idx
Mark index (number - 1)
Definition: bluray.h:282
int type
bd_mark_type_e
Definition: bluray.h:283
uint64_t offset
mark distance from title start, bytes
Definition: bluray.h:286
HDMV / BD-J title information.
Definition: bluray.h:60
uint8_t bdj
0 - HDMV title.
Definition: bluray.h:66
uint8_t interactive
1 if title is interactive (title length and playback position should not be shown in UI)
Definition: bluray.h:62
uint32_t id_ref
Movie Object number / bdjo file number.
Definition: bluray.h:67
uint8_t hidden
1 if title number should not be shown during playback
Definition: bluray.h:64
uint8_t accessible
1 if it is allowed to jump into this title
Definition: bluray.h:63
const char * name
optional title name in preferred language
Definition: bluray.h:61
Directory access.
Definition: filesystem.h:126
File access.
Definition: filesystem.h:43