combine_pdf 0.2.16 → 0.2.17

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA1:
-  metadata.gz: 114c27c4f23021df9f78df6468f5fcffe8022f70
-  data.tar.gz: 5b75261b3ae0c2a0d12520f5f366a9b17b6e2049
+  metadata.gz: 28a01d7ee2e0bd120239415e5691dc391a22c1e2
+  data.tar.gz: a7719887e8d6b96dfde01100ff3139a8fdcd0376
 SHA512:
-  metadata.gz: ff3cbca040ad3dece43ea7ce4ed1b3a006cf86842390761d88c601de0cddf3cc16056d15449ef3fc415886242f24d77c0637818831f7d04efd775d77a1fc23a6
-  data.tar.gz: f4e27c18d9b7925c7018059602f7d7cb16ca970dd06494025056f84db939828b309b399cfd1f52c6a27c36f8b17037e9e810b030b0f6e582f89ca2bba5991cdc
+  metadata.gz: ccdc753817129e63d0d118e955d386d27102b72a4cad9f67681dbaf9a5cf3d271a273f06fd4aa1837dcc0bb5738d12aa6a12125bdb4747b71b2702e40ebfd1b6
+  data.tar.gz: 130f7f1b54e1847d1701ddc5311695e25e85f8cea3d2cd3ef4a253ffbc69565f897add7b1b50f0ccfe18d15f06a44791e154d640c513ae9fecfe49e6cd91c1a6

data/CHANGELOG.md

@@ -2,6 +2,18 @@
 
 ***
 
+Change log v.0.2.17
+
+**Feature**: added the `page#crop` method to easily crop a PDF file in accordance with the GWG industry association recommendations (updating the `MediaBox` property rather then the `CropBox`). Credit to @wingleungchoi for this feature.
+
+***
+
+Change log v.0.2.16
+
+**Fix**: Fix for issue #49 where specific PDF files containing junk data after the %%EOF marker couldn't be opened (as they were invalid files). The issue was fixed by scanning any trailing data before continuing to parse any PDF file beyond the first %%EOF markers (multiple markers are common when using the PDF format). Credit to @wingleungchoi for providing an example for the issue.
+
+***
+
 Change log v.0.2.15
 
 **Fix**: Fix for issue #22 where specific PDF files with nested references could cause page stamping to fail, raising an exception. Credit to @tomascharad for finding the issue.
@@ -44,7 +56,7 @@ Change log v.0.2.10
 
 Change log v.0.2.9
 
-**Fix** hopefully fixed issue #33 ([NoMethodError undefined method `[]' for nil:NilClass](https://github.com/boazsegev/combine_pdf/issues/33)).
+**Fix** hopefully fixed issue #33 ([NoMethodError undefined method `[]` for nil:NilClass](https://github.com/boazsegev/combine_pdf/issues/33)).
 
 ***
 

data/lib/combine_pdf/fonts.rb

@@ -89,7 +89,7 @@ module CombinePDF
 		# returns a list containing the registered font names
 		def fonts_list
 			initiate_library
-			FONTS_LIBRARY.keys			
+			FONTS_LIBRARY.keys
 		end
 
 		# gets the original font object from the fonts library (this allows you to edit the font).
@@ -207,12 +207,15 @@ module CombinePDF
 		end
 
 		# Register a font that already exists in a pdf object into the font library.
-		# DOESN'T WORK YET!!!
+		#
+		# The implementation is experimental, but this function attempts to deconstruct a font object in order to
+		# extract it's cmap and metric data, allowing it's use in the CombinePDF library.
+		#
 		def register_font_from_pdf_object font_name, font_object
 			# FIXME:
 			# - add stream deflation for the CMap file.
 			# - add :Encoding CMaps (such as :WinAnsiEncoding etc`)
-			# - the ToUnicode CMap parsing assumes 8 Bytes <0F0F> while 16 Bytes and multiple unicode chars are also possible. 
+			# - the ToUnicode CMap parsing assumes 8 Bytes <0F0F> while 16 Bytes and multiple unicode chars are also possible.
 
 			# first, create cmap, as it will be used to correctly create the widths directory.
 
@@ -238,7 +241,7 @@ module CombinePDF
 			if font_object[:DescendantFonts]
 				old_widths = font_object[:DescendantFonts]
 				old_widths = old_widths[:referenced_object][:indirect_without_dictionary] if old_widths[:is_reference_only]
-				old_widths = old_widths[0][:referenced_object] 
+				old_widths = old_widths[0][:referenced_object]
 				avrg_height = 360
 				avrg_height = old_widths[:XHeight] if old_widths[:XHeight]
 				avrg_height = (avrg_height + old_widths[:CapHeight])/2 if old_widths[:CapHeight]
@@ -257,7 +260,7 @@ module CombinePDF
 					a = old_widths.shift
 					b = old_widths.shift
 					if b.is_a?(Array)
-						b.each_index {|i| metrics[ cmap_inverted[(a+i)] || (a+i) ] = {wx: b[i], boundingbox: avarage_bbox} }	
+						b.each_index {|i| metrics[ cmap_inverted[(a+i)] || (a+i) ] = {wx: b[i], boundingbox: avarage_bbox} }
 					else
 						c = old_widths.shift
 						(b-a).times {|i| metrics[cmap_inverted[(a+i)] || (a+i)] = {wx: c[0], boundingbox: avarage_bbox} }
@@ -371,7 +374,7 @@ module CombinePDF
 		# - the ToUnicode CMap parsing assumes 8 Bytes <0F0F> while 16 Bytes and multiple unicode chars are also possible (albit very rare).
 		def self.parse_cmap(stream = "")
 			# FIXME:
-			# - the ToUnicode CMap parsing assumes 8 Bytes <0F0F> while 16 Bytes and multiple unicode chars are also possible. 
+			# - the ToUnicode CMap parsing assumes 8 Bytes <0F0F> while 16 Bytes and multiple unicode chars are also possible.
 
 					# when 0..255
 					# 	warn "coded to char"
@@ -446,7 +449,7 @@ module CombinePDF
 							cmap["%c" % line[2][j].hex]  = format % i #FixMe? for now limit to 8 Byte data
 							j += 1
 							i += 1
-						end					
+						end
 					else
 						format = "%0#{line[0].length}x"
 						i = line[0].hex
@@ -460,15 +463,9 @@ module CombinePDF
 					end
 				end
 			end
-			warn "CMap is empty even after parsing!\nthese were the lines found: #{lines_found}\nfrom: #{scanner.string}" if cmap.empty?			
+			warn "CMap is empty even after parsing!\nthese were the lines found: #{lines_found}\nfrom: #{scanner.string}" if cmap.empty?
 			cmap
 		end
 
 	end
 end
-
-
-
-
-
-

data/lib/combine_pdf/page_methods.rb

@@ -441,6 +441,38 @@ module CombinePDF
 			self
 		end
 
+		# crops the page using a <b>relative</b> size.
+		#
+		# `crop` will crop the page by updating it's MediaBox property using a <b>relative</b> crop box. i.e.,
+	  # when cropping a page with {#page_size} of [10,10,900,900] to [5,5,500,500], the resulting page size should be [15, 15, 510, 510] - allowing you to ignore a page's initial XY starting point when cropping.
+		#
+		# for an absolute cropping, simpy use the {#mediabox=} or {#cropbox=} methods, setting their value to the new {page_size}.
+		#
+		# accepts:
+		# new_size:: an Array with four elements: [X0, Y0, X_max, Y_max]. For example, inch4(width)x6(length): `[200, 200, 488, 632]`
+		def crop(new_size=nil)
+			# no crop box? clear any cropping.
+			return page_size if !new_size
+			# type safety
+			raise TypeError, "pdf.page\#crop expeceted an Array (or nil)" unless Array === new_size
+
+			# set the MediaBox to the existing page size
+			self[:MediaBox] = page_size
+			# clear the CropBox
+			self[:CropBox] = nil
+			# update X0
+			self[:MediaBox][0] += new_size[0]
+			# update Y0
+			self[:MediaBox][1] += new_size[1]
+			# update X max IF the value is smaller then the existing value
+			self[:MediaBox][2] = (self[:MediaBox][0] + new_size[2] - new_size[0]) if ((self[:MediaBox][0] + new_size[2] - new_size[0])  < self[:MediaBox][2])
+			# update Y max IF the value is smaller then the existing value
+			self[:MediaBox][3] = (self[:MediaBox][1] + new_size[3] - new_size[1]) if ((self[:MediaBox][1] + new_size[3] - new_size[1])  < self[:MediaBox][3])
+			# return self for chaining
+			self
+		end
+
+
 		# rotate the page 90 degrees counter clockwise
 		def rotate_left
 			self[:Rotate] = self[:Rotate].to_f + 90

data/lib/combine_pdf/version.rb

@@ -1,3 +1,3 @@
 module CombinePDF
-  VERSION = "0.2.16"
+  VERSION = "0.2.17"
 end

metadata

@@ -1,14 +1,14 @@
 --- !ruby/object:Gem::Specification
 name: combine_pdf
 version: !ruby/object:Gem::Version
-  version: 0.2.16
+  version: 0.2.17
 platform: ruby
 authors:
 - Boaz Segev
 autorequire: 
 bindir: bin
 cert_chain: []
-date: 2016-02-25 00:00:00.000000000 Z
+date: 2016-04-10 00:00:00.000000000 Z
 dependencies:
 - !ruby/object:Gem::Dependency
   name: ruby-rc4