ilFFmpeg Class Reference

FFmpeg wrapper. More...

Collaboration diagram for ilFFmpeg:

Public Member Functions
	getFileInfo ()
	Get file info. More...

Static Public Member Functions
static	enabled ()
	Checks, whether FFmpeg support is enabled (path is set in the setup) More...
static	getTargetMimeTypes ()
	Get target mime types. More...
static	getSourceMimeTypes ()
	Get source mime types. More...
static	supportsImageExtraction ($a_mime)
	Check if mime type supports image extraction. More...
static	getPossibleTargetMimeTypes ($a_source_mime_type)
	Get possible target formats. More...
static	exec ($args)
	Execute ffmpeg. More...
static	getSupportedCodecsInfo ()
	Get all supported codecs. More...
static	getSupportedFormatsInfo ()
	Get all supported formats. More...
static	convert ($a_file, $a_target_mime, $a_target_dir="", $a_target_filename="")
	Convert file to target mime type. More...
static	getLastReturnValues ()
	Get last return values. More...
static	extractImage ( $a_file, $a_target_filename, $a_target_dir="", $a_sec=1)
	Extract image from video file. More...

Static Public Attributes
static	$formats
	Formats handled by ILIAS. More...
static	$last_return = array()

Static Private Member Functions
static	getCmd ()
	Get ffmpeg command. More...

Detailed Description

FFmpeg wrapper.

Author

Alex Killing alex..nosp@m.kill.nosp@m.ing@g.nosp@m.mx.d.nosp@m.e

Version

$Id$ /

Definition at line 12 of file class.ilFFmpeg.php.

Member Function Documentation

convert()

static ilFFmpeg::convert (   $a_file,   $a_target_mime,   $a_target_dir = "",   $a_target_filename = ""  )

static

Convert file to target mime type.

Parameters

string	$a_file	source file (full path included)
string	$a_target_mime	target mime type
string	$a_target_dir	target directory (no trailing "/")
string	$a_target_filename	target file name (no path!)

Returns

string new file (full path)

Definition at line 194 of file class.ilFFmpeg.php.

References $formats, $ret, and ilUtil\escapeShellArg().

Referenced by ilObjMediaCastGUI\convertFileObject().

    {
        return; // currently not supported

        if (self::$formats[$a_target_mime]["target"] != true) {
            include_once("./Services/MediaObjects/exceptions/class.ilFFmpegException.php");
            throw new ilFFmpegException("Format " . $a_target_mime . " is not supported");
        }
        $pars = self::$formats[$a_target_mime]["parameters"];
        $spi = pathinfo($a_file);
        
        // use source directory if no target directory is passed
        $target_dir = ($a_target_dir != "")
            ? $a_target_dir
            : $spi['dirname'];
            
        // use source filename if no target filename is passed
        $target_filename = ($a_target_filename != "")
            ? $a_target_filename
            : $spi['filename'] . "." . self::$formats[$a_target_mime]["suffix"];
        
        $target_file = $target_dir . "/" . $target_filename;
        
        $cmd = "-y -i " . ilUtil::escapeShellArg($a_file) . " " . $pars . " " . ilUtil::escapeShellArg($target_file);

        $ret = self::exec($cmd . " 2>&1");
        self::$last_return = $ret;
        
        if (is_file($target_file)) {
            return $target_file;
        } else {
            include_once("./Services/MediaObjects/exceptions/class.ilFFmpegException.php");
            throw new ilFFmpegException("It was not possible to convert file " . basename($a_file) . ".");
        }
        //ffmpeg -i MOV012.3gp -vcodec libx264 -strict experimental -acodec aac -sameq -ab 64k -ar 44100 MOV012.mp4
    }

Here is the call graph for this function:

Here is the caller graph for this function:

enabled()

static ilFFmpeg::enabled ( )

static

Checks, whether FFmpeg support is enabled (path is set in the setup)

Parameters

Definition at line 51 of file class.ilFFmpeg.php.

Referenced by ilObjMediaCastGUI\editCastItemObject(), and ilDclMobRecordFieldModel\parseValue().

    {
        if (defined("PATH_TO_FFMPEG") && PATH_TO_FFMPEG != "") {
            return true;
        }
        return false;
    }

Here is the caller graph for this function:

exec()

static ilFFmpeg::exec (   $args )

static

Execute ffmpeg.

Parameters

Definition at line 143 of file class.ilFFmpeg.php.

References ilUtil\execQuoted().

    {
        return ilUtil::execQuoted(self::getCmd(), $args);
    }

Here is the call graph for this function:

extractImage()

static ilFFmpeg::extractImage (   $a_file,   $a_target_filename,   $a_target_dir = "",   $a_sec = 1  )

static

Extract image from video file.

Parameters

string	$a_file	source file (full path included)
string	$a_target_dir	target directory (no trailing "/")
string	$a_target_filename	target file name (no path!)

Returns

string new file (full path)

Definition at line 251 of file class.ilFFmpeg.php.

References $ret, and ilUtil\escapeShellArg().

Referenced by ilObjMediaCastGUI\extractPreviewImageObject(), and ilDclMobRecordFieldModel\parseValue().

      {
        //echo "-$a_file-$a_target_filename-$a_target_dir-$a_sec-<br>";

        $spi = pathinfo($a_file);
        
        // use source directory if no target directory is passed
        $target_dir = ($a_target_dir != "")
            ? $a_target_dir
            : $spi['dirname'];
        
        $target_file = $target_dir . "/" . $a_target_filename;
        
        $sec = (int) $a_sec;
        $cmd = "-y -i " . ilUtil::escapeShellArg($a_file) . " -r 1 -f image2 -vframes 1 -ss " . $sec . " " . ilUtil::escapeShellArg($target_file);
        //echo "-$cmd-"; exit;
        $ret = self::exec($cmd . " 2>&1");
        self::$last_return = $ret;
        
        if (is_file($target_file)) {
            return $target_file;
        } else {
            include_once("./Services/MediaObjects/exceptions/class.ilFFmpegException.php");
            throw new ilFFmpegException("It was not possible to extract an image from " . basename($a_file) . ".");
        }
    }

Here is the call graph for this function:

Here is the caller graph for this function:

getCmd()

static ilFFmpeg::getCmd ( )

staticprivate

Get ffmpeg command.

Definition at line 132 of file class.ilFFmpeg.php.

    {
        return PATH_TO_FFMPEG;
    }

getFileInfo()

ilFFmpeg::getFileInfo

(

)

Get file info.

Parameters

Definition at line 178 of file class.ilFFmpeg.php.

    {
        //$info = `ffmpeg -i $path$file 2>&1 /dev/null`;
        //@fields = split(/\n/, $info);
    }

getLastReturnValues()

static ilFFmpeg::getLastReturnValues ( )

static

Get last return values.

Parameters

Definition at line 237 of file class.ilFFmpeg.php.

Referenced by ilObjMediaCastGUI\convertFileObject(), and ilObjMediaCastGUI\extractPreviewImageObject().

    {
        return self::$last_return;
    }

Here is the caller graph for this function:

getPossibleTargetMimeTypes()

static ilFFmpeg::getPossibleTargetMimeTypes (   $a_source_mime_type )

static

Get possible target formats.

Parameters

Definition at line 115 of file class.ilFFmpeg.php.

    {
        $pt = array();
        if (in_array($a_source_mime_type, self::getSourceMimeTypes())) {
            foreach (self::getTargetMimeTypes() as $tm) {
                if ($tm != $a_source_mime_type) {
                    $pt[$tm] = $tm;
                }
            }
        }
        return $pt;
    }

getSourceMimeTypes()

static ilFFmpeg::getSourceMimeTypes ( )

static

Get source mime types.

Parameters

Definition at line 85 of file class.ilFFmpeg.php.

References $f, and $formats.

    {
        $ttypes = array();
        foreach (self::$formats as $k => $f) {
            if ($f["source"] == true) {
                $ttypes[] = $k;
            }
        }
        return $ttypes;
    }

getSupportedCodecsInfo()

static ilFFmpeg::getSupportedCodecsInfo ( )

static

Get all supported codecs.

Returns

Definition at line 153 of file class.ilFFmpeg.php.

    {
        $codecs = self::exec("-codecs");
        
        return $codecs;
    }

getSupportedFormatsInfo()

static ilFFmpeg::getSupportedFormatsInfo ( )

static

Get all supported formats.

Returns

Definition at line 165 of file class.ilFFmpeg.php.

References $formats.

Referenced by ilObjMediaObjectGUI\showVideoToolObject().

    {
        $formats = self::exec("-formats");
        
        return $formats;
    }

Here is the caller graph for this function:

getTargetMimeTypes()

static ilFFmpeg::getTargetMimeTypes ( )

static

Get target mime types.

(Please note, that we do not list all possible encoders here, only the ones that are desired for the use in ILIAS)

Parameters

Definition at line 68 of file class.ilFFmpeg.php.

References $f, and $formats.

    {
        $ttypes = array();
        foreach (self::$formats as $k => $f) {
            if ($f["target"] == true) {
                $ttypes[] = $k;
            }
        }
        return $ttypes;
    }

supportsImageExtraction()

static ilFFmpeg::supportsImageExtraction (   $a_mime )

static

Check if mime type supports image extraction.

Parameters

string

$a_mime

mime type

Definition at line 101 of file class.ilFFmpeg.php.

Referenced by ilObjMediaCastGUI\editCastItemObject(), and ilDclMobRecordFieldModel\parseValue().

    {
        if (in_array($a_mime, self::getSourceMimeTypes())) {
            return true;
        }
        return false;
    }

Here is the caller graph for this function:

Field Documentation

$formats

ilFFmpeg::$formats

static

Initial value:

= array(
        "video/3pgg" => array(
            "source" => true,
            "target" => false
            ),
        "video/x-flv" => array(
            "source" => true,
            "target" => false
            ),
        "video/mp4" => array(
            "source" => true,
            "target" => true,
            "parameters" => "-vcodec libx264 -strict experimental -acodec aac -sameq -ab 56k -ar 48000",
            "suffix" => "mp4"
            ),
        "video/webm" => array(
            "source" => true,
            "target" => true,
            "parameters" => "-strict experimental -vcodec libvpx -acodec vorbis -ac 2 -sameq -ab 56k -ar 48000",
            "suffix" => "webm"
            )
        )

Formats handled by ILIAS.

Note: In general the mime types do not reflect the complexity of media container/codec variants. For source formats no specification is needed here. For target formats we use fixed parameters that should result in best web media practice.

Definition at line 20 of file class.ilFFmpeg.php.

Referenced by getSupportedFormatsInfo().

$last_return

ilFFmpeg::$last_return = array()

static

Definition at line 43 of file class.ilFFmpeg.php.

---

The documentation for this class was generated from the following file:

• Services/MediaObjects/classes/class.ilFFmpeg.php