rustpdf 0.1.0-x86_64-linux → 0.4.0-x86_64-linux

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA256:
-  metadata.gz: 338ced9bc04f0b7ec32aaf50f6f3a6dae01b06330a635624af41c28ccaa255b2
-  data.tar.gz: a3d214e870c8e3c7a064235ad273c8637cd801a423ed32500589eab7e13407a0
+  metadata.gz: 927dc1a17caf2b405b6f76aae4fcbb8e2fcb60eed178eba44aa314ff491c4d25
+  data.tar.gz: 57a660201a0e93cd3e0f2be2367819464a62f22c4cc5056f4e470b5edbbcaec4
 SHA512:
-  metadata.gz: 6e9c32134dff46cf7c803414833a6a17e79538a4de354c71c6185179a0310f951292546180b652b0f3d95fdf949e6bd43ff30974e2f21a93836b0e42709d8c5b
-  data.tar.gz: 8b0fc3c9289e2285535a6a58812e4dd99b2317b235bd4f309dc23399bb96ec9d466d8482efb02205d8eba5caf5bbbc5230eeddfbc60cac97f76672097480c9f1
+  metadata.gz: ec46a8638b228b00a6c2728b636824b924896554b8e8b3f0734b1a4d3108db2ac87680949a89852aab9bc596728e59e81e4ed665ca57d15140188e746fe000ba
+  data.tar.gz: 3c911b62b6e32ffcfba2e1d9a072a005d545d3f5d367902e42c8bfd2060969bfd3b96c291aa10fb28946f810b18de6dd3104b835e73538f1774ef8f2c1283e7e

data/README.md

@@ -6,7 +6,7 @@ covers the whole product surface: vector graphics, embedded/subsetted fonts and
 text, wrapping paragraphs, images, **PDF/A** (levels 1b–3a),
 **tagged/accessible** output, embedded-file attachments, **AcroForm** fields,
 manipulation (merge/split/rotate/optimize/incremental update), **text
-extraction**, **encryption** (RC4 / AES-128 / AES-256) and **digital signatures**
+extraction**, **page rendering** (page to PNG image), **encryption** (RC4 / AES-128 / AES-256) and **digital signatures**
 (PKCS#7 / PAdES) — plus **feature licensing**.
 
 Files (module `RustPdf`):
@@ -46,7 +46,7 @@ ed.encrypt(method: RustPdf::Cipher::AES256, owner: "owner").save("secured.pdf")
 signed = RustPdf.sign(data, key_der, cert_der, pades: true)
 ```
 
-Corporate features (PDF/A, signing, encryption, accessibility) require a license;
+Corporate features (PDF/A, signing, encryption, accessibility, page rendering — a **Pro** feature) require a license;
 without one they raise `RustPdf::Error`. See [`docs/LICENSING.md`](../../docs/LICENSING.md).
 
 ## Test

data/lib/rustpdf/document.rb

@@ -160,6 +160,44 @@ module RustPdf
       self
     end
 
+    # ---- hyperlinks + bookmarks (Tier 1) ------------------------------------
+
+    # rect = [x0, y0, x1, y1]; link to an external URI.
+    def link_uri(rect, uri)
+      RustPdf.check(Native.call("pdf_page_link_uri", ptr, rect[0], rect[1], rect[2], rect[3], uri))
+      self
+    end
+
+    # rect = [x0, y0, x1, y1]; link to another page (optional +top+ y-offset).
+    def link_to_page(rect, page_index, top: nil)
+      RustPdf.check(Native.call("pdf_page_link_to_page", ptr, rect[0], rect[1], rect[2], rect[3],
+                                page_index, top || 0.0, top.nil? ? 0 : 1))
+      self
+    end
+
+    # Append one outline tree (a RustPdf::Bookmark). Pre-order flattened into
+    # parallel arrays and emitted in a single native call.
+    def add_bookmark(bookmark)
+      entries = bookmark.flatten_into(0, [])
+      n = entries.size
+      levels = entries.map { |e| e[0] }.pack("i!*")
+      pages  = entries.map { |e| e[2] }.pack("J*")
+      tops   = entries.map { |e| e[3] || 0.0 }.pack("d*")
+      has    = entries.map { |e| e[3].nil? ? 0 : 1 }.pack("i!*")
+      cstrs  = entries.map { |e| Fiddle::Pointer[e[1].to_s] }
+      titles = cstrs.map(&:to_i).pack("J*")
+      RustPdf.check(Native.call("pdf_document_add_bookmarks", ptr, n, levels, titles, pages, tops, has))
+      cstrs.clear # released after the call returned
+      self
+    end
+
+    # ---- ZUGFeRD / Factur-X (Tier 2) ----------------------------------------
+
+    def facturx(xml, profile: FacturxProfile::EN16931)
+      RustPdf.check(Native.call("pdf_document_facturx", ptr, xml, xml.bytesize, profile))
+      self
+    end
+
     # ---- output -------------------------------------------------------------
 
     def page_count

data/lib/rustpdf/editable_doc.rb

@@ -93,6 +93,69 @@ module RustPdf
       found != 0
     end
 
+    # ---- form fill + flatten + watermark (Tier 1) ---------------------------
+
+    # Set a checkbox by field name. Returns whether the field existed.
+    def set_checkbox(name, checked = true)
+      found = RustPdf.out_int { |buf| Native.call("pdf_editable_set_checkbox", ptr, name, checked ? 1 : 0, buf) }
+      found != 0
+    end
+
+    # Select a radio button by field name + export value. Returns whether found.
+    def set_radio(name, export_value)
+      found = RustPdf.out_int { |buf| Native.call("pdf_editable_set_radio", ptr, name, export_value, buf) }
+      found != 0
+    end
+
+    # Set a choice (dropdown/list) value by field name. Returns whether found.
+    def set_choice(name, value)
+      found = RustPdf.out_int { |buf| Native.call("pdf_editable_set_choice", ptr, name, value, buf) }
+      found != 0
+    end
+
+    # Flatten all AcroForm fields into page content (removes interactivity).
+    def flatten_forms
+      RustPdf.check(Native.call("pdf_editable_flatten_forms", ptr))
+      self
+    end
+
+    # Returns the list of AcroForm field names.
+    def field_names
+      p = ptr
+      text = RustPdf.take_bytes { |pp, pn| Native.call("pdf_editable_field_names", p, pp, pn) }
+                    .force_encoding(Encoding::UTF_8)
+      text.split("\n").reject(&:empty?)
+    end
+
+    # Stamp a diagonal text watermark across every page.
+    def watermark_text(text, size: 64.0, color: [0.5, 0.5, 0.5], opacity: 0.30, rotation_deg: 45.0)
+      r, g, b = color
+      RustPdf.check(Native.call("pdf_editable_watermark_text", ptr, text, size, r, g, b, opacity, rotation_deg))
+      self
+    end
+
+    # Stamp an image watermark (from a file) across every page.
+    def watermark_image_file(path, width, height, opacity: 0.30)
+      RustPdf.check(Native.call("pdf_editable_watermark_image_file", ptr, path, width, height, opacity))
+      self
+    end
+
+    # ---- redaction + PDF/A conversion (Tier 2) ------------------------------
+
+    # Black out rectangles on a page. rects = [[x0,y0,x1,y1], ...].
+    # Returns whether the page existed.
+    def redact(page_index, rects)
+      flat = rects.flatten.pack("d*")
+      found = RustPdf.out_int { |buf| Native.call("pdf_editable_redact", ptr, page_index, flat, rects.size, buf) }
+      found != 0
+    end
+
+    # Convert the document to PDF/A (B-levels only: A1B=0, A2B=1, A3B=3).
+    def convert_to_pdfa(level = Pdfa::A2B)
+      RustPdf.check(Native.call("pdf_editable_convert_to_pdfa", ptr, level))
+      self
+    end
+
     def optimize
       RustPdf.check(Native.call("pdf_editable_optimize", ptr))
       self

data/lib/rustpdf/native.rb

@@ -78,9 +78,32 @@ module RustPdf
       "pdf_editable_save"            => [[VP, VP], I],
 
       "pdf_extract_text"             => [[VP, 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],
       "pdf_sign"                     => [[VP, SZ, VP, SZ, VP, SZ, VP, VP, VP, I, VP, VP], I],
       "pdf_timestamp"                => [[VP, SZ, VP, SZ, VP, SZ, VP, VP, VP], I],
       "pdf_add_dss"                  => [[VP, SZ, VP, VP, SZ, VP, VP, SZ, VP, VP], I],
+
+      # Tier 1: hyperlinks + bookmarks (Document)
+      "pdf_page_link_uri"            => [[VP, D, D, D, D, VP], I],
+      "pdf_page_link_to_page"        => [[VP, D, D, D, D, SZ, D, I], I],
+      "pdf_document_add_bookmarks"   => [[VP, SZ, VP, VP, VP, VP, VP], I],
+      # Tier 2: ZUGFeRD / Factur-X (Document)
+      "pdf_document_facturx"         => [[VP, VP, SZ, I], I],
+      # Tier 1: form fill + flatten + watermark (EditableDoc)
+      "pdf_editable_set_checkbox"    => [[VP, VP, I, VP], I],
+      "pdf_editable_set_radio"       => [[VP, VP, VP, VP], I],
+      "pdf_editable_set_choice"      => [[VP, VP, VP, VP], I],
+      "pdf_editable_flatten_forms"   => [[VP], I],
+      "pdf_editable_field_names"     => [[VP, VP, VP], I],
+      "pdf_editable_watermark_text"  => [[VP, VP, D, D, D, D, D, D], I],
+      "pdf_editable_watermark_image_file" => [[VP, VP, D, D, D], I],
+      # Tier 2: redaction + PDF/A conversion (EditableDoc)
+      "pdf_editable_redact"          => [[VP, SZ, VP, SZ, VP], I],
+      "pdf_editable_convert_to_pdfa" => [[VP, I], I],
+      # Tier 2: signature validation (module-level)
+      "pdf_verify_signatures_json"   => [[VP, SZ, VP, VP], I],
     }.freeze
 
     def lib

data/lib/rustpdf.rb

@@ -1,4 +1,5 @@
 require "fiddle"
+require "json"
 require_relative "rustpdf/native"
 
 # Idiomatic Ruby binding for the rust-pdf core over its C ABI (libpdf_ffi),
@@ -24,6 +25,10 @@ module RustPdf
     A2A = 2
     A3B = 3
     A3A = 4
+    # PDF/A-4 (ISO 19005-4), based on PDF 2.0.
+    A4 = 5
+    A4E = 6
+    A4F = 7
   end
 
   # Paragraph alignment.
@@ -50,6 +55,42 @@ module RustPdf
     AES256 = 2
   end
 
+  # ZUGFeRD / Factur-X conformance profiles.
+  module FacturxProfile
+    MINIMUM = 0
+    BASIC_WL = 1
+    BASIC = 2
+    EN16931 = 3
+    EXTENDED = 4
+  end
+
+  # A document outline (bookmark) entry. Nest with #child to build a tree.
+  # Each #add_bookmark call on a Document appends one root tree (pre-order
+  # flattened into parallel arrays).
+  class Bookmark
+    attr_accessor :title, :page, :top, :children
+
+    def initialize(title, page, top: nil, children: nil)
+      @title = title
+      @page = page
+      @top = top
+      @children = children || []
+    end
+
+    # Append a child bookmark; returns self for chaining.
+    def child(bookmark)
+      @children << bookmark
+      self
+    end
+
+    # Pre-order flatten into +out+ as [level, title, page, top] tuples.
+    def flatten_into(level, out)
+      out << [level, title, page, top]
+      children.each { |c| c.flatten_into(level + 1, out) }
+      out
+    end
+  end
+
   module_function
 
   # Native library version string.
@@ -70,6 +111,38 @@ module RustPdf
       .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)
+    count = Fiddle::Pointer.malloc(Native::SIZEOF_SZ, Fiddle::RUBY_FREE)
+    check(Native.call("pdf_extract_images_to_dir", pdf, pdf.bytesize, dir, count))
+    count[0, Native::SIZEOF_SZ].unpack1("J")
+  end
+
+  # Render page +page+ (0-based) of +pdf+ to a PNG image at +dpi+
+  # dots-per-inch. Page rendering is a licensed Pro feature: raises unless a
+  # license granting it is active.
+  def render_page_to_png(pdf, page = 0, dpi = 150.0)
+    take_bytes { |pp, pn| Native.call("pdf_render_page_to_png", pdf, pdf.bytesize, page, dpi.to_f, pp, pn) }
+  end
+
+  # Number of pages in +pdf+ (free — no license required).
+  def page_count(pdf)
+    count = Fiddle::Pointer.malloc(Native::SIZEOF_SZ, Fiddle::RUBY_FREE)
+    check(Native.call("pdf_page_count", pdf, pdf.bytesize, count))
+    count[0, Native::SIZEOF_SZ].unpack1("J")
+  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". An empty
+  # array means the document is unsigned.
+  def verify_signatures(pdf)
+    js = take_bytes { |pp, pn| Native.call("pdf_verify_signatures_json", pdf, pdf.bytesize, pp, pn) }
+         .force_encoding(Encoding::UTF_8)
+    js.empty? ? [] : JSON.parse(js)
+  end
+
   # Sign a PDF (PKCS#7 detached, incremental update). Requires a license.
   def sign(pdf, key_der, cert_der, reason: nil, location: nil, name: nil, pades: false)
     take_bytes do |pp, pn|

metadata

@@ -1,14 +1,14 @@
 --- !ruby/object:Gem::Specification
 name: rustpdf
 version: !ruby/object:Gem::Version
-  version: 0.1.0
+  version: 0.4.0
 platform: x86_64-linux
 authors:
 - rust-pdf
 autorequire:
 bindir: bin
 cert_chain: []
-date: 2026-06-27 00:00:00.000000000 Z
+date: 2026-06-29 00:00:00.000000000 Z
 dependencies: []
 description: Idiomatic Ruby binding over the rust-pdf C ABI (libpdf_ffi) using the
   built-in Fiddle stdlib.