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
31extern "C" {
32#endif
33
34#include <stdint.h>
35#include "bdnav/clpi_data.h"
36
37#define TITLES_ALL 0
38#define TITLES_FILTER_DUP_TITLE 0x01
39#define TITLES_FILTER_DUP_CLIP 0x02
41#define TITLES_RELEVANT \
42 (TITLES_FILTER_DUP_TITLE | TITLES_FILTER_DUP_CLIP)
46typedef struct bluray BLURAY;
47
48/*
49 * Disc info
50 */
51
52/* AACS error codes */
53#define BD_AACS_CORRUPTED_DISC -1
54#define BD_AACS_NO_CONFIG -2
55#define BD_AACS_NO_PK -3
56#define BD_AACS_NO_CERT -4
57#define BD_AACS_CERT_REVOKED -5
58#define BD_AACS_MMC_FAILED -6
61typedef struct {
62 const char *name;
63 uint8_t interactive;
64 uint8_t accessible;
65 uint8_t hidden;
67 uint8_t bdj_supported;/* 1 if BD-J support was compiled in */
68 uint8_t bdj;
69 uint32_t id_ref;
71
73typedef struct {
76 /* Disc ID */
77 const char *disc_name;
78 const char *udf_volume_id;
79 uint8_t disc_id[20];
86 uint32_t num_titles;
87 const BLURAY_TITLE *const *titles;
91 uint32_t num_hdmv_titles;
92 uint32_t num_bdj_titles;
96 uint8_t bdj_detected;
97 uint8_t bdj_supported;
99 uint8_t bdj_handled;
101 char bdj_org_id[9];
102 char bdj_disc_id[33];
104 /* disc application info */
105 uint8_t video_format;
106 uint8_t frame_rate;
109 uint8_t provider_data[32];
111 /* AACS info (valid only if disc uses AACS) */
114 uint8_t aacs_handled;
119 /* BD+ info (valid only if disc uses BD+) */
124 uint8_t bdplus_gen;
125 uint32_t bdplus_date;
127 /* disc application info (libbluray > 1.2.0) */
131
132/*
133 * Playlist info
134 */
135
137typedef enum {
138 BLURAY_STREAM_TYPE_VIDEO_MPEG1 = 0x01,
139 BLURAY_STREAM_TYPE_VIDEO_MPEG2 = 0x02,
140 BLURAY_STREAM_TYPE_AUDIO_MPEG1 = 0x03,
141 BLURAY_STREAM_TYPE_AUDIO_MPEG2 = 0x04,
142 BLURAY_STREAM_TYPE_AUDIO_LPCM = 0x80,
143 BLURAY_STREAM_TYPE_AUDIO_AC3 = 0x81,
144 BLURAY_STREAM_TYPE_AUDIO_DTS = 0x82,
145 BLURAY_STREAM_TYPE_AUDIO_TRUHD = 0x83,
146 BLURAY_STREAM_TYPE_AUDIO_AC3PLUS = 0x84,
147 BLURAY_STREAM_TYPE_AUDIO_DTSHD = 0x85,
148 BLURAY_STREAM_TYPE_AUDIO_DTSHD_MASTER = 0x86,
149 BLURAY_STREAM_TYPE_VIDEO_VC1 = 0xea,
150 BLURAY_STREAM_TYPE_VIDEO_H264 = 0x1b,
151 BLURAY_STREAM_TYPE_VIDEO_HEVC = 0x24,
152 BLURAY_STREAM_TYPE_SUB_PG = 0x90,
153 BLURAY_STREAM_TYPE_SUB_IG = 0x91,
154 BLURAY_STREAM_TYPE_SUB_TEXT = 0x92,
155 BLURAY_STREAM_TYPE_AUDIO_AC3PLUS_SECONDARY = 0xa1,
156 BLURAY_STREAM_TYPE_AUDIO_DTSHD_SECONDARY = 0xa2
158
160typedef enum {
170
172typedef enum {
180
182typedef enum {
183 BLURAY_ASPECT_RATIO_4_3 = 2,
184 BLURAY_ASPECT_RATIO_16_9 = 3
186
188typedef enum {
189 BLURAY_AUDIO_FORMAT_MONO = 1,
190 BLURAY_AUDIO_FORMAT_STEREO = 3,
191 BLURAY_AUDIO_FORMAT_MULTI_CHAN = 6,
192 BLURAY_AUDIO_FORMAT_COMBO = 12 // Stereo ac3/dts,
194 // multi mlp/dts-hd
196typedef enum {
197 BLURAY_AUDIO_RATE_48 = 1,
198 BLURAY_AUDIO_RATE_96 = 4,
199 BLURAY_AUDIO_RATE_192 = 5,
200 BLURAY_AUDIO_RATE_192_COMBO = 12, // 48 or 96 ac3/dts
201 // 192 mpl/dts-hd
202 BLURAY_AUDIO_RATE_96_COMBO = 14 // 48 ac3/dts
203 // 96 mpl/dts-hd
205
207typedef enum {
208 BLURAY_TEXT_CHAR_CODE_UTF8 = 0x01,
209 BLURAY_TEXT_CHAR_CODE_UTF16BE = 0x02,
210 BLURAY_TEXT_CHAR_CODE_SHIFT_JIS = 0x03,
211 BLURAY_TEXT_CHAR_CODE_EUC_KR = 0x04,
212 BLURAY_TEXT_CHAR_CODE_GB18030_20001 = 0x05,
213 BLURAY_TEXT_CHAR_CODE_CN_GB = 0x06,
214 BLURAY_TEXT_CHAR_CODE_BIG5 = 0x07
216
218typedef enum {
223
225typedef enum {
229
231typedef enum {
232 BLURAY_DYNAMIC_RANGE_SDR = 0,
233 BLURAY_DYNAMIC_RANGE_HDR10 = 1,
234 BLURAY_DYNAMIC_RANGE_DOLBY_VISION = 2
236
238typedef struct bd_stream_info {
239 uint8_t coding_type;
240 uint8_t format;
241 uint8_t rate;
242 uint8_t char_code;
243 uint8_t lang[4];
244 uint16_t pid;
245 uint8_t aspect;
246 uint8_t subpath_id;
248
250typedef struct bd_clip {
251 uint32_t idx;
252 uint32_t pkt_count;
253 uint8_t still_mode;
254 uint16_t still_time;
268 uint64_t start_time;
269 uint64_t in_time;
270 uint64_t out_time;
271 char clip_id[6];
273
275typedef struct bd_chapter {
276 uint32_t idx;
277 uint64_t start;
278 uint64_t duration;
279 uint64_t offset;
280 unsigned clip_ref;
282
284typedef struct bd_mark {
285 uint32_t idx;
286 int type;
287 uint64_t start;
288 uint64_t duration;
289 uint64_t offset;
290 unsigned clip_ref;
292
294typedef struct bd_title_info {
295 uint32_t idx;
296 uint32_t playlist;
297 uint64_t duration;
298 uint32_t clip_count;
299 uint8_t angle_count;
300 uint32_t chapter_count;
301 uint32_t mark_count;
308
310typedef struct bd_sound_effect {
311 uint8_t num_channels;
312 uint32_t num_frames;
313 const int16_t *samples;
315
316
328void bd_get_version(int *major, int *minor, int *micro);
329
330/*
331 * Disc functions
332 */
333
334struct bd_dir_s;
335struct bd_file_s;
336struct meta_dl;
337
347BLURAY *bd_open(const char *device_path, const char *keyfile_path);
348
357
366int bd_open_disc(BLURAY *bd, const char *device_path, const char *keyfile_path);
367
377 void *read_blocks_handle,
378 int (*read_blocks)(void *handle, void *buf, int lba, int num_blocks));
379
390 void *handle,
391 struct bd_dir_s *(*open_dir)(void *handle, const char *rel_path),
392 struct bd_file_s *(*open_file)(void *handle, const char *rel_path));
393
399void bd_close(BLURAY *bd);
400
409
423const struct meta_dl *bd_get_meta(BLURAY *bd);
424
438int bd_get_meta_file(BLURAY *bd, const char *file_name, void **data, int64_t *size);
439
440
441/*
442 * Title selection without on-disc menus
443 */
444
458uint32_t bd_get_titles(BLURAY *bd, uint8_t flags, uint32_t min_title_length);
459
469
479BLURAY_TITLE_INFO* bd_get_title_info(BLURAY *bd, uint32_t title_idx, unsigned angle);
480
488
497int bd_select_title(BLURAY *bd, uint32_t title);
498
507int bd_select_playlist(BLURAY *bd, uint32_t playlist);
508
517
526int64_t bd_find_seek_point(BLURAY *bd, uint64_t tick);
527
537int bd_read(BLURAY *bd, unsigned char *buf, int len);
538
539
540/*
541 * Playback control functions
542 */
543
551int64_t bd_seek(BLURAY *bd, uint64_t pos);
552
561int64_t bd_seek_time(BLURAY *bd, uint64_t tick);
562
571int64_t bd_seek_chapter(BLURAY *bd, unsigned chapter);
572
581int64_t bd_seek_mark(BLURAY *bd, unsigned mark);
582
591int64_t bd_seek_playitem(BLURAY *bd, unsigned clip_ref);
592
601int bd_select_angle(BLURAY *bd, unsigned angle);
602
610void bd_seamless_angle_change(BLURAY *bd, unsigned angle);
611
634void bd_select_stream(BLURAY *bd, uint32_t stream_type, uint32_t stream_id, uint32_t enable_flag);
635
636#define BLURAY_AUDIO_STREAM 0
637#define BLURAY_PG_TEXTST_STREAM 1
640/*
641 * Playback status functions
642 */
643
652int64_t bd_chapter_pos(BLURAY *bd, unsigned chapter);
653
662
673
682
690uint64_t bd_tell(BLURAY *bd);
691
699uint64_t bd_tell_time(BLURAY *bd);
700
701
702/*
703 * player settings
704 */
705
707typedef enum {
733
746int bd_set_player_setting(BLURAY *bd, uint32_t idx, uint32_t value);
747
757int bd_set_player_setting_str(BLURAY *bd, uint32_t idx, const char *value);
758
759
760/*
761 * events
762 */
763
765typedef enum {
766
769 /*
770 * errors
771 */
772
777 /*
778 * current playback position
779 */
780
789 /*
790 * stream selection
791 */
792
806 /*
807 * playback control
808 */
809
812
829 /*
830 * status
831 */
832
836
852 /*BD_EVENT_LAST = 33, */
853
854} bd_event_e;
855
857typedef struct {
858 uint32_t event;
859 uint32_t param;
860} BD_EVENT;
861
862/* BD_EVENT_ERROR param values */
863#define BD_ERROR_HDMV 1
864#define BD_ERROR_BDJ 2
866/* BD_EVENT_ENCRYPTED param vlues */
867#define BD_ERROR_AACS 3
868#define BD_ERROR_BDPLUS 4
870/* BD_EVENT_TITLE special titles */
871#define BLURAY_TITLE_FIRST_PLAY 0xffff
872#define BLURAY_TITLE_TOP_MENU 0
874/* BD_EVENT_KEY_INTEREST flags */
875#define BLURAY_KIT_PLAY 0x1
876#define BLURAY_KIT_STOP 0x2
877#define BLURAY_KIT_FFW 0x4
878#define BLURAY_KIT_REW 0x8
879#define BLURAY_KIT_TRACK_NEXT 0x10
880#define BLURAY_KIT_TRACK_PREV 0x20
881#define BLURAY_KIT_PAUSE 0x40
882#define BLURAY_KIT_STILL_OFF 0x80
883#define BLURAY_KIT_SEC_AUDIO 0x100
884#define BLURAY_KIT_SEC_VIDEO 0x200
885#define BLURAY_KIT_PG_TEXTST 0x400
887/* BD_EVENT_UO_MASK flags */
888#define BLURAY_UO_MENU_CALL 0x1
889#define BLURAY_UO_TITLE_SEARCH 0x2
899int bd_get_event(BLURAY *bd, BD_EVENT *event);
900
908const char *bd_event_name(uint32_t /* bd_event_e */ event);
909
910/*
911 * On-screen display
912 */
913
914struct bd_overlay_s; /* defined in overlay.h */
915struct bd_argb_overlay_s; /* defined in overlay.h */
916struct bd_argb_buffer_s; /* defined in overlay.h */
917
924typedef void (*bd_overlay_proc_f)(void *handle, const struct bd_overlay_s * const event);
925
932typedef void (*bd_argb_overlay_proc_f)(void *handle, const struct bd_argb_overlay_s * const event);
933
954
970void bd_register_argb_overlay_proc(BLURAY *bd, void *handle, bd_argb_overlay_proc_f func, struct bd_argb_buffer_s *buf);
971
972
973/*
974 * Playback with on-disc menus
975 */
976
987
1000int bd_play_title(BLURAY *bd, unsigned title);
1001
1012int bd_menu_call(BLURAY *bd, int64_t pts);
1013
1026int bd_read_ext(BLURAY *bd, unsigned char *buf, int len, BD_EVENT *event);
1027
1036
1046BLURAY_TITLE_INFO* bd_get_playlist_info(BLURAY *bd, uint32_t playlist, unsigned angle);
1047
1057int bd_get_sound_effect(BLURAY *bd, unsigned sound_id, struct bd_sound_effect *effect);
1058
1059
1060/*
1061 * User interaction
1062 */
1063
1071void bd_set_scr(BLURAY *bd, int64_t pts);
1072
1086int bd_set_rate(BLURAY *bd, uint32_t rate);
1087
1088#define BLURAY_RATE_PAUSED 0
1089#define BLURAY_RATE_NORMAL 90000
1106int bd_user_input(BLURAY *bd, int64_t pts, uint32_t key);
1107
1120int bd_mouse_select(BLURAY *bd, int64_t pts, uint16_t x, uint16_t y);
1121
1122
1123/*
1124 * Testing and debugging
1125 *
1126 * Note: parsing functions can't be used with UDF images.
1127 */
1128
1129/* access to internal information */
1130
1131struct mpls_pl;
1132struct bdjo_data;
1133struct mobj_objects;
1134
1143struct clpi_cl *bd_get_clpi(BLURAY *bd, unsigned clip_ref);
1144
1146struct clpi_cl *bd_read_clpi(const char *clpi_file);
1147
1154void bd_free_clpi(struct clpi_cl *cl);
1155
1167int bd_get_clip_infos(BLURAY *bd, unsigned clip, uint64_t *clip_start_time, uint64_t *stream_start_time, uint64_t *pos, uint64_t *duration);
1168
1177struct mpls_pl* bd_get_title_mpls(BLURAY * bd);
1178
1180struct mpls_pl *bd_read_mpls(const char *mpls_file);
1182void bd_free_mpls(struct mpls_pl *);
1183
1185struct mobj_objects *bd_read_mobj(const char *mobj_file);
1187void bd_free_mobj(struct mobj_objects *);
1188
1190struct bdjo_data *bd_read_bdjo(const char *bdjo_file);
1192void bd_free_bdjo(struct bdjo_data *);
1193
1194/* BD-J testing */
1195
1197int bd_start_bdj(BLURAY *bd, const char* start_object);
1200
1214int bd_read_file(BLURAY *bd, const char *path, void **data, int64_t *size);
1215
1226struct bd_dir_s *bd_open_dir(BLURAY *bd, const char *dir);
1227
1245struct bd_file_s *bd_open_file_dec(BLURAY *bd, const char *path);
1246
1247
1248#ifdef __cplusplus
1249}
1250#endif
1251
1252#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:924
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_find_seek_point(BLURAY *bd, uint64_t tick)
Find the byte position to specific time in 90Khz ticks.
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:707
@ BLURAY_PLAYER_SETTING_DISPLAY_CAP
Display capability.
Definition: bluray.h:717
@ BLURAY_PLAYER_SETTING_PERSISTENT_STORAGE
Enable/disable BD-J persistent storage.
Definition: bluray.h:727
@ BLURAY_PLAYER_SETTING_AUDIO_LANG
Initial audio language.
Definition: bluray.h:708
@ BLURAY_PLAYER_SETTING_COUNTRY_CODE
Player country code.
Definition: bluray.h:711
@ BLURAY_PLAYER_SETTING_OUTPUT_PREFER
Output mode preference.
Definition: bluray.h:713
@ BLURAY_PLAYER_CACHE_ROOT
Root path to the BD_J cache storage location.
Definition: bluray.h:730
@ BLURAY_PLAYER_SETTING_HDR_PREFERENCE
HDR preference.
Definition: bluray.h:721
@ BLURAY_PLAYER_SETTING_VIDEO_CAP
Video capability.
Definition: bluray.h:716
@ BLURAY_PLAYER_SETTING_TEXT_CAP
Text Subtitle capability.
Definition: bluray.h:723
@ BLURAY_PLAYER_SETTING_PLAYER_PROFILE
Player profile and version.
Definition: bluray.h:724
@ BLURAY_PLAYER_SETTING_REGION_CODE
Player region code.
Definition: bluray.h:712
@ BLURAY_PLAYER_SETTING_PG_LANG
Initial PG/SPU language.
Definition: bluray.h:709
@ BLURAY_PLAYER_SETTING_3D_CAP
3D capability.
Definition: bluray.h:718
@ BLURAY_PLAYER_SETTING_PARENTAL
Age for parental control.
Definition: bluray.h:714
@ BLURAY_PLAYER_SETTING_SDR_CONV_PREFER
SDR conversion preference.
Definition: bluray.h:722
@ BLURAY_PLAYER_SETTING_UHD_CAP
UHD capability.
Definition: bluray.h:719
@ BLURAY_PLAYER_SETTING_MENU_LANG
Initial menu language.
Definition: bluray.h:710
@ BLURAY_PLAYER_SETTING_DECODE_PG
Enable/disable PG (subtitle) decoder.
Definition: bluray.h:726
@ BLURAY_PLAYER_SETTING_UHD_DISPLAY_CAP
UHD display capability.
Definition: bluray.h:720
@ BLURAY_PLAYER_SETTING_AUDIO_CAP
Audio capability.
Definition: bluray.h:715
@ BLURAY_PLAYER_PERSISTENT_ROOT
Root path to the BD_J persistent storage location.
Definition: bluray.h:729
@ BLURAY_PLAYER_JAVA_HOME
Location of JRE.
Definition: bluray.h:731
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.
struct mpls_pl * bd_get_title_mpls(BLURAY *bd)
Get the MPLS struct of the current title.
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:932
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:225
@ BLURAY_MARK_ENTRY
entry mark for chapter search
Definition: bluray.h:226
@ BLURAY_MARK_LINK
link point
Definition: bluray.h:227
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:231
bd_video_rate_e
Stream video frame rate.
Definition: bluray.h:172
@ BLURAY_VIDEO_RATE_60000_1001
59.94 Hz
Definition: bluray.h:178
@ BLURAY_VIDEO_RATE_24000_1001
23.976 Hz
Definition: bluray.h:173
@ BLURAY_VIDEO_RATE_50
50 Hz
Definition: bluray.h:177
@ BLURAY_VIDEO_RATE_24
24 Hz
Definition: bluray.h:174
@ BLURAY_VIDEO_RATE_25
25 Hz
Definition: bluray.h:175
@ BLURAY_VIDEO_RATE_30000_1001
29.97 Hz
Definition: bluray.h:176
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:137
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:207
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:160
@ BLURAY_VIDEO_FORMAT_1080P
SMPTE 274M.
Definition: bluray.h:166
@ BLURAY_VIDEO_FORMAT_720P
SMPTE 296M.
Definition: bluray.h:165
@ BLURAY_VIDEO_FORMAT_576P
ITU-R BT.1358.
Definition: bluray.h:167
@ BLURAY_VIDEO_FORMAT_576I
ITU-R BT.601-4.
Definition: bluray.h:162
@ BLURAY_VIDEO_FORMAT_480P
SMPTE 293M.
Definition: bluray.h:163
@ BLURAY_VIDEO_FORMAT_1080I
SMPTE 274M.
Definition: bluray.h:164
@ BLURAY_VIDEO_FORMAT_480I
ITU-R BT.601-5.
Definition: bluray.h:161
@ BLURAY_VIDEO_FORMAT_2160P
BT.2020.
Definition: bluray.h:168
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_get_clip_infos(BLURAY *bd, unsigned clip, uint64_t *clip_start_time, uint64_t *stream_start_time, uint64_t *pos, uint64_t *duration)
Get information about the clip.
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:46
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:182
int bd_menu_call(BLURAY *bd, int64_t pts)
Open BluRay disc Top Menu.
bd_audio_format_e
Stream audio format.
Definition: bluray.h:188
void bd_free_mpls(struct mpls_pl *)
Testing/debugging: Free parsed playlist.
bd_audio_rate_e
Stream audio rate.
Definition: bluray.h:196
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:765
@ BD_EVENT_SEEK
HDMV VM or JVM seeked the stream.
Definition: bluray.h:817
@ BD_EVENT_MENU
Interactive menu visible.
Definition: bluray.h:841
@ BD_EVENT_PIP_PG_TEXTST_STREAM
1..255, 0xfff = none
Definition: bluray.h:796
@ BD_EVENT_STILL_TIME
Still playback for n seconds (reached end of still mode play item).
Definition: bluray.h:824
@ BD_EVENT_SECONDARY_VIDEO_STREAM
1..32, 0xff = none
Definition: bluray.h:798
@ BD_EVENT_TITLE
current title, 1...N (0 = top menu)
Definition: bluray.h:782
@ BD_EVENT_PG_TEXTST_STREAM
1..255, 0xfff = none
Definition: bluray.h:795
@ BD_EVENT_STEREOSCOPIC_STATUS
3D
Definition: bluray.h:844
@ BD_EVENT_PIP_PG_TEXTST
0 - disable, 1 - enable
Definition: bluray.h:801
@ BD_EVENT_IDLE
Nothing to do.
Definition: bluray.h:835
@ BD_EVENT_PLAYLIST
current playlist (xxxxx.mpls)
Definition: bluray.h:783
@ BD_EVENT_PG_TEXTST
0 - disable, 1 - enable
Definition: bluray.h:800
@ BD_EVENT_CHAPTER
current chapter, 1...N
Definition: bluray.h:785
@ BD_EVENT_ANGLE
current angle, 1...N
Definition: bluray.h:781
@ BD_EVENT_PLAYITEM
current play item, 0...N-1
Definition: bluray.h:784
@ BD_EVENT_UO_MASK_CHANGED
UO mask changed.
Definition: bluray.h:850
@ BD_EVENT_ENCRYPTED
.m2ts file is encrypted and can't be played
Definition: bluray.h:775
@ BD_EVENT_POPUP
Pop-Up menu available.
Definition: bluray.h:838
@ BD_EVENT_PLAYLIST_STOP
HDMV VM or JVM stopped playlist playback.
Definition: bluray.h:811
@ BD_EVENT_SECONDARY_VIDEO
0 - disable, 1 - enable
Definition: bluray.h:803
@ BD_EVENT_KEY_INTEREST_TABLE
BD-J key interest table changed.
Definition: bluray.h:847
@ BD_EVENT_END_OF_TITLE
end of title reached
Definition: bluray.h:787
@ BD_EVENT_IG_STREAM
1..32
Definition: bluray.h:794
@ BD_EVENT_PLAYMARK
playmark reached
Definition: bluray.h:786
@ BD_EVENT_SECONDARY_AUDIO
0 - disable, 1 - enable
Definition: bluray.h:802
@ BD_EVENT_SOUND_EFFECT
Play sound effect.
Definition: bluray.h:827
@ BD_EVENT_SECONDARY_VIDEO_SIZE
0 - PIP, 0xf - fullscreen
Definition: bluray.h:804
@ BD_EVENT_STILL
still playback (pause)
Definition: bluray.h:820
@ BD_EVENT_DISCONTINUITY
discontinuity in the stream (non-seamless connection).
Definition: bluray.h:814
@ BD_EVENT_NONE
no pending events
Definition: bluray.h:767
@ BD_EVENT_SECONDARY_AUDIO_STREAM
1..32, 0xff = none
Definition: bluray.h:797
@ BD_EVENT_ERROR
Fatal error.
Definition: bluray.h:773
@ BD_EVENT_AUDIO_STREAM
1..32, 0xff = none
Definition: bluray.h:793
@ BD_EVENT_READ_ERROR
Reading of .m2ts aligned unit failed.
Definition: bluray.h:774
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:218
@ BLURAY_STILL_INFINITE
Infinite still.
Definition: bluray.h:221
@ BLURAY_STILL_TIME
Still playback for fixed time.
Definition: bluray.h:220
@ BLURAY_STILL_NONE
No still (normal playback)
Definition: bluray.h:219
Event.
Definition: bluray.h:857
uint32_t event
Event type (bd_event_e)
Definition: bluray.h:858
uint32_t param
Event data.
Definition: bluray.h:859
Clip information.
Definition: bluray.h:250
uint16_t still_time
Still time (seconds) if still_mode == BD_STILL_TIME.
Definition: bluray.h:254
uint8_t sec_video_stream_count
Number of secondary video streams.
Definition: bluray.h:260
BLURAY_STREAM_INFO * audio_streams
Audio streams information.
Definition: bluray.h:262
uint8_t pg_stream_count
Number of PG (Presentation Graphics) streams.
Definition: bluray.h:257
uint64_t start_time
start media time, 90kHz, ("playlist time")
Definition: bluray.h:268
BLURAY_STREAM_INFO * pg_streams
PG (Presentation Graphics) streams information.
Definition: bluray.h:263
uint8_t sec_audio_stream_count
Number of secondary audio streams.
Definition: bluray.h:259
uint64_t out_time
end timestamp, 90kHz
Definition: bluray.h:270
uint8_t audio_stream_count
Number of audio streams.
Definition: bluray.h:256
uint64_t in_time
start timestamp, 90kHz
Definition: bluray.h:269
uint32_t pkt_count
Number of mpeg-ts packets.
Definition: bluray.h:252
BLURAY_STREAM_INFO * video_streams
Video streams information.
Definition: bluray.h:261
uint8_t video_stream_count
Number of video streams.
Definition: bluray.h:255
uint8_t ig_stream_count
Number of IG (Interactive Graphics) streams.
Definition: bluray.h:258
BLURAY_STREAM_INFO * sec_audio_streams
Secondary audio streams information.
Definition: bluray.h:265
BLURAY_STREAM_INFO * ig_streams
IG (Interactive Graphics) streams information.
Definition: bluray.h:264
BLURAY_STREAM_INFO * sec_video_streams
Secondary video streams information.
Definition: bluray.h:266
uint8_t still_mode
Clip still mode (bd_still_mode_e)
Definition: bluray.h:253
BluRay disc information.
Definition: bluray.h:73
const BLURAY_TITLE * top_menu
titles[0].
Definition: bluray.h:89
uint8_t libjvm_detected
1 if usable Java VM was found
Definition: bluray.h:98
uint8_t frame_rate
bd_video_rate_e
Definition: bluray.h:106
uint8_t bdplus_detected
1 if disc is using BD+ encoding
Definition: bluray.h:120
const BLURAY_TITLE *const * titles
index is title number 1 ... N
Definition: bluray.h:87
uint8_t content_exist_3D
1 if 3D content exists on the disc
Definition: bluray.h:107
uint8_t initial_dynamic_range_type
bd_dynamic_range_type_e
Definition: bluray.h:128
uint32_t bdplus_date
BD+ content code relese date ((year<<16)|(month<<8)|day)
Definition: bluray.h:125
uint8_t libaacs_detected
1 if usable AACS decoding library was found
Definition: bluray.h:113
uint8_t bdplus_gen
BD+ content code generation.
Definition: bluray.h:124
uint32_t num_unsupported_titles
number of unsupported titles
Definition: bluray.h:93
const char * disc_name
optional disc name in preferred language
Definition: bluray.h:77
uint8_t aacs_handled
1 if disc is using supported AACS encoding
Definition: bluray.h:114
uint8_t first_play_supported
1 if First Play title is present on the disc and can be played
Definition: bluray.h:83
uint8_t bdj_supported
(deprecated)
Definition: bluray.h:97
const char * udf_volume_id
optional UDF volume identifier
Definition: bluray.h:78
uint8_t no_menu_support
HDMV / BD-J titles.
Definition: bluray.h:82
uint8_t bdplus_handled
1 if disc is using supporred BD+ encoding
Definition: bluray.h:122
uint8_t bdj_detected
BD-J info (valid only if disc uses BD-J)
Definition: bluray.h:96
uint32_t num_hdmv_titles
number of HDMV titles
Definition: bluray.h:91
uint32_t num_bdj_titles
number of BD-J titles
Definition: bluray.h:92
uint8_t initial_output_mode_preference
0 - 2D, 1 - 3D
Definition: bluray.h:108
uint8_t bluray_detected
1 if BluRay disc was detected
Definition: bluray.h:74
const BLURAY_TITLE * first_play
titles[N+1].
Definition: bluray.h:88
int aacs_error_code
AACS error code (BD_AACS_*)
Definition: bluray.h:116
int aacs_mkbv
AACS MKB version.
Definition: bluray.h:117
uint8_t top_menu_supported
1 if Top Menu title is present on the disc and can be played
Definition: bluray.h:84
uint8_t libbdplus_detected
1 if usable BD+ decoding library was found
Definition: bluray.h:121
uint8_t bdj_handled
1 if usable Java VM + libbluray.jar was found
Definition: bluray.h:99
uint8_t aacs_detected
1 if disc is using AACS encoding
Definition: bluray.h:112
uint32_t num_titles
number of titles on the disc, not including "First Play" and "Top Menu"
Definition: bluray.h:86
uint8_t video_format
bd_video_format_e
Definition: bluray.h:105
Sound effect data.
Definition: bluray.h:310
const int16_t * samples
48000 Hz, 16 bit LPCM.
Definition: bluray.h:313
uint32_t num_frames
Number of audio frames.
Definition: bluray.h:312
uint8_t num_channels
1 - mono, 2 - stereo
Definition: bluray.h:311
Clip substream information.
Definition: bluray.h:238
uint8_t aspect
Stream video aspect ratio (bd_video_aspect_e)
Definition: bluray.h:245
uint8_t rate
Stream frame rate (bd_audio_rate_e or bd_video_rate_e)
Definition: bluray.h:241
uint8_t format
Stream format (bd_video_format_e or bd_audio_format_e)
Definition: bluray.h:240
uint8_t char_code
Text subtitle charachter code (bd_char_code_e)
Definition: bluray.h:242
uint8_t subpath_id
Sub path identifier (= separate mpeg-ts mux / .m2ts file)
Definition: bluray.h:246
uint8_t coding_type
Stream coding (bd_stream_type_e)
Definition: bluray.h:239
uint16_t pid
mpeg-ts PID
Definition: bluray.h:244
Chapter entry.
Definition: bluray.h:275
uint32_t idx
Chapter index (number - 1)
Definition: bluray.h:276
uint64_t start
start media time, 90kHz, ("playlist time")
Definition: bluray.h:277
unsigned clip_ref
Clip reference (index to playlist clips list)
Definition: bluray.h:280
uint64_t offset
distance from title start, bytes
Definition: bluray.h:279
uint64_t duration
duration
Definition: bluray.h:278
Playlist information.
Definition: bluray.h:294
uint8_t mvc_base_view_r_flag
MVC base view (0 - left, 1 - right)
Definition: bluray.h:306
BLURAY_CLIP_INFO * clips
Clip information.
Definition: bluray.h:302
uint32_t chapter_count
Number of chapters.
Definition: bluray.h:300
uint8_t angle_count
Number of angles.
Definition: bluray.h:299
BLURAY_TITLE_CHAPTER * chapters
Chapter information.
Definition: bluray.h:303
uint32_t mark_count
Number of playmarks.
Definition: bluray.h:301
uint32_t clip_count
Number of clips.
Definition: bluray.h:298
BLURAY_TITLE_MARK * marks
Playmark information.
Definition: bluray.h:304
uint64_t duration
Playlist duration, 90 kHz.
Definition: bluray.h:297
uint32_t idx
Playlist index number (filled only with bd_get_title_info())
Definition: bluray.h:295
uint32_t playlist
Playlist ID (mpls file name)
Definition: bluray.h:296
Playmark information.
Definition: bluray.h:284
unsigned clip_ref
Clip reference (index to playlist clips list)
Definition: bluray.h:290
uint64_t duration
time to next mark
Definition: bluray.h:288
uint64_t start
mark media time, 90kHz, ("playlist time")
Definition: bluray.h:287
uint32_t idx
Mark index (number - 1)
Definition: bluray.h:285
int type
bd_mark_type_e
Definition: bluray.h:286
uint64_t offset
mark distance from title start, bytes
Definition: bluray.h:289
HDMV / BD-J title information.
Definition: bluray.h:61
uint8_t bdj
0 - HDMV title.
Definition: bluray.h:68
uint8_t interactive
1 if title is interactive (title length and playback position should not be shown in UI)
Definition: bluray.h:63
uint32_t id_ref
Movie Object number / bdjo file number.
Definition: bluray.h:69
uint8_t hidden
1 if title number should not be shown during playback
Definition: bluray.h:65
uint8_t accessible
1 if it is allowed to jump into this title
Definition: bluray.h:64
const char * name
optional title name in preferred language
Definition: bluray.h:62
Directory access.
Definition: filesystem.h:126
File access.
Definition: filesystem.h:43