libis-format 0.9.41 → 0.9.44

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA1:
-  metadata.gz: 52324c2a0a320c5a4e9940998515baf300186927
-  data.tar.gz: 8a19e17da36919d97d9310663136a9b9d9889a31
+  metadata.gz: 22fe2305d1461bf58825e88933f215cd64fffdba
+  data.tar.gz: 454e2fc45afeae5b338723df845923c7f4364d10
 SHA512:
-  metadata.gz: 1dd5dea124dfc761dc0b39f6a5810ac61424b29ff88ffcd17eb32a1bdb423625146c6b67a649eced61908b048b83f02f3fd9f53d0c3762a1f78889e770432cce
-  data.tar.gz: 40369f9ea7ccdfc2e4b84e239d78e36952c87e0b3351e700a1ce2bd104ab446f1f5ff64816ea57c7faf9c71928f73721ed73b6bb4acbc83237531bb8aa621a5e
+  metadata.gz: ecf6f26241e61b34c6162c31ee1f55896a8d9bb67b01e2484db1714d1c5dfc75ce5666fad215dc8bc99d6e12d6f50fac3e81f92c9f47a5d8f26bdb43c0766d7b
+  data.tar.gz: 8743beb8af9bc17f9953e9488d0fc78ccb8e709a5fcbc551470926fea972e39560b6ab092faa52789109ff796b7309f45bba9844e395c1e2cc0f3c10d94b27b8

data/README.md

@@ -30,6 +30,371 @@ Or install it yourself as:
 
 The type database is the core of the format services. It stores information about all the known formats.
 
+### ::Libis::Format::Identifier
+
+This class enables support for format identification. It will use 3 external tools to identify a file format:
+droid, fido and the unix file tool. Based on several criteria, the results of these tools will be given a
+score and the result with the highest confidence is returned. The output of all tools can also be returned.
+The format identification result contains a MIME-type and a PRONOM PUID if they are known. Also the calculated
+score, the tool that produced the outcome and recognition method are listed. Some tools also return more
+information like the format name and format version. If these are present on the most confident output, their
+values will also be part of the result info.
+
+Unidentified files will be listed with MIME-type 'application/octet-stream' and PUID 'fmt/unknown'.
+
+The main method #get that performs the format identification takes two parameters:
+- file: can be a string representing a file or directory path, but also an array of file paths.
+- options: optional hash with parameters that influence the behaviour of the format identification process
+
+The options has accespts the following keys (Symbol types):
+- :droid
+  Boolean if set to false will not use the Droid tool. Default: true
+- :fido
+  Boolean if set to false will not use the Fido tool. Default: true
+- :file
+  Boolean if set to false will not use the Unix file tool. Default: true
+- :tool
+  Symbol either :droid, :fido or :file. A shortcut option for setting only the given value to true.
+- :xml_validation
+  Boolean if set to false will not perform XML validation (see below)
+- :recursive
+  Boolean if set to true and a directory is passed as first argument, Identifier will parse the
+  directory tree recursively and will process all files found. Default: false
+- :base_dir
+  String. Normally file will be referenced by their absolute path in the results. If a value is
+  supplied for this option, the given path will be stripped from the start of the file references in the
+  result. Default: nil.
+- :keep_output
+  Boolean if set will store the output of each identification tool in the result structure. Default: false
+
+The result of the identification is a Hash with the following keys:
+- :messages
+  a list (Array) of error and warning messages that the Identifier or one of the tools used has generated.
+  Each entry is another Array with the first argument the severity of the message and the second one the
+  message itself.
+- :output
+  optional output of each tool as an Array with an entry per tool and grouped into a Hash by file reference.
+- :formats
+  a Hash with file references as key and the outcome of the identification as value.
+
+The identification outcome is a Hash of key-value pairs for each property returned. Keys are lower-case
+symbols. If the tools gave results that deffer in a significant part, their outcome will be added to a list as
+:alternatives (see example).
+
+#### XML Validation
+
+None of the tools used is able to identify an XML file by its content. In our context this is especially
+annoying for EAD XML files as we want to identify them in order to process them different from the other XML
+files. The Identifier solves this by performing an extra check on files identified as XML files. It will
+validate each XML file against a list of XML schemas and return the matching MIME-type in the result. If the
+Type Database contains an entry for this format, the result will be extended with the information from the
+Type Database.
+
+With the :xml_validation option this behaviour can be turned off, for instance in cases where no EAD files are
+to be expected or no further identification of XML files is needed. Note that if no XML files are present, the
+Identifier will not spend any time on XML validation anyway.
+
+The list of validation schemas can be extended with the class method #add_xml_validation which takes two
+parameters: a MIME-type and the path to an XML schema (XSD). If you want to also assign a fictuous PUID to the
+XML type you should add an entry to your Type Database with the same MIME-type.
+
+### Example
+
+```
+```
+
+```
+{
+    :messages => [
+        [0] [
+            [0] :debug,
+            [1] "XML file validated against XML Schema: [...]/data/ead.xsd"
+        ],
+        [1] [
+            [0] :debug,
+            [1] "XML file validated against XML Schema: [...]/data/ead.xsd"
+        ],
+        [2] [
+            [0] :debug,
+            [1] "XML file validated against XML Schema: [...]/data/ead.xsd"
+        ]
+    ],
+    :output => {
+        "[...]/data/Cevennes2.bmp" => [
+            [0] {
+                     :matchtype => "signature",
+                  :ext_mismatch => "false",
+                          :puid => "fmt/116",
+                      :mimetype => "image/bmp",
+                   :format_name => "Windows Bitmap",
+                :format_version => "3.0",
+                        :source => :droid,
+                          :TYPE => :BMP,
+                         :GROUP => :IMAGE,
+                         :score => 7
+            },
+            [1] {
+                          :puid => "fmt/116",
+                   :format_name => "Windows Bitmap",
+                :format_version => "Windows Bitmap 3.0",
+                      :mimetype => "image/bmp",
+                     :matchtype => "signature",
+                        :source => :fido,
+                          :TYPE => :BMP,
+                         :GROUP => :IMAGE,
+                         :score => 7
+            },
+            [2] {
+                 :mimetype => "image/bmp",
+                :matchtype => "magic",
+                   :source => :file,
+                     :TYPE => :BMP,
+                    :GROUP => :IMAGE,
+                    :score => 2
+            }
+        ],
+        "[...]/data/Cevennes2.jp2" => [
+            [0] {
+                     :matchtype => "signature",
+                  :ext_mismatch => "false",
+                          :puid => "x-fmt/392",
+                      :mimetype => "image/jp2",
+                   :format_name => "JP2 (JPEG 2000 part 1)",
+                :format_version => "",
+                        :source => :droid,
+                          :TYPE => :JP2,
+                         :GROUP => :IMAGE,
+                         :score => 7
+            },
+            [1] {
+                          :puid => "x-fmt/392",
+                   :format_name => "JP2 (JPEG 2000 part 1)",
+                :format_version => "JPEG2000",
+                      :mimetype => "image/jp2",
+                     :matchtype => "signature",
+                        :source => :fido,
+                          :TYPE => :JP2,
+                         :GROUP => :IMAGE,
+                         :score => 7
+            },
+            [2] {
+                 :mimetype => "image/jp2",
+                :matchtype => "magic",
+                   :source => :file,
+                     :TYPE => :JP2,
+                    :GROUP => :IMAGE,
+                    :score => 2
+            }
+        ],
+        [...]
+     },
+     :formats => {
+        "[...]/data/Cevennes2.bmp" => {
+                 :matchtype => "signature",
+              :ext_mismatch => "false",
+                      :puid => "fmt/116",
+                  :mimetype => "image/bmp",
+               :format_name => "Windows Bitmap",
+            :format_version => "3.0",
+                    :source => :droid,
+                      :TYPE => :BMP,
+                     :GROUP => :IMAGE,
+                     :score => 7
+        },
+        "[...]/data/Cevennes2.jp2" => {
+                 :matchtype => "signature",
+              :ext_mismatch => "false",
+                      :puid => "x-fmt/392",
+                  :mimetype => "image/jp2",
+               :format_name => "JP2 (JPEG 2000 part 1)",
+            :format_version => "JPEG2000",
+                    :source => :droid,
+                      :TYPE => :JP2,
+                     :GROUP => :IMAGE,
+                     :score => 7
+        },
+        "[...]/data/NikonRaw-CameraRaw.TIF" => {
+                 :matchtype => "signature",
+              :ext_mismatch => "false",
+                      :puid => "fmt/353",
+                  :mimetype => "image/tiff",
+               :format_name => "Tagged Image File Format",
+            :format_version => "TIFF generic (little-endian)",
+                    :source => :droid,
+                      :TYPE => :TIFF,
+                     :GROUP => :IMAGE,
+                     :score => 7
+        },
+        "[...]/data/NikonRaw-CaptureOne.tif" => {
+                 :matchtype => "signature",
+              :ext_mismatch => "false",
+                      :puid => "x-fmt/387",
+                  :mimetype => "image/tiff",
+               :format_name => "Exchangeable Image File Format (Uncompressed)",
+            :format_version => "2.2",
+                    :source => :droid,
+                      :TYPE => :TIFF,
+                     :GROUP => :IMAGE,
+                     :score => 7,
+              :alternatives => [
+                [0] {
+                              :puid => "fmt/353",
+                       :format_name => "Tagged Image File Format",
+                    :format_version => "TIFF generic (little-endian)",
+                          :mimetype => "image/tiff",
+                         :matchtype => "signature",
+                            :source => :fido,
+                              :TYPE => :TIFF,
+                             :GROUP => :IMAGE,
+                             :score => 7
+                },
+                [1] {
+                         :matchtype => "signature",
+                      :ext_mismatch => "false",
+                              :puid => "x-fmt/387",
+                          :mimetype => "image/tiff",
+                       :format_name => "Exchangeable Image File Format (Uncompressed)",
+                    :format_version => "2.2",
+                            :source => :droid,
+                              :TYPE => :TIFF,
+                             :GROUP => :IMAGE,
+                             :score => 7
+                }
+            ]
+        },
+        "[...]/data/test-ead.xml" => {
+                 :matchtype => "signature",
+              :ext_mismatch => "false",
+                      :puid => "fmt/101",
+                  :mimetype => "archive/ead",
+               :format_name => "Encoded Archival Description (EAD)",
+            :format_version => "",
+                    :source => :xsd_validation,
+                      :TYPE => :EAD,
+                     :GROUP => :ARCHIVE,
+                     :score => 7,
+                      :tool => :droid,
+                :match_type => "xsd_validation"
+        },
+        "[...]/data/test.doc" => {
+                 :matchtype => "container",
+              :ext_mismatch => "false",
+                      :puid => "fmt/40",
+                  :mimetype => "application/msword",
+               :format_name => "Microsoft Word Document",
+            :format_version => "97-2003",
+                    :source => :droid,
+                      :TYPE => :MSDOC,
+                     :GROUP => :TEXT,
+                     :score => 9,
+              :alternatives => [
+                [0] {
+                         :matchtype => "container",
+                      :ext_mismatch => "false",
+                              :puid => "fmt/40",
+                          :mimetype => "application/msword",
+                       :format_name => "Microsoft Word Document",
+                    :format_version => "97-2003",
+                            :source => :droid,
+                              :TYPE => :MSDOC,
+                             :GROUP => :TEXT,
+                             :score => 9
+                },
+                [1] {
+                              :puid => "fmt/111",
+                       :format_name => "OLE2 Compound Document Format",
+                    :format_version => "OLE2 Compound Document Format",
+                          :mimetype => nil,
+                         :matchtype => "signature",
+                            :source => :fido,
+                             :score => 3
+                }
+            ]
+        },
+        "[...]/data/test.docx" => {
+                 :matchtype => "container",
+              :ext_mismatch => "false",
+                      :puid => "fmt/412",
+                  :mimetype => "application/vnd.openxmlformats-officedocument.wordprocessingml.document",
+               :format_name => "Microsoft Word for Windows",
+            :format_version => "2007 onwards",
+                    :source => :droid,
+                      :TYPE => :MSDOCX,
+                     :GROUP => :TEXT,
+                     :score => 9
+        },
+        "[...]/data/test.xlsx" => {
+                 :matchtype => "container",
+              :ext_mismatch => "false",
+                      :puid => "fmt/214",
+                  :mimetype => "application/vnd.openxmlformats-officedocument.spreadsheetml.sheet",
+               :format_name => "Microsoft Excel for Windows",
+            :format_version => "2007 onwards",
+                    :source => :droid,
+                      :TYPE => :MSXLSX,
+                     :GROUP => :TABULAR,
+                     :score => 9,
+              :alternatives => [
+                [0] {
+                         :matchtype => "container",
+                      :ext_mismatch => "false",
+                              :puid => "fmt/214",
+                          :mimetype => "application/vnd.openxmlformats-officedocument.spreadsheetml.sheet",
+                       :format_name => "Microsoft Excel for Windows",
+                    :format_version => "2007 onwards",
+                            :source => :droid,
+                              :TYPE => :MSXLSX,
+                             :GROUP => :TABULAR,
+                             :score => 9
+                },
+                [1] {
+                     :mimetype => "application/octet-stream",
+                    :matchtype => "magic",
+                       :source => :file,
+                        :score => -2
+                }
+            ]
+        },
+        "[...]/data/test_pdfa.pdf" => {
+                 :matchtype => "signature",
+              :ext_mismatch => "false",
+                      :puid => "fmt/354",
+                  :mimetype => "application/pdf",
+               :format_name => "Acrobat PDF/A - Portable Document Format",
+            :format_version => "1b",
+                    :source => :droid,
+                      :TYPE => :PDFA,
+                     :GROUP => :TEXT,
+                     :score => 7,
+              :alternatives => [
+                [0] {
+                              :puid => "fmt/19",
+                       :format_name => "Acrobat PDF 1.5 - Portable Document Format",
+                    :format_version => "PDF 1.5",
+                          :mimetype => "application/pdf",
+                         :matchtype => "signature",
+                            :source => :fido,
+                              :TYPE => :PDF,
+                             :GROUP => :TEXT,
+                             :score => 7
+                },
+                [1] {
+                         :matchtype => "signature",
+                      :ext_mismatch => "false",
+                              :puid => "fmt/354",
+                          :mimetype => "application/pdf",
+                       :format_name => "Acrobat PDF/A - Portable Document Format",
+                    :format_version => "1b",
+                            :source => :droid,
+                              :TYPE => :PDFA,
+                             :GROUP => :TEXT,
+                             :score => 7
+                }
+            ]
+        }
+    }
+}
+```
 ## Contributing
 
 1. Fork it ( https://github.com/Kris-LIBIS/LIBIS_Format/fork )

data/bin/droid

@@ -5,7 +5,7 @@ require 'libis-tools'
 
 ::Libis::Tools::Config.logger.level = :WARN
 
-result = ::Libis::Format::Droid.run ARGV[0]
+result = ::Libis::Format::Tool::Droid.run ARGV[0]
 
 result.each do |r|
   r.each do |key, value|

data/bin/fido

@@ -5,7 +5,7 @@ require 'libis-tools'
 
 ::Libis::Tools::Config.logger.level = :WARN
 
-result = ::Libis::Format::Fido.run ARGV[0]
+result = ::Libis::Format::Tool::Fido.run ARGV[0]
 
 result.each do |key, value|
   puts "#{key}: #{value}"

data/bin/pdf_copy

@@ -9,5 +9,5 @@ source = ARGV.shift
 target = ARGV.shift
 options = ARGV
 
-::Libis::Format::PdfCopy.run source, target, options
+::Libis::Format::Tool::PdfCopy.run source, target, options
 

data/lib/libis/format/config.rb

@@ -22,6 +22,7 @@ module Libis
     Config[:xml_validations] = [['archive/ead', File.join(data_dir, 'ead.xsd')]]
     Config[:type_database] = File.join(data_dir, 'types.yml')
     Config[:raw_audio_convert_cmd] = 'sox %s -e signed -b 16 -t wav %s rate %d channels %d'
+    Config[:watermark_font] = '/usr/share/fonts/truetype/liberation/LiberationSans-Regular.ttf'
 
   end
 end

data/lib/libis/format/converter/audio_converter.rb

@@ -168,7 +168,7 @@ module Libis
           opts[:output] << '-ar' << @options[:sampling_freq] if @options[:sampling_freq]
           opts[:output] << '-ac' << @options[:channels] if @options[:channels]
           opts[:output] << '-f' << @options[:format] if @options[:format]
-          result = Libis::Format::FFMpeg.run(source, target, opts)
+          result = Libis::Format::Tool::FFMpeg.run(source, target, opts)
           info "FFMpeg output: #{result}"
           result
           target

data/lib/libis/format/converter/base.rb

@@ -3,6 +3,7 @@
 ### require 'tools/string'
 require 'tmpdir'
 require 'libis/tools/logger'
+require 'libis/tools/temp_file'
 require 'libis/format/type_database'
 
 require_relative 'repository'
@@ -43,7 +44,7 @@ module Libis
         end
 
         def Base.using_temp(target)
-          tempfile = File.join(Dir.tmpdir, Dir::Tmpname.make_tmpname(['convert', File.extname(target)], File.basename(target, '.*').gsub(/\s/, '_')))
+          tempfile = Tools::TempFile.name("convert-#{File.basename(target, '.*').gsub(/\s/, '_')}", File.extname(target))
           result = yield tempfile
           return nil unless result
           FileUtils.move result, target

data/lib/libis/format/converter/office_converter.rb

@@ -2,7 +2,7 @@
 
 require_relative 'base'
 
-require 'libis/format/office_to_pdf'
+require 'libis/format/tool/office_to_pdf'
 require 'libis/format/type_database'
 
 module Libis
@@ -38,7 +38,7 @@ module Libis
         def convert(source, target, format, opts = {})
           super
 
-          return nil unless OfficeToPdf.run(source, target)
+          return nil unless Format::Tool::OfficeToPdf.run(source, target)
 
           target
 

data/lib/libis/format/converter/pdf_converter.rb

@@ -3,9 +3,9 @@
 require_relative 'base'
 
 require 'libis/tools/extend/hash'
-require 'libis/format/pdf_copy'
-require 'libis/format/pdf_to_pdfa'
-require 'libis/format/pdf_optimizer'
+require 'libis/format/tool/pdf_copy'
+require 'libis/format/tool/pdf_to_pdfa'
+require 'libis/format/tool/pdf_optimizer'
 
 module Libis
   module Format
@@ -126,7 +126,7 @@ module Libis
         def optimize_pdf(source, target, quality)
 
           using_temp(target) do |tmpname|
-            result = Libis::Format::PdfOptimizer.run(source, tmpname, quality)
+            result = Libis::Format::Tool::PdfOptimizer.run(source, tmpname, quality)
             unless result[:status] == 0
               error("Pdf optimization encountered errors:\n%s", (result[:err] + result[:out]).join('\n'))
               next nil
@@ -138,7 +138,7 @@ module Libis
         def convert_pdf(source, target)
 
           using_temp(target) do |tmpname|
-            result = Libis::Format::PdfCopy.run(
+            result = Libis::Format::Tool::PdfCopy.run(
                 source, tmpname,
                 @options.map { |k, v|
                   if v.nil?
@@ -159,7 +159,7 @@ module Libis
         def pdf_to_pdfa(source, target)
 
           using_temp(target) do |tmpname|
-            result = Libis::Format::PdfToPdfa.run source, tmpname
+            result = Libis::Format::Tool::PdfToPdfa.run source, tmpname
             unless result[:status] == 0
               error("Pdf/A conversion encountered errors:\n%s", result[:err].join('\n'))
               next nil

data/lib/libis/format/converter/video_converter.rb

@@ -1,5 +1,5 @@
 require_relative 'base'
-require 'libis/format/ffmpeg'
+require 'libis/format/tool/ffmpeg'
 
 require 'fileutils'
 
@@ -82,6 +82,49 @@ module Libis
           @options[:scale] = width_x_height
         end
 
+        # @param [String] file Image file path to use as watermark
+        def watermark_image(file)
+          @options[:watermark_image] = file
+        end
+
+        # @param [String] value text for watermark. No watermark if nil (default)
+        def watermark_text(value)
+          @options[:watermark_text] = value
+        end
+
+        # @param [Integer] value Font size for watermark text. Default: 10
+        # Note that the font is selected by the Config[:watermark_font] setting
+        def watermark_text_size(value)
+          @options[:watermark_text_size] = value.to_i
+        end
+
+        # @param [String] value Text color for the watermark text. Default: white
+        def watermark_text_color(value)
+          @options[:watermark_text_color] = value
+        end
+
+        # @param [String] value Text color for the watermark text shadow. Default: black
+        def watermark_text_shadow_color(value)
+          @options[:watermark_text_shadow_color] = value
+        end
+
+        # @param [Integer] value Offset of the watermark text shadow. Used for both x and y offset; default: 1
+        # If the offset is set to 0, no shadow will be printed
+        def watermark_text_shadow_offset(value)
+          @options[:watermark_text_offset] = value.to_i
+        end
+
+        # @param [String] value one of 'bottom_left' (default), 'top_left', 'bottom_right', 'top_right', 'center'
+        def watermark_position(value)
+          @options[:watermark_position] = value
+        end
+
+        # @param [Number] value watermark opacity (0-1) with 0 = invisible and 1 = 100% opaque. Default: 0.5
+        def watermark_opacity(value)
+          @options[:watermark_opacity] = value.to_f
+        end
+
+        # @param [Boolean] value If set to true automatically selects optimal format for web viewing. Default: false
         def web_stream(value)
           if value
             @options[:video_codec] = 'h264'
@@ -89,14 +132,17 @@ module Libis
           end
         end
 
+        # @param [String] name name of a preset. See FFMpeg documentation for more info
         def preset(name)
           @options[:preset] = name
         end
 
+        # @param [String] name name of an audio preset. See FFMpeg documentation for more info
         def audio_preset(name)
           @options[:audio_preset] = name
         end
 
+        # @param [String] name name of a video preset. See FFMpeg documentation for more info
         def video_preset(name)
           @options[:video_preset] = name
         end
@@ -163,6 +209,36 @@ module Libis
           opts = {global: [], input: [], filter: [], output: []}
           opts[:global] << '-hide_banner'
           opts[:global] << '-loglevel' << (@options[:quiet] ? 'fatal' : 'warning')
+
+          # Watermark info
+          @options[:watermark_opacity] ||= 0.5
+          if @options[:watermark_image]
+            opts[:filter] << '-i' << @options[:watermark_image] << '-filter_complex'
+            opts[:filter] << "[1:v]format=argb,colorchannelmixer=aa=%f[wm];[0:v][wm]overlay=%s" %
+                [@options[:watermark_opacity], watermark_position_text]
+          elsif @options[:watermark_text]
+            @options[:watermark_text_size] ||= 10
+            @options[:watermark_text_color] ||= 'white'
+            @options[:watermark_text_shadow_color] ||= 'black'
+            @options[:watermark_text_shadow_offset] ||= 1
+            filter_text = "drawtext=text='%s':%s:fontfile=%s:fontsize=%d:fontcolor=%s@%f" %
+                [
+                    @options[:watermark_text],
+                    watermark_position_text(true),
+                    Config[:watermark_font],
+                    @options[:watermark_text_size],
+                    @options[:watermark_text_color],
+                    @options[:watermark_opacity]
+                ]
+            filter_text += ':shadowcolor=%s@%f:shadowx=%d:shadowy=%d' %
+                [
+                    @options[:watermark_text_shadow_color],
+                    @options[:watermark_opacity],
+                    @options[:watermark_text_shadow_offset],
+                    @options[:watermark_text_shadow_offset]
+                ] if @options[:watermark_text_shadow_offset] > 0
+            opts[:filter] << '-vf' << filter_text
+          end
           opts[:output] << '-ac' << @options[:audio_channels] if @options[:audio_channels]
           opts[:output] << '-c:a' << @options[:audio_codec] if @options[:audio_codec]
           opts[:output] << '-c:v' << @options[:video_codec] if @options[:video_codec]
@@ -188,11 +264,29 @@ module Libis
           opts[:output] << '-pre' << @options[:preset] if @options[:preset]
           opts[:output] << '-apre' << @options[:audio_preset] if @options[:audio_preset]
           opts[:output] << '-vpre' << @options[:video_preset] if @options[:video_preset]
-          result = Libis::Format::FFMpeg.run(source, target, opts)
+          info "FFMpeg options: #{opts}"
+          result = Libis::Format::Tool::FFMpeg.run(source, target, opts)
           info "FFMpeg output: #{result}"
           target
         end
 
+        def watermark_position_text(for_text = false, margin = 10)
+          w = for_text ? 'tw' : 'w'
+          h = for_text ? 'th' : 'h'
+          case @options[:watermark_position]
+            when 'bottom_left'
+              "x=#{margin}:y=H-#{h}-#{margin}"
+            when 'top_left'
+              "x=#{margin}:y=#{margin}"
+            when 'bottom_right'
+              "x=W-#{w}-#{margin}:y=H-#{h}-#{margin}"
+            when 'top_right'
+              "x=W-#{w}-#{margin}:y=#{margin}"
+            else
+              "x=#{margin}:y=H-#{h}-#{margin}"
+          end
+        end
+
       end
 
     end