From 47081726a92f1170a473b314e36e81e4cd9b8d46 Mon Sep 17 00:00:00 2001 From: Erik Rothoff Andersson Date: Thu, 4 Feb 2016 08:57:48 +0100 Subject: [PATCH 1/2] Show convert_options in README --- README.md | 24 +++++++++++++++++++++++- 1 file changed, 23 insertions(+), 1 deletion(-) diff --git a/README.md b/README.md index eda9480..062fb1e 100644 --- a/README.md +++ b/README.md @@ -45,13 +45,35 @@ This will produce: You may optionally add `_meta` to your model and it will get populated with information about the processed video. -The geometry parameters are: +### `geometry` + +The `geometry` option has the following available modifiers: 1. '!' - Keep the same aspect of the image/video, but with the passed dimesion. 2. '#' - Pad the image/video. 3. '<' - Enlarge the image/video. 4. '>' - Shrink the image/video. +### `convert_options` + +The `convert_options` option lets you specify custom command line options to be sent to the `ffmpeg` command. The options are split into `output` and `input`, which define where in the pipeline they will be applied. Read more about which flags go where on the [official documentation](https://ffmpeg.org/ffmpeg.html). + +For example, sending in the `-an` flag would look like this: + +```ruby +has_attached_file :video, styles: { + mobile: { + format: "mp4", + convert_options: { + output: { + an: nil # Remove audio track resulting in a silent movie, passing in nil results in `-an`, + name: "value" # Results in `-name value` in the command line + } + } + }, +} +``` + ## Contributing 1. Fork it ( https://github.com/ruby-av/paperclip-av-transcoder/fork ) From 4aec85e791ad1a62ea04dcef50d9b1bc10059736 Mon Sep 17 00:00:00 2001 From: Jeremy Clemans Date: Thu, 21 Apr 2016 21:10:04 -0700 Subject: [PATCH 2/2] Adds more detailed instructions on how to get file meta data --- README.md | 12 +++++++++++- 1 file changed, 11 insertions(+), 1 deletion(-) diff --git a/README.md b/README.md index 062fb1e..6a2673c 100644 --- a/README.md +++ b/README.md @@ -43,7 +43,17 @@ This will produce: 1. A transcoded `:medium` FLV file with the requested dimensions if they will match the aspect ratio of the original file, otherwise, width will be maintained and height will be recalculated to keep the original aspect ration. 2. A screenshot `:thumb` with the requested dimensions regardless of the aspect ratio. -You may optionally add `_meta` to your model and it will get populated with information about the processed video. +### Meta Data + +Then paperclip-av-transcoder can optionally add uploaded file meta data to a database column for `_meta`. + +Example: Given a model called `User` with an attachment field named `:avatar`, create a new migration to add an `avatar_meta` column to the `users` table. +``` +def change + add_column :users, :avatar_meta, :data_type +end +``` +You can use a data type of `:json`, `:jsonb`, `:hstore` or even just `:string`. Check what data types your database supports. ### `geometry`