采用QT,开发跨平台OFD阅读器
前言 ofd作为板式文档规范,相当于国产化的pdf。由于pdf标准制定的较早,相关生态也比较完备,市面上的pdf阅读器种类繁多。国内ofd阅读器寥寥无几,作者此前采用wpf开发了一款阅读器,但该阅读器只能在windows上运行。若实现跨平台运行,采用QT开发应该是首选。笔者并无QT开发经验,但有多年MFC开发经验,又对ofd研究多年;编程到达一定境界考验的就是思维,在学习QT的过程中,感觉都是熟悉的味道的。边学习边开发,终于完成了一款简易的ofd阅读器。简述开发思路,希望对读者有所启发。
获取最新版本,加入qq群:565438497。
功能简述:
阅读器实现了缩放、旋转、选中、复制、单双页显示等功能。
注释编辑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阅读器并非遥不可及。目前该阅读器仅完成了基本的功能,后续会逐步完善,敬请期待。
【推荐】编程新体验,更懂你的AI,立即体验豆包MarsCode编程助手
【推荐】凌霞软件回馈社区,博客园 & 1Panel & Halo 联合会员上线
【推荐】抖音旗下AI助手豆包,你的智能百科全书,全免费不限次数
【推荐】博客园社区专享云产品让利特惠,阿里云新客6.5折上折
【推荐】轻量又高性能的 SSH 工具 IShell:AI 加持,快人一步
· PowerShell开发游戏 · 打蜜蜂
· 在鹅厂做java开发是什么体验
· 百万级群聊的设计实践
· WPF到Web的无缝过渡:英雄联盟客户端的OpenSilver迁移实战
· 永远不要相信用户的输入:从 SQL 注入攻防看输入验证的重要性