pdf_oxide 0.3.68 → 0.3.70

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA256:
-  metadata.gz: 2e8e54b9721132f15787ec211abc2c2079011d9fefa27a2b08d0dc3c6ba00e39
-  data.tar.gz: 6d61bbbf08983b926a862af95a8c8c6af8b041bbc2ffc093921d9fd54ba764ab
+  metadata.gz: 69ee3975fd3514216f0145f91a2b53321b2837656900242f9292fdb4d31a3887
+  data.tar.gz: 2298ad2c2f64afd4eadedd408d1140e19436a3a5c5ee363295cc5053e789a61e
 SHA512:
-  metadata.gz: 791ef9e50cb212a3c463bd3c66ffa5c064b794cfdad0413728397026138c2b2c42e6684c683e296393bcd8ec4e35e07c0f45db71f50e6153cf09014143749832
-  data.tar.gz: e09e5bf746a771802ba142c7864859f6b3de2ee815c3a4718ee0f39cf15d28e6a55a6453ae9a12eb78f746c9afb13feefa96e42ddc9cc587ab7b5395989db89c
+  metadata.gz: c845247d4fba11a9af23f7b17595de5f410d9750dfeec28020617f2a00633e0664969c3aab8d6505dcc1c01f009f0fbedbfe443b135975fcd88ac8506b02f740
+  data.tar.gz: 491b40c860d487d04af14a2a1aa5196d3d74114838239d2b7676a988dd7766f11c19a0932e0d2bb6c70e979cfa989aabc60ea16e15fc560835a94c2c37e68e1a

data/lib/pdf_oxide/ffi/bindings.rb

@@ -1465,6 +1465,9 @@ module PdfOxide
       attach_function :pdf_oxide_word_get_bbox, %i[pointer pointer pointer pointer pointer pointer pointer pointer], :pointer, blocking: false
       attach_function :pdf_oxide_word_get_font_name, %i[pointer pointer pointer pointer pointer pointer pointer pointer], :pointer, blocking: false
       attach_function :pdf_oxide_word_get_font_size, %i[pointer pointer pointer pointer pointer pointer pointer pointer], :pointer, blocking: false
+      # int64_t pdf_oxide_word_get_sequence(const void *words, int32_t index, int *error_code)
+      # Content-stream emission order of the word's originating span; -1 on null/out-of-range.
+      attach_function :pdf_oxide_word_get_sequence, %i[pointer int32 pointer], :int64, blocking: false
       attach_function :pdf_oxide_word_get_text, %i[pointer pointer pointer pointer pointer pointer pointer pointer], :pointer, blocking: false
       attach_function :pdf_oxide_word_is_bold, %i[pointer pointer pointer pointer pointer pointer pointer pointer], :pointer, blocking: false
       attach_function :pdf_oxide_word_list_free, %i[pointer pointer pointer pointer pointer pointer pointer pointer], :pointer, blocking: false
@@ -1693,6 +1696,39 @@ module PdfOxide
                       %i[pointer size_t pointer], :int32
       attach_function :document_editor_apply_all_redactions,
                       %i[pointer pointer], :int32
+
+      # ============================================================
+      # PHASE 4 EXTEND: global tuning toggles + layer-filtered render.
+      # Real ABI signatures from include/pdf_oxide_c/pdf_oxide.h.
+      # ============================================================
+
+      # int64_t pdf_oxide_set_max_ops_per_stream(int64_t limit)
+      # Process-global content-stream operator cap. `limit < 0` restores
+      # the default (1,000,000); returns the previous cap (or -1 if the
+      # default was active). No error channel.
+      attach_function :pdf_oxide_set_max_ops_per_stream, [:int64], :int64
+
+      # int32_t pdf_oxide_set_preserve_unmapped_glyphs(int32_t preserve)
+      # Toggle the global U+FFFD preservation flag. `1` = preserve,
+      # `0` = filter. Returns the previous value (`0` or `1`). No error
+      # channel.
+      attach_function :pdf_oxide_set_preserve_unmapped_glyphs, [:int32], :int32
+
+      # FfiRenderedImage *pdf_render_page_with_options_ex(
+      #   PdfDocument *doc, int32_t page_index, int32_t dpi, int32_t format,
+      #   float bg_r, float bg_g, float bg_b, float bg_a,
+      #   int32_t transparent_background, int32_t render_annotations,
+      #   int32_t jpeg_quality,
+      #   const char *const *excluded_layers, uintptr_t excluded_layers_count,
+      #   int32_t *error_code)
+      # Like pdf_render_page_with_options but with OCG layer filtering.
+      attach_function :pdf_render_page_with_options_ex,
+                      %i[pointer int32 int32 int32
+                         float float float float
+                         int32 int32 int32
+                         pointer size_t
+                         pointer],
+                      :pointer
     end
   end
 end

data/lib/pdf_oxide/pdf_document.rb

@@ -258,7 +258,50 @@ module PdfOxide
       # path is the byte-buffer accessor introduced for v0.3.5x.
       bytes = read_rendered_image_bytes(img_ptr)
       Bindings.pdf_rendered_image_free(img_ptr) if Bindings.respond_to?(:pdf_rendered_image_free)
-      bytes.force_encoding(Encoding::BINARY)
+      bytes.b # binary-encoded copy (never mutates; read_* may return a frozen empty string)
+    end
+
+    # Render a single page with the full RenderOptions surface plus
+    # Optional-Content-Group (OCG) layer filtering.
+    #
+    # @param page_index [Integer]
+    # @param dpi [Integer] resolution (default 150).
+    # @param format [Integer] 0 = PNG, 1 = JPEG.
+    # @param background [Array(Float,Float,Float,Float)] RGBA, each 0.0..1.0.
+    # @param transparent [Boolean] drop the background fill entirely.
+    # @param render_annotations [Boolean] paint annotation appearances.
+    # @param jpeg_quality [Integer] 1..100 (only used when format == 1).
+    # @param excluded_layers [Array<String>] OCG `/Name`s to suppress.
+    # @return [String] encoded image bytes (BINARY).
+    def render_with_layers(page_index, dpi: 150, format: 0,
+                           background: [1.0, 1.0, 1.0, 1.0], transparent: false,
+                           render_annotations: true, jpeg_quality: 90,
+                           excluded_layers: [])
+      validate_page_index(page_index)
+      bg_r, bg_g, bg_b, bg_a = background
+      names = Array(excluded_layers).map(&:to_s)
+
+      # Build a NULL-terminated-string array (char *const *).
+      names_ptr = ::FFI::Pointer::NULL
+      unless names.empty?
+        str_ptrs = names.map { |n| ::FFI::MemoryPointer.from_string(n) }
+        names_ptr = ::FFI::MemoryPointer.new(:pointer, str_ptrs.length)
+        names_ptr.write_array_of_pointer(str_ptrs)
+      end
+
+      err = ::FFI::MemoryPointer.new(:int32)
+      img_ptr = Bindings.pdf_render_page_with_options_ex(
+        handle, page_index, dpi, format,
+        bg_r.to_f, bg_g.to_f, bg_b.to_f, bg_a.to_f,
+        transparent ? 1 : 0, render_annotations ? 1 : 0, jpeg_quality,
+        names_ptr, names.length, err
+      )
+      raise_for_code(err.read_int32, 'render_with_layers')
+      raise InternalError, 'render_with_layers returned null' if img_ptr.nil? || img_ptr.null?
+
+      bytes = read_rendered_image_bytes(img_ptr)
+      Bindings.pdf_rendered_image_free(img_ptr) if Bindings.respond_to?(:pdf_rendered_image_free)
+      bytes.b # binary-encoded copy (never mutates; read_* may return a frozen empty string)
     end
 
     # @return [PdfPage] a lightweight view of the page at `index`.
@@ -324,14 +367,17 @@ module PdfOxide
     def open_native(source)
       err = ::FFI::MemoryPointer.new(:int32)
       handle, path =
-        if source.is_a?(String) && File.exist?(source)
-          [Bindings.pdf_document_open(File.absolute_path(source), err), File.absolute_path(source)]
-        elsif source.is_a?(String) && source.start_with?('%PDF')
+        # NB: detect in-memory bytes (%PDF…) BEFORE the path branch — binary PDF
+        # bytes contain null bytes, and File.exist? raises ArgumentError
+        # ("path name contains null byte") on those, so the bytes check must run first.
+        if source.is_a?(String) && source.start_with?('%PDF')
           # in-memory PDF bytes
           buf = source.dup.force_encoding(Encoding::BINARY)
           mem = ::FFI::MemoryPointer.new(:uint8, buf.bytesize)
           mem.write_bytes(buf, 0, buf.bytesize)
           [Bindings.pdf_document_open_from_bytes(mem, buf.bytesize, err), '<in-memory>']
+        elsif source.is_a?(String) && File.exist?(source)
+          [Bindings.pdf_document_open(File.absolute_path(source), err), File.absolute_path(source)]
         else
           raise FileNotFoundError, "file not found: #{source}"
         end

data/lib/pdf_oxide/version.rb

@@ -1,5 +1,5 @@
 # frozen_string_literal: true
 
 module PdfOxide
-  VERSION = '0.3.68'
+  VERSION = '0.3.70'
 end

data/lib/pdf_oxide.rb

@@ -56,5 +56,29 @@ module PdfOxide
     def version
       VERSION
     end
+
+    # Set the process-global content-stream operator cap.
+    #
+    # A negative `limit` restores the default (1,000,000); any
+    # non-negative value (including 0) becomes the explicit cap.
+    #
+    # @param limit [Integer]
+    # @return [Integer] the previous cap (or -1 if the default was active).
+    def set_max_ops_per_stream(limit)
+      Bindings.pdf_oxide_set_max_ops_per_stream(Integer(limit))
+    end
+
+    # Toggle the process-global U+FFFD (unmapped-glyph) preservation flag
+    # used by the high-level text extraction accessors.
+    #
+    # @param preserve [Boolean, Integer] truthy / non-zero = preserve,
+    #   falsey / 0 = filter (the v0.3.54 default).
+    # @return [Integer] the previous value (`0` or `1`).
+    def set_preserve_unmapped_glyphs(preserve)
+      # preserve may be Boolean or Integer; avoid numeric predicates that
+      # would raise on a Boolean (e.g. true.zero?). falsey / 0 = filter.
+      flag = [false, nil, 0].include?(preserve) ? 0 : 1
+      Bindings.pdf_oxide_set_preserve_unmapped_glyphs(flag)
+    end
   end
 end

metadata

@@ -1,14 +1,14 @@
 --- !ruby/object:Gem::Specification
 name: pdf_oxide
 version: !ruby/object:Gem::Version
-  version: 0.3.68
+  version: 0.3.70
 platform: ruby
 authors:
 - PDF Oxide Contributors
 autorequire:
 bindir: bin
 cert_chain: []
-date: 2026-06-24 00:00:00.000000000 Z
+date: 2026-07-02 00:00:00.000000000 Z
 dependencies:
 - !ruby/object:Gem::Dependency
   name: ffi