textsubtitleparser.cpp

Go to the documentation of this file.

// -*- Mode: c++ -*-
#include <stdio.h>
#include <cstring>
#include <algorithm>
#include <qtextcodec.h>

using std::lower_bound;

#include "textsubtitleparser.h"
#include "xine_demux_sputext.h"

bool operator<(const text_subtitle_t& left, 
               const text_subtitle_t& right)
{
    return left.start < right.start;
}

bool TextSubtitles::HasSubtitleChanged(uint64_t timecode) const 
{
    return (timecode < m_lastReturnedSubtitle.start ||
            timecode > m_lastReturnedSubtitle.end);
}

QStringList TextSubtitles::GetSubtitles(uint64_t timecode) const 
{
    QStringList list;
    if (m_subtitles.empty())
        return list;

    text_subtitle_t searchTarget(timecode, timecode);

    TextSubtitleList::const_iterator nextSubPos =
        lower_bound(m_subtitles.begin(), m_subtitles.end(), searchTarget);

    uint64_t startCode = 0, endCode = 0;
    if (nextSubPos != m_subtitles.begin()) 
    {
        TextSubtitleList::const_iterator currentSubPos = nextSubPos;
        currentSubPos--;

        const text_subtitle_t &sub = *currentSubPos;
        if (sub.start <= timecode && sub.end >= timecode)
        {
            // found a sub to display
            m_lastReturnedSubtitle = sub;
            return QDeepCopy<QStringList>(m_lastReturnedSubtitle.textLines);
        }

        // the subtitle time span has ended, let's display a blank sub
        startCode = sub.end + 1;
    }

    if (nextSubPos == m_subtitles.end()) 
    {
        // at the end of video, the blank subtitle should last until
        // forever
        endCode = startCode + INT_MAX;
    } 
    else 
    {
        endCode = (*nextSubPos).start - 1;
    }

    // we are in a position in which there are no subtitles to display,
    // return an empty subtitle and create a dummy empty subtitle for this
    // time span so SubtitleChanged() functions also in this case
    text_subtitle_t blankSub(startCode, endCode);
    m_lastReturnedSubtitle = blankSub;

    return list;
}

void TextSubtitles::AddSubtitle(const text_subtitle_t &newSub)
{
    m_subtitles.push_back(newSub); 
}

void TextSubtitles::Clear(void) 
{
    m_subtitles.clear(); 
}

bool TextSubtitleParser::LoadSubtitles(QString fileName, TextSubtitles &target)
{
    demux_sputext_t sub_data;
    sub_data.file_ptr = fopen(fileName, "r");
    
    if (!sub_data.file_ptr)
        return false;
    
    subtitle_t *loaded_subs = sub_read_file(&sub_data);
    if (!loaded_subs)
    {
        fclose(sub_data.file_ptr);
        return false;
    }

    target.SetFrameBasedTiming(!sub_data.uses_time);

    // assume the text to be in UTF8 compatible format until encountering
    // a string of which characters cannot be encoded by UTF8.
    QTextCodec *utf8Codec = QTextCodec::codecForName("utf8");
    bool utf8 = (bool)utf8Codec;

    // convert the subtitles to our own format and free the original structures
    for (int sub_i = 0; sub_i < sub_data.num; ++sub_i)
    {
        const subtitle_t *sub = &loaded_subs[sub_i];
        text_subtitle_t newsub(sub->start, sub->end);

        if (!target.IsFrameBasedTiming())
        {
            newsub.start *= 10; // convert from csec to msec
            newsub.end *= 10;
        }

        for (int line = 0; line < sub->lines; ++line)
        {
            const char *subLine = sub->text[line];
            int lineLength = strlen(subLine);

            // check if the string contains unknown chars to UTF8,
            // if the encoding has not been detected to be non-UTF8
            // before (the heuristics method can sometimes return
            // larger than the lineLength for unknown reason, thus the >= )
            utf8 = utf8 &&
                (utf8Codec->heuristicContentMatch(subLine, lineLength) >= lineLength);

            // use Latin1 as the fallback encoding in case there was
            // non-UTF8 strings detected
            // TODO: user option for setting the fallback encoding could
            // be nice (it's impossible to detect the correct 8-bit encoding
            // automatically)
            if (utf8)
                newsub.textLines.push_back(QString::fromUtf8(subLine));
            else
                newsub.textLines.push_back(QString::fromLatin1(subLine));

            free(sub->text[line]);
        }
        target.AddSubtitle(newsub);
    }

    free(loaded_subs);
    fclose(sub_data.file_ptr);

    return true;
}

---