hpdf 2.0.8

data/History

@@ -0,0 +1,57 @@
+== version 2.0.8 2006.11.25
+ *fixed a problem of HPDF_Circle() which causes buffer overflow. 
+ *added HPDF_Ellipse().
+ 
+== version 2.0.7 2006.11.05
+ *fixed a bug of HPDF_Annotation_New() (the values of bottom and top are set 
+  upside down).
+ *added HPDF_Page_GetCurrentPos2(), HPDF_Page_GetCurrentTextPos2() and
+  HPDF_Image_GetSize2().
+
+== version 2.0.6 2006.10.16
+ *added opacity and blend-mode featurs.
+ *added slide-show functions (contributed by Adrian Nelson). 
+ *added an interface for VB6 (contributed by Ko, Chi-Chih).
+ *fixed a bug that HPDF_MemStream_Rewrite() may cause segmentation fault.
+ *fixed a bug of error checking of HPDF_Page_Concat().
+ *fixed a bug of calculation for the position of text showing.
+
+== version 2.0.5 2006.09.20
+ *fixed a bug that an image which loaded by HPDF_LoadRawImageFromFile() or 
+  HPDF_LoadRawImageFromMem() is not compressed.
+ *added C# interface.
+ *added viewer-preference feature.
+ *fixed a bug that HPDF_SetPassword does not raise error when NULL string set
+  to owner-password.
+ *fixed a bug that causes program crash when using interlaced PNG images.
+
+== version 2.0.4 2006.08.25
+ *fixed a bug of the TrueType font feature related to composit glyph.
+
+== version 2.0.3 2006.08.20
+ *fixed a bug that HPDF_Page_TextRect() always returns 
+  HPDF_PAGE_INSUFFICIENT_SPACE.
+ *added delayed loading function for a png image (HPDF_LoadPngImageFromFile2).
+ *change HPDF_SaveToStream function.
+ *correct hpdf_ttfontdef.c to avoid warning from a compiler.
+
+== version 2.0.2
+ *modified HPDF_Page_ShowTextNextLine() to invoking HPDF_Page_MoveToNextLine()
+  if it is invoked with null or zero-length text.
+ *fixed a bug in which HPDF_Page_MeasureText() returns wrong value when using 
+  CID fonts.
+ *changed the feature of HPDF_Page_MeasureText().
+ *added Japanese word wrap feature to HPDF_Page_MeasureText() and 
+  HPDF_Page_TextRect().
+ *fixed typos of HPDF_PageLayout values.
+ *modified options of makefile for BCC32 to multi-thread.
+  rebuild libz.a, libpng.a for BCC32 with -WM option.
+
+== version 2.0.1a 2006-08-03
+ *fixed a bug that HPDFPage::draw_image does not work correctly. (Ruby module 
+  only.)
+
+== version 2.0.1 2006-07-29
+ *fixed a bug that HPDF_TextRect() does not work correctly when using CID fonts.
+ *added HPDF_Font_GetAscent(), HPDF_Font_GetDescent(), HPDF_Font_GetXHeight(),
+  HPDF_Font_GetCapHeight().

data/License

@@ -0,0 +1,25 @@
+*
+* License
+*
+Haru is distributed under the ZLIB/LIBPNG License. Because ZLIB/LIBPNG License 
+is one of the freest licenses, You can use Haru for various purposes.
+
+The license of Haru is as follows.
+
+Copyright (C) 1999-2006 Takeshi Kanno
+This software is provided 'as-is', without any express or implied warranty.
+
+In no event will the authors be held liable for any damages arising from the 
+use of this software.
+
+Permission is granted to anyone to use this software for any purpose,including 
+commercial applications, and to alter it and redistribute it freely, subject 
+to the following restrictions:
+
+ 1. The origin of this software must not be misrepresented; you must not claim 
+    that you wrote the original software. If you use this software in a 
+    product, an acknowledgment in the product documentation would be 
+    appreciated but is not required.
+ 2. Altered source versions must be plainly marked as such, and must not be 
+    misrepresented as being the original software.
+ 3. This notice may not be removed or altered from any source distribution.

data/README

@@ -0,0 +1,165 @@
+===============================================================================
+#  Haru Free PDF Library Version 2.0.8 - Nov 25, 2006
+
+This gem has been packaged by Emmanuel Oga, EmmanuelOga.blogspot.com
+
+I followed the instructions in the libharu_2_x_x.tar.gz package:
+
+   1) Build Haru as a static library.
+
+      NOTE:
+      When you build haru for creating ruby extension library on linux 
+      platforms, run configure script with following command. 
+
+      ./configure --cflags=-fPIC
+
+   2) Change directory to "libharu-2.X.X/if/ruby" and run extconf.rb.
+
+      ruby extconf.rb
+
+   3) Then invoke "make install" command.
+
+      make install
+
+That's all!!! I only "gemified" the code and included the samples.
+
+WARNING! TO USE THIS GEM on linux you need proper build tools (complete gcc package),
+libpng and zlib. I had to make some research to find these for my ubuntu feisty 
+o.s.
+
+If you are using ubuntu (or maybe debian or other linux with apt support)
+
+"sudo apt-get install build-essential"
+
+should do the trick for the build environment.
+ 
+For zlib and libpng, you could install the program "apt-file" (sudo apt-get install apt-file) 
+and search the dependencies with it. 
+
+"apt-file search png.h"
+"apt-file search zlib.h"
+
+Choose one of the listed packages and install it with apt-get. 
+Then you should have no problem installing the gem.
+
+Original readme follows:
+
+===============================================================================
+
+#  Haru Free PDF Library Version 2.0.8 - Nov 25, 2006
+#  
+#  URL http://libharu.sourceforge.net/
+#
+#  Copyright 2000-2006 (c) Takeshi Kanno
+#
+
+See INSTALL for instructions on how to install libpng.
+
+*
+* What is Haru Free PDF Library?
+*
+Haru is a free, cross platform, open-sourced software library for generating 
+PDF. It supports the following features.
+
+   1. Generating PDF files with lines, text, images.
+   2. Outline, text annotation, link annotation.
+   3. Compressing document with deflate-decode.
+   4. Embedding PNG, Jpeg images.
+   5. Embedding Type1 font and TrueType font.
+   6. Creating encrypted PDF files.
+   7. Using various character set (ISO8859-1~16, MSCP1250~8, KOI-8R).
+   8. Supporting CJK fonts and encodings.
+
+You can add the feature of PDF creation by using Haru without understanding 
+complicated internal structure of PDF.
+
+*
+* The differences from the previous version 
+*
+
+The biggest differences are that all code is written in C. 
+To our regret, because internal structures changed greatly, The API is not 
+compatible with previous version.
+
+However, the new-version has the following advantages compared with the 
+previous version.
+
+ 1. Supported shared-library build.
+    A new-version library is able to be built as shared-library.
+ 2. The performance has been greatly improved.
+    A new-version library is about 4-15 times faster than a previous version. 
+ 3. Supported more features.
+    TrueType font, 128 bit encryption, arc function, and so on.
+
+*
+* Supporting platforms
+*
+Haru is written in ANSI-C and should compile easily with any compliant C 
+compiler.
+I inspected Haru in the following environment and make files for these 
+environments are included in a package.
+
+   1. Cygwin + GCC (Microsoft Windows)
+   2. Cygwin + MinGW (Microsoft Windows)
+   3. MSYS + MinGW (Microsoft Windows)
+   3. Microsoft VC++ (Microsoft Windows)
+   4. Borland C++ (Microsoft Windows)
+   5. GCC (Linux, FreeBSD, NetBSD, Solaris...)
+
+Also on platforms except the above, it is easy to build HARU. If you success to build HARU on other platforms, please send makefile to me.
+In addition, ZLIB and PNGLIB are required when you want to use the features of 
+compression and embedding PNG images. (In the case of Windows, static library 
+files for several compilers are included in the package for WIndows.  In the 
+case of  most of UNIX, these libraries are usually installed.)
+
+*
+* Available development environment
+*
+Haru can work as both static-library (.a, .lib) and shared-library (.so, .dll).
+When you use it as static-library, It can be used by C and a C++.
+But when you use it as shared-library, it can be used by many development 
+languages which support shared library.
+So far, Haru provides bindings for Ruby, Delphi/Free Pascal and C#.
+
+If you write bindings for other programing languages, please notice me!
+
+*
+* Runtime environment of programs using Haru
+*
+1. static-library
+   No runtime files are required.
+
+2. shared-library
+   In Windows, you have to distribute libhpdf.dll with a program. In UNIX you 
+   have to distribute libhpdf.so* with a program.
+
+NOTE:
+In the UNIX environment, there are the cases that libz.so, libpng.so.x are 
+necessary. About this, please refer to the documentation of PNGLIB and ZLIB.
+
+*
+* Acknowledgment
+*
+1. Information-technology Promotion Agency(IPA)
+   The development of Haru has been supported by Exploratory Software Project 
+   of Information-technology Promotion Agency(IPA), Japan. 
+
+2. All users of libHaru.
+   We wish to thank all users of Haru.
+   In particular, we thank Thomas Nimstad, LeslieM, Par Hogberg, adenelson, 
+   Riccardo Cohen, sea_sbs, Andrew. 
+   They gave me very useful advices.
+
+3. Sourceforge.net
+   We would like to thank sourceForge.net for project hosting.
+
+4. Adobe Systems Inc.
+   We thank Adobe Systems Inc. for publishing PDF specification.
+
+
+TODO - todo for libharu
+
+* Vertical writing support of HPDF_TextRect()
+* Correct a code which uses implicit type conversion and causes warnings.
+* Form desiner.
+

data/examples/arc_demo.rb

@@ -0,0 +1,82 @@
+#
+# << Haru Free PDF Library 2.0.2 >> -- arc_demo.rb
+#
+# http://libharu.sourceforge.net/
+#
+# Copyright (c) 1999-2006 Takeshi Kanno
+#
+# Permission to use, copy, modify, distribute and sell this software
+# and its documentation for any purpose is hereby granted without fee,
+# provided that the above copyright notice appear in all copies and
+# that both that copyright notice and this permission notice appear
+# in supporting documentation.
+# It is provided "as is" without express or implied warranty.
+#
+require 'rubygems'
+require "hpdf"
+
+pdf = HPDFDoc.new
+
+# add a new page object. #
+page = pdf.add_page
+
+page.set_height(220)
+page.set_width(200)
+
+# draw pie chart
+#
+#   A: 45% Red
+#   B: 25% Blue
+#   C: 15% green
+#   D: other yellow
+#
+
+# A #
+page.set_rgb_fill(1.0, 0, 0)
+page.move_to(100, 100)
+page.line_to(100, 180)
+page.arc(100, 100, 80, 0, 360 * 0.45)
+pos = page.get_current_pos
+page.line_to(100, 100)
+page.fill
+
+# B #
+page.set_rgb_fill(0, 0, 1.0)
+page.move_to(100, 100)
+page.line_to(pos[0], pos[1])
+page.arc(100, 100, 80, 360 * 0.45, 360 * 0.7)
+pos = page.get_current_pos
+page.line_to(100, 100)
+page.fill
+
+# C #
+page.set_rgb_fill(0, 1.0, 0)
+page.move_to(100, 100)
+page.line_to(pos[0], pos[1])
+page.arc(100, 100, 80, 360 * 0.7, 360 * 0.85)
+pos = page.get_current_pos
+page.line_to(100, 100)
+page.fill
+
+# D #
+page.set_rgb_fill(1.0, 1.0, 0)
+page.move_to(100, 100)
+page.line_to(pos[0], pos[1])
+page.arc(100, 100, 80, 360 * 0.85, 360)
+pos = page.get_current_pos
+page.line_to(100, 100)
+page.fill
+
+# draw center circle #
+page.set_gray_stroke(0)
+page.set_gray_fill(1)
+page.circle(100, 100, 30)
+page.fill
+
+if $demo_output_filename
+  file_name= $demo_output_filename
+else
+  file_name= $0 + ".pdf"
+end  
+
+pdf.save_to_file(file_name)

data/examples/demo.rb

@@ -0,0 +1,92 @@
+#
+# << Haru Free PDF Library 2.0.0 >> -- demo.rb
+#
+# Copyright (c) 1999-2006 Takeshi Kanno <takeshi_kanno@est.hi-ho.ne.jp>
+#
+# Permission to use, copy, modify, distribute and sell this software
+# and its documentation for any purpose is hereby granted without fee,
+# provided that the above copyright notice appear in all copies and
+# that both that copyright notice and this permission notice appear
+# in supporting documentation.
+# It is provided "as is" without express or implied warranty.
+#
+
+require 'rubygems'
+require "hpdf"
+
+if ARGV.empty?
+  line = 'Ruby Rocks'
+else
+  line = ARGV.join(" ")
+end
+
+pdf = HPDFDoc.new
+
+page = pdf.add_page
+
+x = 578
+r1 = 25
+
+40.step(1, -3) do |xw|
+  tone = 1.0 - (xw / 40.0) * 0.2
+
+  page.set_line_width(xw.to_f)
+  page.set_rgb_stroke(tone, 1.0, tone)
+  page.circle(50.0, 750.0, r1.to_f)
+  page.stroke
+  r1 += xw
+end
+
+40.step(1, -3) do |xw|
+  tone = 1.0 - (xw / 40.0) * 0.2
+
+  page.set_line_width(xw.to_f)
+  page.set_rgb_stroke(tone, tone, 1.0)
+  page.move_to(x.to_f, 0.0)
+  page.line_to(x.to_f, 842.0)
+  page.stroke
+  x = (x - xw - 2)
+end
+
+page.set_rgb_stroke(0.0, 0.0, 0.0)
+page.set_line_width(1.0)
+page.rectangle(20.0, 20.0, 558.0, 802.0)
+page.stroke
+
+font = pdf.get_font("Helvetica", nil)
+bbox = font.get_bbox
+
+y = 800
+50.step(5, -5) do |size|
+  height = (bbox[3] - bbox[1]) / 1000 * size
+  y = y - height
+
+  page.begin_text
+  page.set_font_and_size(font, size.to_f)
+  page.text_out(30.0, y.to_f, line)
+  page.end_text
+end
+
+(0...360).step(20) do |angle|
+  page.set_rgb_fill(rand, rand, rand)
+
+  page.begin_text
+  rad = angle / 180.0 * 3.141592
+  page.set_font_and_size(font, 20.0)
+  page.set_text_matrix(Math.cos(rad),
+                        Math.sin(rad),
+                        -Math.sin(rad), 
+                        Math.cos(rad),
+                        300 + Math.cos(rad) * 40,
+                        300 + Math.sin(rad) * 40)
+  page.show_text(line)
+  page.end_text
+end
+
+if $demo_output_filename
+  file_name= $demo_output_filename
+else
+  file_name= $0 + ".pdf"
+end  
+
+pdf.save_to_file(file_name)

data/examples/encryption.rb

@@ -0,0 +1,41 @@
+#
+# << Haru Free PDF Library 2.0.0 >> -- encryption.rb
+#
+# Copyright (c) 1999-2006 Takeshi Kanno <takeshi_kanno@est.hi-ho.ne.jp>
+#
+# Permission to use, copy, modify, distribute and sell this software
+# and its documentation for any purpose is hereby granted without fee,
+# provided that the above copyright notice appear in all copies and
+# that both that copyright notice and this permission notice appear
+# in supporting documentation.
+# It is provided "as is" without express or implied warranty.
+#
+require 'rubygems'
+require "hpdf"
+
+pdf = HPDFDoc.new
+
+text = "This is an encrypt document example."
+owner_passwd = "owner"
+user_passwd = "user"
+
+font1 = pdf.get_font("Helvetica", nil)
+
+page = pdf.add_page
+
+page.set_size(HPDFDoc::HPDF_PAGE_SIZE_B5, HPDFDoc::HPDF_PAGE_LANDSCAPE)
+
+page.begin_text
+page.set_font_and_size(font1, 20)
+page.text_rect(0, page.get_height / 2 + 20, page.get_width, page.get_height / 2 -10, text, HPDFDoc::HPDF_TALIGN_CENTER)
+page.end_text
+
+pdf.set_password(owner_passwd, user_passwd)
+
+if $demo_output_filename
+  file_name= $demo_output_filename
+else
+  file_name= $0 + ".pdf"
+end  
+
+pdf.save_to_file(file_name)