213 lines
		
	
	
		
			7.7 KiB
		
	
	
	
		
			HTML
		
	
	
	
			
		
		
	
	
			213 lines
		
	
	
		
			7.7 KiB
		
	
	
	
		
			HTML
		
	
	
	
<!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>
 |