rustpdf 0.4.5-aarch64-linux → 0.4.6-aarch64-linux

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA256:
-  metadata.gz: 5202d7b96416bc904812cc339778930fad646ec6807d93bc4210f0a5dcc17855
-  data.tar.gz: 017e805349b7ef2736ad1a99baf778f10e5343a514dedbacf696216d78dc995c
+  metadata.gz: 70178a69ffe81e07690514a1c1fe8116707b848b381fbf1ae17952571c9c31ef
+  data.tar.gz: 753e07ad832d29f6d638397f10cb0888495fc2a4c56f39b2216d260edf2267b8
 SHA512:
-  metadata.gz: 1eac4e56695810aa5f403287169bd240d5a435cd95bc75e7e2b3ec1904fd0e682f15abfb861c509380f00965ffda00aad68f179223b1bce7b1b0bdc05b9ad6c4
-  data.tar.gz: 87dccbd05237d9aa2427b8ca68832dd99809b61644a142f299edbe0cbfd7beed8d88706d12a1eb4dca4ff68e838a39d73d680bf1e493ffb6541d57c53dbc6845
+  metadata.gz: 10f7a53e4b0d0f3d76e51ef0aac75654b4a9efda0b355aa84415d2a81a0510079f686d116d9b7ec69ccf9637e4fe8a10349001a85a0a0aa38c238e64341eb5d0
+  data.tar.gz: 48d2852ad7d33e705c4e8dac80fb807109704799d270c93367838bc160465792535b8c2d94380e19e5f30dfb307f9624b7f52772db628bab62b56dfde62c5cb3

data/lib/rustpdf/editable_doc.rb

@@ -167,14 +167,51 @@ module RustPdf
     # +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)
+    # rotated page). +align+ (RustPdf::Align, default LEFT) shifts the start
+    # point along the baseline direction by the text width for RIGHT/CENTER
+    # alignment. 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,
+                   align: Align::LEFT)
       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)
+        Native.call("pdf_editable_place_text_aligned", 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, align, buf)
+      end
+      found != 0
+    end
+
+    # Mask a placeholder: fill an opaque background box +[x, y, x+width,
+    # y+height]+ in +bg_color+ (each 0..1, default white), then write +text+
+    # over it using standard Helvetica at +size+ points in +text_color+ (each
+    # 0..1, default black), horizontally aligned per +align+ (RustPdf::Align,
+    # default LEFT) and vertically centered within the box. Saves hand-computing
+    # the baseline when stamping a real value over a placeholder. Coordinates are
+    # in the page's VISIBLE space (origin lower-left, y up). Returns whether the
+    # page existed.
+    def masked_text(page_index, x, y, width, height, text, size = 12.0,
+                    text_color = [0.0, 0.0, 0.0], bg_color = [1.0, 1.0, 1.0],
+                    align: Align::LEFT)
+      tr, tg, tb = text_color
+      br, bg, bb = bg_color
+      found = RustPdf.out_int do |buf|
+        Native.call("pdf_editable_masked_text", ptr, page_index, x.to_f, y.to_f,
+                    width.to_f, height.to_f, text, size.to_f,
+                    tr.to_f, tg.to_f, tb.to_f, br.to_f, bg.to_f, bb.to_f, align, buf)
+      end
+      found != 0
+    end
+
+    # Stamp an +image+ (PNG or JPEG bytes; the core dispatches on the signature)
+    # onto page +page_index+ (0-based), with its lower-left corner at (+x+, +y+),
+    # scaled to +width+ x +height+ points and rotated +rotation_deg+ degrees
+    # counter-clockwise about that corner. 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 draw_image(page_index, image, x, y, width, height, rotation_deg = 0.0)
+      found = RustPdf.out_int do |buf|
+        Native.call("pdf_editable_draw_image", ptr, page_index, image, image.bytesize,
+                    x.to_f, y.to_f, width.to_f, height.to_f, rotation_deg.to_f, buf)
       end
       found != 0
     end

data/lib/rustpdf/native.rb

@@ -78,6 +78,7 @@ module RustPdf
       "pdf_editable_save"            => [[VP, VP], I],
 
       "pdf_extract_text"             => [[VP, SZ, VP, VP], I],
+      "pdf_extract_page_text"        => [[VP, SZ, SZ, VP, VP], I],
       "pdf_extract_images_to_dir"    => [[VP, SZ, VP, VP], I],
       "pdf_render_page_to_png"       => [[VP, SZ, SZ, D, VP, VP], I],
       "pdf_page_count"               => [[VP, SZ, VP], I],
@@ -129,6 +130,11 @@ module RustPdf
       "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],
+      "pdf_editable_place_text_aligned" => [[VP, I, D, D, VP, D, D, D, D, D, I, VP], I],
+      "pdf_editable_masked_text"     => [[VP, I, D, D, D, D, VP, D, D, D, D, D, D, D, I, VP], I],
+      # Issue #50: stamp a PNG/JPEG image onto an existing page. The image bytes
+      # cross as the (uint8_t* data, uintptr_t len) pair, like pdf_editable_load.
+      "pdf_editable_draw_image"      => [[VP, I, VP, SZ, D, D, D, D, D, VP], I],
     }.freeze
 
     def lib

data/lib/rustpdf.rb

@@ -228,6 +228,13 @@ module RustPdf
       .force_encoding(Encoding::UTF_8)
   end
 
+  # Extract the text of a single 0-based +page_index+ (Unicode via ToUnicode),
+  # without building an intermediate one-page document.
+  def extract_page_text(pdf, page_index)
+    take_bytes { |pp, pn| Native.call("pdf_extract_page_text", pdf, pdf.bytesize, page_index, pp, pn) }
+      .force_encoding(Encoding::UTF_8)
+  end
+
   # Extract every raster image into +dir+ (JPEG verbatim as .jpg, others as
   # .png; files named page{N}_{name}.{ext}). Returns the number written.
   def extract_images_to_dir(pdf, dir)

metadata

@@ -1,7 +1,7 @@
 --- !ruby/object:Gem::Specification
 name: rustpdf
 version: !ruby/object:Gem::Version
-  version: 0.4.5
+  version: 0.4.6
 platform: aarch64-linux
 authors:
 - rust-pdf