123456789101112131415161718192021222324252627282930313233343536373839404142434445464748495051525354555657585960616263646566676869707172737475767778798081828384858687888990919293949596979899100101102103104105106107108109110111112113114115116117118119120121122123124125126127128129130131132133134135136137138139140141142143144145146147148149150151152153154155156157158159160161162163164165166167168169170171172173174175176177178179180181182183184185186187188189190191192193194195196197198199200201202203204205206207208209210211212 |
- <!DOCTYPE html>
- <html lang="en">
- <head>
- <meta charset="utf-8">
- <title>JSDoc: Source: options/output.js</title>
- <script src="scripts/prettify/prettify.js"> </script>
- <script src="scripts/prettify/lang-css.js"> </script>
- <!--[if lt IE 9]>
- <script src="//html5shiv.googlecode.com/svn/trunk/html5.js"></script>
- <![endif]-->
- <link type="text/css" rel="stylesheet" href="styles/prettify-tomorrow.css">
- <link type="text/css" rel="stylesheet" href="styles/jsdoc-default.css">
- </head>
- <body>
- <div id="main">
- <h1 class="page-title">Source: options/output.js</h1>
-
-
- <section>
- <article>
- <pre class="prettyprint source linenums"><code>/*jshint node:true*/
- 'use strict';
- var utils = require('../utils');
- /*
- *! Output-related methods
- */
- module.exports = function(proto) {
- /**
- * Add output
- *
- * @method FfmpegCommand#output
- * @category Output
- * @aliases addOutput
- *
- * @param {String|Writable} target target file path or writable stream
- * @param {Object} [pipeopts={}] pipe options (only applies to streams)
- * @return FfmpegCommand
- */
- proto.addOutput =
- proto.output = function(target, pipeopts) {
- var isFile = false;
- if (!target && this._currentOutput) {
- // No target is only allowed when called from constructor
- throw new Error('Invalid output');
- }
- if (target && typeof target !== 'string') {
- if (!('writable' in target) || !(target.writable)) {
- throw new Error('Invalid output');
- }
- } else if (typeof target === 'string') {
- var protocol = target.match(/^([a-z]{2,}):/i);
- isFile = !protocol || protocol[0] === 'file';
- }
- if (target && !('target' in this._currentOutput)) {
- // For backwards compatibility, set target for first output
- this._currentOutput.target = target;
- this._currentOutput.isFile = isFile;
- this._currentOutput.pipeopts = pipeopts || {};
- } else {
- if (target && typeof target !== 'string') {
- var hasOutputStream = this._outputs.some(function(output) {
- return typeof output.target !== 'string';
- });
- if (hasOutputStream) {
- throw new Error('Only one output stream is supported');
- }
- }
- this._outputs.push(this._currentOutput = {
- target: target,
- isFile: isFile,
- flags: {},
- pipeopts: pipeopts || {}
- });
- var self = this;
- ['audio', 'audioFilters', 'video', 'videoFilters', 'sizeFilters', 'options'].forEach(function(key) {
- self._currentOutput[key] = utils.args();
- });
- if (!target) {
- // Call from constructor: remove target key
- delete this._currentOutput.target;
- }
- }
- return this;
- };
- /**
- * Specify output seek time
- *
- * @method FfmpegCommand#seek
- * @category Input
- * @aliases seekOutput
- *
- * @param {String|Number} seek seek time in seconds or as a '[hh:[mm:]]ss[.xxx]' string
- * @return FfmpegCommand
- */
- proto.seekOutput =
- proto.seek = function(seek) {
- this._currentOutput.options('-ss', seek);
- return this;
- };
- /**
- * Set output duration
- *
- * @method FfmpegCommand#duration
- * @category Output
- * @aliases withDuration,setDuration
- *
- * @param {String|Number} duration duration in seconds or as a '[[hh:]mm:]ss[.xxx]' string
- * @return FfmpegCommand
- */
- proto.withDuration =
- proto.setDuration =
- proto.duration = function(duration) {
- this._currentOutput.options('-t', duration);
- return this;
- };
- /**
- * Set output format
- *
- * @method FfmpegCommand#format
- * @category Output
- * @aliases toFormat,withOutputFormat,outputFormat
- *
- * @param {String} format output format name
- * @return FfmpegCommand
- */
- proto.toFormat =
- proto.withOutputFormat =
- proto.outputFormat =
- proto.format = function(format) {
- this._currentOutput.options('-f', format);
- return this;
- };
- /**
- * Add stream mapping to output
- *
- * @method FfmpegCommand#map
- * @category Output
- *
- * @param {String} spec stream specification string, with optional square brackets
- * @return FfmpegCommand
- */
- proto.map = function(spec) {
- this._currentOutput.options('-map', spec.replace(utils.streamRegexp, '[$1]'));
- return this;
- };
- /**
- * Run flvtool2/flvmeta on output
- *
- * @method FfmpegCommand#flvmeta
- * @category Output
- * @aliases updateFlvMetadata
- *
- * @return FfmpegCommand
- */
- proto.updateFlvMetadata =
- proto.flvmeta = function() {
- this._currentOutput.flags.flvmeta = true;
- return this;
- };
- };
- </code></pre>
- </article>
- </section>
- </div>
- <nav>
- <h2><a href="index.html">Index</a></h2><ul><li><a href="index.html#installation">Installation</a></li><ul></ul><li><a href="index.html#usage">Usage</a></li><ul><li><a href="index.html#prerequisites">Prerequisites</a></li><li><a href="index.html#creating-an-ffmpeg-command">Creating an FFmpeg command</a></li><li><a href="index.html#specifying-inputs">Specifying inputs</a></li><li><a href="index.html#input-options">Input options</a></li><li><a href="index.html#audio-options">Audio options</a></li><li><a href="index.html#video-options">Video options</a></li><li><a href="index.html#video-frame-size-options">Video frame size options</a></li><li><a href="index.html#specifying-multiple-outputs">Specifying multiple outputs</a></li><li><a href="index.html#output-options">Output options</a></li><li><a href="index.html#miscellaneous-options">Miscellaneous options</a></li><li><a href="index.html#setting-event-handlers">Setting event handlers</a></li><li><a href="index.html#starting-ffmpeg-processing">Starting FFmpeg processing</a></li><li><a href="index.html#controlling-the-ffmpeg-process">Controlling the FFmpeg process</a></li><li><a href="index.html#reading-video-metadata">Reading video metadata</a></li><li><a href="index.html#querying-ffmpeg-capabilities">Querying ffmpeg capabilities</a></li><li><a href="index.html#cloning-an-ffmpegcommand">Cloning an FfmpegCommand</a></li></ul><li><a href="index.html#contributing">Contributing</a></li><ul><li><a href="index.html#code-contributions">Code contributions</a></li><li><a href="index.html#documentation-contributions">Documentation contributions</a></li><li><a href="index.html#updating-the-documentation">Updating the documentation</a></li><li><a href="index.html#running-tests">Running tests</a></li></ul><li><a href="index.html#main-contributors">Main contributors</a></li><ul></ul><li><a href="index.html#license">License</a></li><ul></ul></ul><h3>Classes</h3><ul><li><a href="FfmpegCommand.html">FfmpegCommand</a></li><ul><li> <a href="FfmpegCommand.html#audio-methods">Audio methods</a></li><li> <a href="FfmpegCommand.html#capabilities-methods">Capabilities methods</a></li><li> <a href="FfmpegCommand.html#custom-options-methods">Custom options methods</a></li><li> <a href="FfmpegCommand.html#input-methods">Input methods</a></li><li> <a href="FfmpegCommand.html#metadata-methods">Metadata methods</a></li><li> <a href="FfmpegCommand.html#miscellaneous-methods">Miscellaneous methods</a></li><li> <a href="FfmpegCommand.html#other-methods">Other methods</a></li><li> <a href="FfmpegCommand.html#output-methods">Output methods</a></li><li> <a href="FfmpegCommand.html#processing-methods">Processing methods</a></li><li> <a href="FfmpegCommand.html#video-methods">Video methods</a></li><li> <a href="FfmpegCommand.html#video-size-methods">Video size methods</a></li></ul></ul>
- </nav>
- <br clear="both">
- <footer>
- Documentation generated by <a href="https://github.com/jsdoc3/jsdoc">JSDoc 3.4.0</a> on Sun May 01 2016 12:10:37 GMT+0200 (CEST)
- </footer>
- <script> prettyPrint(); </script>
- <script src="scripts/linenumber.js"> </script>
- </body>
- </html>
|