PDF开源库libharu的折腾之旅-CFANZ编程社区

最近入手了一台Kindle,想在上面看代码.发现直接放上去看不了。

好吧，就准备写个批量将代码文件自动转成带目录标签的PDF文件的程序。

找到了libharu这个开源库，准备开用，没想到要用起来真不容易。

下面是折腾记录。

开发环境: VS Express 2015 版本

相关工程下载

从github下载libharu

https://github.com/libharu/libharu

下载zlib

http://www.zlib.net/

下载libpng

http://libmng.com/pub/png/libpng.html

编译 zlib

cd zlib\contrib\vstudio\vc11

打开VS 工程,选择zlibvc编译

编译出64位 zlibwapi.lib与zlibwapi.dll

编译libpng

cd lpng1618\projects\vstudio

用VS 打开 vstudio.sln

libpng需要zlib的支持，使用我们刚编译好的zlib.

1. 在解决方案的属性页中，将libpng依赖zlib的勾拿掉

2. 在工程属性中设置好 zlib头文件及zlibwapi.lib和目录

编译得到 libpng16.lib及libpng16.dll

开始编译libharu

按 https://github.com/libharu/libharu/wiki/Installation#Windows_except_cygwinMSYS 中的说明来做:

cd libharu\script

更改Makefile.msvc和Makefile.msvc_dll

分别将 PNG_PREFIX 与 ZLIB_PREFIX 路径指向真实的libpng和zlib头文件所在目录.

及LDFLAGS行中将libpng13.lib更改为libpng16.lib.

然后运行编译命令

nmake -f script/Makefile.msvc

nmake -f script/Makefile.msvc_dll

会报 libhpdf.def : error LNK2001: 无法解析的外部符号 HPDF_3DAnnot_Set3DView

在def中去掉，然后发现是按win32方式写的编译脚本，修改成win64方式无果后。

果断用vs新建了一个libharu的vs新工程

libharu的vs 64位新工程:

1. 将libharu\src下所有.c 文件复制至工程目录

2. 将libharu\include目录下所有.h文件复制至工程目录

3.将libharu\win32\include目录下hpdf_config.h文件复制至工程目录

4.将zlib及libpng所有的.h文件分别建立include目录，并在工程中设定.

5.将zlib和libpng编译后的lib和dll文件建立lib目录，并在工程中设定.

6.将工程属性由默认的exe改为dll

7.在工程目录新建libhpdf.def文件，否则不会生成.lib文件

8.在链接器->输入->模块定义文件中输入libhpdf.def文件名,

lib /def:libhpdf.def 命令从dll生成.lib文件

编译完成即可得到LIBHPDF.lib和LIBHPDF.dll.

libharu终于编译完了，然后折腾又来了.

写了个例子测试，编译时发现一堆 declared deprecated 类错误。 #pragma warning (disable: 4996) 搞定，

然后运行时报 "无法定位程序输入点CreateFile2于动态链接库KERNEL32.dll上“

https://msdn.microsoft.com/en-us/library/windows/desktop/hh449422(v=vs.85).aspx可查到这玩意最少要Windows 8

才支持，我用的Windows 7.

好吧，我再来重新编译一遍。

修改上面四个工程的属性:

常规->平台工具集值由"Visual Studio 2015 (v140)"

更改为 " Visual Studio 2015 - Windows XP (v140_xp)".

哈哈，终于，终于生成出了pdf文件。

其实libpng和libharu应当用其各自版本对应的zlib，代码会有一致性，不会出现哪个函数不支持的情况。不过无所谓了。

我只是生成普通的pdf而已，估计够用。

附测试代码:

#include <stdlib.h>
#include <stdio.h>
#include <string.h>
#include <setjmp.h>
#include "hpdf.h"

const char *text = "This PDF should have an attachment named attach.c";

jmp_buf env;

#if defined(WIN32) || defined(_WIN64)
  #pragma warning (disable: 4996)  //_s   //declared deprecated ?
#endif

#ifdef HPDF_DLL
void  __stdcall
#else
void
#endif
error_handler(HPDF_STATUS   error_no,
  HPDF_STATUS   detail_no,
  void         *user_data)
{
  printf("ERROR: error_no=%04X, detail_no=%u\n", (HPDF_UINT)error_no,
    (HPDF_UINT)detail_no);
  longjmp(env, 1);
}

int
main(int argc, char **argv)
{
  HPDF_Doc  pdf;
  HPDF_Font font;
  HPDF_Page page;
  char fname[256];
  HPDF_REAL tw;

  strcpy(fname, argv[0]);
  strcat(fname, ".pdf");

  pdf = HPDF_New(error_handler, NULL);
  if (!pdf) {
    printf("error: cannot create PdfDoc object\n");
    return 1;
  }

  if (setjmp(env)) {
    HPDF_Free(pdf);
    return 1;
  }

  /* create default-font */
  font = HPDF_GetFont(pdf, "Helvetica", NULL);

  /* add a new page object. */
  
  page = HPDF_AddPage(pdf);

  HPDF_Page_SetSize(page, HPDF_PAGE_SIZE_LETTER, HPDF_PAGE_PORTRAIT);

  HPDF_Page_BeginText(page);
  HPDF_Page_SetFontAndSize(page, font, 20);
  tw = HPDF_Page_TextWidth(page, text);
  HPDF_Page_MoveTextPos(page, (HPDF_Page_GetWidth(page) - tw) / 2,
    (HPDF_Page_GetHeight(page) - 20) / 2);
  HPDF_Page_ShowText(page, text);
  HPDF_Page_EndText(page);
  

  /* attach a file to the document */
  //HPDF_AttachFile(pdf, "attach.c");
  //HPDF_AttachFile(pdf, "jpeg_demo.c");

  /* save the document to a file */
  HPDF_SaveToFile(pdf, fname);

  /* clean up */
  HPDF_Free(pdf);

  return 0;
}