hexapdf 0.3.0 → 0.4.0

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA1:
-  metadata.gz: ecec6549dbb8ccc811ea329857ff768bb248d9ca
-  data.tar.gz: 2e04be0ab4a81fc11491314b18ad95411dc2a0cc
+  metadata.gz: 506ca50e79972288ec42dcfb6b31b436500da5c7
+  data.tar.gz: ea88dc0891a1ce15cf40a6d8cc4e6a15e9a05583
 SHA512:
-  metadata.gz: 4a447429d78977fb78336e4f000d4b53d13bb40fd9e27a4d5a02b9a984d6e2fad76dbbe4d8a069236e24d1295b49ec996eb09d416cbe2668018b3331109e4df1
-  data.tar.gz: aba92a4c25811ab09146a3dafb544194c4aa42373098137ffe339061c1b779c5239afd092521cfe683d4bc8b9e11e609e108213e94375894c854278dac98be41
+  metadata.gz: b9a9fd668aa6a2ad42a93a42c7cd6d1e2864a5841cf21bd1191815916a8cca4a229d3a1ed5657ece44edbadd1b82975f974c2dc10ae10bd8ca9a720649ce4dcf
+  data.tar.gz: e2bf96c4158ca5cb440bebe9fb85b3d1a61e7b8caa53a13908ab1ac4b9638488593ff6875382d799477e1fedcea4620f248e71f9970fd6478b1ce94b06a9ed61

data/CHANGELOG.md

@@ -1,3 +1,71 @@
+## 0.4.0 - 2017-03-19
+
+### Added
+
+* [HexaPDF::Type::FontType0] and [HexaPDF::Type::CIDFont] for composite font
+  support
+* Complete support for CMaps for use with composite fonts; the interface for
+  [HexaPDF::Font::CMap] changed to accomodate this
+* CLI command `hexapdf batch` for batch execution of a single command for
+  multiple input files
+* CLI option `--verbose` for more verbose output; also changed the default
+  verbosity level to only display warnings and not informational messages
+* CLI option `--quiet` for suppressing additional and diagnostic output
+* CLI option `--strict` for enabling strict parsing and validation; also
+  changed the default from strict to non-strict parsing/validation
+* CLI optimization option `--optimize-fonts` for optimizing embedded fonts
+* Method `#word_spacing_applicable?` to font types
+* Support for marked-content points and sequences in [HexaPDF::Content::Canvas]
+* Support for property lists in a page's resource dictionary
+* Show file name and size in `hexapdf info` output
+* [HexaPDF::Type::Font#font_file] for getting the embedded font file
+* [HexaPDF::Font::TrueType::Optimizer] for optimizing TrueType fonts
+* Configuration option 'filter.flate_memory' for configuring memory use of the
+  [HexaPDF::Filter::FlateDecode] filter
+* Method [HexaPDF::Content::Canvas#show_glyphs_only] for faster glyph showing
+  without text matrix calculations
+* Methods for caching expensive computations of PDF objects
+  ([HexaPDF::Document#cache] and others)
+
+### Changed
+
+* Enabled in-place processing of PDF files for all CLI commands
+* Show warning instead of exiting when extracting images with `hexapdf images`
+  and an image format is not supported
+* Handling of character code to Unicode mapping:
+  - [HexaPDF::Font::CMap#to_unicode], [HexaPDF::Font::Encoding::Base#unicode]
+    and [HexaPDF::Font::Encoding::GlyphList#name_to_unicode] return `nil`
+    instead of an empty string
+  - Font dictionaries use the new configuration option
+    'font.on_missing_unicode_mapping' in their `#to_utf8` method
+* [HexaPDF::Configuration#constantize] to raise error if constant is not found
+* Extracted TrueType font file building code into new module
+  [HexaPDF::Font::TrueType::Builder]
+* [HexaPDF::Filter::FlateDecode] filter to use pools of Zlib inflaters and
+  deflaters to conserve memory
+
+### Fixed
+
+* Use of wrong glyph IDs for glyph width entries and unicode mapping for subset
+  TrueType fonts
+* Invalid document reference when importing wrapped direct objects with
+  [HexaPDF::Importer]
+* Invalid type of /DW key in CIDFont dictionary when embedding TrueType fonts
+* Caching problem in [HexaPDF::Document::Fonts] which lead to multiple instances
+  of the same font
+* Bug in handling of word spacing with respect to offset calculations when
+  showing or extracting text
+* Incorrect handling of page rotation values in `hexapdf merge`
+* Missing handling of certain rotation values in `hexapdf modify`
+* Removal of unused pages in `hexapdf modify`
+* Handling of invalid page numbers in CLI commands
+* Useless multiple extraction of the same image in `hexapdf images`
+* Type of /VP entry of [HexaPDF::Type::Page]
+* Parsing of inline images that contain the end-of-image marker
+* High memory usage due to not closing `Zlib::Stream` objects in
+  [HexaPDF::Filter::FlateDecode]
+
+
 ## 0.3.0 - 2017-01-25
 
 ### Added

data/CONTRIBUTERS

@@ -1,3 +1,3 @@
   Count Name
 ======= ====
-    682 Thomas Leitner <t_leitner@gmx.at>
+    741 Thomas Leitner <t_leitner@gmx.at>

data/README.md

@@ -28,7 +28,7 @@ PDF file:
 require 'hexapdf'
 
 doc = HexaPDF::Document.new
-canvas = doc.pages.add_page.canvas
+canvas = doc.pages.add.canvas
 canvas.font('Helvetica', size: 100)
 canvas.text("Hello World!", at: [20, 400])
 doc.write("hello-world.pdf")
@@ -57,10 +57,23 @@ hexapdf`.
 
 ## Difference to Prawn
 
-[Prawn] is a Ruby library that can be used for creating PDF files. It has been in development since
-2008 and currently provides more features in regard to PDF content creation than HexaPDF.
+The main difference between HexaPDF and [Prawn] is that HexaPDF is a **full PDF library** whereas
+Prawn is a **library for generating content**.
 
-So why use HexaPDF? Because it differs significantly from Prawn in how it is implemented:
+To be more specific, it is easily possible to read an existing PDF with HexaPDF and modify parts of
+it before writing it out again. The modifications can be to the PDF object structure like removing
+superfluous annotations or the the content itself.
+
+Prawn has no such functionality. There is basic support for using a PDF as a template using the
+`pdf-reader` and `prawn-template` gems but support is very limited. However, Prawn has a very
+featureful API when it comes to creating content, for individual pages as well as across pages.
+
+Such functionality will be incorporated into HexaPDF in the near future. The main functionality for
+providing such a feature is already available in HexaPDF (the [page canvas API]). What's missing
+(and this is quite big chunk) is automatic box and page layout so that one can say: There is a box
+on this page with these dimensions at this position; show this text in the box.
+
+So why use HexaPDF?
 
 * The architecture of HexaPDF is based on the object model of the PDF standard. This makes extending
   HexaPDF very easy and allows for **reading PDF files for templating purposes**.
@@ -70,13 +83,31 @@ So why use HexaPDF? Because it differs significantly from Prawn in how it is imp
   emphasized text and so on. These elements can be customized and additional element types easily
   added.
 
+* In addition to being usable as a library, HexaPDF also comes with a command line tool for
+  manipulating PDFs. This tool is intended to be a replacement for tools like `pdftk` and the
+  various Poppler-based tools like `pdfinfo`, `pdfimages`, ...
+
 [Prawn]: http://prawnpdf.org
+[page canvas API]: https://hexapdf.gettalong.org/api/HexaPDF/Content/Canvas.html
 
 
 ## License
 
 See the LICENSE file for licensing details.
 
+Some included files have a different license:
+
+* For the license of the included AFM files in the `data/hexapdf/afm` directory, see the file
+  `data/hexapdf/afm/MustRead.html`.
+
+* The files `test/data/encoding/{glyphlist.txt,zapfdingbats.txt}` are licensed under the Apache
+  License V2.0.
+
+* The file `test/data/fonts/Ubuntu-Title.ttf` is licensed under the SIL Open Font License.
+
+* The AES test vector files in `test/data/aes-test-vectors` have been created using the test vector
+  file available from <http://csrc.nist.gov/groups/STM/cavp/block-ciphers.html#test-vectors>.
+
 
 ## Contributing
 

data/Rakefile

@@ -66,6 +66,7 @@ namespace :dev do
     s.default_executable = 'hexapdf'
     s.add_dependency('cmdparse', '~> 3.0', '>= 3.0.3')
     s.add_development_dependency('kramdown', '~> 1.0', '>= 1.13.0')
+    s.required_ruby_version = '>= 2.3'
 
     s.author = 'Thomas Leitner'
     s.email = 't_leitner@gmx.at'

data/VERSION

@@ -1 +1 @@
-0.3.0
+0.4.0

data/data/hexapdf/cmap/83pv-RKSJ-H

@@ -0,0 +1,314 @@
+%!PS-Adobe-3.0 Resource-CMap
+%%DocumentNeededResources: ProcSet (CIDInit)
+%%IncludeResource: ProcSet (CIDInit)
+%%BeginResource: CMap (83pv-RKSJ-H)
+%%Title: (83pv-RKSJ-H Adobe Japan1 1)
+%%Version: 10.005
+%%Copyright: -----------------------------------------------------------
+%%Copyright: Copyright 1990-2015 Adobe Systems Incorporated.
+%%Copyright: All rights reserved.
+%%Copyright:
+%%Copyright: Redistribution and use in source and binary forms, with or
+%%Copyright: without modification, are permitted provided that the
+%%Copyright: following conditions are met:
+%%Copyright:
+%%Copyright: Redistributions of source code must retain the above
+%%Copyright: copyright notice, this list of conditions and the following
+%%Copyright: disclaimer.
+%%Copyright:
+%%Copyright: Redistributions in binary form must reproduce the above
+%%Copyright: copyright notice, this list of conditions and the following
+%%Copyright: disclaimer in the documentation and/or other materials
+%%Copyright: provided with the distribution. 
+%%Copyright:
+%%Copyright: Neither the name of Adobe Systems Incorporated nor the names
+%%Copyright: of its contributors may be used to endorse or promote
+%%Copyright: products derived from this software without specific prior
+%%Copyright: written permission. 
+%%Copyright:
+%%Copyright: THIS SOFTWARE IS PROVIDED BY THE COPYRIGHT HOLDERS AND
+%%Copyright: CONTRIBUTORS "AS IS" AND ANY EXPRESS OR IMPLIED WARRANTIES,
+%%Copyright: INCLUDING, BUT NOT LIMITED TO, THE IMPLIED WARRANTIES OF
+%%Copyright: MERCHANTABILITY AND FITNESS FOR A PARTICULAR PURPOSE ARE
+%%Copyright: DISCLAIMED. IN NO EVENT SHALL THE COPYRIGHT HOLDER OR
+%%Copyright: CONTRIBUTORS BE LIABLE FOR ANY DIRECT, INDIRECT, INCIDENTAL,
+%%Copyright: SPECIAL, EXEMPLARY, OR CONSEQUENTIAL DAMAGES (INCLUDING, BUT
+%%Copyright: NOT LIMITED TO, PROCUREMENT OF SUBSTITUTE GOODS OR SERVICES;
+%%Copyright: LOSS OF USE, DATA, OR PROFITS; OR BUSINESS INTERRUPTION)
+%%Copyright: HOWEVER CAUSED AND ON ANY THEORY OF LIABILITY, WHETHER IN
+%%Copyright: CONTRACT, STRICT LIABILITY, OR TORT (INCLUDING NEGLIGENCE OR
+%%Copyright: OTHERWISE) ARISING IN ANY WAY OUT OF THE USE OF THIS
+%%Copyright: SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY OF SUCH DAMAGE.
+%%Copyright: -----------------------------------------------------------
+%%EndComments
+
+/CIDInit /ProcSet findresource begin
+
+12 dict begin
+
+begincmap
+
+/CIDSystemInfo 3 dict dup begin
+  /Registry (Adobe) def
+  /Ordering (Japan1) def
+  /Supplement 1 def
+end def
+
+/CMapName /83pv-RKSJ-H def
+/CMapVersion 10.005 def
+/CMapType 1 def
+
+/UIDOffset 0 def
+/XUID [1 10 25324] def
+
+/WMode 0 def
+
+5 begincodespacerange
+  <00>   <80>
+  <8140> <9FFC>
+  <A0>   <DF>
+  <E040> <FCFC>
+  <FD>   <FF>
+endcodespacerange
+
+1 beginnotdefrange
+<00> <1f> 1
+endnotdefrange
+
+100 begincidrange
+<20> <7e>        1
+<80> <80>       97
+<8140> <817e>  633
+<8180> <81ac>  696
+<81b8> <81bf>  741
+<81c8> <81ce>  749
+<81da> <81e8>  756
+<81f0> <81f7>  771
+<81fc> <81fc>  779
+<824f> <8258>  780
+<8260> <8279>  790
+<8281> <829a>  816
+<829f> <82f1>  842
+<8340> <837e>  925
+<8380> <8396>  988
+<839f> <83b6> 1011
+<83bf> <83d6> 1035
+<8440> <8460> 1059
+<8470> <847e> 1092
+<8480> <8491> 1107
+<849f> <849f> 7479
+<84a0> <84a0> 7481
+<84a1> <84a1> 7491
+<84a2> <84a2> 7495
+<84a3> <84a3> 7503
+<84a4> <84a4> 7499
+<84a5> <84a5> 7507
+<84a6> <84a6> 7523
+<84a7> <84a7> 7515
+<84a8> <84a8> 7531
+<84a9> <84a9> 7539
+<84aa> <84aa> 7480
+<84ab> <84ab> 7482
+<84ac> <84ac> 7494
+<84ad> <84ad> 7498
+<84ae> <84ae> 7506
+<84af> <84af> 7502
+<84b0> <84b0> 7514
+<84b1> <84b1> 7530
+<84b2> <84b2> 7522
+<84b3> <84b3> 7538
+<84b4> <84b4> 7554
+<84b5> <84b5> 7511
+<84b6> <84b6> 7526
+<84b7> <84b7> 7519
+<84b8> <84b8> 7534
+<84b9> <84b9> 7542
+<84ba> <84ba> 7508
+<84bb> <84bb> 7527
+<84bc> <84bc> 7516
+<84bd> <84bd> 7535
+<84be> <84be> 7545
+<8540> <857e>  232
+<8580> <8580>  390
+<8581> <859e>  296
+<859f> <85dd>  327
+<85de> <85fc>  391
+<8640> <867e>  422
+<8680> <8691>  485
+<8692> <8692>  295
+<8693> <869e>  503
+<86a2> <86ed> 7479
+<8740> <875d> 7555
+<875f> <8775> 7585
+<8780> <878f> 7608
+<8790> <8790>  762
+<8791> <8791>  761
+<8792> <8792>  769
+<8793> <8799> 7624
+<879a> <879a>  768
+<879b> <879c> 7631
+<889f> <88fc> 1125
+<8940> <897e> 1219
+<8980> <89fc> 1282
+<8a40> <8a7e> 1407
+<8a80> <8afc> 1470
+<8b40> <8b7e> 1595
+<8b80> <8bfc> 1658
+<8c40> <8c7e> 1783
+<8c80> <8cfc> 1846
+<8d40> <8d7e> 1971
+<8d80> <8dfc> 2034
+<8e40> <8e7e> 2159
+<8e80> <8efc> 2222
+<8f40> <8f7e> 2347
+<8f80> <8ffc> 2410
+<9040> <907e> 2535
+<9080> <90fc> 2598
+<9140> <917e> 2723
+<9180> <91fc> 2786
+<9240> <927e> 2911
+<9280> <92fc> 2974
+<9340> <937e> 3099
+<9380> <93fc> 3162
+<9440> <947e> 3287
+<9480> <94fc> 3350
+<9540> <957e> 3475
+<9580> <95fc> 3538
+<9640> <967e> 3663
+<9680> <96fc> 3726
+endcidrange
+
+100 begincidrange
+<9740> <977e> 3851
+<9780> <97fc> 3914
+<9840> <9872> 4039
+<989f> <98fc> 4090
+<9940> <997e> 4184
+<9980> <99fc> 4247
+<9a40> <9a7e> 4372
+<9a80> <9afc> 4435
+<9b40> <9b7e> 4560
+<9b80> <9bfc> 4623
+<9c40> <9c7e> 4748
+<9c80> <9cfc> 4811
+<9d40> <9d7e> 4936
+<9d80> <9dfc> 4999
+<9e40> <9e7e> 5124
+<9e80> <9efc> 5187
+<9f40> <9f7e> 5312
+<9f80> <9ffc> 5375
+<a0> <df>      326
+<e040> <e07e> 5500
+<e080> <e0fc> 5563
+<e140> <e17e> 5688
+<e180> <e1fc> 5751
+<e240> <e27e> 5876
+<e280> <e2fc> 5939
+<e340> <e37e> 6064
+<e380> <e3fc> 6127
+<e440> <e47e> 6252
+<e480> <e4fc> 6315
+<e540> <e57e> 6440
+<e580> <e5fc> 6503
+<e640> <e67e> 6628
+<e680> <e6fc> 6691
+<e740> <e77e> 6816
+<e780> <e7fc> 6879
+<e840> <e87e> 7004
+<e880> <e8fc> 7067
+<e940> <e97e> 7192
+<e980> <e9fc> 7255
+<ea40> <ea7e> 7380
+<ea80> <eaa2> 7443
+<eaa3> <eaa4> 8284
+<eb40> <eb40>  633
+<eb41> <eb42> 7887
+<eb43> <eb4f>  636
+<eb50> <eb51> 7889
+<eb52> <eb5a>  651
+<eb5b> <eb5d> 7891
+<eb5e> <eb5f>  663
+<eb60> <eb64> 7894
+<eb65> <eb68>  670
+<eb69> <eb7a> 7899
+<eb7b> <eb7e>  692
+<eb80> <eb80>  696
+<eb81> <eb81> 7917
+<eb82> <ebac>  698
+<ebb8> <ebbf>  741
+<ebc8> <ebce>  749
+<ebda> <ebe8>  756
+<ebf0> <ebf7>  771
+<ebfc> <ebfc>  779
+<ec4f> <ec58>  780
+<ec60> <ec79>  790
+<ec81> <ec9a>  816
+<ec9f> <ec9f> 7918
+<eca0> <eca0>  843
+<eca1> <eca1> 7919
+<eca2> <eca2>  845
+<eca3> <eca3> 7920
+<eca4> <eca4>  847
+<eca5> <eca5> 7921
+<eca6> <eca6>  849
+<eca7> <eca7> 7922
+<eca8> <ecc0>  851
+<ecc1> <ecc1> 7923
+<ecc2> <ece0>  877
+<ece1> <ece1> 7924
+<ece2> <ece2>  909
+<ece3> <ece3> 7925
+<ece4> <ece4>  911
+<ece5> <ece5> 7926
+<ece6> <eceb>  913
+<ecec> <ecec> 7927
+<eced> <ecf1>  920
+<ed40> <ed40> 7928
+<ed41> <ed41>  926
+<ed42> <ed42> 7929
+<ed43> <ed43>  928
+<ed44> <ed44> 7930
+<ed45> <ed45>  930
+<ed46> <ed46> 7931
+<ed47> <ed47>  932
+<ed48> <ed48> 7932
+<ed49> <ed61>  934
+<ed62> <ed62> 7933
+<ed63> <ed7e>  960
+<ed80> <ed82>  988
+<ed83> <ed83> 7934
+<ed84> <ed84>  992
+<ed85> <ed85> 7935
+endcidrange
+
+22 begincidrange
+<ed86> <ed86>  994
+<ed87> <ed87> 7936
+<ed88> <ed8d>  996
+<ed8e> <ed8e> 7937
+<ed8f> <ed94> 1003
+<ed95> <ed96> 7938
+<ed9f> <edb6> 1011
+<edbf> <edd6> 1035
+<ee40> <ee5d> 7555
+<ee5f> <ee6e> 7940
+<ee6f> <ee75> 7601
+<ee80> <ee81> 7956
+<ee82> <ee8f> 7610
+<ee90> <ee90>  762
+<ee91> <ee91>  761
+<ee92> <ee92>  769
+<ee93> <ee99> 7624
+<ee9a> <ee9a>  768
+<ee9b> <ee9c> 7631
+<fd> <fd>      152
+<fe> <fe>      228
+<ff> <ff>      124
+endcidrange
+endcmap
+CMapName currentdict /CMap defineresource pop
+end
+end
+
+%%EndResource
+%%EOF