class.ilFFmpeg.php

Go to the documentation of this file.

<?php

/* Copyright (c) 1998-2012 ILIAS open source, Extended GPL, see docs/LICENSE */

class ilFFmpeg
{
        static $formats = 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"
                        )
                );
        
        static $last_return = array();
        
        static function enabled()
        {
                if (defined("PATH_TO_FFMPEG") && PATH_TO_FFMPEG != "")
                {
                        return true;
                }
                return false;
        }
        
        static function getTargetMimeTypes()
        {
                $ttypes = array();
                foreach (self::$formats as $k => $f)
                {
                        if ($f["target"] == true)
                        {
                                $ttypes[] = $k;
                        }
                }
                return $ttypes;
        }
        
        static function getSourceMimeTypes()
        {
                $ttypes = array();
                foreach (self::$formats as $k => $f)
                {
                        if ($f["source"] == true)
                        {
                                $ttypes[] = $k;
                        }
                }
                return $ttypes;
        }
        
        static function supportsImageExtraction($a_mime)
        {
                if (in_array($a_mime, self::getSourceMimeTypes()))
                {
                        return true;
                }
                return false;
        }
        
        function getPossibleTargetMimeTypes($a_source_mime_type)
        {
                $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;
        }
        
        
        private static function getCmd()
        {
                return PATH_TO_FFMPEG;
        }

        function exec($args)
        {
                return ilUtil::execQuoted(self::getCmd(), $args);
        }
        
        static function getSupportedCodecsInfo()
        {
                $codecs = self::exec("-codecs");
                
                return $codecs;
        }

        static function getSupportedFormatsInfo()
        {
                $formats = self::exec("-formats");
                
                return $formats;
        }
        
        function getFileInfo()
        {
                //$info = `ffmpeg -i $path$file 2>&1 /dev/null`;
                //@fields = split(/\n/, $info);
        }
        
        static function convert($a_file, $a_target_mime, $a_target_dir = "", $a_target_filename = "")
        {
                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
        }
        
        function getLastReturnValues()
        {
                return self::$last_return;
        }
        
        static function extractImage($a_file, $a_target_filename, $a_target_dir = "",
                $a_sec = 1)
        {
//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).".");
                }
        }

}

?>