README.md in hydra-derivatives-3.2.2 vs README.md in hydra-derivatives-3.3.0
- old
+ new
@@ -50,10 +50,12 @@
Then when you call `obj.create_derivatives` two new files, 'thumbnail' and 'content_medium', will have been created with downsized images in them.
We recommend you run `obj.create_derivatives` in a background worker, because some derivative creation (especially videos) can take a long time.
+The ActiveEncode runner provides support for using external video transcoding services like Amazon Elastic Transcoder. See [ActiveEncode](https://github.com/samvera-labs/active_encode) for details on specific adapters supported.
+
## Configuration
### Retrieving from a basic container in Fedora
Provide the object and `:source` option instead of a filename
@@ -72,10 +74,11 @@
Hydra::Derivatives::Processors::Video::Processor.timeout = 10.minutes
Hydra::Derivatives::Processors::Document.timeout = 5.minutes
Hydra::Derivatives::Processors::Audio.timeout = 10.minutes
Hydra::Derivatives::Processors::Image.timeout = 5.minutes
+Hydra::Derivatives::Processors::ActiveEncode.timeout = 5.minutes
```
### Video Processing configuration
@@ -85,9 +88,31 @@
Hydra::Derivatives::Processors::Video::Processor.config.mpeg4.codec = '-vcodec libx264 -acodec libfdk_aac'
Hydra::Derivatives::Processors::Video::Processor.config.webm.codec = '-vcodec libvpx -acodec libvorbis'
Hydra::Derivatives::Processors::Video::Processor.config.mkv.codec = '-vcodec ffv1'
Hydra::Derivatives::Processors::Video::Processor.config.jpeg.codec = '-vcodec mjpeg'
```
+
+### Configuration for Audio/Video Processing with ActiveEncode
+
+```ruby
+# Set the transcoding engine
+ActiveEncode::Base.engine_adapter = :elastic_transcoder
+
+# Sleep time (in seconds) to poll for status of encoding job
+Hydra::Derivatives.active_encode_poll_time = 10
+
+# If you want to use a different class for the source file service
+Hydra::Derivatives::ActiveEncodeDerivatives.source_file_service = MyCustomSourceFileService
+
+# If you want to use a different class for the output file service
+Hydra::Derivatives::ActiveEncodeDerivatives.output_file_service = MyCustomOutputFileService
+```
+
+Note: Please don't confuse these methods with the similar methods in the parent class:
+`Hydra::Derivatives.source_file_service` and `Hydra::Derivatives.output_file_service`
+
+For additional documentation on using ActiveEncode, see:
+* [Using Amazon Elastic Transcoder](doc/amazon_elastic_transcoder.md)
### Additional Directives
#### Layers