libbluray
Loading...
Searching...
No Matches
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
31extern "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)
45typedef 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
60typedef 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;
69
71typedef struct {
74 /* Disc ID */
75 const char *disc_name;
76 const char *udf_volume_id;
77 uint8_t disc_id[20];
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;
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) */
112 uint8_t aacs_handled;
117 /* BD+ info (valid only if disc uses BD+) */
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
135typedef 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
158typedef enum {
168
170typedef enum {
178
180typedef enum {
181 BLURAY_ASPECT_RATIO_4_3 = 2,
182 BLURAY_ASPECT_RATIO_16_9 = 3
184
186typedef 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
194typedef 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
205typedef 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
216typedef enum {
221
223typedef enum {
227
229typedef enum {
230 BLURAY_DYNAMIC_RANGE_SDR = 0,
231 BLURAY_DYNAMIC_RANGE_HDR10 = 1,
232 BLURAY_DYNAMIC_RANGE_DOLBY_VISION = 2
234
236typedef 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
248typedef struct bd_clip {
249 uint32_t pkt_count;
250 uint8_t still_mode;
251 uint16_t still_time;
265 uint64_t start_time;
266 uint64_t in_time;
267 uint64_t out_time;
268 char clip_id[6];
270
272typedef struct bd_chapter {
273 uint32_t idx;
274 uint64_t start;
275 uint64_t duration;
276 uint64_t offset;
277 unsigned clip_ref;
279
281typedef 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
291typedef 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
307typedef struct bd_sound_effect {
308 uint8_t num_channels;
309 uint32_t num_frames;
310 const int16_t *samples;
312
313
325void bd_get_version(int *major, int *minor, int *micro);
326
327/*
328 * Disc functions
329 */
330
331struct bd_dir_s;
332struct bd_file_s;
333struct meta_dl;
334
344BLURAY *bd_open(const char *device_path, const char *keyfile_path);
345
354
363int 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
396void bd_close(BLURAY *bd);
397
406
420const struct meta_dl *bd_get_meta(BLURAY *bd);
421
435int 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
455uint32_t bd_get_titles(BLURAY *bd, uint8_t flags, uint32_t min_title_length);
456
466
476BLURAY_TITLE_INFO* bd_get_title_info(BLURAY *bd, uint32_t title_idx, unsigned angle);
477
485
494int bd_select_title(BLURAY *bd, uint32_t title);
495
504int bd_select_playlist(BLURAY *bd, uint32_t playlist);
505
514
524int bd_read(BLURAY *bd, unsigned char *buf, int len);
525
526
527/*
528 * Playback control functions
529 */
530
538int64_t bd_seek(BLURAY *bd, uint64_t pos);
539
548int64_t bd_seek_time(BLURAY *bd, uint64_t tick);
549
558int64_t bd_seek_chapter(BLURAY *bd, unsigned chapter);
559
568int64_t bd_seek_mark(BLURAY *bd, unsigned mark);
569
578int64_t bd_seek_playitem(BLURAY *bd, unsigned clip_ref);
579
588int bd_select_angle(BLURAY *bd, unsigned angle);
589
597void bd_seamless_angle_change(BLURAY *bd, unsigned angle);
598
621void 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
639int64_t bd_chapter_pos(BLURAY *bd, unsigned chapter);
640
649
660
669
677uint64_t bd_tell(BLURAY *bd);
678
686uint64_t bd_tell_time(BLURAY *bd);
687
688
689/*
690 * player settings
691 */
692
694typedef enum {
720
733int bd_set_player_setting(BLURAY *bd, uint32_t idx, uint32_t value);
734
744int bd_set_player_setting_str(BLURAY *bd, uint32_t idx, const char *value);
745
746
747/*
748 * events
749 */
750
752typedef 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
844typedef 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
886int bd_get_event(BLURAY *bd, BD_EVENT *event);
887
895const char *bd_event_name(uint32_t /* bd_event_e */ event);
896
897/*
898 * On-screen display
899 */
900
901struct bd_overlay_s; /* defined in overlay.h */
902struct bd_argb_overlay_s; /* defined in overlay.h */
903struct bd_argb_buffer_s; /* defined in overlay.h */
904
911typedef void (*bd_overlay_proc_f)(void *handle, const struct bd_overlay_s * const event);
912
919typedef void (*bd_argb_overlay_proc_f)(void *handle, const struct bd_argb_overlay_s * const event);
920
941
957void 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
974
987int bd_play_title(BLURAY *bd, unsigned title);
988
999int bd_menu_call(BLURAY *bd, int64_t pts);
1000
1013int bd_read_ext(BLURAY *bd, unsigned char *buf, int len, BD_EVENT *event);
1014
1023
1033BLURAY_TITLE_INFO* bd_get_playlist_info(BLURAY *bd, uint32_t playlist, unsigned angle);
1034
1044int bd_get_sound_effect(BLURAY *bd, unsigned sound_id, struct bd_sound_effect *effect);
1045
1046
1047/*
1048 * User interaction
1049 */
1050
1058void bd_set_scr(BLURAY *bd, int64_t pts);
1059
1073int bd_set_rate(BLURAY *bd, uint32_t rate);
1074
1075#define BLURAY_RATE_PAUSED 0
1076#define BLURAY_RATE_NORMAL 90000
1093int bd_user_input(BLURAY *bd, int64_t pts, uint32_t key);
1094
1107int 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
1118struct clpi_cl;
1119struct mpls_pl;
1120struct bdjo_data;
1121struct mobj_objects;
1122
1131struct clpi_cl *bd_get_clpi(BLURAY *bd, unsigned clip_ref);
1132
1134struct clpi_cl *bd_read_clpi(const char *clpi_file);
1135
1142void bd_free_clpi(struct clpi_cl *cl);
1143
1144
1146struct mpls_pl *bd_read_mpls(const char *mpls_file);
1148void bd_free_mpls(struct mpls_pl *);
1149
1151struct mobj_objects *bd_read_mobj(const char *mobj_file);
1153void bd_free_mobj(struct mobj_objects *);
1154
1156struct bdjo_data *bd_read_bdjo(const char *bdjo_file);
1158void bd_free_bdjo(struct bdjo_data *);
1159
1160/* BD-J testing */
1161
1163int bd_start_bdj(BLURAY *bd, const char* start_object);
1166
1180int bd_read_file(BLURAY *bd, const char *path, void **data, int64_t *size);
1181
1192struct bd_dir_s *bd_open_dir(BLURAY *bd, const char *dir);
1193
1211struct 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.
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.
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.
BLURAY * bd_open(const char *device_path, const char *keyfile_path)
Open BluRay disc.
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
const BLURAY_DISC_INFO * bd_get_disc_info(BLURAY *bd)
Get information about current BluRay disc.
const struct meta_dl * bd_get_meta(BLURAY *bd)
Get meta information about current BluRay disc.
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
const char * bd_event_name(uint32_t event)
Get name of event.
BLURAY_TITLE_INFO * bd_get_title_info(BLURAY *bd, uint32_t title_idx, unsigned angle)
Get information about a title.
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
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
struct mobj_objects * bd_read_mobj(const char *mobj_file)
Testing/debugging: Parse movie objects (MOBJ) file.
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 bdjo_data * bd_read_bdjo(const char *bdjo_file)
Testing/debugging: Parse BD-J object file (BDJO)
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 bd_file_s * bd_open_file_dec(BLURAY *bd, const char *path)
Open a file from BluRay Virtual File System.
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.
BLURAY * bd_init(void)
Initialize BLURAY object.
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.
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.
struct clpi_cl * bd_get_clpi(BLURAY *bd, unsigned clip_ref)
Get copy of clip information for requested playitem.
struct clpi_cl * bd_read_clpi(const char *clpi_file)
Testing/debugging: Parse clip information (CLPI) file.
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.
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.
BLURAY_TITLE_INFO * bd_get_playlist_info(BLURAY *bd, uint32_t playlist, unsigned angle)
Get information about a playlist.
struct mpls_pl * bd_read_mpls(const char *mpls_file)
Testing/debugging: Parse playlist (MPLS) file.
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.
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
struct bd_dir_s * bd_open_dir(BLURAY *bd, const char *dir)
Open a directory from BluRay Virtual File System.
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 ... N
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