[FFmpeg] Add FFmpeg plugin
FFmpeg plugin serves as a better performant/quality alternative to resize animated GIFs than the ImageMagick plugin.
This commit is contained in:
parent
4a50579ef1
commit
b7cf60c7b4
151
plugins/FFmpeg/FFmpegPlugin.php
Normal file
151
plugins/FFmpeg/FFmpegPlugin.php
Normal file
|
@ -0,0 +1,151 @@
|
|||
<?php
|
||||
// This file is part of GNU social - https://www.gnu.org/software/social
|
||||
//
|
||||
// GNU social is free software: you can redistribute it and/or modify
|
||||
// it under the terms of the GNU Affero General Public License as published by
|
||||
// the Free Software Foundation, either version 3 of the License, or
|
||||
// (at your option) any later version.
|
||||
//
|
||||
// GNU social is distributed in the hope that it will be useful,
|
||||
// but WITHOUT ANY WARRANTY; without even the implied warranty of
|
||||
// MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the
|
||||
// GNU Affero General Public License for more details.
|
||||
//
|
||||
// You should have received a copy of the GNU Affero General Public License
|
||||
// along with GNU social. If not, see <http://www.gnu.org/licenses/>.
|
||||
|
||||
/**
|
||||
* Animated GIF resize support via PHP-FFMpeg
|
||||
*
|
||||
* @package GNUsocial
|
||||
* @author Bruno Casteleiro <up201505347@fc.up.pt>
|
||||
* @copyright 2020 Free Software Foundation, Inc http://www.fsf.org
|
||||
* @license https://www.gnu.org/licenses/agpl.html GNU AGPL v3 or later
|
||||
* @link http://www.gnu.org/software/social/
|
||||
*/
|
||||
|
||||
defined('GNUSOCIAL') || die();
|
||||
|
||||
class FFmpegPlugin extends Plugin
|
||||
{
|
||||
const PLUGIN_VERSION = '0.1.0';
|
||||
|
||||
public function onStartResizeImageFile(ImageFile $imagefile, string $outpath, array $box): bool
|
||||
{
|
||||
switch ($imagefile->mimetype) {
|
||||
case 'image/gif':
|
||||
// resize only if an animated GIF
|
||||
if ($imagefile->animated) {
|
||||
return !$this->resizeImageFileAnimatedGif($imagefile, $outpath, $box);
|
||||
}
|
||||
break;
|
||||
}
|
||||
return true;
|
||||
}
|
||||
|
||||
/**
|
||||
* High quality GIF conversion.
|
||||
*
|
||||
* @see http://blog.pkh.me/p/21-high-quality-gif-with-ffmpeg.html
|
||||
* @see https://github.com/PHP-FFMpeg/PHP-FFMpeg/pull/592
|
||||
*/
|
||||
public function resizeImageFileAnimatedGif(ImageFile $imagefile, string $outpath, array $box): bool
|
||||
{
|
||||
// Create FFMpeg instance
|
||||
// Need to explictly tell the drivers location or it won't find them
|
||||
$ffmpeg = FFMpeg\FFMpeg::create([
|
||||
'ffmpeg.binaries' => exec("which ffmpeg"),
|
||||
'ffprobe.binaries' => exec("which ffprobe")
|
||||
]);
|
||||
|
||||
// FFmpeg can't edit existing files in place,
|
||||
// generate temporary output file to avoid that
|
||||
$tmp_outpath = tempnam(sys_get_temp_dir(), 'outpath-');
|
||||
|
||||
// Generate palette file. FFmpeg explictly needs to be told the
|
||||
// extension for PNG files outputs
|
||||
$palette = $this->tempnam_sfx(sys_get_temp_dir(), '.png');
|
||||
|
||||
// Build filters
|
||||
$filters = 'fps=30';
|
||||
$filters .= ",crop={$box['w']}:{$box['h']}:{$box['x']}:{$box['y']}";
|
||||
$filters .= ",scale={$box['width']}:{$box['height']}:flags=lanczos";
|
||||
|
||||
// Assemble commands for palette generation
|
||||
$commands[] = $commands_2[] = '-f';
|
||||
$commands[] = $commands_2[] = 'gif';
|
||||
$commands[] = $commands_2[] = '-i';
|
||||
$commands[] = $commands_2[] = $imagefile->filepath;
|
||||
$commands[] = '-vf';
|
||||
$commands[] = $filters . ',palettegen';
|
||||
$commands[] = '-y';
|
||||
$commands[] = $palette;
|
||||
|
||||
// Assemble commands for GIF generation
|
||||
$commands_2[] = '-i';
|
||||
$commands_2[] = $palette;
|
||||
$commands_2[] = '-lavfi';
|
||||
$commands_2[] = $filters . ' [x]; [x][1:v] paletteuse';
|
||||
$commands_2[] = '-f';
|
||||
$commands_2[] = 'gif';
|
||||
$commands_2[] = '-y';
|
||||
$commands_2[] = $tmp_outpath;
|
||||
|
||||
$success = true;
|
||||
|
||||
// Generate the palette image
|
||||
try {
|
||||
$ffmpeg->getFFMpegDriver()->command($commands);
|
||||
} catch (Exception $e) {
|
||||
$this->log(LOG_ERR, 'Unable to generate the palette image');
|
||||
$success = false;
|
||||
}
|
||||
|
||||
// Generate GIF
|
||||
try {
|
||||
if ($success) {
|
||||
$ffmpeg->getFFMpegDriver()->command($commands_2);
|
||||
}
|
||||
} catch (Exception $e) {
|
||||
$this->log(LOG_ERR, 'Unable to generate the GIF image');
|
||||
$success = false;
|
||||
}
|
||||
|
||||
if ($success) {
|
||||
$success = @rename($tmp_outpath, $outpath);
|
||||
}
|
||||
|
||||
@unlink($tmp_outpath);
|
||||
@unlink($palette);
|
||||
|
||||
return $success;
|
||||
}
|
||||
|
||||
/**
|
||||
* Suffix version of tempnam.
|
||||
* Courtesy of tomas at slax dot org:
|
||||
* @see https://www.php.net/manual/en/function.tempnam.php#98232
|
||||
*/
|
||||
private function tempnam_sfx(string $dir, string $suffix): string
|
||||
{
|
||||
do {
|
||||
$file = $dir . "/" . mt_rand() . $suffix;
|
||||
$fp = @fopen($file, 'x');
|
||||
} while (!$fp);
|
||||
|
||||
fclose($fp);
|
||||
return $file;
|
||||
}
|
||||
|
||||
public function onPluginVersion(array &$versions): bool
|
||||
{
|
||||
$versions[] = ['name' => 'FFmpeg',
|
||||
'version' => self::PLUGIN_VERSION,
|
||||
'author' => 'Bruno Casteleiro',
|
||||
'homepage' => 'https://notabug.org/diogo/gnu-social/src/nightly/plugins/FFmpeg',
|
||||
'rawdescription' =>
|
||||
// TRANS: Plugin description.
|
||||
_m('Use PHP-FFMpeg for resizing animated GIFs')];
|
||||
return true;
|
||||
}
|
||||
}
|
19
plugins/FFmpeg/README.md
Normal file
19
plugins/FFmpeg/README.md
Normal file
|
@ -0,0 +1,19 @@
|
|||
# FFmpeg plugin for GNU social
|
||||
(c) 2020 Free Software Foundation, Inc
|
||||
|
||||
This is the README file for GNU social's ActivityPub plugin.
|
||||
It includes general information about the plugin.
|
||||
|
||||
## About
|
||||
|
||||
This plugin adds FFmpeg support to GNU social via PHP-FFMpeg.
|
||||
|
||||
Currently it serves as a better performant and quality alternative to resize
|
||||
animated GIFs than the ImageMagick plugin. However, it has the downside of
|
||||
increasing a little the size of the original GIF images for some conversions.
|
||||
|
||||
## Settings
|
||||
|
||||
Make sure you've set the `upload_max_filesize` and `post_max_size` in php.ini
|
||||
to be large enough to handle uploads if you ever experience some error with
|
||||
fetching remote images.
|
23
plugins/FFmpeg/locale/FFmpeg.pot
Normal file
23
plugins/FFmpeg/locale/FFmpeg.pot
Normal file
|
@ -0,0 +1,23 @@
|
|||
# SOME DESCRIPTIVE TITLE.
|
||||
# Copyright (C) YEAR THE PACKAGE'S COPYRIGHT HOLDER
|
||||
# This file is distributed under the same license as the PACKAGE package.
|
||||
# FIRST AUTHOR <EMAIL@ADDRESS>, YEAR.
|
||||
#
|
||||
#, fuzzy
|
||||
msgid ""
|
||||
msgstr ""
|
||||
"Project-Id-Version: PACKAGE VERSION\n"
|
||||
"Report-Msgid-Bugs-To: \n"
|
||||
"POT-Creation-Date: 2020-08-13 03:09+0100\n"
|
||||
"PO-Revision-Date: YEAR-MO-DA HO:MI+ZONE\n"
|
||||
"Last-Translator: FULL NAME <EMAIL@ADDRESS>\n"
|
||||
"Language-Team: LANGUAGE <LL@li.org>\n"
|
||||
"Language: \n"
|
||||
"MIME-Version: 1.0\n"
|
||||
"Content-Type: text/plain; charset=CHARSET\n"
|
||||
"Content-Transfer-Encoding: 8bit\n"
|
||||
|
||||
#. TRANS: Plugin description.
|
||||
#: FFmpegPlugin.php:104
|
||||
msgid "Use PHP-FFMpeg for resizing animated GIFs"
|
||||
msgstr ""
|
24
plugins/FFmpeg/locale/en_GB/LC_MESSAGES/FFmpeg.po
Normal file
24
plugins/FFmpeg/locale/en_GB/LC_MESSAGES/FFmpeg.po
Normal file
|
@ -0,0 +1,24 @@
|
|||
# Translation file for GNU social - the free software social networking platform
|
||||
# Copyright (C) 2015 - 2019 Free Software Foundation, Inc http://www.fsf.org
|
||||
# This file is under https://www.gnu.org/licenses/agpl v3 or later
|
||||
#
|
||||
# Translators:
|
||||
# Bruno Casteleiro <up201505347@fc.up.pt>, 2020
|
||||
msgid ""
|
||||
msgstr ""
|
||||
"Project-Id-Version: GNU social\n"
|
||||
"Report-Msgid-Bugs-To: \n"
|
||||
"POT-Creation-Date: 2020-08-13 18:21+0100\n"
|
||||
"PO-Revision-Date: 2020-08-13 18:21+0100\n"
|
||||
"Last-Translator: Bruno Casteleiro <up201505347@fc.up.pt>\n"
|
||||
"Language-Team: English (United Kingdom) (http://www.transifex.com/gnu-social/gnu-social/language/en_GB/)\n"
|
||||
"MIME-Version: 1.0\n"
|
||||
"Content-Type: text/plain; charset=UTF-8\n"
|
||||
"Content-Transfer-Encoding: 8bit\n"
|
||||
"Language: en_GB\n"
|
||||
"Plural-Forms: nplurals=2; plural=(n != 1);\n"
|
||||
|
||||
#. TRANS: Plugin description.
|
||||
#: FFmpegPlugin.php:104
|
||||
msgid "Use PHP-FFMpeg for resizing animated GIFs"
|
||||
msgstr "Use PHP-FFMpeg for resizing animated GIFs"
|
23
plugins/FFmpeg/locale/pt/LC_MESSAGES/FFmpeg.po
Normal file
23
plugins/FFmpeg/locale/pt/LC_MESSAGES/FFmpeg.po
Normal file
|
@ -0,0 +1,23 @@
|
|||
# Copyright (C) 2020 Free Software Foundation, Inc http://www.fsf.org
|
||||
# This file is under https://www.gnu.org/licenses/agpl v3 or later
|
||||
#
|
||||
# Translators:
|
||||
# Bruno Casteleiro <up201505347@fc.up.pt>, 2020
|
||||
msgid ""
|
||||
msgstr ""
|
||||
"Project-Id-Version: GNU social\n"
|
||||
"Report-Msgid-Bugs-To: \n"
|
||||
"POT-Creation-Date: 2020-08-13 18:20+0100\n"
|
||||
"PO-Revision-Date: 2019-08-13 18:20+0100\n"
|
||||
"Last-Translator: Bruno Casteleiro <up201505347@fc.up.pt>\n"
|
||||
"Language-Team: Portuguese (http://www.transifex.com/gnu-social/gnu-social/language/pt/)\n"
|
||||
"MIME-Version: 1.0\n"
|
||||
"Content-Type: text/plain; charset=UTF-8\n"
|
||||
"Content-Transfer-Encoding: 8bit\n"
|
||||
"Language: pt\n"
|
||||
"Plural-Forms: nplurals=2; plural=(n != 1);\n"
|
||||
|
||||
#. TRANS: Plugin description.
|
||||
#: FFmpegPlugin.php:104
|
||||
msgid "Use PHP-FFMpeg for resizing animated GIFs"
|
||||
msgstr "Utiliza PHP-FFMpeg para redimensionar GIFs animados"
|
Loading…
Reference in New Issue
Block a user