[Summary view] [Print] [Text view]

   1  <?php
   2  /**
   3   * Packed image gallery. All images adjusted to be same height.
   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   */
  22  
  23  class PackedImageGallery extends TraditionalImageGallery {
  24  	function __construct( $mode = 'traditional' ) {
  25          parent::__construct( $mode );
  26          // Does not support per row option.
  27          $this->mPerRow = 0;
  28      }
  29  
  30      /**
  31       * We artificially have 1.5 the resolution neccessary so that
  32       * we can scale it up by that much on the client side, without
  33       * worrying about requesting a new image.
  34       */
  35      const SCALE_FACTOR = 1.5;
  36  
  37  	protected function getVPad( $boxHeight, $thumbHeight ) {
  38          return ( $this->getThumbPadding() + $boxHeight - $thumbHeight / self::SCALE_FACTOR ) / 2;
  39      }
  40  
  41  	protected function getThumbPadding() {
  42          return 0;
  43      }
  44  
  45  	protected function getGBPadding() {
  46          return 2;
  47      }
  48  
  49      /**
  50       * @param File $img The file being transformed. May be false
  51       * @return array
  52       */
  53  	protected function getThumbParams( $img ) {
  54          if ( $img && $img->getMediaType() === MEDIATYPE_AUDIO ) {
  55              $width = $this->mWidths;
  56          } else {
  57              // We want the width not to be the constraining
  58              // factor, so use random big number.
  59              $width = $this->mHeights * 10 + 100;
  60          }
  61  
  62          // self::SCALE_FACTOR so the js has some room to manipulate sizes.
  63          return array(
  64              'width' => $width * self::SCALE_FACTOR,
  65              'height' => $this->mHeights * self::SCALE_FACTOR,
  66          );
  67      }
  68  
  69  	protected function getThumbDivWidth( $thumbWidth ) {
  70          // Require at least 60px wide, so caption is wide enough to work.
  71          if ( $thumbWidth < 60 * self::SCALE_FACTOR ) {
  72              $thumbWidth = 60 * self::SCALE_FACTOR;
  73          }
  74  
  75          return $thumbWidth / self::SCALE_FACTOR + $this->getThumbPadding();
  76      }
  77  
  78      /**
  79       * @param MediaTransformOutput|bool $thumb The thumbnail, or false if no
  80       *   thumb (which can happen)
  81       * @return float
  82       */
  83  	protected function getGBWidth( $thumb ) {
  84          $thumbWidth = $thumb ? $thumb->getWidth() : $this->mWidths * self::SCALE_FACTOR;
  85  
  86          return $this->getThumbDivWidth( $thumbWidth ) + $this->getGBPadding();
  87      }
  88  
  89  	protected function adjustImageParameters( $thumb, &$imageParameters ) {
  90          // Re-adjust back to normal size.
  91          $imageParameters['override-width'] = ceil( $thumb->getWidth() / self::SCALE_FACTOR );
  92          $imageParameters['override-height'] = ceil( $thumb->getHeight() / self::SCALE_FACTOR );
  93      }
  94  
  95      /**
  96       * Add javascript which auto-justifies the rows by manipulating the image sizes.
  97       * Also ensures that the hover version of this degrades gracefully.
  98       * @return array
  99       */
 100  	protected function getModules() {
 101          return array( 'mediawiki.page.gallery' );
 102      }
 103  
 104      /**
 105       * Do not support per-row on packed. It really doesn't work
 106       * since the images have varying widths.
 107       * @param int $num
 108       */
 109  	public function setPerRow( $num ) {
 110          return;
 111      }
 112  }