hexapdf 0.6.0 → 0.7.0

data/lib/hexapdf/cli/modify.rb

@@ -1,10 +1,10 @@
-# -*- encoding: utf-8 -*-
+# -*- encoding: utf-8; frozen_string_literal: true -*-
 #
 #--
 # This file is part of HexaPDF.
 #
 # HexaPDF - A Versatile PDF Creation and Manipulation Library For Ruby
-# Copyright (C) 2014-2017 Thomas Leitner
+# Copyright (C) 2014-2018 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
@@ -49,7 +49,7 @@ module HexaPDF
       def initialize #:nodoc:
         super('modify', takes_commands: false)
         short_desc("Modify a PDF file")
-        long_desc(<<-EOF.gsub!(/^ */, ''))
+        long_desc(<<~EOF)
           This command modifies a PDF file. It can be used to select pages that should appear in
           the output file and/or rotate them. The output file can also be encrypted/decrypted and
           optimized in various ways.
@@ -79,7 +79,7 @@ module HexaPDF
         maybe_raise_on_existing_file(out_file)
         with_document(in_file, password: @password, out_file: out_file) do |doc|
           arrange_pages(doc) unless @pages == '1-e'
-          @embed_files.each {|file| doc.files.add(file, embed: true)}
+          @embed_files.each {|file| doc.files.add(file, embed: true) }
           apply_encryption_options(doc)
           apply_optimization_options(doc)
         end

data/lib/hexapdf/cli/optimize.rb

@@ -1,10 +1,10 @@
-# -*- encoding: utf-8 -*-
+# -*- encoding: utf-8; frozen_string_literal: true -*-
 #
 #--
 # This file is part of HexaPDF.
 #
 # HexaPDF - A Versatile PDF Creation and Manipulation Library For Ruby
-# Copyright (C) 2014-2017 Thomas Leitner
+# Copyright (C) 2014-2018 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
@@ -42,7 +42,7 @@ module HexaPDF
       def initialize #:nodoc:
         super('optimize', takes_commands: false)
         short_desc("Optimize the size of a PDF file")
-        long_desc(<<-EOF.gsub!(/^ */, ''))
+        long_desc(<<~EOF)
           This command uses several optimization strategies to reduce the file size of the PDF file.
 
           By default, all strategies except page compression are used since page compression may

data/lib/hexapdf/configuration.rb

@@ -1,10 +1,10 @@
-# -*- encoding: utf-8 -*-
+# -*- encoding: utf-8; frozen_string_literal: true -*-
 #
 #--
 # This file is part of HexaPDF.
 #
 # HexaPDF - A Versatile PDF Creation and Manipulation Library For Ruby
-# Copyright (C) 2014-2017 Thomas Leitner
+# Copyright (C) 2014-2018 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
@@ -58,7 +58,6 @@ module HexaPDF
       DefaultDocumentConfiguration.merge(values)
     end
 
-
     # Creates a new Configuration object using the provided hash argument.
     def initialize(options = {})
       @options = options
@@ -68,7 +67,7 @@ module HexaPDF
     def key?(name)
       options.key?(name)
     end
-    alias :option? :key?
+    alias option? key?
 
     # Returns the value for the configuration option +name+.
     def [](name)
@@ -122,7 +121,7 @@ module HexaPDF
       if data.nil? && block_given?
         data = yield(name)
       elsif data.nil?
-        raise HexaPDF::Error, "Error getting constant for configuration option '#{name}'" <<
+        raise HexaPDF::Error, "Error getting constant for configuration option '#{name}'" +
           (keys.empty? ? "" : " and keys '#{keys.join(', ')}'")
       end
       data

data/lib/hexapdf/content.rb

@@ -1,10 +1,10 @@
-# -*- encoding: utf-8 -*-
+# -*- encoding: utf-8; frozen_string_literal: true -*-
 #
 #--
 # This file is part of HexaPDF.
 #
 # HexaPDF - A Versatile PDF Creation and Manipulation Library For Ruby
-# Copyright (C) 2014-2017 Thomas Leitner
+# Copyright (C) 2014-2018 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

data/lib/hexapdf/content/canvas.rb

@@ -1,10 +1,10 @@
-# -*- encoding: utf-8 -*-
+# -*- encoding: utf-8; frozen_string_literal: true -*-
 #
 #--
 # This file is part of HexaPDF.
 #
 # HexaPDF - A Versatile PDF Creation and Manipulation Library For Ruby
-# Copyright (C) 2014-2017 Thomas Leitner
+# Copyright (C) 2014-2018 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
@@ -463,7 +463,7 @@ module HexaPDF
       def line_width(width = nil, &block)
         gs_getter_setter(:line_width, :w, width, &block)
       end
-      alias :line_width= :line_width
+      alias line_width= line_width
 
       # :call-seq:
       #   canvas.line_cap_style                    => current_line_cap_style
@@ -497,7 +497,7 @@ module HexaPDF
       def line_cap_style(style = nil, &block)
         gs_getter_setter(:line_cap_style, :J, style && LineCapStyle.normalize(style), &block)
       end
-      alias :line_cap_style= :line_cap_style
+      alias line_cap_style= line_cap_style
 
       # :call-seq:
       #   canvas.line_join_style                    => current_line_join_style
@@ -531,7 +531,7 @@ module HexaPDF
       def line_join_style(style = nil, &block)
         gs_getter_setter(:line_join_style, :j, style && LineJoinStyle.normalize(style), &block)
       end
-      alias :line_join_style= :line_join_style
+      alias line_join_style= line_join_style
 
       # :call-seq:
       #   canvas.miter_limit                    => current_miter_limit
@@ -564,7 +564,7 @@ module HexaPDF
       def miter_limit(limit = nil, &block)
         gs_getter_setter(:miter_limit, :M, limit, &block)
       end
-      alias :miter_limit= :miter_limit
+      alias miter_limit= miter_limit
 
       # :call-seq:
       #   canvas.line_dash_pattern                                  => current_line_dash_pattern
@@ -613,7 +613,7 @@ module HexaPDF
         gs_getter_setter(:line_dash_pattern, :d, value && LineDashPattern.normalize(value, phase),
                          &block)
       end
-      alias :line_dash_pattern= :line_dash_pattern
+      alias line_dash_pattern= line_dash_pattern
 
       # :call-seq:
       #   canvas.rendering_intent                       => current_rendering_intent
@@ -651,7 +651,7 @@ module HexaPDF
       def rendering_intent(intent = nil, &bk)
         gs_getter_setter(:rendering_intent, :ri, intent && RenderingIntent.normalize(intent), &bk)
       end
-      alias :rendering_intent= :rendering_intent
+      alias rendering_intent= rendering_intent
 
       # :call-seq:
       #   canvas.stroke_color                             => current_stroke_color
@@ -718,7 +718,7 @@ module HexaPDF
       def stroke_color(*color, &block)
         color_getter_setter(:stroke_color, color, :RG, :G, :K, :CS, :SCN, &block)
       end
-      alias :stroke_color= :stroke_color
+      alias stroke_color= stroke_color
 
       # The fill color defines the color used for non-stroking operations, i.e. for filling paths.
       #
@@ -727,7 +727,7 @@ module HexaPDF
       def fill_color(*color, &block)
         color_getter_setter(:fill_color, color, :rg, :g, :k, :cs, :scn, &block)
       end
-      alias :fill_color= :fill_color
+      alias fill_color= fill_color
 
       # :call-seq:
       #   canvas.opacity                                           => current_values
@@ -956,7 +956,7 @@ module HexaPDF
           check_poly_points(points)
           move_to(*point_on_line(points[0], points[1], points[2], points[3], distance: radius))
           points.concat(points[0, 4])
-          0.step(points.length - 6, 2) {|i| line_with_rounded_corner(*points[i, 6], radius)}
+          0.step(points.length - 6, 2) {|i| line_with_rounded_corner(*points[i, 6], radius) }
         end
         close_subpath
       end
@@ -1085,7 +1085,7 @@ module HexaPDF
         unless obj.respond_to?(:configure)
           obj = context.document.config.constantize('graphic_object.map', obj)
         end
-        obj = obj.configure(options) if options.size > 0 || !obj.respond_to?(:draw)
+        obj = obj.configure(options) unless options.empty? && obj.respond_to?(:draw)
         obj
       end
 
@@ -1276,7 +1276,7 @@ module HexaPDF
 
         obj
       end
-      alias :image :xobject
+      alias image xobject
 
       # :call-seq:
       #   canvas.character_spacing                       => current_character_spacing
@@ -1310,7 +1310,7 @@ module HexaPDF
       def character_spacing(amount = nil, &bk)
         gs_getter_setter(:character_spacing, :Tc, amount, &bk)
       end
-      alias :character_spacing= :character_spacing
+      alias character_spacing= character_spacing
 
       # :call-seq:
       #   canvas.word_spacing                       => current_word_spacing
@@ -1347,7 +1347,7 @@ module HexaPDF
       def word_spacing(amount = nil, &bk)
         gs_getter_setter(:word_spacing, :Tw, amount, &bk)
       end
-      alias :word_spacing= :word_spacing
+      alias word_spacing= word_spacing
 
       # :call-seq:
       #   canvas.horizontal_scaling                        => current_horizontal_scaling
@@ -1381,7 +1381,7 @@ module HexaPDF
       def horizontal_scaling(amount = nil, &bk)
         gs_getter_setter(:horizontal_scaling, :Tz, amount, &bk)
       end
-      alias :horizontal_scaling= :horizontal_scaling
+      alias horizontal_scaling= horizontal_scaling
 
       # :call-seq:
       #   canvas.leading                       => current_leading
@@ -1412,7 +1412,7 @@ module HexaPDF
       def leading(amount = nil, &bk)
         gs_getter_setter(:leading, :TL, amount, &bk)
       end
-      alias :leading= :leading
+      alias leading= leading
 
       # :call-seq:
       #   canvas.text_rendering_mode                     => current_text_rendering_mode
@@ -1448,7 +1448,7 @@ module HexaPDF
       def text_rendering_mode(m = nil, &bk)
         gs_getter_setter(:text_rendering_mode, :Tr, m && TextRenderingMode.normalize(m), &bk)
       end
-      alias :text_rendering_mode= :text_rendering_mode
+      alias text_rendering_mode= text_rendering_mode
 
       # :call-seq:
       #   canvas.text_rise                       => current_text_rise
@@ -1480,7 +1480,7 @@ module HexaPDF
       def text_rise(amount = nil, &bk)
         gs_getter_setter(:text_rise, :Ts, amount, &bk)
       end
-      alias :text_rise= :text_rise
+      alias text_rise= text_rise
 
       # :call-seq:
       #   canvas.begin_text(force_new: false)      -> canvas
@@ -1620,42 +1620,37 @@ module HexaPDF
           @font
         end
       end
-      alias :font= :font
+      alias font= font
 
       # :call-seq:
-      #   canvas.font_size                                  => font_size
-      #   canvas.font_size(size, leading: size * 1.2)       => canvas
+      #   canvas.font_size            => font_size
+      #   canvas.font_size(size       => canvas
       #
       # Specifies the font size.
       #
       # Note that an error is raised if no font has been set before!
       #
-      # The leading can be additionally set and defaults to the font size times 1.2. If the leading
-      # should not be changed, +nil+ has to be passed for +leading+.
-      #
       # Returns the current font size when no argument is given.
       #
       # Examples:
       #
       #   canvas.font_size(12)
       #   canvas.font_size                       # => 12
-      #   canvas.font_size(12, leading: 20)
       #   canvas.font_size = 12
       #
       # See: PDF1.7 s9.2.2
-      def font_size(size = nil, leading: size && size * 1.2)
+      def font_size(size = nil)
         if size
           unless @font
             raise HexaPDF::Error, "A font needs to be set before the font size can be set"
           end
           invoke_font_operator(@font.dict, size)
-          self.leading(leading) if leading
           self
         else
           graphics_state.font_size
         end
       end
-      alias :font_size= :font_size
+      alias font_size= font_size
 
       # :call-seq:
       #   canvas.text(text)                  -> canvas
@@ -1705,6 +1700,7 @@ module HexaPDF
       #
       # This method is usually not invoked directly but by higher level methods like #text.
       def show_glyphs(glyphs)
+        return if glyphs.empty?
         raise_unless_font_set
         begin_text
 
@@ -1720,7 +1716,7 @@ module HexaPDF
 
             offset += item.width * graphics_state.scaled_font_size +
               graphics_state.scaled_character_spacing
-            offset += graphics_state.scaled_word_spacing if encoded == " ".freeze
+            offset += graphics_state.scaled_word_spacing if encoded == " "
           end
         end
 
@@ -1741,19 +1737,22 @@ module HexaPDF
       # #text_cursor and other methods using the current text matrix are invalid until the next call
       # to #text_matrix or #end_text.
       def show_glyphs_only(glyphs)
+        return if glyphs.empty?
         raise_unless_font_set
         begin_text
 
-        result = [''.b]
+        simple = true
+        result = [last = ''.b]
         glyphs.each do |item|
           if item.kind_of?(Numeric)
-            result << item << ''.b
+            simple = false
+            result << item << (last = ''.b)
           else
-            result[-1] << @font.encode(item)
+            last << @font.encode(item)
           end
         end
 
-        serialize1(:TJ, result)
+        simple ? serialize1(:Tj, result[0]) : serialize1(:TJ, result)
         self
       end
 
@@ -1898,7 +1897,7 @@ module HexaPDF
 
       # Invokes the font operator using the given PDF font dictionary.
       def invoke_font_operator(font, font_size)
-        if graphics_state.font != font || graphics_state.font_size != font_size
+        unless graphics_state.font == font && graphics_state.font_size == font_size
           invoke(:Tf, resources.add_font(font), font_size)
         end
       end
@@ -1962,7 +1961,7 @@ module HexaPDF
       # Utility method that abstracts the implementation of the stroke and fill color methods.
       def color_getter_setter(name, color, rg, g, k, cs, scn)
         color.flatten!
-        if color.length > 0
+        if !color.empty?
           raise_unless_at_page_description_level_or_in_text
           color = color_from_specification(color)
 

data/lib/hexapdf/content/color_space.rb

@@ -1,10 +1,10 @@
-# -*- encoding: utf-8 -*-
+# -*- encoding: utf-8; frozen_string_literal: true -*-
 #
 #--
 # This file is part of HexaPDF.
 #
 # HexaPDF - A Versatile PDF Creation and Manipulation Library For Ruby
-# Copyright (C) 2014-2017 Thomas Leitner
+# Copyright (C) 2014-2018 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
@@ -156,23 +156,20 @@ module HexaPDF
           # Returns the specific Universal color space used for this color.
           attr_reader :color_space
 
+          # Returns the componets of the universal color, i.e. all arguments provided on
+          # initialization.
+          attr_reader :components
+
           # Creates a new universal color with the given components.
           def initialize(color_space, *components)
             @color_space = color_space
             @components = components
           end
 
-          # Returns the componets of the universal color, i.e. all arguments provided on
-          # initialization.
-          def components
-            @components
-          end
-
         end
 
       end
 
-
       # The DeviceRGB color space.
       class DeviceRGB
 
@@ -180,7 +177,7 @@ module HexaPDF
         DEFAULT = new
 
         # Returns the DeviceRGB color space object.
-        def self.new
+        def self.new(_definition = nil)
           DEFAULT
         end
 
@@ -234,7 +231,6 @@ module HexaPDF
 
       end
 
-
       # The DeviceCMYK color space.
       class DeviceCMYK
 
@@ -242,7 +238,7 @@ module HexaPDF
         DEFAULT = new
 
         # Returns the DeviceCMYK color space object.
-        def self.new
+        def self.new(_definition = nil)
           DEFAULT
         end
 
@@ -298,7 +294,6 @@ module HexaPDF
 
       end
 
-
       # The DeviceGray color space.
       class DeviceGray
 
@@ -306,7 +301,7 @@ module HexaPDF
         DEFAULT = new
 
         # Returns the DeviceGray color space object.
-        def self.new
+        def self.new(_definition = nil)
           DEFAULT
         end