hexapdf 0.1.0

data/lib/hexapdf/font/type1_wrapper.rb

@@ -0,0 +1,193 @@
+# -*- 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 'hexapdf/font/type1'
+require 'hexapdf/font/encoding'
+require 'hexapdf/error'
+
+module HexaPDF
+  module Font
+
+    # This class wraps a generic Type1 font object and provides the methods needed for working with
+    # the font in a PDF context.
+    class Type1Wrapper
+
+      # Represents a single glyph of the wrapped font.
+      class Glyph
+
+        # The name of the glyph.
+        attr_reader :name
+        alias_method :id, :name
+
+        # Creates a new Glyph object.
+        def initialize(font, name)
+          @font = font
+          @name = name
+        end
+
+        # Returns the width of the glyph.
+        def width
+          @width ||= @font.width(name)
+        end
+
+        # Returns +true+ if the glyph represents the space character.
+        def space?
+          @name == :space
+        end
+
+      end
+
+      private_constant :Glyph
+
+
+      # Returns the wrapped Type1 font object.
+      attr_reader :wrapped_font
+
+      # The PDF font dictionary representing the wrapped font.
+      attr_reader :dict
+
+      # Creates a new object wrapping the Type1 font for the PDF document.
+      #
+      # The optional argument +custom_encoding+ can be set to +true+ so that a custom encoding
+      # instead of the WinAnsiEncoding is used.
+      def initialize(document, font, custom_encoding: false)
+        @document = document
+        @wrapped_font = font
+
+        @dict = build_font_dict
+        @document.register_listener(:complete_objects, &method(:complete_font_dict))
+        if @wrapped_font.metrics.character_set == 'Special' || custom_encoding
+          @encoding = Encoding::Base.new
+          @encoding.code_to_name[32] = :space
+          @max_code = 32 # 32 = space
+        else
+          @encoding = Encoding.for_name(:WinAnsiEncoding)
+          @max_code = 255 # Encoding is not modified
+        end
+
+        @zapf_dingbats_opt = {zapf_dingbats: (@wrapped_font.font_name == 'ZapfDingbats')}
+        @name_to_glyph = {}
+        @codepoint_to_glyph = {}
+        @encoded_glyphs = {}
+      end
+
+      # Returns a Glyph object for the given glyph name.
+      def glyph(name)
+        @name_to_glyph[name] ||=
+          begin
+            unless @wrapped_font.metrics.character_metrics.key?(name)
+              name = @document.config['font.on_missing_glyph'].call(name, @wrapped_font)
+            end
+            Glyph.new(@wrapped_font, name)
+          end
+      end
+
+      # Returns an array of glyph objects representing the characters in the UTF-8 encoded string.
+      def decode_utf8(str)
+        str.each_codepoint.map do |c|
+          @codepoint_to_glyph[c] ||=
+            begin
+              name = Encoding::GlyphList.unicode_to_name('' << c, @zapf_dingbats_opt)
+              name = '' << c if name == :'.notdef'
+              glyph(name)
+            end
+        end
+      end
+
+      # Encodes the glyph and returns the code string.
+      def encode(glyph)
+        @encoded_glyphs[glyph.name] ||=
+          begin
+            code = @encoding.code_to_name.key(glyph.name)
+            if code
+              code.chr.freeze
+            elsif @max_code < 255
+              @max_code += 1
+              @encoding.code_to_name[@max_code] = glyph.name
+              @max_code.chr.freeze
+            else
+              raise HexaPDF::Error, "Type1 encoding has no codepoint for #{glyph.name}"
+            end
+          end
+      end
+
+      private
+
+      # Builds a generic Type1 font dictionary for the wrapped font.
+      #
+      # Generic in the sense that no information regarding the encoding or widths is included.
+      def build_font_dict
+        unless defined?(@fd)
+          @fd = @document.wrap(Type: :FontDescriptor,
+                               FontName: @wrapped_font.font_name.intern,
+                               FontBBox: @wrapped_font.bounding_box,
+                               ItalicAngle: @wrapped_font.italic_angle || 0,
+                               Ascent: @wrapped_font.ascender || 0,
+                               Descent: @wrapped_font.descender || 0,
+                               CapHeight: @wrapped_font.cap_height,
+                               XHeight: @wrapped_font.x_height,
+                               StemH: @wrapped_font.dominant_horizontal_stem_width,
+                               StemV: @wrapped_font.dominant_vertical_stem_width || 0)
+          @fd.flag(:fixed_pitch) if @wrapped_font.metrics.is_fixed_pitch
+          @fd.flag(@wrapped_font.metrics.character_set == 'Special' ? :symbolic : :nonsymbolic)
+          @fd.must_be_indirect = true
+        end
+
+        @document.wrap(Type: :Font, Subtype: :Type1,
+                       BaseFont: @wrapped_font.font_name.intern, Encoding: :WinAnsiEncoding,
+                       FontDescriptor: @fd)
+      end
+
+      # Array of valid encoding names in PDF
+      VALID_ENCODING_NAMES = [:WinAnsiEncoding, :MacRomanEncoding, :MacExpertEncoding]
+
+      # Completes the font dictionary by filling in the values that depend on the used encoding.
+      def complete_font_dict
+        min, max = @encoding.code_to_name.keys.minmax
+        @dict[:FirstChar] = min
+        @dict[:LastChar] = max
+        @dict[:Widths] = (min..max).map {|code| glyph(@encoding.name(code)).width}
+
+        if VALID_ENCODING_NAMES.include?(@encoding.encoding_name)
+          @dict[:Encoding] = @encoding.encoding_name
+        else
+          differences = [min]
+          (min..max).each {|code| differences << @encoding.name(code)}
+          @dict[:Encoding] = {Differences: differences}
+        end
+      end
+
+    end
+
+  end
+end

data/lib/hexapdf/font_loader/from_configuration.rb

@@ -0,0 +1,70 @@
+# -*- 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 'hexapdf/font/true_type_wrapper'
+
+module HexaPDF
+  module FontLoader
+
+    # This module uses the configuration option 'font.map' for loading a font.
+    module FromConfiguration
+
+      # Loads the given font by looking up the needed file in the 'font.map' configuration option.
+      #
+      # The file object representing the font file is *not* closed and if needed must be closed by
+      # the caller once the font is not needed anymore.
+      #
+      # +document+::
+      #     The PDF document to associate the font object with.
+      #
+      # +name+::
+      #     The name of the font.
+      #
+      # +variant+::
+      #     The font variant. Normally one of :none, :bold, :italic, :bold_italic.
+      def self.call(document, name, variant: :none, **)
+        file = document.config['font.map'].dig(name, variant)
+        return nil if file.nil?
+
+        unless File.file?(file)
+          raise HexaPDF::Error, "The configured font file #{file} does not exist"
+        end
+
+        font = HexaPDF::Font::TrueType::Font.new(io: File.open(file))
+        HexaPDF::Font::TrueTypeWrapper.new(document, font)
+      end
+
+    end
+
+  end
+end

data/lib/hexapdf/font_loader/standard14.rb

@@ -0,0 +1,98 @@
+# -*- 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 'hexapdf/data_dir'
+require 'hexapdf/font/type1_wrapper'
+
+module HexaPDF
+  module FontLoader
+
+    # This module is used for providing the standard 14 PDF fonts.
+    module Standard14
+
+      # Mapping of font family name and variant to font name.
+      MAPPING = {
+        'Times' => {
+          none: 'Times-Roman',
+          bold: 'Times-Bold',
+          italic: 'Times-Italic',
+          bold_italic: 'Times-BoldItalic',
+        },
+        'Helvetica' => {
+          none: 'Helvetica',
+          bold: 'Helvetica-Bold',
+          italic: 'Helvetica-Oblique',
+          bold_italic: 'Helvetica-BoldOblique',
+        },
+        'Courier' => {
+          none: 'Courier',
+          bold: 'Courier-Bold',
+          italic: 'Courier-Oblique',
+          bold_italic: 'Courier-BoldOblique',
+        },
+        'Symbol' => {
+          none: 'Symbol',
+        },
+        'ZapfDingbats' => {
+          none: 'ZapfDingbats',
+        },
+      }
+
+      # Creates a new font object backed by the AFM font metrics read from the file or IO stream.
+      #
+      # +document+::
+      #     The PDF document to associate the font object with.
+      #
+      # +name+::
+      #     The name of the built-in font. One of Times, Helvetica, Courier, Symbol or ZapfDingbats.
+      #
+      # +variant+::
+      #     The font variant. Can be :none, :bold, :italic, :bold_italic for Times, Helvetica and
+      #     Courier; and must be :none for Symbol and ZapfDingbats.
+      #
+      # +custom_encoding+::
+      #     For Times, Helvetica and Courier the standard encoding WinAnsiEncoding is used. If this
+      #     option is not wanted because access to other glyphs is needed, set this to +true+
+      def self.call(document, name, variant: :none, custom_encoding: false, **)
+        name = MAPPING[name] && MAPPING[name][variant]
+        return nil if name.nil?
+
+        file = File.join(HexaPDF.data_dir, 'afm', "#{name}.afm")
+        font = HexaPDF::Font::Type1::Font.from_afm(file)
+        HexaPDF::Font::Type1Wrapper.new(document, font, custom_encoding: custom_encoding)
+      end
+
+    end
+
+  end
+end

data/lib/hexapdf/font_loader.rb

@@ -0,0 +1,85 @@
+# -*- 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 *font loader* is a callable object that loads a font based on the given name and options. If
+  # the font loader doesn't have the requested font, it has to return +nil+.
+  #
+  # The returned object has to be a PDF font wrapper and not the generic font object because it
+  # needs to be usable by the PDF canvas. See below for details.
+  #
+  #
+  # == Implementation of a Font Loader
+  #
+  # Each font loader is a (stateless) object (normally a module) that has to be callable, i.e. it
+  # has to provide the following method:
+  #
+  # call(document, name, **options)::
+  #     Should return the font wrapper customized for the given document if the font is known or
+  #     else +nil+.
+  #
+  # The +options+ argument is font loader dependent. However, all font loaders should handle the
+  # following common options:
+  #
+  # variant:: The font variant that should be used (e.g. +:none+, +:bold+, +:italic+,
+  #           +:bold_italic+).
+  #
+  #
+  # == Font Wrappers
+  #
+  # A font wrapper needs to provide the following generic interface so that it can be used correctly
+  # by HexaPDF:
+  #
+  # dict::
+  #     This method needs to return the PDF font dictionary that represents the wrapped font.
+  #
+  # decode_utf8(str)::
+  #     This method needs to convert the given string into an array of glyph objects. The glyph
+  #     objects themselves are treated as opaque objects by HexaPDF::Content::Canvas.
+  #
+  # encode(glyph)::
+  #     This method takes a single glyph object, that needs to be compatible with the font wrapper,
+  #     and returns an encoded string that can be decoded with the font dictionary returned by
+  #     \#dict.
+  #
+  module FontLoader
+
+    autoload(:Standard14, 'hexapdf/font_loader/standard14')
+    autoload(:FromConfiguration, 'hexapdf/font_loader/from_configuration')
+
+  end
+
+end

data/lib/hexapdf/font_utils.rb

@@ -0,0 +1,89 @@
+# -*- 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 'hexapdf/configuration'
+require 'hexapdf/font_loader'
+
+module HexaPDF
+
+  # This class provides utility functions for working with fonts. It is available through the
+  # HexaPDF::Document#fonts method.
+  class FontUtils
+
+    # Creates a new FontUtils object for the given PDF document.
+    def initialize(document)
+      @document = document
+      @loaded_fonts_cache = {}
+    end
+
+    # :call-seq:
+    #   fonts.load(name, **options)            -> font
+    #
+    # Loads and returns the font (using the loaders specified with the configuration option
+    # 'font_loaders').
+    #
+    # If a font with the same parameters has been loaded before, the cached font object is used.
+    def load(name, **options)
+      font = @loaded_fonts_cache[[name, options]]
+      return font if font
+
+      each_font_loader do |loader|
+        font = loader.call(@document, name, **options)
+        break if font
+      end
+
+      if font
+        @loaded_fonts_cache[[name, options]] = font
+      else
+        raise HexaPDF::Error, "The requested font '#{name}' couldn't be found"
+      end
+    end
+
+    private
+
+    # :call-seq:
+    #   fonts.each_font_loader {|loader| block}
+    #
+    # Iterates over all configured font loaders.
+    def each_font_loader
+      @document.config['font_loader'].each_index do |index|
+        loader = @document.config.constantize('font_loader', index) do
+          raise HexaPDF::Error, "Couldn't retrieve font loader ##{index} from configuration"
+        end
+        yield(loader)
+      end
+    end
+
+  end
+
+end

data/lib/hexapdf/image_loader/jpeg.rb

@@ -0,0 +1,166 @@
+# -*- 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 'hexapdf/error'
+
+module HexaPDF
+  module ImageLoader
+
+    # This module is used for loading images in the JPEG format from files or IO streams.
+    #
+    # See: PDF1.7 s7.4.8, ITU T.81 Annex B
+    module JPEG
+
+      # The magic marker that tells us if the file/IO contains an image in JPEG format.
+      MAGIC_FILE_MARKER = "\xFF\xD8\xFF".b
+
+      # The various start-of-frame markers that tell us which kind of JPEG it is. The marker
+      # segment itself contains all the needed information needed for creating the PDF image
+      # object.
+      #
+      # See: ITU T.81 B1.1.3
+      SOF_MARKERS = [0xC0, 0xC1, 0xC2, 0xC3, 0xC5, 0xC6, 0xC7, 0xC9, 0xCA, 0xCB, 0xCD, 0xCE, 0xCF]
+
+      # Adobe uses the marker 0xEE (APPE) for its purposes. We need to use it for determinig
+      # whether to invert the colors for CMYK/YCCK images or not (Adobe does this...).
+      #
+      # The marker also let's us distinguish between YCCK and CMYK images. However, we don't
+      # actually need this information (and we don't need to set the /ColorTransform value)
+      # because if the image has this information it is automically used.
+      ADOBE_MARKER = 0xEE
+
+      # End-of-image marker
+      EOI_MARKER = 0xD9
+
+      # Start-of-scan marker
+      SOS_MARKER = 0xDA
+
+      # :call-seq:
+      #   JPEG.handles?(filename)     -> true or false
+      #   JPGE.handles?(io)           -> true or false
+      #
+      # Returns +true+ if the given file or IO stream can be handled, ie. if it contains an image
+      # in JPEG format.
+      def self.handles?(file_or_io)
+        if file_or_io.kind_of?(String)
+          File.read(file_or_io, 3, mode: 'rb') == MAGIC_FILE_MARKER
+        else
+          file_or_io.rewind
+          file_or_io.read(3) == MAGIC_FILE_MARKER
+        end
+      end
+
+      # :call-seq:
+      #   JPEG.load(document, filename)    -> image_obj
+      #   JPEG.load(document, io)          -> image_obj
+      #
+      # Creates a PDF image object from the JPEG file or IO stream.
+      def self.load(document, file_or_io)
+        dict = if file_or_io.kind_of?(String)
+                 File.open(file_or_io, 'rb') {|io| image_data_from_io(io)}
+               else
+                 image_data_from_io(file_or_io)
+               end
+        document.add(dict, stream: HexaPDF::StreamData.new(file_or_io))
+      end
+
+      # Returns a hash containing the extracted JPEG image data.
+      def self.image_data_from_io(io)
+        io.seek(2, IO::SEEK_SET)
+
+        while true
+          code0 = io.getbyte
+          code1 = io.getbyte
+
+          # B1.1.2 - all markers start with 0xFF
+          if code0 != 0xFF
+            raise HexaPDF::Error, "Invalid bytes found, expected marker code"
+          end
+
+          # B1.1.2 - markers may be preceeded by any number of 0xFF fill bytes
+          code1 = io.getbyte while code1 == 0xFF
+
+          break if code1 == SOS_MARKER || code1 == EOI_MARKER
+
+          # B1.1.4 - next two bytes are the length of the segment (except for RSTm or TEM markers
+          # but those shouldn't appear here)
+          length = io.read(2).unpack('n').first
+
+          if code1 == ADOBE_MARKER # Adobe apps invert the colors when using CMYK color space
+            invert_colors = true
+            io.seek(length - 2, IO::SEEK_CUR)
+            next
+          elsif !SOF_MARKERS.include?(code1)
+            io.seek(length - 2, IO::SEEK_CUR)
+            next
+          end
+
+          bits, height, width, components = io.read(6).unpack('CnnC')
+          io.seek(length - 2 - 6, IO::SEEK_CUR)
+
+          # short-cut loop if we have all needed information
+          break if components != 4 || invert_colors
+        end
+
+        # PDF1.7 s8.9.5.1
+        if bits != 8
+          raise HexaPDF::Error, "Unsupported number of bits per component: #{bits}"
+        end
+
+        color_space = case components
+                      when 1 then :DeviceGray
+                      when 3 then :DeviceRGB
+                      when 4 then :DeviceCMYK
+                      end
+
+        dict = {
+          Type: :XObject,
+          Subtype: :Image,
+          Width: width,
+          Height: height,
+          ColorSpace: color_space,
+          BitsPerComponent: bits,
+          Filter: :DCTDecode,
+        }
+        if invert_colors && color_space == :DeviceCMYK
+          dict[:Decode] = [1.0, 0.0, 1.0, 0.0, 1.0, 0.0, 1.0, 0.0]
+        end
+
+        dict
+      end
+      private_class_method :image_data_from_io
+
+    end
+
+  end
+end