hexapdf 0.1.0

data/lib/hexapdf/encryption.rb

@@ -0,0 +1,94 @@
+# -*- encoding: utf-8 -*-
+#
+#--
+# This file is part of HexaPDF.
+#
+# HexaPDF - A Versatile PDF Creation and Manipulation Library For Ruby
+# Copyright (C) 2016 Thomas Leitner
+#
+# HexaPDF is free software: you can redistribute it and/or modify it
+# under the terms of the GNU Affero General Public License version 3 as
+# published by the Free Software Foundation with the addition of the
+# following permission added to Section 15 as permitted in Section 7(a):
+# FOR ANY PART OF THE COVERED WORK IN WHICH THE COPYRIGHT IS OWNED BY
+# THOMAS LEITNER, THOMAS LEITNER DISCLAIMS THE WARRANTY OF NON
+# INFRINGEMENT OF THIRD PARTY RIGHTS.
+#
+# HexaPDF is distributed in the hope that it will be useful, but WITHOUT
+# ANY WARRANTY; without even the implied warranty of MERCHANTABILITY or
+# FITNESS FOR A PARTICULAR PURPOSE. See the GNU Affero General Public
+# License for more details.
+#
+# You should have received a copy of the GNU Affero General Public License
+# along with HexaPDF. If not, see <http://www.gnu.org/licenses/>.
+#
+# The interactive user interfaces in modified source and object code
+# versions of HexaPDF must display Appropriate Legal Notices, as required
+# under Section 5 of the GNU Affero General Public License version 3.
+#
+# In accordance with Section 7(b) of the GNU Affero General Public
+# License, a covered work must retain the producer line in every PDF that
+# is created or manipulated using HexaPDF.
+#++
+
+module HexaPDF
+
+  # == Overview
+  #
+  # A PDF document may be encrypted so that
+  #
+  # * certain permissions are respected when the document is opened,
+  # * a password must be specified so that a document can be openend or so that
+  # * a password must be specified to remove the restrictions and allow full access.
+  #
+  # This module contains all encryption and security related code to facilitate PDF encryption.
+  #
+  #
+  # === Security Handlers
+  #
+  # Security handlers manage the process of encrypting and decrypting a PDF document. One of the
+  # main responsibilities of them is providing the encryption key that is then used by the
+  # selected encryption algorithm (see below). However, security handlers may also provide
+  # additional information.
+  #
+  # The Encryption::SecurityHandler is the base class for all such security handlers. It defines the
+  # interface and all common code for encrypting and decrypting strings and streams.
+  #
+  # The PDF specification also defines a password-based standard security handler that
+  # additionally allows setting permission information. This security handler is implemented by
+  # the Encryption::StandardSecurityHandler class.
+  #
+  #
+  # === Encryption Algorithms
+  #
+  # PDF security is based on two algorithms with varying key lengths: ARC4 and AES. The ARC4 and
+  # AES modules contain code common to their specific algorithm and are adapted to work together
+  # with any SecurityHandler.
+  #
+  # There are at least two versions of each algorithm present:
+  #
+  # FastAES and FastARC4::
+  #   The preferred versions which are based on OpenSSL and therefore rely on the OpenSSL library
+  #   and a C extension.
+  #
+  # RubyAES and RubyARC4::
+  #   Pure Ruby implementations of the algorithms which are naturally much slower than the OpenSSL
+  #   based ones. However, these implementation can be used on any Ruby implementation.
+  #
+  #
+  # See: PDF1.7 s7.6
+  module Encryption
+
+    autoload(:ARC4, 'hexapdf/encryption/arc4')
+    autoload(:AES, 'hexapdf/encryption/aes')
+    autoload(:FastARC4, "hexapdf/encryption/fast_arc4")
+    autoload(:RubyARC4, "hexapdf/encryption/ruby_arc4")
+    autoload(:FastAES, "hexapdf/encryption/fast_aes")
+    autoload(:RubyAES, "hexapdf/encryption/ruby_aes")
+    autoload(:Identity, "hexapdf/encryption/identity")
+
+    autoload(:SecurityHandler, 'hexapdf/encryption/security_handler')
+    autoload(:StandardSecurityHandler, 'hexapdf/encryption/standard_security_handler')
+
+  end
+end

data/lib/hexapdf/error.rb

@@ -0,0 +1,73 @@
+# -*- encoding: utf-8 -*-
+#
+#--
+# This file is part of HexaPDF.
+#
+# HexaPDF - A Versatile PDF Creation and Manipulation Library For Ruby
+# Copyright (C) 2016 Thomas Leitner
+#
+# HexaPDF is free software: you can redistribute it and/or modify it
+# under the terms of the GNU Affero General Public License version 3 as
+# published by the Free Software Foundation with the addition of the
+# following permission added to Section 15 as permitted in Section 7(a):
+# FOR ANY PART OF THE COVERED WORK IN WHICH THE COPYRIGHT IS OWNED BY
+# THOMAS LEITNER, THOMAS LEITNER DISCLAIMS THE WARRANTY OF NON
+# INFRINGEMENT OF THIRD PARTY RIGHTS.
+#
+# HexaPDF is distributed in the hope that it will be useful, but WITHOUT
+# ANY WARRANTY; without even the implied warranty of MERCHANTABILITY or
+# FITNESS FOR A PARTICULAR PURPOSE. See the GNU Affero General Public
+# License for more details.
+#
+# You should have received a copy of the GNU Affero General Public License
+# along with HexaPDF. If not, see <http://www.gnu.org/licenses/>.
+#
+# The interactive user interfaces in modified source and object code
+# versions of HexaPDF must display Appropriate Legal Notices, as required
+# under Section 5 of the GNU Affero General Public License version 3.
+#
+# In accordance with Section 7(b) of the GNU Affero General Public
+# License, a covered work must retain the producer line in every PDF that
+# is created or manipulated using HexaPDF.
+#++
+
+module HexaPDF
+
+  # A general error.
+  class Error < StandardError; end
+
+  # Raised when the PDF is invalid and can't be read correctly.
+  class MalformedPDFError < Error
+
+    # The byte position in the PDF file where the error occured.
+    attr_reader :pos
+
+    # Creates a new malformed PDF error object for the given exception or exception message.
+    #
+    # The byte position where the error occured can be given via the optional +pos+ argument.
+    def initialize(msg_or_error, pos: nil)
+      super(msg_or_error)
+      set_backtrace(msg_or_error.backtrace) if msg_or_error.kind_of?(Exception)
+      @pos = pos
+    end
+
+    def message # :nodoc:
+      pos_msg = @pos.nil? ? '' : " around position #{pos}"
+      "PDF malformed#{pos_msg}: #{super}"
+    end
+
+  end
+
+  # Raised when a filter encounters a problem during decoding or encoding.
+  class FilterError < Error; end
+
+  # Raised when a PDF object contains invalid data.
+  class InvalidPDFObjectError < Error; end
+
+  # Raised when there are problems while encrypting or decrypting a document.
+  class EncryptionError < Error; end
+
+  # Raised when the encryption method is not supported.
+  class UnsupportedEncryptionError < EncryptionError; end
+
+end

data/lib/hexapdf/filter/ascii85_decode.rb

@@ -0,0 +1,160 @@
+# -*- encoding: utf-8 -*-
+#
+#--
+# This file is part of HexaPDF.
+#
+# HexaPDF - A Versatile PDF Creation and Manipulation Library For Ruby
+# Copyright (C) 2016 Thomas Leitner
+#
+# HexaPDF is free software: you can redistribute it and/or modify it
+# under the terms of the GNU Affero General Public License version 3 as
+# published by the Free Software Foundation with the addition of the
+# following permission added to Section 15 as permitted in Section 7(a):
+# FOR ANY PART OF THE COVERED WORK IN WHICH THE COPYRIGHT IS OWNED BY
+# THOMAS LEITNER, THOMAS LEITNER DISCLAIMS THE WARRANTY OF NON
+# INFRINGEMENT OF THIRD PARTY RIGHTS.
+#
+# HexaPDF is distributed in the hope that it will be useful, but WITHOUT
+# ANY WARRANTY; without even the implied warranty of MERCHANTABILITY or
+# FITNESS FOR A PARTICULAR PURPOSE. See the GNU Affero General Public
+# License for more details.
+#
+# You should have received a copy of the GNU Affero General Public License
+# along with HexaPDF. If not, see <http://www.gnu.org/licenses/>.
+#
+# The interactive user interfaces in modified source and object code
+# versions of HexaPDF must display Appropriate Legal Notices, as required
+# under Section 5 of the GNU Affero General Public License version 3.
+#
+# In accordance with Section 7(b) of the GNU Affero General Public
+# License, a covered work must retain the producer line in every PDF that
+# is created or manipulated using HexaPDF.
+#++
+
+require 'fiber'
+require 'strscan'
+require 'hexapdf/tokenizer'
+require 'hexapdf/error'
+
+module HexaPDF
+  module Filter
+
+    # This filter module implements the ASCII-85 filter which can encode arbitrary data into an
+    # ASCII compatible format that expands the original data only by a factor of 4:5.
+    #
+    # See: HexaPDF::Filter, PDF1.7 s7.4.2
+    module ASCII85Decode
+
+      VALUE_TO_CHAR = {} #:nodoc:
+      (0..84).each do |i|
+        VALUE_TO_CHAR[i] = (i + 33).chr
+      end
+
+      POW85_1 = 85    #:nodoc:
+      POW85_2 = 85**2 #:nodoc:
+      POW85_3 = 85**3 #:nodoc:
+      POW85_4 = 85**4 #:nodoc:
+
+      MAX_VALUE = 0xffffffff  #:nodoc:
+      FIXED_SUBTRAHEND = 33 * (POW85_4 + POW85_3 + POW85_2 + POW85_1 + 1) #:nodoc:
+
+      # See HexaPDF::Filter
+      def self.decoder(source, _ = nil)
+        Fiber.new do
+          rest = nil
+          finished = false
+
+          while !finished && source.alive? && (data = source.resume)
+            data.tr!(HexaPDF::Tokenizer::WHITESPACE, '')
+            if data.index(/[^!-uz~]/)
+              raise FilterError, "Invalid characters in ASCII85 stream"
+            end
+
+            if rest
+              data = rest << data
+              rest = nil
+            end
+
+            result = []
+            scanner = StringScanner.new(data)
+            until scanner.eos?
+              if (m = scanner.scan(/[!-u]{5}/))
+                num = (m.getbyte(0) * POW85_4 + m.getbyte(1) * POW85_3 +
+                  m.getbyte(2) * POW85_2 + m.getbyte(3) * POW85_1 +
+                  m.getbyte(4)) - FIXED_SUBTRAHEND
+                if num > MAX_VALUE
+                  raise FilterError, "Value outside range in ASCII85 stream"
+                end
+                result << num
+              elsif scanner.scan(/z/)
+                result << 0
+              elsif scanner.scan(/([!-u]{0,4})~>/)
+                rest = scanner[1] unless scanner[1].empty?
+                finished = true
+                break
+              else
+                rest = scanner.scan(/.+/)
+              end
+            end
+            Fiber.yield(result.pack('N*')) unless result.empty?
+          end
+
+          if rest
+            if rest.index('z') || rest.index('~')
+              raise FilterError, "End of ASCII85 encoded stream is invalid"
+            end
+
+            rlen = rest.length
+            rest << "u" * (5 - rlen)
+            num = (rest.getbyte(0) * POW85_4 + rest.getbyte(1) * POW85_3 +
+              rest.getbyte(2) * POW85_2 + rest.getbyte(3) * POW85_1 +
+              rest.getbyte(4)) - FIXED_SUBTRAHEND
+            if num > MAX_VALUE
+              raise FilterError, "Value outside base-85 range in ASCII85 stream"
+            end
+            [num].pack('N')[0, rlen - 1]
+          end
+        end
+      end
+
+      # See HexaPDF::Filter
+      def self.encoder(source, _ = nil)
+        Fiber.new do
+          rest = nil
+
+          while source.alive? && (data = source.resume)
+            data = rest << data if rest
+
+            rlen = data.length % 4
+            rest = (rlen != 0 ? data.slice!(-rlen, rlen) : nil)
+            next if data.length < 4
+
+            data = data.unpack('N*').inject(''.b) do |memo, num|
+              memo << if num == 0
+                        'z'
+                      else
+                        VALUE_TO_CHAR[num / POW85_4 % 85] + VALUE_TO_CHAR[num / POW85_3 % 85] <<
+                          VALUE_TO_CHAR[num / POW85_2 % 85] << VALUE_TO_CHAR[num / POW85_1 % 85] <<
+                          VALUE_TO_CHAR[num % 85]
+                      end
+            end
+
+            Fiber.yield(data)
+          end
+
+          if rest
+            rlen = rest.length
+            num = (rest + "\0" * (4 - rlen)).unpack('N').first
+            ((VALUE_TO_CHAR[num / POW85_4 % 85] + VALUE_TO_CHAR[num / POW85_3 % 85] <<
+              VALUE_TO_CHAR[num / POW85_2 % 85] << VALUE_TO_CHAR[num / POW85_1 % 85] <<
+              VALUE_TO_CHAR[num % 85])[0, rlen + 1] << "~>").force_encoding(Encoding::BINARY)
+          else
+            "~>".force_encoding(Encoding::BINARY)
+          end
+        end
+      end
+
+    end
+
+  end
+end

data/lib/hexapdf/filter/ascii_hex_decode.rb

@@ -0,0 +1,87 @@
+# -*- encoding: utf-8 -*-
+#
+#--
+# This file is part of HexaPDF.
+#
+# HexaPDF - A Versatile PDF Creation and Manipulation Library For Ruby
+# Copyright (C) 2016 Thomas Leitner
+#
+# HexaPDF is free software: you can redistribute it and/or modify it
+# under the terms of the GNU Affero General Public License version 3 as
+# published by the Free Software Foundation with the addition of the
+# following permission added to Section 15 as permitted in Section 7(a):
+# FOR ANY PART OF THE COVERED WORK IN WHICH THE COPYRIGHT IS OWNED BY
+# THOMAS LEITNER, THOMAS LEITNER DISCLAIMS THE WARRANTY OF NON
+# INFRINGEMENT OF THIRD PARTY RIGHTS.
+#
+# HexaPDF is distributed in the hope that it will be useful, but WITHOUT
+# ANY WARRANTY; without even the implied warranty of MERCHANTABILITY or
+# FITNESS FOR A PARTICULAR PURPOSE. See the GNU Affero General Public
+# License for more details.
+#
+# You should have received a copy of the GNU Affero General Public License
+# along with HexaPDF. If not, see <http://www.gnu.org/licenses/>.
+#
+# The interactive user interfaces in modified source and object code
+# versions of HexaPDF must display Appropriate Legal Notices, as required
+# under Section 5 of the GNU Affero General Public License version 3.
+#
+# In accordance with Section 7(b) of the GNU Affero General Public
+# License, a covered work must retain the producer line in every PDF that
+# is created or manipulated using HexaPDF.
+#++
+
+require 'fiber'
+require 'hexapdf/tokenizer'
+require 'hexapdf/error'
+
+module HexaPDF
+  module Filter
+
+    # This filter module implements the ASCII hex decode/encode filter which can encode arbitrary
+    # data into the two byte ASCII hex format that expands the original data by a factor of 1:2.
+    #
+    # See: HexaPDF::Filter, PDF1.7 s7.4.2
+    module ASCIIHexDecode
+
+      # See HexaPDF::Filter
+      def self.decoder(source, _ = nil)
+        Fiber.new do
+          rest = nil
+          finished = false
+
+          while !finished && source.alive? && (data = source.resume)
+            data.tr!(HexaPDF::Tokenizer::WHITESPACE, '')
+            finished = true if data.gsub!(/>.*?\z/m, '')
+            if data.index(/[^A-Fa-f0-9]/)
+              raise FilterError, "Invalid characters in ASCII hex stream"
+            end
+
+            data = rest << data if rest
+
+            if data.size.odd?
+              rest = data.slice!(-1, 1)
+            else
+              rest = nil
+            end
+
+            Fiber.yield([data].pack('H*'))
+          end
+          [rest].pack('H*') if rest
+        end
+      end
+
+      # See HexaPDF::Filter
+      def self.encoder(source, _ = nil)
+        Fiber.new do
+          while source.alive? && (data = source.resume)
+            Fiber.yield(data.unpack('H*').first.force_encoding(Encoding::BINARY))
+          end
+          '>'.b
+        end
+      end
+
+    end
+
+  end
+end

data/lib/hexapdf/filter/dct_decode.rb

@@ -0,0 +1,57 @@
+# -*- encoding: utf-8 -*-
+#
+#--
+# This file is part of HexaPDF.
+#
+# HexaPDF - A Versatile PDF Creation and Manipulation Library For Ruby
+# Copyright (C) 2016 Thomas Leitner
+#
+# HexaPDF is free software: you can redistribute it and/or modify it
+# under the terms of the GNU Affero General Public License version 3 as
+# published by the Free Software Foundation with the addition of the
+# following permission added to Section 15 as permitted in Section 7(a):
+# FOR ANY PART OF THE COVERED WORK IN WHICH THE COPYRIGHT IS OWNED BY
+# THOMAS LEITNER, THOMAS LEITNER DISCLAIMS THE WARRANTY OF NON
+# INFRINGEMENT OF THIRD PARTY RIGHTS.
+#
+# HexaPDF is distributed in the hope that it will be useful, but WITHOUT
+# ANY WARRANTY; without even the implied warranty of MERCHANTABILITY or
+# FITNESS FOR A PARTICULAR PURPOSE. See the GNU Affero General Public
+# License for more details.
+#
+# You should have received a copy of the GNU Affero General Public License
+# along with HexaPDF. If not, see <http://www.gnu.org/licenses/>.
+#
+# The interactive user interfaces in modified source and object code
+# versions of HexaPDF must display Appropriate Legal Notices, as required
+# under Section 5 of the GNU Affero General Public License version 3.
+#
+# In accordance with Section 7(b) of the GNU Affero General Public
+# License, a covered work must retain the producer line in every PDF that
+# is created or manipulated using HexaPDF.
+#++
+
+module HexaPDF
+  module Filter
+
+    # The DCTDecode filter is currently only implemented as a pass-through filter, ie. the source
+    # gets passed on unmodified. This also means that the :ColorTransform parameter is not
+    # evaluated!
+    #
+    # See: HexaPDF::Filter, PDF1.7 s7.4.8
+    module DCTDecode
+
+      # See HexaPDF::Filter
+      def self.decoder(source, _ = nil)
+        source
+      end
+
+      # See HexaPDF::Filter
+      def self.encoder(source, _ = nil)
+        source
+      end
+
+    end
+
+  end
+end

data/lib/hexapdf/filter/encryption.rb

@@ -0,0 +1,59 @@
+# -*- encoding: utf-8 -*-
+#
+#--
+# This file is part of HexaPDF.
+#
+# HexaPDF - A Versatile PDF Creation and Manipulation Library For Ruby
+# Copyright (C) 2016 Thomas Leitner
+#
+# HexaPDF is free software: you can redistribute it and/or modify it
+# under the terms of the GNU Affero General Public License version 3 as
+# published by the Free Software Foundation with the addition of the
+# following permission added to Section 15 as permitted in Section 7(a):
+# FOR ANY PART OF THE COVERED WORK IN WHICH THE COPYRIGHT IS OWNED BY
+# THOMAS LEITNER, THOMAS LEITNER DISCLAIMS THE WARRANTY OF NON
+# INFRINGEMENT OF THIRD PARTY RIGHTS.
+#
+# HexaPDF is distributed in the hope that it will be useful, but WITHOUT
+# ANY WARRANTY; without even the implied warranty of MERCHANTABILITY or
+# FITNESS FOR A PARTICULAR PURPOSE. See the GNU Affero General Public
+# License for more details.
+#
+# You should have received a copy of the GNU Affero General Public License
+# along with HexaPDF. If not, see <http://www.gnu.org/licenses/>.
+#
+# The interactive user interfaces in modified source and object code
+# versions of HexaPDF must display Appropriate Legal Notices, as required
+# under Section 5 of the GNU Affero General Public License version 3.
+#
+# In accordance with Section 7(b) of the GNU Affero General Public
+# License, a covered work must retain the producer line in every PDF that
+# is created or manipulated using HexaPDF.
+#++
+
+module HexaPDF
+  module Filter
+
+    # This filter module allows access to the standard encryption and decryption routines
+    # implemented by the SecurityHandler using the standard Filter interface.
+    #
+    # The +options+ hash for ::decoder and ::encoder must contain two keys: :key (the
+    # encryption/decryption key) and :algorithm (the class used for encrypting/decrypting).
+    #
+    # This module must not be confused with the Crypt filter specified in the PDF specification!
+    module Encryption
+
+      # See HexaPDF::Filter
+      def self.decoder(source, options)
+        options[:algorithm].decryption_fiber(options[:key], source)
+      end
+
+      # See HexaPDF::Filter
+      def self.encoder(source, options)
+        options[:algorithm].encryption_fiber(options[:key], source)
+      end
+
+    end
+
+  end
+end

data/lib/hexapdf/filter/flate_decode.rb

@@ -0,0 +1,93 @@
+# -*- encoding: utf-8 -*-
+#
+#--
+# This file is part of HexaPDF.
+#
+# HexaPDF - A Versatile PDF Creation and Manipulation Library For Ruby
+# Copyright (C) 2016 Thomas Leitner
+#
+# HexaPDF is free software: you can redistribute it and/or modify it
+# under the terms of the GNU Affero General Public License version 3 as
+# published by the Free Software Foundation with the addition of the
+# following permission added to Section 15 as permitted in Section 7(a):
+# FOR ANY PART OF THE COVERED WORK IN WHICH THE COPYRIGHT IS OWNED BY
+# THOMAS LEITNER, THOMAS LEITNER DISCLAIMS THE WARRANTY OF NON
+# INFRINGEMENT OF THIRD PARTY RIGHTS.
+#
+# HexaPDF is distributed in the hope that it will be useful, but WITHOUT
+# ANY WARRANTY; without even the implied warranty of MERCHANTABILITY or
+# FITNESS FOR A PARTICULAR PURPOSE. See the GNU Affero General Public
+# License for more details.
+#
+# You should have received a copy of the GNU Affero General Public License
+# along with HexaPDF. If not, see <http://www.gnu.org/licenses/>.
+#
+# The interactive user interfaces in modified source and object code
+# versions of HexaPDF must display Appropriate Legal Notices, as required
+# under Section 5 of the GNU Affero General Public License version 3.
+#
+# In accordance with Section 7(b) of the GNU Affero General Public
+# License, a covered work must retain the producer line in every PDF that
+# is created or manipulated using HexaPDF.
+#++
+
+require 'fiber'
+require 'zlib'
+require 'hexapdf/filter/predictor'
+require 'hexapdf/configuration'
+require 'hexapdf/error'
+
+module HexaPDF
+  module Filter
+
+    # Implements the Deflate filter using the Zlib library.
+    #
+    # See: HexaPDF::Filter, PDF1.7 s7.4.4
+    module FlateDecode
+
+      # See HexaPDF::Filter
+      def self.decoder(source, options = nil)
+        fib = Fiber.new do
+          inflater = Zlib::Inflate.new
+          while source.alive? && (data = source.resume)
+            begin
+              data = inflater.inflate(data)
+            rescue
+              raise FilterError, "Problem while decoding Flate encoded stream: #{$!}"
+            end
+            Fiber.yield(data)
+          end
+          begin
+            inflater.finish
+          rescue
+            raise FilterError, "Problem while decoding Flate encoded stream: #{$!}"
+          end
+        end
+
+        if options && options[:Predictor]
+          Predictor.decoder(fib, options)
+        else
+          fib
+        end
+      end
+
+      # See HexaPDF::Filter
+      def self.encoder(source, options = nil)
+        if options && options[:Predictor]
+          source = Predictor.encoder(source, options)
+        end
+
+        Fiber.new do
+          deflater = Zlib::Deflate.new(HexaPDF::GlobalConfiguration['filter.flate_compression'])
+          while source.alive? && (data = source.resume)
+            data = deflater.deflate(data)
+            Fiber.yield(data)
+          end
+          deflater.finish
+        end
+      end
+
+    end
+
+  end
+end

data/lib/hexapdf/filter/jpx_decode.rb

@@ -0,0 +1,56 @@
+# -*- encoding: utf-8 -*-
+#
+#--
+# This file is part of HexaPDF.
+#
+# HexaPDF - A Versatile PDF Creation and Manipulation Library For Ruby
+# Copyright (C) 2016 Thomas Leitner
+#
+# HexaPDF is free software: you can redistribute it and/or modify it
+# under the terms of the GNU Affero General Public License version 3 as
+# published by the Free Software Foundation with the addition of the
+# following permission added to Section 15 as permitted in Section 7(a):
+# FOR ANY PART OF THE COVERED WORK IN WHICH THE COPYRIGHT IS OWNED BY
+# THOMAS LEITNER, THOMAS LEITNER DISCLAIMS THE WARRANTY OF NON
+# INFRINGEMENT OF THIRD PARTY RIGHTS.
+#
+# HexaPDF is distributed in the hope that it will be useful, but WITHOUT
+# ANY WARRANTY; without even the implied warranty of MERCHANTABILITY or
+# FITNESS FOR A PARTICULAR PURPOSE. See the GNU Affero General Public
+# License for more details.
+#
+# You should have received a copy of the GNU Affero General Public License
+# along with HexaPDF. If not, see <http://www.gnu.org/licenses/>.
+#
+# The interactive user interfaces in modified source and object code
+# versions of HexaPDF must display Appropriate Legal Notices, as required
+# under Section 5 of the GNU Affero General Public License version 3.
+#
+# In accordance with Section 7(b) of the GNU Affero General Public
+# License, a covered work must retain the producer line in every PDF that
+# is created or manipulated using HexaPDF.
+#++
+
+module HexaPDF
+  module Filter
+
+    # The JPXDecode filter is currently only implemented as a pass-through filter, ie. the source
+    # gets passed on unmodified.
+    #
+    # See: HexaPDF::Filter, PDF1.7 s7.4.9
+    module JPXDecode
+
+      # See HexaPDF::Filter
+      def self.decoder(source, _ = nil)
+        source
+      end
+
+      # See HexaPDF::Filter
+      def self.encoder(source, _ = nil)
+        source
+      end
+
+    end
+
+  end
+end