FFmpegFrameGrabber (JavaCV 1.5 API)

java.lang.Object
- org.bytedeco.javacv.FrameGrabber
- - org.bytedeco.javacv.FFmpegFrameGrabber

All Implemented Interfaces:

Closeable, AutoCloseable
```
public class FFmpegFrameGrabber
extends FrameGrabber
```
Author:

Samuel Audet

Nested Class Summary
- Nested classes/interfaces inherited from class org.bytedeco.javacv.FrameGrabber
  FrameGrabber.Array, FrameGrabber.Exception, FrameGrabber.ImageMode, FrameGrabber.PropertyEditor, FrameGrabber.SampleMode

Field Summary
- Fields inherited from class org.bytedeco.javacv.FrameGrabber
  aspectRatio, audioBitrate, audioChannels, audioCodec, audioCodecName, audioMetadata, audioOptions, audioStream, bpp, deinterlace, format, frameNumber, frameRate, gamma, imageHeight, imageMode, imageScalingFlags, imageWidth, list, maxDelay, metadata, numBuffers, options, pixelFormat, sampleFormat, sampleMode, sampleRate, SENSOR_PATTERN_BGGR, SENSOR_PATTERN_GBRG, SENSOR_PATTERN_GRBG, SENSOR_PATTERN_RGGB, sensorPattern, timeout, timestamp, triggerMode, videoBitrate, videoCodec, videoCodecName, videoMetadata, videoOptions, videoStream

Constructor Summary

Constructors
Constructor and Description
`FFmpegFrameGrabber(File file)`
`FFmpegFrameGrabber(InputStream inputStream)` Calls `FFmpegFrameGrabber(inputStream, Integer.MAX_VALUE - 8)` so that the whole input stream is seekable.
`FFmpegFrameGrabber(InputStream inputStream, int maximumSize)`
`FFmpegFrameGrabber(String filename)`

Method Summary

All Methods Static Methods Instance Methods Concrete Methods
Modifier and Type	Method and Description
`static FFmpegFrameGrabber`	`createDefault(File deviceFile)`
`static FFmpegFrameGrabber`	`createDefault(int deviceNumber)`
`static FFmpegFrameGrabber`	`createDefault(String devicePath)`
`protected void`	`finalize()`
`double`	`getAspectRatio()`
`int`	`getAudioBitrate()`
`int`	`getAudioChannels()`
`int`	`getAudioCodec()`
`double`	`getAudioFrameRate()` Estimation of audio frames per second
`Map<String,String>`	`getAudioMetadata()`
`String`	`getAudioMetadata(String key)`
`static String[]`	`getDeviceDescriptions()`
`String`	`getFormat()`
`AVFormatContext`	`getFormatContext()`
`double`	`getFrameRate()` Returns `getVideoFrameRate()`
`double`	`getGamma()`
`int`	`getImageHeight()`
`int`	`getImageWidth()`
`int`	`getLengthInAudioFrames()`
`int`	`getLengthInFrames()` Returns `getLengthInVideoFrames()`
`long`	`getLengthInTime()`
`int`	`getLengthInVideoFrames()` Returns `(int) Math.round(getLengthInTime() * getFrameRate() / 1000000L)`, which is an approximation in general.
`Map<String,String>`	`getMetadata()`
`String`	`getMetadata(String key)`
`int`	`getPixelFormat()`
`int`	`getSampleFormat()`
`int`	`getSampleRate()`
`int`	`getVideoBitrate()`
`int`	`getVideoCodec()`
`double`	`getVideoFrameRate()`
`Map<String,String>`	`getVideoMetadata()`
`String`	`getVideoMetadata(String key)`
`Frame`	`grab()` Each call to grab stores the new image in the memory address for the previously returned frame.
`Frame`	`grabFrame(boolean doAudio, boolean doVideo, boolean doProcessing, boolean keyFrames)`
`Frame`	`grabImage()`
`Frame`	`grabKeyFrame()`
`AVPacket`	`grabPacket()`
`Frame`	`grabSamples()`
`boolean`	`hasAudio()` Is there an audio stream?
`boolean`	`hasVideo()` Is there a video stream?
`boolean`	`isCloseInputStream()`
`void`	`release()`
`void`	`releaseUnsafe()`
`void`	`setAudioFrameNumber(int frameNumber)` if there is audio stream tries to seek to audio frame with corresponding timestamp ignoring otherwise
`void`	`setAudioTimestamp(long timestamp)` setTimestamp with resulting audio frame type if there is an audio stream
`void`	`setCloseInputStream(boolean closeInputStream)`
`void`	`setFrameNumber(int frameNumber)` default override of super.setFrameNumber implies setting of a frame close to a video frame having that number
`void`	`setTimestamp(long timestamp)` setTimestamp without checking frame content (using old code used in JavaCV versions prior to 1.4.1)
`void`	`setTimestamp(long timestamp, boolean checkFrame)` setTimestamp with possibility to select between old quick seek code or new code doing check of frame content.
`void`	`setVideoFrameNumber(int frameNumber)` if there is video stream tries to seek to video frame with corresponding timestamp otherwise sets super.frameNumber only because frameRate==0 if there is no video stream
`void`	`setVideoTimestamp(long timestamp)` setTimestamp with resulting video frame type if there is a video stream
`void`	`start()`
`void`	`startUnsafe()`
`void`	`stop()`
`void`	`trigger()`
`static void`	`tryLoad()`

Methods inherited from class org.bytedeco.javacv.FrameGrabber
close, create, create, create, create, createArray, delayedGrab, flush, get, getAudioCodecName, getAudioOption, getAudioOptions, getAudioStream, getBitsPerPixel, getDefault, getDelayedFrame, getDelayedTime, getFrameNumber, getImageMode, getImageScalingFlags, getMaxDelay, getNumBuffers, getOption, getOptions, getSampleMode, getSensorPattern, getTimeout, getTimestamp, getVideoCodecName, getVideoOption, getVideoOptions, getVideoStream, grabFrame, init, isDeinterlace, isTriggerMode, restart, setAspectRatio, setAudioBitrate, setAudioChannels, setAudioCodec, setAudioCodecName, setAudioMetadata, setAudioMetadata, setAudioOption, setAudioOptions, setAudioStream, setBitsPerPixel, setDeinterlace, setFormat, setFrameRate, setGamma, setImageHeight, setImageMode, setImageScalingFlags, setImageWidth, setMaxDelay, setMetadata, setMetadata, setNumBuffers, setOption, setOptions, setPixelFormat, setSampleFormat, setSampleMode, setSampleRate, setSensorPattern, setTimeout, setTriggerMode, setVideoBitrate, setVideoCodec, setVideoCodecName, setVideoMetadata, setVideoMetadata, setVideoOption, setVideoOptions, setVideoStream

Methods inherited from class java.lang.Object
clone, equals, getClass, hashCode, notify, notifyAll, toString, wait, wait, wait

- Constructor Detail
  - FFmpegFrameGrabber
```
public FFmpegFrameGrabber(File file)
```
  - FFmpegFrameGrabber
```
public FFmpegFrameGrabber(String filename)
```
  - FFmpegFrameGrabber
```
public FFmpegFrameGrabber(InputStream inputStream)
```
    Calls FFmpegFrameGrabber(inputStream, Integer.MAX_VALUE - 8) so that the whole input stream is seekable.
  - FFmpegFrameGrabber
```
public FFmpegFrameGrabber(InputStream inputStream,
                          int maximumSize)
```
- Method Detail
  - getDeviceDescriptions
```
public static String[] getDeviceDescriptions()
                                      throws FrameGrabber.Exception
```
    Throws:
    
    FrameGrabber.Exception
  - createDefault
```
public static FFmpegFrameGrabber createDefault(File deviceFile)
                                        throws FrameGrabber.Exception
```
    Throws:
    
    FrameGrabber.Exception
  - createDefault
```
public static FFmpegFrameGrabber createDefault(String devicePath)
                                        throws FrameGrabber.Exception
```
    Throws:
    
    FrameGrabber.Exception
  - createDefault
```
public static FFmpegFrameGrabber createDefault(int deviceNumber)
                                        throws FrameGrabber.Exception
```
    Throws:
    
    FrameGrabber.Exception
  - tryLoad
```
public static void tryLoad()
                    throws FrameGrabber.Exception
```
    Throws:
    
    FrameGrabber.Exception
  - release
```
public void release()
             throws FrameGrabber.Exception
```
    Specified by:
    
    release in class FrameGrabber
    
    Throws:
    
    FrameGrabber.Exception
  - releaseUnsafe
```
public void releaseUnsafe()
                   throws FrameGrabber.Exception
```
    Throws:
    
    FrameGrabber.Exception
  - finalize
```
protected void finalize()
                 throws Throwable
```
    Overrides:
    
    finalize in class Object
    
    Throws:
    
    Throwable
  - isCloseInputStream
```
public boolean isCloseInputStream()
```
  - setCloseInputStream
```
public void setCloseInputStream(boolean closeInputStream)
```
  - hasVideo
```
public boolean hasVideo()
```
    Is there a video stream?
    
    Returns:
    
    video_st!=null;
  - hasAudio
```
public boolean hasAudio()
```
    Is there an audio stream?
    
    Returns:
    
    audio_st!=null;
  - getGamma
```
public double getGamma()
```
    Overrides:
    
    getGamma in class FrameGrabber
  - getFormat
```
public String getFormat()
```
    Overrides:
    
    getFormat in class FrameGrabber
  - getImageWidth
```
public int getImageWidth()
```
    Overrides:
    
    getImageWidth in class FrameGrabber
  - getImageHeight
```
public int getImageHeight()
```
    Overrides:
    
    getImageHeight in class FrameGrabber
  - getAudioChannels
```
public int getAudioChannels()
```
    Overrides:
    
    getAudioChannels in class FrameGrabber
  - getPixelFormat
```
public int getPixelFormat()
```
    Overrides:
    
    getPixelFormat in class FrameGrabber
  - getVideoCodec
```
public int getVideoCodec()
```
    Overrides:
    
    getVideoCodec in class FrameGrabber
  - getVideoBitrate
```
public int getVideoBitrate()
```
    Overrides:
    
    getVideoBitrate in class FrameGrabber
  - getAspectRatio
```
public double getAspectRatio()
```
    Overrides:
    
    getAspectRatio in class FrameGrabber
  - getFrameRate
```
public double getFrameRate()
```
    Returns getVideoFrameRate()
    
    Overrides:
    
    getFrameRate in class FrameGrabber
  - getAudioFrameRate
```
public double getAudioFrameRate()
```
    Estimation of audio frames per second
    
    Returns:
    
    (double) getSampleRate()) / samples_frame.nb_samples() if samples_frame.nb_samples() is not zero, otherwise return 0
  - getVideoFrameRate
```
public double getVideoFrameRate()
```
  - getAudioCodec
```
public int getAudioCodec()
```
    Overrides:
    
    getAudioCodec in class FrameGrabber
  - getAudioBitrate
```
public int getAudioBitrate()
```
    Overrides:
    
    getAudioBitrate in class FrameGrabber
  - getSampleFormat
```
public int getSampleFormat()
```
    Overrides:
    
    getSampleFormat in class FrameGrabber
  - getSampleRate
```
public int getSampleRate()
```
    Overrides:
    
    getSampleRate in class FrameGrabber
  - getMetadata
```
public Map<String,String> getMetadata()
```
    Overrides:
    
    getMetadata in class FrameGrabber
  - getVideoMetadata
```
public Map<String,String> getVideoMetadata()
```
    Overrides:
    
    getVideoMetadata in class FrameGrabber
  - getAudioMetadata
```
public Map<String,String> getAudioMetadata()
```
    Overrides:
    
    getAudioMetadata in class FrameGrabber
  - getMetadata
```
public String getMetadata(String key)
```
    Overrides:
    
    getMetadata in class FrameGrabber
  - getVideoMetadata
```
public String getVideoMetadata(String key)
```
    Overrides:
    
    getVideoMetadata in class FrameGrabber
  - getAudioMetadata
```
public String getAudioMetadata(String key)
```
    Overrides:
    
    getAudioMetadata in class FrameGrabber
  - setFrameNumber
```
public void setFrameNumber(int frameNumber)
                    throws FrameGrabber.Exception
```
    default override of super.setFrameNumber implies setting of a frame close to a video frame having that number
    
    Overrides:
    
    setFrameNumber in class FrameGrabber
    
    Throws:
    
    FrameGrabber.Exception
  - setVideoFrameNumber
```
public void setVideoFrameNumber(int frameNumber)
                         throws FrameGrabber.Exception
```
    if there is video stream tries to seek to video frame with corresponding timestamp otherwise sets super.frameNumber only because frameRate==0 if there is no video stream
    
    Throws:
    
    FrameGrabber.Exception
  - setAudioFrameNumber
```
public void setAudioFrameNumber(int frameNumber)
                         throws FrameGrabber.Exception
```
    if there is audio stream tries to seek to audio frame with corresponding timestamp ignoring otherwise
    
    Throws:
    
    FrameGrabber.Exception
  - setTimestamp
```
public void setTimestamp(long timestamp)
                  throws FrameGrabber.Exception
```
    setTimestamp without checking frame content (using old code used in JavaCV versions prior to 1.4.1)
    
    Overrides:
    
    setTimestamp in class FrameGrabber
    
    Throws:
    
    FrameGrabber.Exception
  - setTimestamp
```
public void setTimestamp(long timestamp,
                         boolean checkFrame)
                  throws FrameGrabber.Exception
```
    setTimestamp with possibility to select between old quick seek code or new code doing check of frame content. The frame check can be useful with corrupted files, when seeking may end up with an empty frame not containing video nor audio
    
    Throws:
    
    FrameGrabber.Exception
  - setVideoTimestamp
```
public void setVideoTimestamp(long timestamp)
                       throws FrameGrabber.Exception
```
    setTimestamp with resulting video frame type if there is a video stream
    
    Throws:
    
    FrameGrabber.Exception
  - setAudioTimestamp
```
public void setAudioTimestamp(long timestamp)
                       throws FrameGrabber.Exception
```
    setTimestamp with resulting audio frame type if there is an audio stream
    
    Throws:
    
    FrameGrabber.Exception
  - getLengthInFrames
```
public int getLengthInFrames()
```
    Returns getLengthInVideoFrames()
    
    Overrides:
    
    getLengthInFrames in class FrameGrabber
  - getLengthInTime
```
public long getLengthInTime()
```
    Overrides:
    
    getLengthInTime in class FrameGrabber
  - getLengthInVideoFrames
```
public int getLengthInVideoFrames()
```
    Returns (int) Math.round(getLengthInTime() * getFrameRate() / 1000000L), which is an approximation in general.
  - getLengthInAudioFrames
```
public int getLengthInAudioFrames()
```
  - getFormatContext
```
public AVFormatContext getFormatContext()
```
  - start
```
public void start()
           throws FrameGrabber.Exception
```
    Specified by:
    
    start in class FrameGrabber
    
    Throws:
    
    FrameGrabber.Exception
  - startUnsafe
```
public void startUnsafe()
                 throws FrameGrabber.Exception
```
    Throws:
    
    FrameGrabber.Exception
  - stop
```
public void stop()
          throws FrameGrabber.Exception
```
    Specified by:
    
    stop in class FrameGrabber
    
    Throws:
    
    FrameGrabber.Exception
  - trigger
```
public void trigger()
             throws FrameGrabber.Exception
```
    Specified by:
    
    trigger in class FrameGrabber
    
    Throws:
    
    FrameGrabber.Exception
  - grab
```
public Frame grab()
           throws FrameGrabber.Exception
```
    Description copied from class: FrameGrabber
    
    Each call to grab stores the new image in the memory address for the previously returned frame.
    IE.
    grabber.grab() == grabber.grab()
    This means that if you need to cache images returned from grab you should Frame.clone() the returned frame as the next call to grab will overwrite your existing image's memory.
    Why?
    Using this method instead of allocating a new buffer every time a frame is grabbed improves performance by reducing the frequency of garbage collections. Almost no additional heap space is typically allocated per frame.
    
    Specified by:
    
    grab in class FrameGrabber
    
    Returns:
    
    The frame returned from the grabber
    
    Throws:
    
    FrameGrabber.Exception
  - grabImage
```
public Frame grabImage()
                throws FrameGrabber.Exception
```
    Throws:
    
    FrameGrabber.Exception
  - grabSamples
```
public Frame grabSamples()
                  throws FrameGrabber.Exception
```
    Throws:
    
    FrameGrabber.Exception
  - grabKeyFrame
```
public Frame grabKeyFrame()
                   throws FrameGrabber.Exception
```
    Throws:
    
    FrameGrabber.Exception
  - grabFrame
```
public Frame grabFrame(boolean doAudio,
                       boolean doVideo,
                       boolean doProcessing,
                       boolean keyFrames)
                throws FrameGrabber.Exception
```
    Throws:
    
    FrameGrabber.Exception
  - grabPacket
```
public AVPacket grabPacket()
                    throws FrameGrabber.Exception
```
    Throws:
    
    FrameGrabber.Exception

Class FFmpegFrameGrabber

Nested Class Summary

Nested classes/interfaces inherited from class org.bytedeco.javacv.FrameGrabber

Field Summary

Fields inherited from class org.bytedeco.javacv.FrameGrabber

Constructor Summary

Method Summary

Methods inherited from class org.bytedeco.javacv.FrameGrabber

Methods inherited from class java.lang.Object

Constructor Detail

FFmpegFrameGrabber

FFmpegFrameGrabber

FFmpegFrameGrabber

FFmpegFrameGrabber

Method Detail

getDeviceDescriptions

createDefault

createDefault

createDefault

tryLoad

release

releaseUnsafe

finalize

isCloseInputStream

setCloseInputStream

hasVideo

hasAudio

getGamma

getFormat

getImageWidth

getImageHeight

getAudioChannels

getPixelFormat

getVideoCodec

getVideoBitrate

getAspectRatio

getFrameRate

getAudioFrameRate

getVideoFrameRate

getAudioCodec

getAudioBitrate

getSampleFormat

getSampleRate

getMetadata

getVideoMetadata

getAudioMetadata

getMetadata

getVideoMetadata

getAudioMetadata

setFrameNumber

setVideoFrameNumber

setAudioFrameNumber

setTimestamp

setTimestamp

setVideoTimestamp

setAudioTimestamp

getLengthInFrames

getLengthInTime

getLengthInVideoFrames

getLengthInAudioFrames

getFormatContext

start

startUnsafe

stop

trigger

grab

grabImage

grabSamples

grabKeyFrame

grabFrame

grabPacket