updated on Thu Jan 19 20:01:47 UTC 2012
[aur-mirror.git] / libdvdread-dvdfilestat / dvd_reader.h.patch
blobb590882bb2d600af2a37822159d7eed9386a956b
1 *** dvd_reader.h 2008-09-06 16:55:51.000000000 -0500
2 --- dvd_reader.h 2009-09-09 11:49:26.355110103 -0500
3 ***************
4 *** 114,119 ****
5 --- 114,153 ----
6 single file. */
7 } dvd_read_domain_t;
9 + typedef struct {
10 + off_t size; /**< Total size of file in bytes */
11 + int nr_parts; /**< Number of file parts */
12 + off_t parts_size[9]; /**< Size of each part in bytes */
13 + } dvd_stat_t;
15 + /**
16 + * Stats a file on the DVD given the title number and domain.
17 + * The information about the file is stored in a dvd_stat_t
18 + * which contains information about the size of the file and
19 + * the number of parts in case of a multipart file and the respective
20 + * sizes of the parts.
21 + * A multipart file is for instance VTS_02_1.VOB, VTS_02_2.VOB, VTS_02_3.VOB
22 + * The size of VTS_02_1.VOB will be stored in stat->parts_size[0],
23 + * VTS_02_2.VOB in stat->parts_size[1], ...
24 + * The total size (sum of all parts) is stored in stat->size and
25 + * stat->nr_parts will hold the number of parts.
26 + * Only DVD_READ_TITLE_VOBS (VTS_??_[1-9].VOB) can be multipart files.
27 + *
28 + * This function is only of use if you want to get the size of each file
29 + * in the filesystem. These sizes are not needed to use any other
30 + * functions in libdvdread.
31 + *
32 + * @param dvd A dvd read handle.
33 + * @param titlenum Which Video Title Set should be used, VIDEO_TS is 0.
34 + * @param domain Which domain.
35 + * @param stat Pointer to where the result is stored.
36 + * @return If successful 0, otherwise -1.
37 + *
38 + * int DVDFileStat(dvd, titlenum, domain, stat);
39 + */
40 + int DVDFileStat(dvd_reader_t *, int, dvd_read_domain_t, dvd_stat_t *);
43 /**
44 * Opens a file on the DVD given the title number and domain.