ifo.h

VLC媒体播放程序

/*****************************************************************************
 * dvd_ifo.h: Structures for ifo parsing
 *****************************************************************************
 * Copyright (C) 1999-2001 VideoLAN
 * $Id: ifo.h,v 1.4 2003/10/25 00:49:13 sam Exp $
 *
 * Author: St閜hane Borel <[e-mail]>
 *
 * based on:
 *  - libifo by Thomas Mirlacher <[e-mail]>
 *  - IFO structure documentation by Thomas Mirlacher, Bj鰎n Englund,
 *  H錵an Hjort
 *
 * This program 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.
 *
 * This program 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 this program; if not, write to the Free Software
 * Foundation, Inc., 59 Temple Place - Suite 330, Boston, MA  02111, USA.
 *****************************************************************************/

/*****************************************************************************
 * Common structures for Video Management and Video Title sets
 *****************************************************************************/

/*
 * Program Chain structures
 */
typedef struct ifo_video_s
{
    uint8_t i_compression         ;/* 2; */
    uint8_t i_system              ;/* 2; */
    uint8_t i_ratio               ;/* 2; */
    uint8_t i_perm_displ          ;/* 2; */

    uint8_t i_line21_1            ;/* 1; */
    uint8_t i_line21_2            ;/* 1; */
    uint8_t i_source_res          ;/* 2; */
    uint8_t i_letterboxed         ;/* 1; */
    uint8_t i_mode                ;/* 1; */
} ifo_video_t;

/* Audio type information */
typedef struct ifo_audio_s
{
    uint8_t i_coding_mode         ;/* 3; */
    uint8_t i_multichannel_extension  ;/* 1; */
    uint8_t i_type                ;/* 2; */
    uint8_t i_appl_mode           ;/* 2; */

    uint8_t i_quantization        ;/* 2; */
    uint8_t i_sample_freq         ;/* 2; */
    uint8_t i_test                ;/* 1; */
    uint8_t i_num_channels        ;/* 3; */
    uint16_t i_lang_code          ;/* 16;   // <char> description */
    uint8_t i_foo                 ;/* 8;    // 0x00000000 ? */
    uint8_t i_caption             ;/* 8; */
    uint8_t i_bar                 ;/* 8;    // 0x00000000 ? */
} ifo_audio_t;

/* Audio Status */
typedef struct audio_status_s
{
    uint8_t i_available;        /* 1 */
    uint8_t i_position;         /* 7 */
    uint8_t i_foo;              /* 8 */
} audio_status_t;

typedef struct ifo_spu_t
{
    uint16_t i_prefix             ;/* 16;   // 0x0100 ? */
    uint16_t i_lang_code          ;/* 16;   // <char> description */
    uint8_t i_foo                 ;/* 8;    // dont know */
    uint8_t i_caption             ;/* 8;    // 0x00 ? */
} ifo_spu_t;

/* Subpicture status */
typedef struct spu_status_s
{
    uint8_t i_available;        /*1*/
    uint8_t i_position_43;      /*7*/
    uint8_t i_position_wide;    /*8*/
    uint8_t i_position_letter;  /*8*/
    uint8_t i_position_pan;     /*8*/
} spu_status_t;


/* Ifo vitual machine Commands */
typedef struct command_desc_s
{
    unsigned int    i_type      :3;
    unsigned int    i_direct    :1;
    unsigned int    i_cmd       :4;
    unsigned int    i_dir_cmp   :1;
    unsigned int    i_cmp       :3;
    unsigned int    i_sub_cmd   :4;
    union
    {
        uint8_t     pi_8[6];
        uint16_t    pi_16[3];
    } data;
} command_desc_t;

/* Program Chain Command Table
  - start at i_pgc_com_tab_sbyte */
typedef struct command_s
{
    uint16_t        i_pre_command_nb;               /* 2 bytes */
    uint16_t        i_post_command_nb;              /* 2 bytes */
    uint16_t        i_cell_command_nb;              /* 2 bytes */
/*    char[2]         ??? */
    uint64_t * p_pre_command;                       /* i_pre_com_nb * 8 bytes */
    uint64_t * p_post_command;                      /* i_post_com_nb * 8 bytes */
    uint64_t * p_cell_command;                      /* i_pre_com_nb * 8 bytes */

/*    command_desc_t* p_cell_command;                 // i_cell_com_nb * 8 bytes */
/*    command_desc_t* p_post_command;                 // i_post_com_nb * 8 bytes */
/*    command_desc_t* p_cell_command;                 // i_cell_com_nb * 8 bytes */
} command_t;

/* Program Chain Map Table
 * - start at "i_pgc_prg_map_sbyte" */
typedef struct chapter_map_s
{
    uint8_t *       pi_start_cell;              /* i_prg_nb * 1 byte  */
} chapter_map_t;

/* Cell Playback Information Table
 * we have a pointer to such a structure for each cell
 * - first start at "i_cell_play_inf_sbyte" */
typedef struct cell_play_s
{
    /* This information concerns the currently selected cell */
    uint16_t        i_category;                 /* 2 bytes */
    uint8_t         i_still_time;               /* 1 byte; in seconds; ff=inf */
    uint8_t         i_command_nb;               /* 1 byte; 0 = no com */
    uint32_t        i_play_time;                /* 4 bytes */
    uint32_t        i_first_sector;             /* 4 bytes */
    uint32_t        i_first_ilvu_vobu_esector;  /* 4 bytes; ??? */
    uint32_t        i_last_vobu_start_sector;   /* 4 bytes */
    uint32_t        i_last_sector;              /* 4 bytes */
} cell_play_t;

/* Cell Position Information Table
 * we have a pointer to such a structure for each cell
 * - first start at "i_cell_pos_inf_sbyte" */
typedef struct cell_pos_s
{
    /* This information concerns the currently selected cell */
    uint16_t        i_vob_id;                   /* 2 bytes */
/*    char            ??? */
    uint8_t         i_cell_id;                  /* 1 byte */
} cell_pos_t;

/* Main structure for Program Chain
 * - start at i_fp_pgc_sbyte
 * - or at i_vmgm_pgci_sbyte in vmgm_pgci_srp_t */
typedef struct title_s
{
    /* Global features of program chain */
/*    char[2]         ??? */
    uint8_t         i_chapter_nb;                   /* 1 byte */
    uint8_t         i_cell_nb;                  /* 1 byte */
    uint32_t        i_play_time;                /* 4 bytes */
    uint32_t        i_prohibited_user_op;       /* 4 bytes */
    audio_status_t  pi_audio_status[8];         /* 8*2 bytes */
    spu_status_t    pi_spu_status[32];       /* 32*4 bytes */
    uint16_t        i_next_title_num;              /* 2 bytes */
    uint16_t        i_prev_title_num;              /* 2 bytes */
    uint16_t        i_go_up_title_num;              /* 2 bytes */
    uint8_t         i_still_time;               /* 1 byte ; in seconds */
    uint8_t         i_play_mode;                /* 1 byte */
    /* In video_ts.ifo, the 3 significant bytes of each color are
     * preceded by 1 unsignificant byte */
    uint32_t        pi_yuv_color[16];           /* 16*3 bytes */
    /* Here come the start bytes of the following structures */
    uint16_t        i_command_start_byte;            /* 2 bytes */
    uint16_t        i_chapter_map_start_byte;            /* 2 bytes */
    uint16_t        i_cell_play_start_byte;      /* 2 bytes */
    uint16_t        i_cell_pos_start_byte;       /* 2 bytes */
    /* Predefined structures */
    command_t       command;
    chapter_map_t   chapter_map;
    cell_play_t*    p_cell_play;           /* i_cell_nb * 24 bytes */
    cell_pos_t*     p_cell_pos;             /* i_cell_nb * 4 bytes */
} title_t;

/*
 * Menu PGCI Unit Table
 */

/* Menu PGCI Language unit Descriptor */
typedef struct unit_s
{
    uint16_t        i_lang_code;            /* 2 bytes (ISO-xx) */
/*    char            ??? */
    uint8_t         i_existence_mask;           /* 1 byte */
    uint32_t        i_unit_inf_start_byte;                 /* 4 bytes */
} unit_t;

typedef struct unit_title_s
{
    uint8_t         i_category_mask;             /* 1 byte */
    uint8_t         i_category;                  /* 1 byte */
    uint16_t        i_parental_mask;                 /* 2 bytes */
    uint32_t        i_title_start_byte;               /* 4 bytes */
    title_t         title;
} unit_title_t;

/* Menu PGCI Language Unit Table
 * - start at i_lu_sbyte */
typedef struct unit_inf_s
{
    uint16_t        i_title_nb;                   /* 2 bytes */
/*    char[2]         ??? */
    uint32_t        i_last_byte;                /* 4 bytes */
    unit_title_t *  p_title;                      /* i_srp_nb * 8 bytes */
} unit_inf_t;

/* Main Struct for Menu PGCI
 * - start at i_*_pgci_ut_ssector */
typedef struct title_unit_s
{
    uint16_t        i_unit_nb;                    /* 2 bytes; ??? */
/*    char[2]         ??? */
    uint32_t        i_last_byte;                   /* 4 bytes */
    unit_t*         p_unit;                       /* i_lu_nb * 8 bytes */
    unit_inf_t*     p_unit_inf;                 /* i_lu_nb * 8 bytes */
} title_unit_t;

/*
 * Cell Adress Table Information
 */
typedef struct cell_map_s
{
    uint16_t        i_vob_id;                   /* 2 bytes */
    uint8_t         i_cell_id;                  /* 1 byte */
/*    char            ??? */
    uint32_t        i_first_sector;             /* 4 bytes */
    uint32_t        i_last_sector;              /* 4 bytes */
} cell_map_t;

typedef struct cell_inf_s
{
    uint16_t        i_vob_nb;                   /* 2 bytes */
/*    char[2]         ??? */
    uint32_t        i_last_byte;                /* 4 bytes */
    uint16_t        i_cell_nb;                  /* not in ifo; computed */
                                                /* with e_byte */
    cell_map_t*     p_cell_map;
} cell_inf_t;


/*
 * VOBU Adress Map Table
 */
typedef struct vobu_map_s
{
    uint32_t        i_last_byte;                   /* 4 bytes */
    uint32_t *      pi_vobu_start_sector;            /* (nb of vobu) * 4 bytes */
} vobu_map_t;

/*****************************************************************************
 * Structures for Video Management (cf video_ts.ifo)
 *****************************************************************************/

/*
 * Video Manager Information Management Table
 */
typedef struct manager_inf_s
{
    byte_t          psz_id[13];                 /* 12 bytes (DVDVIDEO-VMG) */
    uint32_t        i_vmg_end_sector;                  /* 4 bytes */
/*    char[12]        ??? */
    uint32_t        i_vmg_inf_end_sector;                /* 4 bytes */