sub_cc.c

   1 /*
   2  * decoder for Closed Captions
   3  *
   4  * This decoder relies on MPlayer's OSD to display subtitles.
   5  * Be warned that decoding is somewhat preliminary, though it basically works.
   6  *
   7  * Most notably, only the text information is decoded as of now, discarding
   8  * color, background and position info (see source below).
   9  *
  10  * uses source from the xine closed captions decoder
  11  *
  12  * Copyright (C) 2002 Matteo Giani
  13  *
  14  * This file is part of MPlayer.
  15  *
  16  * MPlayer is free software; you can redistribute it and/or modify
  17  * it under the terms of the GNU General Public License as published by
  18  * the Free Software Foundation; either version 2 of the License, or
  19  * (at your option) any later version.
  20  *
  21  * MPlayer is distributed in the hope that it will be useful,
  22  * but WITHOUT ANY WARRANTY; without even the implied warranty of
  23  * MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.  See the
  24  * GNU General Public License for more details.
  25  *
  26  * You should have received a copy of the GNU General Public License along
  27  * with MPlayer; if not, write to the Free Software Foundation, Inc.,
  28  * 51 Franklin Street, Fifth Floor, Boston, MA 02110-1301 USA.
  29  */
  30
  31 #include <stdio.h>
  32 #include <stdlib.h>
  33 #include <string.h>
  34
  35 #include "config.h"
  36 #include "sub_cc.h"
  37
  38 #include "subreader.h"
  39
  40 #include "libvo/video_out.h"
  41 #include "libvo/sub.h"
  42
  43
  44 #define CC_MAX_LINE_LENGTH 64
  45
  46 static char chartbl[128];
  47
  48 static subtitle buf1,buf2;
  49 static subtitle *fb,*bb;
  50
  51 static unsigned int cursor_pos=0;
  52
  53 static int initialized=0;
  54
  55 #define CC_ROLLON 1
  56 #define CC_ROLLUP 2
  57
  58 static int cc_mode=CC_ROLLON;
  59 static int cc_lines=4; ///< number of visible rows in CC roll-up mode, not used in CC roll-on mode
  60
  61 static void build_char_table(void)
  62 {
  63   int i;
  64   /* first the normal ASCII codes */
  65   for (i = 0; i < 128; i++)
  66     chartbl[i] = (char) i;
  67   /* now the special codes */
  68   chartbl[0x2a] = 'á';
  69   chartbl[0x5c] = 'é';
  70   chartbl[0x5e] = 'í';
  71   chartbl[0x5f] = 'ó';
  72   chartbl[0x60] = 'ú';
  73   chartbl[0x7b] = 'ç';
  74   chartbl[0x7c] = '÷';
  75   chartbl[0x7d] = 'Ñ';
  76   chartbl[0x7e] = 'ñ';
  77   chartbl[0x7f] = '¤';    /* FIXME: this should be a solid block */
  78 }
  79
  80 static void clear_buffer(subtitle *buf)
  81 {
  82         int i;
  83         buf->lines=0;
  84         for (i = 0; i < SUB_MAX_TEXT; i++) {
  85                 free(buf->text[i]);
  86                 buf->text[i] = NULL;
  87         }
  88 }
  89
  90
  91 /**
  92  \brief scroll buffer one line up
  93  \param buf buffer to scroll
  94 */
  95 static void scroll_buffer(subtitle* buf)
  96 {
  97         int i;
  98
  99         while(buf->lines > cc_lines)
 100         {
 101                 free(buf->text[0]);
 102
 103                 for(i = 0; i < (buf->lines - 1); i++) buf->text[i] = buf->text[i+1];
 104
 105                 buf->text[buf->lines-1] = NULL;
 106                 buf->lines--;
 107         }
 108 }
 109
 110
 111 void subcc_init(void)
 112 {
 113         int i;
 114         //printf("subcc_init(): initing...\n");
 115         build_char_table();
 116         for(i=0;i<SUB_MAX_TEXT;i++) {buf1.text[i]=buf2.text[i]=NULL;}
 117         buf1.lines=buf2.lines=0;
 118         fb=&buf1;
 119         bb=&buf2;
 120
 121         initialized=1;
 122 }
 123
 124
 125 static void display_buffer(subtitle *buf)
 126 {
 127         vo_sub = buf;
 128         vo_osd_changed(OSDTYPE_SUBTITLE);
 129 }
 130
 131
 132 static void append_char(char c)
 133 {
 134         if(!bb->lines) {bb->lines++; cursor_pos=0;}
 135         if(bb->text[bb->lines - 1]==NULL)
 136         {
 137                 bb->text[bb->lines - 1]=malloc(CC_MAX_LINE_LENGTH);
 138                 memset(bb->text[bb->lines - 1],0,CC_MAX_LINE_LENGTH);
 139                 cursor_pos=0;
 140         }
 141
 142         if(c=='\n')
 143         {
 144                 if(cursor_pos>0 && bb->lines < SUB_MAX_TEXT)
 145                 {
 146                         bb->lines++;cursor_pos=0;
 147                         if(cc_mode==CC_ROLLUP){ //Carriage return - scroll buffer one line up
 148                                 bb->text[bb->lines - 1]=calloc(1, CC_MAX_LINE_LENGTH);
 149                                 scroll_buffer(bb);
 150                         }
 151                 }
 152         }
 153         else
 154         {
 155                 if(cursor_pos==CC_MAX_LINE_LENGTH-1)
 156                 {
 157                         fprintf(stderr,"CC: append_char() reached CC_MAX_LINE_LENGTH!\n");
 158                         return;
 159                 }
 160                 bb->text[bb->lines - 1][cursor_pos++]=c;
 161         }
 162         //In CC roll-up mode data should be shown immediately
 163         if(cc_mode==CC_ROLLUP) display_buffer(bb);
 164 }
 165
 166
 167 static void swap_buffers(void)
 168 {
 169         subtitle *foo;
 170         foo=fb;
 171         fb=bb;
 172         bb=foo;
 173 }
 174
 175
 176 static void cc_decode_EIA608(unsigned short int data)
 177 {
 178
 179   static unsigned short int lastcode=0x0000;
 180   unsigned char c1 = data & 0x7f;
 181   unsigned char c2 = (data >> 8) & 0x7f;
 182
 183   if (c1 & 0x60) {              /* normal character, 0x20 <= c1 <= 0x7f */
 184            append_char(chartbl[c1]);
 185            if(c2 & 0x60)        /*c2 might not be a normal char even if c1 is*/
 186                    append_char(chartbl[c2]);
 187   }
 188   else if (c1 & 0x10)           // control code / special char
 189   {
 190 //        int channel= (c1 & 0x08) >> 3;
 191           c1&=~0x08;
 192           if(data!=lastcode)
 193           {
 194                 if(c2 & 0x40) { /*PAC, Preamble Address Code */
 195                         append_char('\n'); /*FIXME properly interpret PACs*/
 196                 }
 197                 else
 198                         switch(c1)
 199                         {
 200                                 case 0x10:      break; // ext attribute
 201                                 case 0x11:
 202                                         if((c2 & 0x30)==0x30)
 203                                         {
 204                                                 //printf("[debug]:Special char (ignored)\n");
 205                                                 /*cc_decode_special_char()*/;
 206                                         }
 207                                         else if (c2 & 0x20)
 208                                         {
 209                                                 //printf("[debug]: midrow_attr (ignored)\n");
 210                                                 /*cc_decode_midrow_attr()*/;
 211                                         }
 212                                         break;
 213                                 case 0x14:
 214                                         switch(c2)
 215                                         {
 216                                                 case 0x00: //CC roll-on mode
 217                                                            cc_mode=CC_ROLLON;
 218                                                            break;
 219                                                 case 0x25: //CC roll-up, 2 rows
 220                                                 case 0x26: //CC roll-up, 3 rows
 221                                                 case 0x27: //CC roll-up, 4 rows
 222                                                            cc_lines=c2-0x23;
 223                                                            cc_mode=CC_ROLLUP;
 224                                                            break;
 225                                                 case 0x2C: display_buffer(NULL); //EDM
 226                                                            clear_buffer(fb); break;
 227                                                 case 0x2d: append_char('\n');   //carriage return
 228                                                            break;
 229                                                 case 0x2e: clear_buffer(bb);    //ENM
 230                                                            break;
 231                                                 case 0x2f: swap_buffers();      //Swap buffers
 232                                                            display_buffer(fb);
 233                                                            clear_buffer(bb);
 234                                                            break;
 235                                         }
 236                                         break;
 237                                 case 0x17:
 238                                         if( c2>=0x21 && c2<=0x23) //TAB
 239                                         {
 240                                                 break;
 241                                         }
 242                         }
 243           }
 244   }
 245   lastcode=data;
 246 }
 247
 248 static void subcc_decode(unsigned char *inputbuffer, unsigned int inputlength)
 249 {
 250   /* The first number may denote a channel number. I don't have the
 251    * EIA-708 standard, so it is hard to say.
 252    * From what I could figure out so far, the general format seems to be:
 253    *
 254    * repeat
 255    *
 256    *   0xfe starts 2 byte sequence of unknown purpose. It might denote
 257    *        field #2 in line 21 of the VBI. We'll ignore it for the
 258    *        time being.
 259    *
 260    *   0xff starts 2 byte EIA-608 sequence, field #1 in line 21 of the VBI.
 261    *        Followed by a 3-code triplet that starts either with 0xff or
 262    *        0xfe. In either case, the following triplet needs to be ignored
 263    *        for line 21, field 1.
 264    *
 265    *   0x00 is padding, followed by 2 more 0x00.
 266    *
 267    *   0x01 always seems to appear at the beginning, always seems to
 268    *        be followed by 0xf8, 8-bit number.
 269    *        The lower 7 bits of this 8-bit number seem to denote the
 270    *        number of code triplets that follow.
 271    *        The most significant bit denotes whether the Line 21 field 1
 272    *        captioning information is at odd or even triplet offsets from this
 273    *        beginning triplet. 1 denotes odd offsets, 0 denotes even offsets.
 274    *
 275    *        Most captions are encoded with odd offsets, so this is what we
 276    *        will assume.
 277    *
 278    * until end of packet
 279    */
 280   unsigned char *current = inputbuffer;
 281   unsigned int curbytes = 0;
 282   unsigned char data1, data2;
 283   unsigned char cc_code;
 284   int odd_offset = 1;
 285
 286   while (curbytes < inputlength) {
 287     int skip = 2;
 288
 289     cc_code = *(current);
 290
 291     if (inputlength - curbytes < 2) {
 292 #ifdef LOG_DEBUG
 293       fprintf(stderr, "Not enough data for 2-byte CC encoding\n");
 294 #endif
 295       break;
 296     }
 297
 298     data1 = *(current+1);
 299     data2 = *(current + 2);
 300     current++; curbytes++;
 301
 302     switch (cc_code) {
 303     case 0xfe:
 304       /* expect 2 byte encoding (perhaps CC3, CC4?) */
 305       /* ignore for time being */
 306       break;
 307
 308     case 0xff:
 309       /* expect EIA-608 CC1/CC2 encoding */
 310       // FIXME check parity!
 311       // Parity check omitted assuming we are reading from a DVD and therefore
 312       // we should encounter no "transmission errors".
 313       cc_decode_EIA608(data1 | (data2 << 8));
 314       skip = 5;
 315       break;
 316
 317     case 0x00:
 318       /* This seems to be just padding */
 319       break;
 320
 321     case 0x01:
 322       odd_offset = data2 & 0x80;
 323       if (!odd_offset)
 324         skip = 5;
 325       break;
 326
 327     default:
 328 //#ifdef LOG_DEBUG
 329       fprintf(stderr, "Unknown CC encoding: %x\n", cc_code);
 330 //#endif
 331       break;
 332     }
 333     current += skip;
 334     curbytes += skip;
 335   }
 336 }
 337
 338
 339 void subcc_process_data(unsigned char *inputdata,unsigned int len)
 340 {
 341         if(!subcc_enabled) return;
 342         if(!initialized) subcc_init();
 343
 344         subcc_decode(inputdata, len);
 345 }