rustpdf 0.4.4-universal-darwin → 0.4.5-universal-darwin

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA256:
-  metadata.gz: 26be79c246143805efc4c3a4551e4afc5a189bc808f4554285b13dd533b90b6f
-  data.tar.gz: 3bd71a7b39e767292d447821de06952d60f0b79c2222aa77f7f775390b0c09dc
+  metadata.gz: bf26136e96e0bb69576cf294f81bbe62b5b9974c4a0646fac69ed40e72ffa82d
+  data.tar.gz: f60566e9fc77e467e8b29328769a86fd3ec013d5a93a00bc7453ba8a12e7cef7
 SHA512:
-  metadata.gz: b196d1f22eff0fe24fb7ca9b4d61bf30670a1f7e847e7c5bd847790b5dc6913ad87c1adffa123f9b41c51548a3be421747da752c342a5d06beeec8f2368b8a27
-  data.tar.gz: f5a0d5b8ee82a2ab459a632058ada47f4c36a54474fe2e62fe33504cb6b5c4991b8cc0bd0cb9b9614d298006c338c88491da32a898c169c164e4b961fb90c6b7
+  metadata.gz: c7330892e700726c8f1f8d4b3e8bd4876afc20b3d24909d8e3a3bc154f5a3130a9fe456aadbae0b1f31c8a3dd33046c17945cc6cf32bb0f3f1a55d16be67dd40
+  data.tar.gz: ddaaf60885bdccea7dd06eb990d9af4b2e021b313f51a8f5e9dd035de833c1d15a8ba6981b6b8a0359dde450c8669bf977b221a3a18a45f7e6bcc8e8b8a06294

data/lib/rustpdf/editable_doc.rb

@@ -146,6 +146,39 @@ module RustPdf
       self
     end
 
+    # ---- positioned drawing primitives (issue #45 P1) -----------------------
+
+    # Paint a filled rectangle at (+x+, +y+) sized +width+ x +height+ on page
+    # +page_index+ (0-based), in RGB +color+ (each 0..1, default opaque white) at
+    # +opacity+ (0..1). Coordinates are in the page's VISIBLE space (origin
+    # lower-left, y up), regardless of the page's /Rotate. The common use is
+    # masking a placeholder with an opaque white box. Returns whether the page
+    # existed.
+    def fill_rect(page_index, x, y, width, height, color = [1.0, 1.0, 1.0], opacity = 1.0)
+      r, g, b = color
+      found = RustPdf.out_int do |buf|
+        Native.call("pdf_editable_fill_rect", ptr, page_index, x.to_f, y.to_f,
+                    width.to_f, height.to_f, r.to_f, g.to_f, b.to_f, opacity.to_f, buf)
+      end
+      found != 0
+    end
+
+    # Draw a line of positioned +text+ with baseline at (+x+, +y+) on page
+    # +page_index+ (0-based), using standard Helvetica at +size+ points in RGB
+    # +color+ (each 0..1, default black). +rotation_deg+ rotates the text
+    # counter-clockwise about its anchor (match the page rotation to follow a
+    # rotated page). Coordinates are in the page's VISIBLE space (origin
+    # lower-left, y up), regardless of the page's /Rotate. Returns whether the
+    # page existed.
+    def place_text(page_index, x, y, text, size = 12.0, color = [0.0, 0.0, 0.0], rotation_deg = 0.0)
+      r, g, b = color
+      found = RustPdf.out_int do |buf|
+        Native.call("pdf_editable_place_text", ptr, page_index, x.to_f, y.to_f, text,
+                    size.to_f, r.to_f, g.to_f, b.to_f, rotation_deg.to_f, buf)
+      end
+      found != 0
+    end
+
     # ---- redaction + PDF/A conversion (Tier 2) ------------------------------
 
     # Black out rectangles on a page. rects = [[x0,y0,x1,y1], ...].

data/lib/rustpdf/native.rb

@@ -123,6 +123,12 @@ module RustPdf
       "pdf_timestamp_begin"          => [[VP, SZ, VP, VP, VP, VP], I],
       "pdf_timestamp_request"        => [[VP, SZ, VP, SZ, I, VP, VP], I],
       "pdf_timestamp_token_from_response" => [[VP, SZ, VP, VP], I],
+
+      # Issue #45 P1: page geometry, document inspection, positioned drawing.
+      "pdf_measure_pages_json"       => [[VP, SZ, VP, VP], I],
+      "pdf_inspect_json"             => [[VP, SZ, VP, VP], I],
+      "pdf_editable_fill_rect"       => [[VP, I, D, D, D, D, D, D, D, D, VP], I],
+      "pdf_editable_place_text"      => [[VP, I, D, D, VP, D, D, D, D, D, VP], I],
     }.freeze
 
     def lib

data/lib/rustpdf.rb

@@ -157,6 +157,31 @@ module RustPdf
   # origin lower-left; +x+/+y+ is the lower-left corner of the box.
   TextHit = Struct.new(:page, :text, :x, :y, :width, :height)
 
+  # A rectangle in PDF user space (points, origin lower-left). Used for a page's
+  # MediaBox/CropBox. #width / #height are the (non-negative) extents.
+  PdfRect = Struct.new(:x0, :y0, :x1, :y1) do
+    def width
+      (x1 - x0).abs
+    end
+
+    def height
+      (y1 - y0).abs
+    end
+  end
+
+  # Read-only geometry of one page (from #measure_page / #measure_pages). Sizes
+  # are in PDF points; +width+/+height+ ignore rotation while +rotated_width+/
+  # +rotated_height+ account for it (swapped for 90/270 pages). +media_box+ and
+  # +crop_box+ are PdfRect values.
+  PageGeometry = Struct.new(:page, :width, :height, :rotation,
+                            :rotated_width, :rotated_height, :media_box, :crop_box)
+
+  # A non-mutating summary of a PDF (from #inspect_pdf). +pdfa_level+ is nil when
+  # the document is not PDF/A; +encryption+ is the cipher name ("None" when the
+  # document is not encrypted).
+  PdfOverview = Struct.new(:version, :pdfa_level, :encrypted, :encryption,
+                           :requires_password, :page_count)
+
   # An in-progress two-phase signature: #document holds the placeholder PDF and
   # #bytes the exact bytes the signature covers. Hand #hash to a remote signer,
   # build the CMS container, then call #complete.
@@ -240,6 +265,46 @@ module RustPdf
     end
   end
 
+  # Read the geometry (size, rotation, MediaBox, CropBox) of every page in +pdf+,
+  # in page order, without mutating it. Returns an Array of PageGeometry. Sizes
+  # are in PDF points; +rotated_width+/+rotated_height+ swap for 90/270 pages.
+  def measure_pages(pdf)
+    js = take_bytes { |pp, pn| Native.call("pdf_measure_pages_json", pdf, pdf.bytesize, pp, pn) }
+         .force_encoding(Encoding::UTF_8)
+    return [] if js.empty?
+
+    rect = lambda do |arr|
+      a = Array(arr)
+      a.size == 4 ? PdfRect.new(a[0], a[1], a[2], a[3]) : PdfRect.new(0, 0, 0, 0)
+    end
+    JSON.parse(js).map do |g|
+      PageGeometry.new(g["page"], g["width"], g["height"], g["rotation"],
+                       g["rotatedWidth"], g["rotatedHeight"],
+                       rect.call(g["mediaBox"]), rect.call(g["cropBox"]))
+    end
+  end
+
+  # Read the geometry of a single 0-based page of +pdf+. Raises IndexError if
+  # +index+ is out of range.
+  def measure_page(pdf, index)
+    pages = measure_pages(pdf)
+    raise IndexError, "page index #{index} out of range (#{pages.size} pages)" if index.negative? || index >= pages.size
+
+    pages[index]
+  end
+
+  # Inspect +pdf+ without mutating it: PDF version, PDF/A level (if any),
+  # encryption posture and page count. Works even on password-protected files
+  # (the encryption fields are still reported). Returns a PdfOverview. Named
+  # +inspect_pdf+ to avoid shadowing Object#inspect.
+  def inspect_pdf(pdf)
+    js = take_bytes { |pp, pn| Native.call("pdf_inspect_json", pdf, pdf.bytesize, pp, pn) }
+         .force_encoding(Encoding::UTF_8)
+    o = JSON.parse(js)
+    PdfOverview.new(o["version"], o["pdfaLevel"], o["encrypted"] ? true : false,
+                    o["encryption"], o["requiresPassword"] ? true : false, o["pageCount"])
+  end
+
   # Validate every signature in +pdf+. Returns one Hash per signature with keys
   # "field_name", "sub_filter", "signer", "covers_whole_document",
   # "digest_valid", "signature_valid", "is_valid" and "byte_range", plus the

metadata

@@ -1,7 +1,7 @@
 --- !ruby/object:Gem::Specification
 name: rustpdf
 version: !ruby/object:Gem::Version
-  version: 0.4.4
+  version: 0.4.5
 platform: universal-darwin
 authors:
 - rust-pdf