采用QT，开发跨平台OFD阅读器

前言 ofd作为板式文档规范，相当于国产化的pdf。由于pdf标准制定的较早，相关生态也比较完备，市面上的pdf阅读器种类繁多。国内ofd阅读器寥寥无几，作者此前采用wpf开发了一款阅读器，但该阅读器只能在windows上运行。若实现跨平台运行，采用QT开发应该是首选。笔者并无QT开发经验，但有多年MFC开发经验，又对ofd研究多年；编程到达一定境界考验的就是思维，在学习QT的过程中，感觉都是熟悉的味道的。边学习边开发，终于完成了一款简易的ofd阅读器。简述开发思路，希望对读者有所启发。

获取最新版本，加入qq群：QQ:618168615。

功能简述：

 阅读器实现了缩放、旋转、选中、复制、单双页显示等功能。

注释编辑ofd

开发思路解析

ofd阅读器显示的内容包括：文字、图形、图等，称之为图元；阅读器可能需要显示成千上万个图元。采用qt完成此功能，有多重方案可供选择，选择方案时必须考虑下列因素：1)显示的性能。2)图元与鼠标键盘的交互。我选择了“Graphics View Framework 图形视图框架”；程序处理的逻辑见下图：

ofd解压：

　　ofd本身就是压缩文件，和zip后缀的文件处理完全一样。解压缩采用QuaZip库。作者在此库基础上作了进一步封装，使之更便于使用。

OfdFileReader::OfdFileReader()
{
    _pZipInfo = nullptr;
    _file = nullptr;
}

OfdFileReader::~OfdFileReader()
{
    MemManage::instance()->Delete(_pZipInfo);
    MemManage::instance()->Delete(_file);
}

bool OfdFileReader::Open(QString fileName)
{
     MemManage::instance()->Delete( _file);

    _file =MemManage::instance()->New<QFile,QString>(fileName);

    if (!_file->open(QIODevice::ReadOnly))
        return false;

    _ofdFileName = fileName;
    return Open(_file);
}

bool OfdFileReader::Open(QIODevice *ioDevice)
{
     MemManage::instance()->Delete(_pZipInfo);

    _pZipInfo =MemManage::instance()->New<QuaZip,QIODevice*>(ioDevice);
    bool isOpen = _pZipInfo->open(QuaZip::mdUnzip);
    if(!isOpen)
        return false;

    _listFilePath.clear();
    GetAllZipInfo();

    return true;
}

QString OfdFileReader::GetFileFullName()
{
    return _ofdFileName;
}

QString OfdFileReader::GetFileShortName()
{
    QFileInfo fileInfo(_ofdFileName);
    return fileInfo.baseName();
}

void OfdFileReader::GetAllZipInfo()
{
    for (bool f = _pZipInfo->goToFirstFile(); f;f=_pZipInfo->goToNextFile())
    {
        QString relativePath = _pZipInfo->getCurrentFileName();
        _listFilePath.append(relativePath);

        //qDebug() << relativePath;
    }
}

int OfdFileReader::GetFileCount()
{
    return _listFilePath.count();
}

QString OfdFileReader::GetFilePath(int index)
{
    return _listFilePath[index];
}

QStringList OfdFileReader::GetFilePathList()
{
    return _listFilePath;
}

QByteArray OfdFileReader::GetFileContent(const QString& relativePath)
{
    if(relativePath.size()==0)
    {
        QByteArray empty;
        return empty;
    }

    _pZipInfo->setCurrentFile(relativePath);

    QuaZipFile  zFile(_pZipInfo,0);
    if(!zFile.open(QIODevice::ReadOnly))
    {
        QByteArray empty;
        return empty;
    }

    QByteArray ba = zFile.readAll();
    zFile.close();
    return ba;
}

xml解析

　　ofd主要是由xml文本和资源文件组成。qt解析xml有两个库：DOM解析(QDomDocument)和流式解析(QXmlStreamReader)。DOM解析使用起来简单，但是性能慢；流式解析反之。从性能角度考虑，作者采用了流式解析的方法。

Qt Graphics View Framework 图形视图框架

　　绘制大量图元最佳方案就是采用qt提供的“Graphics View Framework”架构。此架构确保高效的绘制大量图元，又能快速的根据区域定位到图元。该架构采用面向对象的方法处理图元，减轻了开发难度。图元的描述称之为scene，图元显示为view。一个scene可以由多个view展示。首先需要将ofd页面中文字、线、图等元素转换成对应的scene。以显示文字为例，定义类型 class OfdVisualItemText : public QGraphicsObject。需要实现两个虚函数：

   QRectF boundingRect() const override;
   void paint(QPainter *painter, const QStyleOptionGraphicsItem *option, QWidget *widget = nullptr) override;

paint函数根据scene数据，绘制对应的文字。第一次绘制时，须记录每个文字的区域；鼠标滑动时，根据选择区域与每个文字的关系，确定文字是否被选中。

void OfdVisualItemText::paint(QPainter *painter,
                              const QStyleOptionGraphicsItem *option, QWidget *widget)
{
    Q_UNUSED(option);
    Q_UNUSED(widget);

    painter->setRenderHint(QPainter::TextAntialiasing);
    painter->setBrush(Qt::black);
    painter->setPen(Qt::black);

    SetPen(painter);
    SetFont(painter);

    //SetCTMTransfer(painter);
    if(_isFirstPaint)
    {
        SetCTMTransfer();
    }

    if(_isSelect)
    {
        QList<QRectData*> selectData = _boundingRectManage.GetSelectData(_selectPolygon);
        foreach(QRectData *item,selectData)
        {
            painter->fillRect(item->rect,*OfdViewParam::TextSelectBrush);
        }
    }

    OfdPageItemText *itemText = (OfdPageItemText*)_ofdPageItem;

    int charCount = itemText->TextCode.GetCharCount();
    QChar charItem;
    float x;
    float y;

    QRectF textboundingRect;
    QRectF textClipRect;

    float baseline = GetBaseline();
    for(int i=0;i<charCount;i++)
    {
        itemText->TextCode.GetChar(i,charItem,x,y);
        double xPixel = OfdConvert::OfdMMToPixel(x);
        double yPixel = OfdConvert::OfdMMToPixel(y);
        QString textChar(charItem);

        textClipRect.setRect(xPixel,yPixel-baseline,10000,10000);
        painter->drawText(textClipRect,0,textChar,&textboundingRect);

        AdjustTextRect(textboundingRect);
    }

    _isFirstPaint = false;
}

 阅读器操作截图

后记：理清思路，选对框架是成功的第一步。qt作为一款优秀的跨平台框架，为方便我们开发提供了大量的类库。在充分理解ofd的基础上，配合qt的“Graphics View Framework”框架，开发ofd阅读器并非遥不可及。目前该阅读器仅完成了基本的功能，后续会逐步完善，敬请期待。