combine_pdf 0.2.3 → 0.2.4

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA1:
-  metadata.gz: 84c4c10854fe1876f80ef97367f22ac2ea60e2b1
-  data.tar.gz: 6ebc1e28df2124ceb2f845532601e48f962b908e
+  metadata.gz: bfa5b9792e629049a4ebf6a379b1e834f6f76eb7
+  data.tar.gz: 0ea35cdbccc1fa1480370cccfa8e11351f6973d5
 SHA512:
-  metadata.gz: 4779c64b3e923500c2e0aaab1e655763b9b055e5c85b44d00d304fc5e39f851ac075b8530453b55e3565c3ee540e584c518744de7e516b0dbceaa3109b2a30ae
-  data.tar.gz: 567e5a818742da6e0b76e5eb647cde9b8b98ed184b557e0b1c6718f289559097b145f34647c4a5cac12521f42027c97184aa973af2bb18a0b3742423d73444c3
+  metadata.gz: a5baf7554a0757a4666e22464ef0d6f515153a8ea7c6b1058edb92090f4f683808996b259539b5e2553ced8e74c1c6a78ef4bf947442ee131bb5be31c43d34f0
+  data.tar.gz: 171cf6606fa1a4d91b9652f4d166bfa198ed6acd049631f0f50137362cbcf10a7c5d15b6191434a9bb9bc52b7eab9a00cafe07fb2edeb656bfba2f06eb71eb92

data/CHANGELOG.md

@@ -2,6 +2,14 @@
 
 ***
 
+Change log v.0.2.4
+
+**fixed**: Fixed the default page sizes which weren't as described in the documentation and now default to US Letter. The documentation was also fixed. No major version bump is declered since the defaults were faulty and weren't as described (fixed a bug, not changed the API).
+
+**feature**: added the `resize` page method, to allow resizing of pages with or without conserving the content's aspect ratio (defaults to conserving the aspect ratio).
+
+***
+
 Change log v.0.2.3
 
 **update**: a better general error message for CombinePDF.new

data/lib/combine_pdf.rb

@@ -92,6 +92,23 @@ load "combine_pdf/version.rb"
 #
 # font support for the writer is still in the works and is limited to extracting know fonts by location of the 14 standard fonts.
 #
+# == Resizing pages
+#
+# Using the {http://www.prepressure.com/library/paper-size PDF standards for page sizes}, it is now possible to resize
+# existing PDF pages, as well as stretch and shrink their content to the new size.
+#
+#   pdf = CombinePDF.load "file.pdf"
+#   a4_size = [0, 0, 595, 842]
+#   # keep aspect ratio intact
+#   pdf.pages.each {|p| p.resize a4_size}
+#   pdf.save "a4.pdf"
+#
+#   pdf = CombinePDF.load "file.pdf"
+#   a4_squared = [0, 0, 595, 595]
+#   # stretch or shrink content to fit new size
+#   pdf.pages.each {|p| p.resize a4_squared, false}
+#   pdf.save "square.pdf"
+#
 # == Decryption & Filters
 #
 # Some PDF files are encrypted and some are compressed (the use of filters)... not all files can be opened, merged, stamped or used and stamps.

data/lib/combine_pdf/api.rb

@@ -47,10 +47,10 @@ module CombinePDF
 	# PDFWriter objects are used internally for numbering pages (by creating a PDF page
 	# with the page number and "stamping" it over the existing page).
 	#
-	# ::mediabox an Array representing the size of the PDF document. defaults to: [0.0, 0.0, 612.0, 792.0]
+	# ::mediabox an Array representing the size of the PDF document. defaults to: [0.0, 0.0, 612.0, 792.0] (US Letter)
 	#
 	# if the page is PDFWriter object as a stamp, the final size will be that of the original page.
-	def create_page(mediabox = [0, 0, 595.3, 841.9])
+	def create_page(mediabox = [0, 0, 612.0, 792.0])
 		PDFWriter.new mediabox
 	end
 

data/lib/combine_pdf/basic_writer.rb

@@ -37,8 +37,8 @@ module CombinePDF
 
 		# create a new PDFWriter object.
 		#
-		# mediabox:: the PDF page size in PDF points. defaults to [0, 0, 595.3, 841.9] (A4)
-		def initialize(mediabox = [0, 0, 595.3, 841.9])
+		# mediabox:: the PDF page size in PDF points. defaults to [0, 0, 612.0, 792.0] (US Letter)
+		def initialize(mediabox = [0, 0, 612.0, 792.0])
 			# indirect_reference_id, :indirect_generation_number
 			@contents = ""
 			@base_font_name = "Writer" + SecureRandom.hex(7) + "PDF"

data/lib/combine_pdf/page_methods.rb

@@ -406,6 +406,36 @@ module CombinePDF
 			self
 		end
 
+		# resizes the page relative to it's current viewport (either the cropbox or the mediabox), setting the new viewport to the requested size.
+		#
+		# accepts:
+		# new_size:: an Array with four elements: [X0, Y0, X_max, Y_max]. For example, A4: `[0, 0, 595, 842]`. It is important that the first two numbers are 0 unless a special effect is attempted. If the first two numbers change, the final result might not be the size requested, but the nearest possible transformation (calling the method again will allow a better resizing).
+		# conserve_aspect_ratio:: whether to keep the current content in the same aspect ratio or to allow streaching. Defaults to true - so that although the content is resized, it might not fill the new size completely.
+		def resize new_size = nil, conserve_aspect_ratio = true
+			return page_size unless new_size
+			c_mediabox = mediabox
+			c_cropbox = cropbox
+			c_size = c_cropbox || c_mediabox
+			x_ratio = 1.0 * (new_size[2]-new_size[0]) / (c_size[2])#-c_size[0])
+			y_ratio = 1.0 * (new_size[3]-new_size[1]) / (c_size[3])#-c_size[1])
+			x_move = new_size[0] - c_size[0]
+			y_move = new_size[1] - c_size[1]
+			puts "ctm will be: #{x_ratio.round(4).to_s} 0 0 #{y_ratio.round(4).to_s} #{x_move} #{y_move}"
+			self[:MediaBox] = [(c_mediabox[0] + x_move), (c_mediabox[1] + y_move), ((c_mediabox[2] * x_ratio) + x_move ), ((c_mediabox[3] * y_ratio) + y_move)]
+			self[:CropBox] = [(c_cropbox[0] + x_move), (c_cropbox[1] + y_move), ((c_cropbox[2] * x_ratio) + x_move), ((c_cropbox[3] * y_ratio) + y_move)] if c_cropbox
+			x_ratio = y_ratio = [x_ratio, y_ratio].min if conserve_aspect_ratio
+			# insert the rotation stream into the current content stream
+			# insert_content "q\n#{x_ratio.round(4).to_s} 0 0 #{y_ratio.round(4).to_s} 0 0 cm\n1 0 0 1 #{x_move} #{y_move} cm\n", 0
+			insert_content "q\n#{x_ratio.round(4).to_s} 0 0 #{y_ratio.round(4).to_s} #{x_move} #{y_move} cm\n", 0
+			# close the rotation stream
+			insert_content CONTENT_CONTAINER_END
+			# disconnect the content stream, so that future inserts aren't rotated
+			@contents = false #init_contents
+
+			# always return self, for chaining.
+			self
+		end
+
 		# rotate the page 90 degrees counter clockwise
 		def rotate_left
 			self[:Rotate] = self[:Rotate].to_f + 90
@@ -432,7 +462,7 @@ module CombinePDF
 		#
 		# * Notice: a square page always returns the :portrait value and is ignored when trying to set the orientation.
 		def orientation force = nil, clockwise = true
-			a = self[:CropBox] || self[:MediaBox]
+			a = page_size
 			unless force
 				return (a[2] - a[0] > a[3] - a[1]) ? :landscape : :portrait
 			end

data/lib/combine_pdf/pdf_public.rb

@@ -114,7 +114,9 @@ module CombinePDF
 		# adds a new page to the end of the PDF object.
 		#
 		# returns the new page object.
-		def new_page(mediabox = [0, 0, 595.3, 841.9], location = -1)
+		#
+		# unless the media box is specified, it defaults to US Letter: [0, 0, 612.0, 792.0]
+		def new_page(mediabox = [0, 0, 612.0, 792.0], location = -1)
 			p = PDFWriter.new(mediabox)
 			insert(-1, p )
 			p

data/lib/combine_pdf/version.rb

@@ -1,4 +1,4 @@
 module CombinePDF
-  VERSION = "0.2.3"
+  VERSION = "0.2.4"
 end
 

data/test/console

@@ -0,0 +1,16 @@
+#!/usr/bin/env ruby
+
+require 'benchmark'
+$LOAD_PATH.unshift File.expand_path(File.join('..', '..', 'lib'), __FILE__ )
+require "combine_pdf"
+require "bundler/setup"
+
+# You can add fixtures and/or initialization code here to make experimenting
+# with your gem easier. You can also use a different console, if you like.
+
+# (If you use this, don't forget to add pry to your Gemfile!)
+# require "pry"
+# Pry.start
+
+require "irb"
+IRB.start

metadata

@@ -1,14 +1,14 @@
 --- !ruby/object:Gem::Specification
 name: combine_pdf
 version: !ruby/object:Gem::Version
-  version: 0.2.3
+  version: 0.2.4
 platform: ruby
 authors:
 - Boaz Segev
 autorequire: 
 bindir: bin
 cert_chain: []
-date: 2015-08-07 00:00:00.000000000 Z
+date: 2015-08-09 00:00:00.000000000 Z
 dependencies:
 - !ruby/object:Gem::Dependency
   name: ruby-rc4
@@ -81,6 +81,7 @@ files:
 - lib/combine_pdf/pdf_public.rb
 - lib/combine_pdf/renderer.rb
 - lib/combine_pdf/version.rb
+- test/console
 homepage: https://github.com/boazsegev/combine_pdf
 licenses:
 - MIT
@@ -105,4 +106,5 @@ rubygems_version: 2.4.7
 signing_key: 
 specification_version: 4
 summary: Combine, stamp and watermark PDF files in pure Ruby.
-test_files: []
+test_files:
+- test/console