Package limn.video.ffmpeg

Class FfmpegException

java.lang.Object
java.lang.Throwable
java.lang.Exception
java.lang.RuntimeException
limn.video.ffmpeg.FfmpegException
All Implemented Interfaces:
Serializable
public class FfmpegException extends RuntimeException
What every failure inside the FFmpeg decoder arrives as, including every failure that started in C.

That is the point of it. A native decoder handed a malformed file has two ways to react: it can dereference something the file said was there and take the whole virtual machine down with it, or it can check and report. Nothing below this class ever does the first, so a truncated container, a header claiming an impossible size, a codec this build was not compiled with and a stream that changes resolution halfway through all reach Java as this exception, thrown on the thread that asked.

Unchecked, because that is the shape the SPI publishes: VideoDecoder.openStream and VideoStreamSource.readFrame both document a RuntimeException for a stream that cannot be opened or decoded, and a decode thread carrying a checked exception would have nowhere to put it.

The message names what was being attempted and, where FFmpeg supplied one, its own description of the failure. There is no error code and nothing to branch on: a caller either shows the message or shows a poster.

See Also:

  • Constructor Details

    • FfmpegException

      public FfmpegException(String message)
      Parameters:
      message - what was being attempted, and what went wrong with it

    • FfmpegException

      public FfmpegException(String message, Throwable cause)
      Parameters:
      message - what was being attempted; cause is what it failed on