c# 基于wpf,开发OFD电子文档阅读器

作者:源之缘 时间:2023-09-08 00:10:02 

前言 

OFD是国家标准版式文档格式,于2016年生效。OFD文档国家标准参见《电子文件存储与交换格式版式文档》。既然是国家标准,OFD随后肯定会首先在政务系统使用,并逐步推向社会各个方面。OFD是在研究当下各类文件格式后,推出的标准,有如下优点:

1 产权属于自主产权

2 具有便携性:文件小,可压缩比率大。测试显示生成的文件体量比PDF还要小。

3 具有开放性:易于入门,对于使用者来说更具开放性。

4 具有扩展性:预留了可扩展入口和自定义标引,设置了非接触式引用机制,为特性化提供支持。

5 呈现效果与设备无关,在各种设备上阅读、打印或印刷时,版面固定、不跑版。

6 应用广泛:无论是电子商务、电子公务,还是信息发布、文件交换,档案管理等都需要版式文档的技术支持。

关于标准,我也要吐槽一下。OFD标准是国内几家专业的电子文档处理公司参与起草的;标准文档(注:以下用”标准”特指OFD标准)只有126页,在我看来,标准对技术细节的描述过于简单,没有一定的技术背景很难看懂。与此形成鲜明对比的是pdf标准,有1000多页。我在网上也没找到文字版的标准,特别不利于阅读和参考。

ofd阅读器程序(已集成了转图、转PDF功能)下载。

我最近一直研究ofd标准,试图写一款阅读器,已初有成果。具有ofd转换为pdf、转为图片等特色功能。界面如下:

c# 基于wpf,开发OFD电子文档阅读器

c# 基于wpf,开发OFD电子文档阅读器

 本文就把我开发的过程做简单介绍。

OFD标准简介

简而言之,OFD存储是采用压缩技术,描述采用XML格式。这一点与微软的word文档(docx)格式很类似。标准可能参考了微软的处理方式;在技术上也要实事求是,国标这种格式不是独创和领先的。将OFD格式文件解压后,会看到如下目录和文件:

c# 基于wpf,开发OFD电子文档阅读器

文件中会包括资源文件(图片、字体库等)。XML会对资源存放,图元(文字、图像等)显示做描述,阅读软件会根据这些描述呈现出一致的显示效果。

开发OFD阅读软件步骤

  国内流行的ofd阅读软件应该是福昕和数科开发的,这两款我都用过。我还要吐槽一下:

1)福昕阅读器帮助文档是ofd格式,但是无法用数科的阅读器打开。

2)有些ofd文档中xml标记,在标准中找不到,是某些公司独创的?

这些软件都是用C++开发的,用到了QT。同样情况下,相比于C#,C++开发软件难度肯定会大增。在windows平台开发界面,WPF应该是最好的库了。WPF虽然出现十几年了,大家好像对此还很陌生。主要现在是BS的天下;不是WPF不够好,是生不逢时。

1 对OFD文件解压缩

OFD文件其实就是压缩文件,解压后的文件也有目录结构。该模块的功能是获取每个文件的路径和数据。


using System;
using System.Collections.Generic;
using System.IO;
using System.IO.Compression;
using System.Linq;

namespace WpfOfdReader.OfdFileType
{
 class OfdFileReader
 {
   ZipArchive _zipArchive;
   public void ReadZipFile(string fileName)
   {
     _zipArchive = ZipFile.OpenRead(fileName);
   }

public void Close()
   {
     if (_zipArchive != null)
       _zipArchive.Dispose();
   }

public List<OfdFileItemInfo> AllFileItem
   {
     get
     {
       return _zipArchive.Entries.Select(o => new OfdFileItemInfo(o)).ToList();
     }
   }

private ZipArchiveEntry GetArchiveEntry(ZipFilePath path)
   {
     foreach (ZipArchiveEntry entry in _zipArchive.Entries)
     {
       if (entry.FullName == path.FulleName)
       {
         return entry;
       }
     }
     return null;
   }

public static byte[] GetFileBuffer(ZipArchiveEntry entry)
   {
     List<byte[]> listBuffer = new List<byte[]>();
     using (Stream s = entry.Open())
     {
       while (true)
       {
         byte[] buffer = new byte[10];
         int n = s.Read(buffer, 0, buffer.Length);
         if (n <= 0)
           break;

if (n == buffer.Length)
         {
           listBuffer.Add(buffer);
         }
         else
         {
           Array.Resize(ref buffer, n);
           listBuffer.Add(buffer);
           break;
         }
       }
     }

int totalLen = 0;
     listBuffer.ForEach(o => totalLen += o.Length);
     byte[] result = new byte[totalLen];
     int index = 0;
     foreach (byte[] buffer in listBuffer)
     {
       Buffer.BlockCopy(buffer, 0, result, index, buffer.Length);
       index += buffer.Length;
     }
     return result;
   }
 }
}

2 找到需要展示的page

顺着路线 OFD.xml --> Document.xml --> Pages,找到最终需要展示的page页。Page页包含三类节点:PathObject、ImageObject,暨对应标准中的三类图元。需要对这三类节点建模。这三个类共同继承父类PageObject。所有的图元都有绘制区域、坐标变换、裁剪等共性,所有这些由PageObject类处理。


 public class PageObject
 {
   public string ID { get; set; }
   public PageLayer ParentLayer { get; set; }
   public string PageFileLoc => ParentLayer.ParentPage.PageFileLoc;

XmlNode _xmlNode;

public string Boundary { get; set; }
   public string CTM { get; set; }

public OfdClipsGroup ClipsGroup { get; set; }

public void SetPageObject(PageLayer layer, XmlNode xmlNode)
   {
     _xmlNode = xmlNode;

ID = XmlHelper.GetXmlAttributeValue(xmlNode, "ID");
     ParentLayer = layer;

Boundary = XmlHelper.GetXmlAttributeValue(xmlNode, "Boundary");
     CTM = XmlHelper.GetXmlAttributeValue(xmlNode, "CTM");

foreach (XmlNode childNode in xmlNode.ChildNodes)
     {
       if (childNode.Name == OfdClipsGroup.XML_Name)
       {
         ClipsGroup = OfdClipsGroup.FromXml(childNode);
         break;
       }
     }

}

public string GetAttributeValue(string name)
   {
     string result = XmlHelper.GetXmlAttributeValue(_xmlNode, name);
     return result;
   }

}

3 创建WPF显示模型

图像精确定位需要用到Canvas控件作为容器。绘制大量图形需要用到轻量级绘制模型DrawingVisual。在此基础上,派生了绘制基础模型OfdVisual,此模型对应PageObject。 


 public class OfdVisual : DrawingVisual
 {
   public OfdVisual()
   {
   }

protected DrawingCanvas _drawingCanvas;
   public DrawingCanvas DrawingCanvas
   {
     get
     {
       return _drawingCanvas;
     }
   }

public bool IsAddToCanvas
   {
     get
     {
       return _drawingCanvas != null;
     }
   }

internal void AddToCanvas(DrawingCanvas drawingCanvas)
   {
     if (_drawingCanvas == drawingCanvas)
       return;
     _drawingCanvas = drawingCanvas;
     _drawingCanvas.AddVisual(this);
   }

public void ReomveFromCanvas()
   {
     if (_drawingCanvas != null)
     {
       _drawingCanvas.DeleteVisual(this);
     }
   }

public virtual void Show(bool visiable, bool even = false)
   {

}

public Point BoundaryLocation { get; set; }
   public Size BoundarySize { get; set; }

public MatrixTransform ObjectTransform { get; protected set; }

public VisualClipsGroup ObjectClipsGroup { get; protected set; }
   public void SetPageObject(PageObject pageObject)
   {
     OfdHelper.ParseBoundary(pageObject.Boundary, out Point location, out Size size);
     BoundaryLocation = location;
     BoundarySize = size;

if (!string.IsNullOrEmpty(pageObject.CTM))
     {
       ObjectTransform = OfdHelper.OfdTextToTransform(pageObject.CTM);
     }

if (pageObject.ClipsGroup != null)
     {
       ObjectClipsGroup = new VisualClipsGroup() { ClipsGroup = pageObject.ClipsGroup };
     }
   }

protected Rect ClipRect
   {
     get
     {
       return new Rect(0, 0, BoundarySize.Width, BoundarySize.Height);
     }
   }

protected RectangleGeometry ClipGeometry
   {
     get
     {
       RectangleGeometry geometry = new RectangleGeometry(ClipRect);
       return geometry;
     }
   }

protected void PutBoundary(DrawingContext dc)
   {
     TranslateTransform translateBoundary = new TranslateTransform(BoundaryLocation.X, BoundaryLocation.Y);
     dc.PushTransform(translateBoundary);
     dc.PushClip(ClipGeometry);
   }

protected void PopBoundary(DrawingContext dc)
   {
     dc.Pop();
     dc.Pop();
   }

protected void PutTransform(DrawingContext dc)
   {
     if (ObjectTransform != null)
     {
       dc.PushTransform(ObjectTransform);
     }
   }

protected void PopTransform(DrawingContext dc)
   {
     if (ObjectTransform != null)
     {
       dc.Pop();
     }
   }
 }

有三种类型绘制对象OfdVisualText、OfdVisualPath、OfdVisualImage,派生自OfdVisual。分别处理三种图元数据。所有的绘制操作在函数


public override void Show(bool visiable, bool even = false);

对应文本,绘制函数如下:


void DrawText()
   {
     using (DrawingContext dc = RenderOpen())
     {
       if (ObjectClipsGroup == null)
       {
         PutBoundary(dc);
         PutTransform(dc);

DrawTextInner(dc);

PopTransform(dc);
         PopBoundary(dc);
       }
       else
       {
         foreach (VisulClip visulClip in ObjectClipsGroup)
         {
           PutBoundary(dc);
           visulClip.PutClip(dc);
           PutTransform(dc);

DrawTextInner(dc);

PopTransform(dc);
           visulClip.PopClip(dc);
           PopBoundary(dc);
         }
       }
     }
   }

private void DrawTextInner(DrawingContext dc)
   {
     int i = -1;
     double deltaXTotal = 0;
     double deltaYTotal = 0;
     Point pt = new Point();

foreach (FormattedText formattedText in FormattedTextCollection)
     {
       i++;
       if (i != 0)
       {
         if (DeltaCollectionX != null)
         {
           double deltaX = DeltaCollectionX.GetValue(i - 1);
           deltaXTotal += deltaX;
         }

if (DeltaCollectionY != null)
         {
           double deltaY = DeltaCollectionY.GetValue(i - 1);
           deltaYTotal += deltaY;
         }
       }

pt.X = TextLocation.X + deltaXTotal;
       pt.Y = TextLocation.Y + deltaYTotal - FormattedTextCollection.FontBaseLine;
       dc.DrawText(formattedText, pt);
     }
   }

 绘制前,需要对当前坐标做变换、旋转、剪切等操作。

最近又对程序完善了,增加缩略图和公文索引:

c# 基于wpf,开发OFD电子文档阅读器

c# 基于wpf,开发OFD电子文档阅读器

c# 基于wpf,开发OFD电子文档阅读器

后记

编写阅读器类软件的关键是建模。首先读懂标准,对标准中描述的图元做归类分析,并建立起相应的显示模型。本人做WPF开发很多年了,感觉用WPF开发这类软件并不是非常的难。相比于QT,采用wpf开发有很多优势。如果要完整实现OFD标准,还需要大量的开发,我会逐步完善该软件的功能。

特别说明

ofd阅读器开发语言为c#,具有完全自主产权,没有使用第三方ofd开发包。可以根据你的需求快速定制开发。本阅读器还在开发完善阶段,如有任何问题,可以联系我QQ:13712486。

来源:https://www.cnblogs.com/yuanchenhui/p/ofdreader.html

标签:c#,wpf,ofd,电子文档阅读器
0
投稿

猜你喜欢

  • Java自定义注解用法实例小结

    2023-03-26 09:13:51
  • QR 二维码中插入图片实现方法

    2023-01-24 14:32:32
  • 利用logback 设置不同包下的日志级别

    2022-08-11 20:05:43
  • Java自定义实现equals()方法过程解析

    2021-10-12 11:21:48
  • Java Swing JProgressBar进度条的实现示例

    2023-07-15 17:48:47
  • C# 多线程编程技术基础知识入门

    2023-05-27 08:00:24
  • Android 6.0调用相机图册崩溃的完美解决方案

    2022-10-13 02:00:39
  • java实现获取安卓设备里已安装的软件包

    2022-10-21 00:53:04
  • Spring Security 中如何让上级拥有下级的所有权限(案例分析)

    2022-01-28 16:55:26
  • C#开发之Socket网络编程TCP/IP层次模型、端口及报文等探讨

    2023-03-28 14:49:53
  • 利用java制作简单的音乐播放器

    2022-01-21 11:39:32
  • SpringBoot使用token简单鉴权的具体实现方法

    2022-07-10 14:23:42
  • Java实现人机猜拳小游戏

    2023-10-07 16:11:37
  • Java中的字节流文件读取教程(一)

    2023-08-14 08:14:47
  • 详解Java反射创建对象

    2022-12-10 03:52:23
  • 利用C#版OpenCV实现圆心求取实例代码

    2022-10-28 12:51:48
  • C#快速排序算法实例分析

    2023-06-17 00:30:00
  • 浅谈java中String的两种赋值方式的区别

    2021-09-21 23:59:36
  • 详解Java中Callable和Future的区别

    2023-07-25 21:18:58
  • 关于C#10 新特性 Lambda 优化

    2022-05-31 08:21:16
  • asp之家 软件编程 m.aspxhome.com