includes/media/DjVu.php

   1 <?php
   2 /**
   3  * Handler for DjVu images.
   4  *
   5  * This program is free software; you can redistribute it and/or modify
   6  * it under the terms of the GNU General Public License as published by
   7  * the Free Software Foundation; either version 2 of the License, or
   8  * (at your option) any later version.
   9  *
  10  * This program is distributed in the hope that it will be useful,
  11  * but WITHOUT ANY WARRANTY; without even the implied warranty of
  12  * MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the
  13  * GNU General Public License for more details.
  14  *
  15  * You should have received a copy of the GNU General Public License along
  16  * with this program; if not, write to the Free Software Foundation, Inc.,
  17  * 51 Franklin Street, Fifth Floor, Boston, MA 02110-1301, USA.
  18  * http://www.gnu.org/copyleft/gpl.html
  19  *
  20  * @file
  21  * @ingroup Media
  22  */
  23
  24 /**
  25  * Handler for DjVu images
  26  *
  27  * @ingroup Media
  28  */
  29 class DjVuHandler extends ImageHandler {
  30
  31         /**
  32          * @return bool
  33          */
  34         function isEnabled() {
  35                 global $wgDjvuRenderer, $wgDjvuDump, $wgDjvuToXML;
  36                 if ( !$wgDjvuRenderer || ( !$wgDjvuDump && !$wgDjvuToXML ) ) {
  37                         wfDebug( "DjVu is disabled, please set \$wgDjvuRenderer and \$wgDjvuDump\n" );
  38                         return false;
  39                 } else {
  40                         return true;
  41                 }
  42         }
  43
  44         /**
  45          * @param $file
  46          * @return bool
  47          */
  48         function mustRender( $file ) {
  49                 return true;
  50         }
  51
  52         /**
  53          * @param $file
  54          * @return bool
  55          */
  56         function isMultiPage( $file ) {
  57                 return true;
  58         }
  59
  60         /**
  61          * @return array
  62          */
  63         function getParamMap() {
  64                 return array(
  65                         'img_width' => 'width',
  66                         'img_page' => 'page',
  67                 );
  68         }
  69
  70         /**
  71          * @param $name
  72          * @param $value
  73          * @return bool
  74          */
  75         function validateParam( $name, $value ) {
  76                 if ( in_array( $name, array( 'width', 'height', 'page' ) ) ) {
  77                         if ( $value <= 0 ) {
  78                                 return false;
  79                         } else {
  80                                 return true;
  81                         }
  82                 } else {
  83                         return false;
  84                 }
  85         }
  86
  87         /**
  88          * @param $params
  89          * @return bool|string
  90          */
  91         function makeParamString( $params ) {
  92                 $page = isset( $params['page'] ) ? $params['page'] : 1;
  93                 if ( !isset( $params['width'] ) ) {
  94                         return false;
  95                 }
  96                 return "page{$page}-{$params['width']}px";
  97         }
  98
  99         /**
 100          * @param $str
 101          * @return array|bool
 102          */
 103         function parseParamString( $str ) {
 104                 $m = false;
 105                 if ( preg_match( '/^page(\d+)-(\d+)px$/', $str, $m ) ) {
 106                         return array( 'width' => $m[2], 'page' => $m[1] );
 107                 } else {
 108                         return false;
 109                 }
 110         }
 111
 112         /**
 113          * @param $params
 114          * @return array
 115          */
 116         function getScriptParams( $params ) {
 117                 return array(
 118                         'width' => $params['width'],
 119                         'page' => $params['page'],
 120                 );
 121         }
 122
 123         /**
 124          * @param $image File
 125          * @param  $dstPath
 126          * @param  $dstUrl
 127          * @param  $params
 128          * @param int $flags
 129          * @return MediaTransformError|ThumbnailImage|TransformParameterError
 130          */
 131         function doTransform( $image, $dstPath, $dstUrl, $params, $flags = 0 ) {
 132                 global $wgDjvuRenderer, $wgDjvuPostProcessor;
 133
 134                 // Fetch XML and check it, to give a more informative error message than the one which
 135                 // normaliseParams will inevitably give.
 136                 $xml = $image->getMetadata();
 137                 if ( !$xml ) {
 138                         $width = isset( $params['width'] ) ? $params['width'] : 0;
 139                         $height = isset( $params['height'] ) ? $params['height'] : 0;
 140                         return new MediaTransformError( 'thumbnail_error', $width, $height,
 141                                 wfMsg( 'djvu_no_xml' ) );
 142                 }
 143
 144                 if ( !$this->normaliseParams( $image, $params ) ) {
 145                         return new TransformParameterError( $params );
 146                 }
 147                 $width = $params['width'];
 148                 $height = $params['height'];
 149                 $page = $params['page'];
 150                 if ( $page > $this->pageCount( $image ) ) {
 151                         return new MediaTransformError( 'thumbnail_error', $width, $height, wfMsg( 'djvu_page_error' ) );
 152                 }
 153
 154                 if ( $flags & self::TRANSFORM_LATER ) {
 155                         return new ThumbnailImage( $image, $dstUrl, $width, $height, $dstPath, $page );
 156                 }
 157
 158                 if ( !wfMkdirParents( dirname( $dstPath ), null, __METHOD__ ) ) {
 159                         return new MediaTransformError( 'thumbnail_error', $width, $height, wfMsg( 'thumbnail_dest_directory' ) );
 160                 }
 161
 162                 $srcPath = $image->getLocalRefPath();
 163                 # Use a subshell (brackets) to aggregate stderr from both pipeline commands
 164                 # before redirecting it to the overall stdout. This works in both Linux and Windows XP.
 165                 $cmd = '(' . wfEscapeShellArg( $wgDjvuRenderer ) . " -format=ppm -page={$page}" .
 166                         " -size={$params['physicalWidth']}x{$params['physicalHeight']} " .
 167                         wfEscapeShellArg( $srcPath );
 168                 if ( $wgDjvuPostProcessor ) {
 169                         $cmd .= " | {$wgDjvuPostProcessor}";
 170                 }
 171                 $cmd .= ' > ' . wfEscapeShellArg($dstPath) . ') 2>&1';
 172                 wfProfileIn( 'ddjvu' );
 173                 wfDebug( __METHOD__.": $cmd\n" );
 174                 $retval = '';
 175                 $err = wfShellExec( $cmd, $retval );
 176                 wfProfileOut( 'ddjvu' );
 177
 178                 $removed = $this->removeBadFile( $dstPath, $retval );
 179                 if ( $retval != 0 || $removed ) {
 180                         wfDebugLog( 'thumbnail',
 181                                 sprintf( 'thumbnail failed on %s: error %d "%s" from "%s"',
 182                                         wfHostname(), $retval, trim($err), $cmd ) );
 183                         return new MediaTransformError( 'thumbnail_error', $width, $height, $err );
 184                 } else {
 185                         return new ThumbnailImage( $image, $dstUrl, $width, $height, $dstPath, $page );
 186                 }
 187         }
 188
 189         /**
 190          * Cache an instance of DjVuImage in an Image object, return that instance
 191          *
 192          * @return DjVuImage
 193          */
 194         function getDjVuImage( $image, $path ) {
 195                 if ( !$image ) {
 196                         $deja = new DjVuImage( $path );
 197                 } elseif ( !isset( $image->dejaImage ) ) {
 198                         $deja = $image->dejaImage = new DjVuImage( $path );
 199                 } else {
 200                         $deja = $image->dejaImage;
 201                 }
 202                 return $deja;
 203         }
 204
 205         /**
 206          * Cache a document tree for the DjVu XML metadata
 207          * @param $image File
 208          * @param $gettext Boolean: DOCUMENT (Default: false)
 209          * @return bool
 210          */
 211         function getMetaTree( $image , $gettext = false ) {
 212                 if ( isset( $image->dejaMetaTree ) ) {
 213                         return $image->dejaMetaTree;
 214                 }
 215
 216                 $metadata = $image->getMetadata();
 217                 if ( !$this->isMetadataValid( $image, $metadata ) ) {
 218                         wfDebug( "DjVu XML metadata is invalid or missing, should have been fixed in upgradeRow\n" );
 219                         return false;
 220                 }
 221                 wfProfileIn( __METHOD__ );
 222
 223                 wfSuppressWarnings();
 224                 try {
 225                         // Set to false rather than null to avoid further attempts
 226                         $image->dejaMetaTree = false;
 227                         $image->djvuTextTree = false;
 228                         $tree = new SimpleXMLElement( $metadata );
 229                         if( $tree->getName() == 'mw-djvu' ) {
 230                                 foreach($tree->children() as $b){
 231                                         if( $b->getName() == 'DjVuTxt' ) {
 232                                                 $image->djvuTextTree = $b;
 233                                         }
 234                                         elseif ( $b->getName() == 'DjVuXML' ) {
 235                                                 $image->dejaMetaTree = $b;
 236                                         }
 237                                 }
 238                         } else {
 239                                 $image->dejaMetaTree = $tree;
 240                         }
 241                 } catch( Exception $e ) {
 242                         wfDebug( "Bogus multipage XML metadata on '{$image->getName()}'\n" );
 243                 }
 244                 wfRestoreWarnings();
 245                 wfProfileOut( __METHOD__ );
 246                 if( $gettext ) {
 247                         return $image->djvuTextTree;
 248                 } else {
 249                         return $image->dejaMetaTree;
 250                 }
 251         }
 252
 253         function getImageSize( $image, $path ) {
 254                 return $this->getDjVuImage( $image, $path )->getImageSize();
 255         }
 256
 257         function getThumbType( $ext, $mime, $params = null ) {
 258                 global $wgDjvuOutputExtension;
 259                 static $mime;
 260                 if ( !isset( $mime ) ) {
 261                         $magic = MimeMagic::singleton();
 262                         $mime = $magic->guessTypesForExtension( $wgDjvuOutputExtension );
 263                 }
 264                 return array( $wgDjvuOutputExtension, $mime );
 265         }
 266
 267         function getMetadata( $image, $path ) {
 268                 wfDebug( "Getting DjVu metadata for $path\n" );
 269                 return $this->getDjVuImage( $image, $path )->retrieveMetaData();
 270         }
 271
 272         function getMetadataType( $image ) {
 273                 return 'djvuxml';
 274         }
 275
 276         function isMetadataValid( $image, $metadata ) {
 277                 return !empty( $metadata ) && $metadata != serialize(array());
 278         }
 279
 280         function pageCount( $image ) {
 281                 $tree = $this->getMetaTree( $image );
 282                 if ( !$tree ) {
 283                         return false;
 284                 }
 285                 return count( $tree->xpath( '//OBJECT' ) );
 286         }
 287
 288         function getPageDimensions( $image, $page ) {
 289                 $tree = $this->getMetaTree( $image );
 290                 if ( !$tree ) {
 291                         return false;
 292                 }
 293
 294                 $o = $tree->BODY[0]->OBJECT[$page-1];
 295                 if ( $o ) {
 296                         return array(
 297                                 'width' => intval( $o['width'] ),
 298                                 'height' => intval( $o['height'] )
 299                         );
 300                 } else {
 301                         return false;
 302                 }
 303         }
 304
 305         function getPageText( $image, $page ){
 306                 $tree = $this->getMetaTree( $image, true );
 307                 if ( !$tree ) {
 308                         return false;
 309                 }
 310
 311                 $o = $tree->BODY[0]->PAGE[$page-1];
 312                 if ( $o ) {
 313                         $txt = $o['value'];
 314                         return $txt;
 315                 } else {
 316                         return false;
 317                 }
 318
 319         }
 320
 321 }