Producer Plugin

avformat

---
schema_version: 0.1
type: producer
identifier: avformat
title: FFmpeg Reader
version: 1
copyright: Copyright (C) 2003-2011 Ushodaya Enterprises Limited
license: LGPL
language: en
url: http://www.ffmpeg.org/
creator: Charles Yates
contributor:
  - Dan Dennedy
tags:
  - Audio
  - Video
description: Read an audio and/or video file using FFmpeg
bugs:
  - Audio sync discrepancy with some content.
  - Not all libavformat supported formats are seekable.
  - Seeking is not always accurate. Sometimes it doesn't seek to I-frames so you may get junk for a few frames.
  - More than 2 channels of audio more than 16 bits is not supported.
parameters:
  - identifier: argument
    title: File/URL
    type: string
    description: |
                 A file name specification or URL in the form:
                 [{protocol}|{format}]:{resource}[?{format-parameter}[&{format-parameter}...]]
                 For example, video4linux2:/dev/video1?width=320&height=240
                 Note: on the bash command line, & must be escaped as '\&'.
                 Use 'f-list' to see a list of supported file formats.
                 Use 'vcodec-list' to see a list of supported video decoders.
                 Use 'acodec-list' to see a list of supported audio decoders.
    readonly: no
    required: yes
    mutable: no
    widget: fileopen
  - identifier: audio_index
    title: Audio index
    type: integer
    description: Choose the index of audio stream to use (-1 is off). When this value is equal to the maximum size of a 32-bit signed integer or the string "all" then all audio tracks are coalesced into a bundle of channels on one audio track.
    readonly: no
    mutable: no
    minimum: -1
    default: 0
    widget: spinner
  - identifier: video_index
    title: Video index
    type: integer
    description: Choose the index of video stream to use (-1 is off)
    readonly: no
    mutable: no
    minimum: -1
    default: 0
    widget: spinner
  - identifier: video_delay
    title: Video delay
    description: Manually adjust A/V synchronization. A negative value advances the video instead of delaying it.
    type: float
    default: 0
    unit: seconds
    widget: timecode
  - identifier: force_aspect_ratio
    title: Sample aspect ratio
    type: float
    description: Optionally override a (mis)detected aspect ratio
    readonly: no
    mutable: yes
    minimum: 0.001
    maximum: 9.999
  - identifier: source_fps
    title: Frame rate
    type: float
    scale: 2
    description: the framerate of the resource
    readonly: yes
    unit: frames/second
  - identifier: seekable
    title: Supports seeking
    description: if the resource can seek
    readonly: yes
  - identifier: width
    title: Width
    type: integer
    unit: pixels
    readonly: yes
  - identifier: height
    title: Height
    type: integer
    unit: pixels
    readonly: yes
  - identifier: noimagecache
    title: Disable image caching
    type: integer
    minimum: 0
    maximum: 0
    default: 0
    widget: checkbox
  - identifier: new_seek
    title: Use new seeking
    description: When this is not provided (recommended), it is enabled only for H.264 in MPEG-2 Transport Streams.
    type: integer
    minimum: 0
    maximum: 1
    widget: checkbox
  - identifier: force_progressive
    title: Force progressive
    description: When provided, this overrides the detection of progressive video.
    type: integer
    minimum: 0
    maximum: 1
    widget: checkbox
  - identifier: force_tff
    title: Force top field first
    description: When provided, this overrides the detected field order of interlaced video.
    type: integer
    minimum: 0
    maximum: 1
    widget: checkbox
  - identifier: force_fps
    title: Force frame rate
    description: When provided, this attempts to override the detected frame rate of the video.
    type: integer
    minimum: 0
    maximum: 1
    widget: checkbox
  - identifier: force_colorspace
    title: Force colorspace
    description: When provided, this overrides the detected colorspace of the video (Y'CbCr only).
    type: integer
    values:
      - 240
      - 601
      - 709
  - identifier: probesize
    description: set probing size
    type: integer
    minimum: 32
    default: 5000000
  - identifier: fflags
    type: string
    format: flags
    values:
      - ignidx
      - genpts
      - nofillin
      - noparse
      - igndts
      - discardcorrupt
      - sortdts
      - keepside
  - identifier: analyzeduration
    description: how many microseconds are analyzed to estimate duration
    type: integer
    minimum: 0
    default: 5000000
  - identifier: indexmem
    description: max memory used for timestamp index (per stream)
    type: integer
    minimum: 0
    default: 1048576
  - identifier: rtbufsize
    description: max memory used for buffering real-time frames
    type: integer
    minimum: 0
    default: 3041280
  - identifier: fdebug
    description: print specific debug info
    type: string
    format: flags
    values:
      - ts
  - identifier: max_delay
    description: maximum muxing or demuxing delay in microseconds
    type: integer
    minimum: 0
    default: 0
  - identifier: fer
    description: set error detection aggressivity
    type: string
    format: integer or keyword
    values:
      - careful
      - explode
  - identifier: fpsprobesize
    description: number of frames used to probe fps
    type: integer
    minimum: -1
    maximum: 2147483646
    default: -1
  - identifier: use_odml
    description: use odml index (avi)
    type: integer
    minimum: -1
    maximum: 1
    default: 1
  - identifier: framerate
    description:  (cavsvideo)
    type: string
    default: 25
  - identifier: framerate
    description:  (dirac)
    type: string
    default: 25
  - identifier: framerate
    description:  (dnxhd)
    type: string
    default: 25
  - identifier: bit_rate
    description:  (g729)
    type: integer
    minimum: 0
    default: 0
  - identifier: sample_rate
    description:  (gsm)
    type: integer
    minimum: 1
    maximum: 65075262
    default: 8000
  - identifier: framerate
    description:  (h261)
    type: string
    default: 25
  - identifier: framerate
    description:  (h263)
    type: string
    default: 25
  - identifier: framerate
    description:  (h264)
    type: string
    default: 25
  - identifier: pixel_format
    description:  (image2)
    type: string
  - identifier: video_size
    description:  (image2)
    type: string
  - identifier: framerate
    description:  (image2)
    type: string
    default: 25
  - identifier: loop
    description:  (image2)
    type: integer
    minimum: 0
    maximum: 1
    default: 0
  - identifier: pixel_format
    description:  (image2pipe)
    type: string
  - identifier: video_size
    description:  (image2pipe)
    type: string
  - identifier: framerate
    description:  (image2pipe)
    type: string
    default: 25
  - identifier: loop
    description:  (image2pipe)
    type: integer
    minimum: 0
    maximum: 1
    default: 0
  - identifier: framerate
    description:  (ingenient)
    type: string
    default: 25
  - identifier: framerate
    description:  (m4v)
    type: string
    default: 25
  - identifier: framerate
    description:  (mjpeg)
    type: string
    default: 25
  - identifier: compute_pcr
    description: Compute exact PCR for each transport stream packet. (mpegtsraw)
    type: integer
    minimum: 0
    maximum: 1
    default: 0
  - identifier: framerate
    description:  (mpegvideo)
    type: string
    default: 25
  - identifier: sample_rate
    description:  (alaw)
    type: integer
    minimum: 0
    default: 0
  - identifier: channels
    description:  (alaw)
    type: integer
    minimum: 0
    default: 0
  - identifier: sample_rate
    description:  (mulaw)
    type: integer
    minimum: 0
    default: 0
  - identifier: channels
    description:  (mulaw)
    type: integer
    minimum: 0
    default: 0
  - identifier: sample_rate
    description:  (f64be)
    type: integer
    minimum: 0
    default: 0
  - identifier: channels
    description:  (f64be)
    type: integer
    minimum: 0
    default: 0
  - identifier: sample_rate
    description:  (f64le)
    type: integer
    minimum: 0
    default: 0
  - identifier: channels
    description:  (f64le)
    type: integer
    minimum: 0
    default: 0
  - identifier: sample_rate
    description:  (f32be)
    type: integer
    minimum: 0
    default: 0
  - identifier: channels
    description:  (f32be)
    type: integer
    minimum: 0
    default: 0
  - identifier: sample_rate
    description:  (f32le)
    type: integer
    minimum: 0
    default: 0
  - identifier: channels
    description:  (f32le)
    type: integer
    minimum: 0
    default: 0
  - identifier: sample_rate
    description:  (s32be)
    type: integer
    minimum: 0
    default: 0
  - identifier: channels
    description:  (s32be)
    type: integer
    minimum: 0
    default: 0
  - identifier: sample_rate
    description:  (s32le)
    type: integer
    minimum: 0
    default: 0
  - identifier: channels
    description:  (s32le)
    type: integer
    minimum: 0
    default: 0
  - identifier: sample_rate
    description:  (s24be)
    type: integer
    minimum: 0
    default: 0
  - identifier: channels
    description:  (s24be)
    type: integer
    minimum: 0
    default: 0
  - identifier: sample_rate
    description:  (s24le)
    type: integer
    minimum: 0
    default: 0
  - identifier: channels
    description:  (s24le)
    type: integer
    minimum: 0
    default: 0
  - identifier: sample_rate
    description:  (s16be)
    type: integer
    minimum: 0
    default: 0
  - identifier: channels
    description:  (s16be)
    type: integer
    minimum: 0
    default: 0
  - identifier: sample_rate
    description:  (s16le)
    type: integer
    minimum: 0
    default: 0
  - identifier: channels
    description:  (s16le)
    type: integer
    minimum: 0
    default: 0
  - identifier: sample_rate
    description:  (s8)
    type: integer
    minimum: 0
    default: 0
  - identifier: channels
    description:  (s8)
    type: integer
    minimum: 0
    default: 0
  - identifier: sample_rate
    description:  (u32be)
    type: integer
    minimum: 0
    default: 0
  - identifier: channels
    description:  (u32be)
    type: integer
    minimum: 0
    default: 0
  - identifier: sample_rate
    description:  (u32le)
    type: integer
    minimum: 0
    default: 0
  - identifier: channels
    description:  (u32le)
    type: integer
    minimum: 0
    default: 0
  - identifier: sample_rate
    description:  (u24be)
    type: integer
    minimum: 0
    default: 0
  - identifier: channels
    description:  (u24be)
    type: integer
    minimum: 0
    default: 0
  - identifier: sample_rate
    description:  (u24le)
    type: integer
    minimum: 0
    default: 0
  - identifier: channels
    description:  (u24le)
    type: integer
    minimum: 0
    default: 0
  - identifier: sample_rate
    description:  (u16be)
    type: integer
    minimum: 0
    default: 0
  - identifier: channels
    description:  (u16be)
    type: integer
    minimum: 0
    default: 0
  - identifier: sample_rate
    description:  (u16le)
    type: integer
    minimum: 0
    default: 0
  - identifier: channels
    description:  (u16le)
    type: integer
    minimum: 0
    default: 0
  - identifier: sample_rate
    description:  (u8)
    type: integer
    minimum: 0
    default: 0
  - identifier: channels
    description:  (u8)
    type: integer
    minimum: 0
    default: 0
  - identifier: video_size
    description: A string describing frame size, such as 640x480 or hd720. (rawvideo)
    type: string
  - identifier: pixel_format
    description:  (rawvideo)
    type: string
    default: yuv420p
  - identifier: framerate
    description:  (rawvideo)
    type: string
    default: 25
  - identifier: rtp_flags
    description: RTP flags (rtp)
    type: string
    format: flags
    values:
      - filter_src
  - identifier: initial_pause
    description: Don't start playing the stream immediately (rtsp)
    type: integer
    minimum: 0
    maximum: 1
    default: 0
  - identifier: rtsp_transport
    description: RTSP transport protocols (rtsp)
    type: string
    format: flags
    values:
      - udp
      - tcp
      - udp_multicast
      - http
  - identifier: rtsp_flags
    description: RTSP flags (rtsp)
    type: string
    format: flags
    values:
      - filter_src
  - identifier: allowed_media_types
    description: Media types to accept from the server (rtsp)
    type: string
    format: flags
    values:
      - video
      - audio
      - data
  - identifier: sdp_flags
    description: SDP flags (sdp)
    type: string
    format: flags
    values:
      - filter_src
  - identifier: allowed_media_types
    description: Media types to accept from the server (sdp)
    type: string
    format: flags
    values:
      - video
      - audio
      - data
  - identifier: chars_per_frame
    description:  (tty)
    type: integer
    minimum: 1
    default: 6000
  - identifier: video_size
    description: A string describing frame size, such as 640x480 or hd720. (tty)
    type: string
  - identifier: framerate
    description:  (tty)
    type: string
    default: 25
  - identifier: framerate
    description:  (vc1)
    type: string
    default: 25
  - identifier: ignore_length
    description: Ignore length (wav)
    type: integer
    minimum: 0
    maximum: 1
    default: 0
  - identifier: sample_rate
    description:  (alsa)
    type: integer
    minimum: 1
    default: 48000
  - identifier: channels
    description:  (alsa)
    type: integer
    minimum: 1
    default: 2
  - identifier: standard
    description:  (dv1394)
    type: string
    format: integer or keyword
    values:
      - PAL
      - NTSC
  - identifier: channel
    description:  (dv1394)
    type: integer
    minimum: 0
    default: 63
  - identifier: framerate
    description:  (fbdev)
    type: string
    default: 25
  - identifier: channels
    description: Number of audio channels. (jack)
    type: integer
    minimum: 1
    default: 2
  - identifier: graph
    description: Libavfilter graph (lavfi)
    type: string
  - identifier: sample_rate
    description:  (oss)
    type: integer
    minimum: 1
    default: 48000
  - identifier: channels
    description:  (oss)
    type: integer
    minimum: 1
    default: 2
  - identifier: standard
    description:  (video4linux2,v4l2)
    type: string
  - identifier: channel
    description:  (video4linux2,v4l2)
    type: integer
    minimum: 0
    default: 0
  - identifier: video_size
    description: A string describing frame size, such as 640x480 or hd720. (video4linux2,v4l2)
    type: string
  - identifier: pixel_format
    description:  (video4linux2,v4l2)
    type: string
  - identifier: framerate
    description:  (video4linux2,v4l2)
    type: string
  - identifier: video_size
    description: A string describing frame size, such as 640x480 or hd720. (x11grab)
    type: string
    default: vga
  - identifier: framerate
    description:  (x11grab)
    type: string
    default: ntsc
  - identifier: draw_mouse
    description: Draw the mouse pointer. (x11grab)
    type: integer
    minimum: 0
    maximum: 1
    default: 1
  - identifier: follow_mouse
    description: Move the grabbing region when the mouse pointer reaches within specified amount of pixels to the edge of region. (x11grab)
    type: string
    format: integer or keyword
    values:
      - centered
  - identifier: show_region
    description: Show the grabbing region. (x11grab)
    type: integer
    minimum: 0
    maximum: 1
    default: 0
  - identifier: flags
    type: string
    format: flags
    values:
      - gray
      - low_delay
      - bitexact
  - identifier: ar
    description: set audio sampling rate (in Hz)
    type: integer
    default: 0
  - identifier: ac
    description: set number of audio channels
    type: integer
    default: 0
  - identifier: bug
    description: workaround not auto detected encoder bugs
    type: string
    format: flags
    values:
      - autodetect
      - old_msmpeg4
      - xvid_ilace
      - ump4
      - no_padding
      - amv
      - ac_vlc
      - qpel_chroma
      - std_qpel
      - qpel_chroma2
      - direct_blocksize
      - edge
      - hpel_chroma
      - dc_clip
      - ms
      - trunc
  - identifier: strict
    description: how strictly to follow the standards
    type: string
    format: integer or keyword
    values:
      - very
      - strict
      - normal
      - unofficial
      - experimental
  - identifier: er
    description: set error detection aggressivity
    type: string
    format: integer or keyword
    values:
      - careful
      - compliant
      - aggressive
      - very_aggressive
      - explode
  - identifier: err_filter
    description: set error detection filter flags
    type: string
    format: flags
    values:
      - crccheck
      - bitstream
      - buffer
      - explode
  - identifier: idct
    description: select IDCT implementation
    type: string
    format: integer or keyword
    values:
      - auto
      - int
      - simple
      - simplemmx
      - libmpeg2mmx
      - ps2
      - mlib
      - arm
      - altivec
      - sh4
      - simplearm
      - simplearmv5te
      - simplearmv6
      - simpleneon
      - simplealpha
      - h264
      - vp3
      - ipp
      - xvidmmx
      - faani
  - identifier: ec
    description: set error concealment strategy
    type: string
    format: flags
    values:
      - guess_mvs
      - deblock
  - identifier: debug
    description: print specific debug info
    type: string
    format: flags
    values:
      - pict
      - bitstream
      - mb_type
      - qp
      - mv
      - dct_coeff
      - skip
      - startcode
      - pts
      - er
      - mmco
      - bugs
      - vis_qp
      - vis_mb_type
      - buffers
      - thread_ops
  - identifier: vismv
    description: visualize motion vectors (MVs)
    type: string
    format: integer or keyword
    values:
      - pf
      - bf
      - bb
  - identifier: flags2
    type: string
    format: flags
    values:
      - showall
  - identifier: antialias
    description: MP3 antialias algorithm
    type: string
    format: integer or keyword
    values:
      - auto
      - fastint
      - int
      - float
  - identifier: threads
    type: integer
    default: 1
  - identifier: skip_top
    description: number of macroblock rows at the top which are skipped
    type: integer
    default: 0
  - identifier: skip_bottom
    description: number of macroblock rows at the bottom which are skipped
    type: integer
    default: 0
  - identifier: lowres
    description: decode at 1= 1/2, 2=1/4, 3=1/8 resolutions
    type: integer
    minimum: 0
    default: 0
  - identifier: skip_loop_filter
    type: string
    format: integer or keyword
    values:
      - none
      - default
      - noref
      - bidir
      - nokey
      - all
  - identifier: skip_idct
    type: string
    format: integer or keyword
    values:
      - none
      - default
      - noref
      - bidir
      - nokey
      - all
  - identifier: skip_frame
    type: string
    format: integer or keyword
    values:
      - none
      - default
      - noref
      - bidir
      - nokey
      - all
  - identifier: request_channels
    description: set desired number of audio channels
    type: integer
    minimum: 0
    default: 0
  - identifier: drc_scale
    description: percentage of dynamic range compression to apply
    type: float
    minimum: 0.000000
    maximum: 1.000000
    default: 0.000000
  - identifier: channel_layout
    type: integer
    format: 64-bit
    minimum: 0
    default: 0
  - identifier: request_channel_layout
    type: integer
    format: 64-bit
    minimum: 0
    default: 0
  - identifier: ticks_per_frame
    type: integer
    minimum: 1
    default: 1
  - identifier: color_primaries
    type: integer
    minimum: 1
    maximum: 8
    default: 2
  - identifier: color_trc
    type: integer
    minimum: 1
    maximum: 7
    default: 2
  - identifier: colorspace
    type: integer
    minimum: 1
    maximum: 8
    default: 2
  - identifier: color_range
    type: integer
    minimum: 0
    maximum: 2
    default: 0
  - identifier: chroma_sample_location
    type: integer
    minimum: 0
    maximum: 6
    default: 0
  - identifier: thread_type
    description: select multithreading type
    type: string
    format: flags
    values:
      - slice
      - frame
  - identifier: request_sample_fmt
    description: sample format audio decoders should prefer
    type: string
    format: integer or keyword
    values:
      - u8
      - s16
      - s32
      - flt
      - dbl
  - identifier: extern_huff
    description: Use external huffman table. (mjpeg)
    type: integer
    minimum: 0
    maximum: 1
    default: 0
  - identifier: top
    description: top field first (rawvideo)
    type: integer
    minimum: -1
    maximum: 1
    default: -1
  - identifier: drc_scale
    description: percentage of dynamic range compression to apply (ac3)
    type: float
    minimum: 0.000000
    maximum: 1.000000
    default: 1.000000
  - identifier: drc_scale
    description: percentage of dynamic range compression to apply (eac3)
    type: float
    minimum: 0.000000
    maximum: 1.000000
    default: 1.000000
  - identifier: bits_per_codeword
    description: Bits per G722 codeword (g722)
    type: string
    format: flags
...