2023年12月8日发(作者:)

采用qt技术,开发OFD电子文档阅读器

前言 ofd作为板式文档规范,相当于国产化的pdf。由于pdf标准制定的较早,相关生态也比较完备,市面上的pdf阅读器种类繁多。国内

ofd阅读器寥寥无几,作者此前采用,但该阅读器只能在windows上运行。若实现跨平台运行,采用QT开发应该是首选。笔者并无QT开发

经验,但有多年MFC开发经验,又对ofd研究多年;编程到达一定境界考验的就是思维,在学习QT的过程中,感觉都是熟悉的味道的。边

学习边开发,终于完成了一款简易的ofd阅读器。简述开发思路,希望对读者有所启发。

功能简述:

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

注释编辑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(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(ioDevice); bool isOpen = _pZipInfo->open(QuaZip::mdUnzip); if(!isOpen) return false; _(); GetAllZipInfo(); return true;}QString OfdFileReader::GetFileFullName(){ return _ofdFileName;}QString OfdFileReader::GetFileShortName(){ QFileInfo fileInfo(_ofdFileName); return me();}void OfdFileReader::GetAllZipInfo(){ for (bool f = _pZipInfo->goToFirstFile(); f;f=_pZipInfo->goToNextFile()) { QString relativePath = _pZipInfo->getCurrentFileName(); _(relativePath); //qDebug() << relativePath; }}int OfdFileReader::GetFileCount(){ return _();}QString OfdFileReader::GetFilePath(int index){ return _listFilePath[index];}QStringList OfdFileReader::GetFilePathList(){ return _listFilePath;}QByteArray OfdFileReader::GetFileContent(const QString& relativePath)

QByteArray OfdFileReader::GetFileContent(const QString& relativePath)

{

if(()==0)

{

QByteArray empty;

return empty;

}

_pZipInfo->setCurrentFile(relativePath);

QuaZipFile zFile(_pZipInfo,0);

if(!(QIODevice::ReadOnly))

{

QByteArray empty;

return empty;

}

QByteArray ba = l();

();

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 selectData = _ectData(_selectPolygon); foreach(QRectData *item,selectData) { painter->fillRect(item->rect,*OfdViewParam::TextSelectBrush); } } OfdPageItemText *itemText = (OfdPageItemText*)_ofdPageItem; int charCount = itemText->rCount(); QChar charItem; float x; float y; QRectF textboundingRect; QRectF textClipRect; float baseline = GetBaseline(); for(int i=0;ir(i,charItem,x,y); double xPixel = OfdConvert::OfdMMToPixel(x); double yPixel = OfdConvert::OfdMMToPixel(y); QString textChar(charItem); t(xPixel,yPixel-baseline,10000,10000); painter->drawText(textClipRect,0,textChar,&textboundingRect); AdjustTextRect(textboundingRect); } _isFirstPaint = false;} 阅读器操作截图

后记:理清思路,选对框架是成功的第一步。qt作为一款优秀的跨平台框架,为方便我们开发提供了大量的类库。在充分理解ofd的基础

上,配合qt的“Graphics View Framework”框架,开发ofd阅读器并非遥不可及。目前该阅读器仅完成了基本的功能,后续会逐步完

善,敬请期待。