/* * Copyright (C) 2000, 2001, 2002 Björn Englund , * Håkan Hjort * * This file is part of libdvdread. * * libdvdread is free software; you can redistribute it and/or modify * it under the terms of the GNU General Public License as published by * the Free Software Foundation; either version 2 of the License, or * (at your option) any later version. * * libdvdread is distributed in the hope that it will be useful, * but WITHOUT ANY WARRANTY; without even the implied warranty of * MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the * GNU General Public License for more details. * * You should have received a copy of the GNU General Public License along * with libdvdread; if not, write to the Free Software Foundation, Inc., * 51 Franklin Street, Fifth Floor, Boston, MA 02110-1301 USA. */ /** * handle = ifoOpen(dvd, title); * * Opens an IFO and reads in all the data for the IFO file corresponding to the * given title. If title 0 is given, the video manager IFO file is read. * Returns a handle to a completely parsed structure. */ ifo_handle_t *ifoOpen(dvd_reader_t *, int ); /** * handle = ifoOpenVMGI(dvd); * * Opens an IFO and reads in _only_ the vmgi_mat data. This call can be used * together with the calls below to read in each segment of the IFO file on * demand. */ ifo_handle_t *ifoOpenVMGI(dvd_reader_t *); /** * handle = ifoOpenVTSI(dvd, title); * * Opens an IFO and reads in _only_ the vtsi_mat data. This call can be used * together with the calls below to read in each segment of the IFO file on * demand. */ ifo_handle_t *ifoOpenVTSI(dvd_reader_t *, int); /** * ifoClose(ifofile); * Cleans up the IFO information. This will free all data allocated for the * substructures. */ void ifoClose(ifo_handle_t *); /** * The following functions are for reading only part of the VMGI/VTSI files. * Returns 1 if the data was successfully read and 0 on error. */ /** * okay = ifoRead_PLT_MAIT(ifofile); * * Read in the Parental Management Information table, filling the * ifofile->ptl_mait structure and its substructures. This data is only * located in the video manager information file. This fills the * ifofile->ptl_mait structure and all its substructures. */ int ifoRead_PTL_MAIT(ifo_handle_t *); /** * okay = ifoRead_VTS_ATRT(ifofile); * * Read in the attribute table for the main menu vob, filling the * ifofile->vts_atrt structure and its substructures. Only located in the * video manager information file. This fills in the ifofile->vts_atrt * structure and all its substructures. */ int ifoRead_VTS_ATRT(ifo_handle_t *); /** * okay = ifoRead_TT_SRPT(ifofile); * * Reads the title info for the main menu, filling the ifofile->tt_srpt * structure and its substructures. This data is only located in the video * manager information file. This structure is mandatory in the IFO file. */ int ifoRead_TT_SRPT(ifo_handle_t *); /** * okay = ifoRead_VTS_PTT_SRPT(ifofile); * * Reads in the part of title search pointer table, filling the * ifofile->vts_ptt_srpt structure and its substructures. This data is only * located in the video title set information file. This structure is * mandatory, and must be included in the VTSI file. */ int ifoRead_VTS_PTT_SRPT(ifo_handle_t *); /** * okay = ifoRead_FP_PGC(ifofile); * * Reads in the first play program chain data, filling the * ifofile->first_play_pgc structure. This data is only located in the video * manager information file (VMGI). This structure is optional. */ int ifoRead_FP_PGC(ifo_handle_t *); /** * okay = ifoRead_PGCIT(ifofile); * * Reads in the program chain information table for the video title set. Fills * in the ifofile->vts_pgcit structure and its substructures, which includes * the data for each program chain in the set. This data is only located in * the video title set information file. This structure is mandatory, and must * be included in the VTSI file. */ int ifoRead_PGCIT(ifo_handle_t *); /** * okay = ifoRead_PGCI_UT(ifofile); * * Reads in the menu PGCI unit table for the menu VOB. For the video manager, * this corresponds to the VIDEO_TS.VOB file, and for each title set, this * corresponds to the VTS_XX_0.VOB file. This data is located in both the * video manager and video title set information files. For VMGI files, this * fills the ifofile->vmgi_pgci_ut structure and all its substructures. For * VTSI files, this fills the ifofile->vtsm_pgci_ut structure. */ int ifoRead_PGCI_UT(ifo_handle_t *); /** * okay = ifoRead_VTS_TMAPT(ifofile); * * Reads in the VTS Time Map Table, this data is only located in the video * title set information file. This fills the ifofile->vts_tmapt structure * and all its substructures. When pressent enables VOBU level time-based * seeking for One_Sequential_PGC_Titles. */ int ifoRead_VTS_TMAPT(ifo_handle_t *); /** * okay = ifoRead_C_ADT(ifofile); * * Reads in the cell address table for the menu VOB. For the video manager, * this corresponds to the VIDEO_TS.VOB file, and for each title set, this * corresponds to the VTS_XX_0.VOB file. This data is located in both the * video manager and video title set information files. For VMGI files, this * fills the ifofile->vmgm_c_adt structure and all its substructures. For VTSI * files, this fills the ifofile->vtsm_c_adt structure. */ int ifoRead_C_ADT(ifo_handle_t *); /** * okay = ifoRead_TITLE_C_ADT(ifofile); * * Reads in the cell address table for the video title set corresponding to * this IFO file. This data is only located in the video title set information * file. This structure is mandatory, and must be included in the VTSI file. * This call fills the ifofile->vts_c_adt structure and its substructures. */ int ifoRead_TITLE_C_ADT(ifo_handle_t *); /** * okay = ifoRead_VOBU_ADMAP(ifofile); * * Reads in the VOBU address map for the menu VOB. For the video manager, this * corresponds to the VIDEO_TS.VOB file, and for each title set, this * corresponds to the VTS_XX_0.VOB file. This data is located in both the * video manager and video title set information files. For VMGI files, this * fills the ifofile->vmgm_vobu_admap structure and all its substructures. For * VTSI files, this fills the ifofile->vtsm_vobu_admap structure. */ int ifoRead_VOBU_ADMAP(ifo_handle_t *); /** * okay = ifoRead_TITLE_VOBU_ADMAP(ifofile); * * Reads in the VOBU address map for the associated video title set. This data * is only located in the video title set information file. This structure is * mandatory, and must be included in the VTSI file. Fills the * ifofile->vts_vobu_admap structure and its substructures. */ int ifoRead_TITLE_VOBU_ADMAP(ifo_handle_t *); /** * okay = ifoRead_TXTDT_MGI(ifofile); * * Reads in the text data strings for the DVD. Fills the ifofile->txtdt_mgi * structure and all its substructures. This data is only located in the video * manager information file. This structure is mandatory, and must be included * in the VMGI file. */ int ifoRead_TXTDT_MGI(ifo_handle_t *); /** * The following functions are used for freeing parsed sections of the * ifo_handle_t structure and the allocated substructures. The free calls * below are safe: they will not mind if you attempt to free part of an IFO * file which was not read in or which does not exist. */ void ifoFree_PTL_MAIT(ifo_handle_t *); void ifoFree_VTS_ATRT(ifo_handle_t *); void ifoFree_TT_SRPT(ifo_handle_t *); void ifoFree_VTS_PTT_SRPT(ifo_handle_t *); void ifoFree_FP_PGC(ifo_handle_t *); void ifoFree_PGCIT(ifo_handle_t *); void ifoFree_PGCI_UT(ifo_handle_t *); void ifoFree_VTS_TMAPT(ifo_handle_t *); void ifoFree_C_ADT(ifo_handle_t *); void ifoFree_TITLE_C_ADT(ifo_handle_t *); void ifoFree_VOBU_ADMAP(ifo_handle_t *); void ifoFree_TITLE_VOBU_ADMAP(ifo_handle_t *); void ifoFree_TXTDT_MGI(ifo_handle_t *);