You are here

canvasactions.inc in ImageCache Actions 7

Same filename and directory in other branches
  1. 8 canvasactions/canvasactions.inc
  2. 6.2 canvasactions/canvasactions.inc

File

canvasactions/canvasactions.inc
View source
<?php

/**
 * @file Helper functions for the canvas actions for imagecache
 *
 * @author Dan Morrison http://coders.co.nz
 *
 * Individually configurable rounded corners logic contributed by canaryMason
 * 2009 03 https://drupal.org/node/402112
 *
 * Better algorithm for trimming rounded corners from donquixote
 * 2009 09 https://drupal.org/node/564036
 *
 */
if (!function_exists('image_overlay')) {
  module_load_include('inc', 'imagecache_actions', 'image_overlay');
}
if (!function_exists('imagecache_actions_pos_form')) {
  module_load_include('inc', 'imagecache_actions', 'utility-form');
}
if (!function_exists('imagecache_actions_keyword_filter')) {
  module_load_include('inc', 'imagecache_actions', 'utility');
}

/**
 * Image effect form callback for the image mask effect.
 *
 * @param array $data
 *   The current configuration for this image effect.
 *
 * @return array
 *   The form definition for this effect.
 */
function canvasactions_imagemask_form(array $data) {

  // @todo: add offset/positioning/scaling support - currently the mask is applied to the supplied image without resizing and positioned at (0,0)
  $form = array();
  $form['effect_help_text'] = array(
    '#type' => 'item',
    '#title' => t('Image mask'),
    '#description' => t('This effect will add (or replace) a transparency channel to your image. The mask file should be a grayscale image where black is fully transparent and white is fully opaque. The referenced mask will be applied to the top left of the image.'),
  );
  $form['path'] = array(
    '#type' => 'textfield',
    '#title' => t('Mask file name'),
    '#default_value' => isset($data['path']) ? $data['path'] : '',
    '#description' => imagecache_actions_file_field_description(),
    '#element_validate' => array(
      'imagecache_actions_validate_file',
    ),
  );
  return $form;
}

/**
 * Implements theme_hook() for the image mask effect summary.
 *
 * @param array $variables
 *   An associative array containing:
 *   - data: The current configuration for this image effect.
 *
 * @return string
 *   The HTML for the summary of this image effect.
 * @ingroup themeable
 */
function theme_canvasactions_imagemask_summary(array $variables) {
  $data = $variables['data'];
  return 'file: ' . $data['path'];
}

/**
 * Image effect callback for the image mask effect.
 *
 * @param stdClass $image
 * @param array $data
 *
 * @return bool
 *   true on success, false otherwise.
 */
function canvasactions_imagemask_effect(stdClass $image, array $data) {
  $mask = imagecache_actions_image_load($data['path'], $image->toolkit);
  if ($mask) {

    // @todo: (sydneyshan) Consider best way to add offset support - I assume we
    // would position the mask somewhere (top/left/offset px etc) and choose if
    // the surrounding area is white or black (opaque or transparent) using an
    // extra form element (radio). Assess existing positioning code first to
    // reduce duplication of code. Pass the results to the following function as
    // array($mask, $data). Perhaps add a 'scale mask to fit image'/'scale image
    // to fit mask'/'no scale' radio group?
    return image_toolkit_invoke('imagemask', $image, array(
      $mask,
    ));
  }
  return FALSE;
}

/**
 * GD toolkit specific implementation of the image mask effect.
 *
 * @param stdClass $image
 *   Image object containing the GD image resource to operate on.
 * @param stdClass $mask
 *   An image object containing the image to use as mask.
 *
 * @return bool
 *   true on success, false otherwise.
 */
function image_gd_imagemask(stdClass $image, stdClass $mask) {
  $newPicture = imagecreatetruecolor($image->info['width'], $image->info['height']);
  imagesavealpha($newPicture, TRUE);
  imagealphablending($newPicture, TRUE);
  $transparent = imagecolorallocatealpha($newPicture, 0, 0, 0, 127);
  imagefill($newPicture, 0, 0, $transparent);

  // Perform pixel-based alpha map application.
  for ($x = 0; $x < $image->info['width']; $x++) {
    for ($y = 0; $y < $image->info['height']; $y++) {

      // Deal with images with mismatched sizes
      if ($x >= $mask->info['width'] || $y >= $mask->info['height']) {
        imagesetpixel($newPicture, $x, $y, $transparent);
      }
      else {
        $alpha = imagecolorsforindex($mask->resource, imagecolorat($mask->resource, $x, $y));
        $alpha = 127 - floor($alpha['red'] / 2);
        $color = imagecolorsforindex($image->resource, imagecolorat($image->resource, $x, $y));
        imagesetpixel($newPicture, $x, $y, imagecolorallocatealpha($newPicture, $color['red'], $color['green'], $color['blue'], $alpha));
      }
    }
  }

  // Copy back to original picture.
  imagedestroy($image->resource);
  $image->resource = $newPicture;
  return TRUE;
}

/**
 * Imagemagick toolkit specific implementation of the image mask effect.
 *
 * @param stdClass $image
 *   Image object containing the image resource to operate on.
 * @param stdClass $mask
 *   An image object containing the image to use as mask.
 *
 * @return bool
 *   true on success, false otherwise.
 */
function image_imagemagick_imagemask(stdClass $image, stdClass $mask) {
  $image->ops[] = escapeshellarg($mask->source);
  $image->ops[] = '-alpha Off -compose CopyOpacity -composite';
  return TRUE;
}

/**
 * Image effect form callback for the define canvas effect.
 *
 * @param array $data
 *   The current configuration for this image effect.
 *
 * @return array
 *   The form definition for this effect.
 */
function canvasactions_definecanvas_form(array $data) {
  module_load_include('inc', 'imagecache_actions', 'utility-color');
  $defaults = array(
    'RGB' => array(
      'HEX' => '#333333',
    ),
    'under' => TRUE,
    'exact' => array(
      'width' => '',
      'height' => '',
      'xpos' => 'center',
      'ypos' => 'center',
    ),
    'relative' => array(
      'leftdiff' => '',
      'rightdiff' => '',
      'topdiff' => '',
      'bottomdiff' => '',
    ),
  );
  $data += $defaults;
  $form = array(
    'RGB' => imagecache_rgb_form($data['RGB']),
    'help' => array(
      '#markup' => t('Enter no color value for transparent. This will have the effect of adding clear margins around the image.'),
      '#prefix' => '<p>',
      '#suffix' => '</p>',
    ),
    'under' => array(
      '#type' => 'checkbox',
      '#title' => t('Resize canvas <em>under</em> image (possibly cropping)'),
      '#default_value' => $data['under'],
      '#description' => t('If <em>not</em> set, this will create a solid flat layer, probably totally obscuring the source image'),
    ),
  );
  $form['info'] = array(
    '#value' => t('Enter values in ONLY ONE of the below options. Either exact or relative. Most values are optional - you can adjust only one dimension as needed. If no useful values are set, the current base image size will be used.'),
  );
  $form['exact'] = array(
    '#type' => 'fieldset',
    '#collapsible' => TRUE,
    '#title' => 'Exact size',
    'help' => array(
      '#markup' => t('Set the canvas to a precise size, possibly cropping the image. Use to start with a known size.'),
      '#prefix' => '<p>',
      '#suffix' => '</p>',
    ),
    'width' => array(
      '#type' => 'textfield',
      '#title' => t('Width'),
      '#default_value' => $data['exact']['width'],
      '#description' => t('Enter a value in pixels or percent'),
      '#size' => 5,
    ),
    'height' => array(
      '#type' => 'textfield',
      '#title' => t('Height'),
      '#default_value' => $data['exact']['height'],
      '#description' => t('Enter a value in pixels or percent'),
      '#size' => 5,
    ),
  );
  $form['exact'] = array_merge($form['exact'], imagecache_actions_pos_form($data['exact']));
  if (!$data['exact']['width'] && !$data['exact']['height']) {
    $form['exact']['#collapsed'] = TRUE;
  }
  $form['relative'] = array(
    '#type' => 'fieldset',
    '#collapsible' => TRUE,
    '#title' => t('Relative size'),
    'help' => array(
      '#markup' => t('Set the canvas to a relative size, based on the current image dimensions. Use to add simple borders or expand by a fixed amount. Negative values may crop the image.'),
      '#prefix' => '<p>',
      '#suffix' => '</p>',
    ),
    'leftdiff' => array(
      '#type' => 'textfield',
      '#title' => t('left difference'),
      '#default_value' => $data['relative']['leftdiff'],
      '#size' => 6,
      '#description' => t('Enter an offset in pixels.'),
    ),
    'rightdiff' => array(
      '#type' => 'textfield',
      '#title' => t('right difference'),
      '#default_value' => $data['relative']['rightdiff'],
      '#size' => 6,
      '#description' => t('Enter an offset in pixels.'),
    ),
    'topdiff' => array(
      '#type' => 'textfield',
      '#title' => t('top difference'),
      '#default_value' => $data['relative']['topdiff'],
      '#size' => 6,
      '#description' => t('Enter an offset in pixels.'),
    ),
    'bottomdiff' => array(
      '#type' => 'textfield',
      '#title' => t('bottom difference'),
      '#default_value' => $data['relative']['bottomdiff'],
      '#size' => 6,
      '#description' => t('Enter an offset in pixels.'),
    ),
  );
  if (!$data['relative']['leftdiff'] && !$data['relative']['rightdiff'] && !$data['relative']['topdiff'] && !$data['relative']['bottomdiff']) {
    $form['relative']['#collapsed'] = TRUE;
  }
  $form['#submit'][] = 'canvasactions_definecanvas_form_submit';
  return $form;
}

/** @noinspection PhpDocMissingThrowsInspection */

/**
 * Implements theme_hook() for the define canvas effect summary.
 *
 * @param array $variables
 *   An associative array containing:
 *   - data: The current configuration for this image effect.
 *
 * @return string
 *   The HTML for the summary of this image effect.
 * @ingroup themeable
 */
function theme_canvasactions_definecanvas_summary(array $variables) {
  $data = $variables['data'];
  if ($data['exact']['width'] || $data['exact']['height']) {
    $w = !empty($data['exact']['width']) ? $data['exact']['width'] : '100%';
    $h = !empty($data['exact']['height']) ? $data['exact']['height'] : '100%';
    $x = !empty($data['exact']['xpos']) ? $data['exact']['xpos'] : '0';
    $y = !empty($data['exact']['ypos']) ? $data['exact']['ypos'] : '0';
    $output = "{$w}x{$h} ({$x}, {$y})";
  }
  else {
    $output = ' left:' . $data['relative']['leftdiff'];
    $output .= ' right:' . $data['relative']['rightdiff'];
    $output .= ' top:' . $data['relative']['topdiff'];
    $output .= ' bottom:' . $data['relative']['bottomdiff'];
  }

  /** @noinspection PhpUnhandledExceptionInspection */
  $output .= theme('imagecacheactions_rgb', array(
    'RGB' => $data['RGB'],
  ));
  $output .= $data['under'] ? t(" <b>under</b> image ") : t(" <b>over</b> image ");
  return $output;
}

/**
 * Image effect callback for the define canvas effect.
 *
 * @param stdClass $image
 * @param array $data
 *
 * @return boolean
 *   true on success, false otherwise.
 */
function canvasactions_definecanvas_effect(stdClass $image, array $data) {

  // May be given either exact or relative dimensions.
  if ($data['exact']['width'] || $data['exact']['height']) {

    // Allows only one dimension to be used if the other is unset.
    if (!$data['exact']['width']) {
      $data['exact']['width'] = $image->info['width'];
    }
    if (!$data['exact']['height']) {
      $data['exact']['height'] = $image->info['height'];
    }
    $target_size['width'] = imagecache_actions_percent_filter($data['exact']['width'], $image->info['width']);
    $target_size['height'] = imagecache_actions_percent_filter($data['exact']['height'], $image->info['height']);
    $target_size['left'] = image_filter_keyword($data['exact']['xpos'], $target_size['width'], $image->info['width']);
    $target_size['top'] = image_filter_keyword($data['exact']['ypos'], $target_size['height'], $image->info['height']);
  }
  else {

    // Calculate relative size.
    $target_size['width'] = $image->info['width'] + (int) $data['relative']['leftdiff'] + (int) $data['relative']['rightdiff'];
    $target_size['height'] = $image->info['height'] + (int) $data['relative']['topdiff'] + (int) $data['relative']['bottomdiff'];
    $target_size['left'] = (int) $data['relative']['leftdiff'];
    $target_size['top'] = (int) $data['relative']['topdiff'];
  }

  // Convert from hex (as it is stored in the UI).
  if ($data['RGB']['HEX'] && ($deduced = imagecache_actions_hex2rgba($data['RGB']['HEX']))) {
    $data['RGB'] = array_merge($data['RGB'], $deduced);
  }

  // All the math is done, now defer to the toolkit in use.
  $data['targetsize'] = $target_size;
  $success = image_toolkit_invoke('definecanvas', $image, array(
    $data,
  ));
  if ($success) {
    $image->info['width'] = $target_size['width'];
    $image->info['height'] = $target_size['height'];
  }
  return $success;
}

/**
 * GD toolkit specific implementation of the define canvas effect.
 *
 * @param stdClass $image
 * @param array $data
 *   The parameters for this effect. $data['targetsize'] is an array expected to
 *   contain a width, height and a left, top.
 *
 * @return bool
 *   true on success, false otherwise.
 */
function image_gd_definecanvas(stdClass $image, array $data) {
  $target_size = $data['targetsize'];
  $RGB = $data['RGB'];
  $newcanvas = imagecreatetruecolor($target_size['width'], $target_size['height']);
  imagesavealpha($newcanvas, TRUE);
  imagealphablending($newcanvas, FALSE);
  imagesavealpha($image->resource, TRUE);
  if ($RGB['HEX']) {

    // Set color, allow it to define transparency, or assume opaque.
    $background = imagecolorallocatealpha($newcanvas, $RGB['red'], $RGB['green'], $RGB['blue'], $RGB['alpha']);
  }
  else {

    // No color, attempt transparency, assume white.
    $background = imagecolorallocatealpha($newcanvas, 255, 255, 255, 127);
  }
  imagefilledrectangle($newcanvas, 0, 0, $target_size['width'], $target_size['height'], $background);
  if ($data['under']) {
    $canvas_object = new stdClass();
    $canvas_object->resource = $newcanvas;
    $canvas_object->info = array(
      'width' => $target_size['width'],
      'height' => $target_size['height'],
      'mime_type' => $image->info['mime_type'],
      'extension' => $image->info['extension'],
    );
    $canvas_object->toolkit = $image->toolkit;
    image_overlay($image, $canvas_object, $target_size['left'], $target_size['top'], 100, TRUE);
  }
  else {
    $image->resource = $newcanvas;
  }
  return TRUE;
}

/**
 * Imagemagick toolkit specific implementation of the define canvas effect.
 *
 * @param stdClass $image
 * @param array $data
 *   The parameters for this effect. $data['targetsize'] is an array expected to
 *   contain a width, height and a left, top.
 *
 * @return bool
 *   true on success, false otherwise.
 *
 * @see http://www.imagemagick.org/script/command-line-options.php#extent
 */
function image_imagemagick_definecanvas(stdClass $image, $data) {

  // Reset any gravity settings from earlier effects.
  $image->ops[] = '-gravity None';
  $backgroundcolor = $data['RGB']['HEX'] != '' ? '#' . ltrim($data['RGB']['HEX'], '#') : 'None';
  $image->ops[] = '-background ' . escapeshellarg($backgroundcolor);
  $compose_operator = $data['under'] ? 'src-over' : 'dst-over';
  $image->ops[] = "-compose {$compose_operator}";
  $target_size = $data['targetsize'];
  $geometry = sprintf('%dx%d', $target_size['width'], $target_size['height']);
  if ($target_size['left'] || $target_size['top']) {
    $geometry .= sprintf('%+d%+d', -$target_size['left'], -$target_size['top']);
  }
  $image->ops[] = '-extent ' . escapeshellarg($geometry);
  return TRUE;
}

/**
 * Image dimensions callback for the define canvas effect.
 *
 * @param array $dimensions
 *   Dimensions to be modified - an associative array containing the items
 *   'width' and 'height' (in pixels).
 * @param array $data
 *   An associative array containing the effect data.
 */
function canvasactions_definecanvas_dimensions(array &$dimensions, array $data) {

  // May be given either exact or relative dimensions.
  if ($data['exact']['width'] || $data['exact']['height']) {

    // Allows only one dimension to be used if the other is unset.
    if (!$data['exact']['width']) {
      $data['exact']['width'] = $dimensions['width'];
    }
    if (!$data['exact']['height']) {
      $data['exact']['height'] = $dimensions['height'];
    }
    $dimensions['width'] = imagecache_actions_percent_filter($data['exact']['width'], $dimensions['width']);
    $dimensions['height'] = imagecache_actions_percent_filter($data['exact']['height'], $dimensions['height']);
  }
  else {

    // Calculate relative sizes (only possible if we have the current size).
    if ($dimensions['width'] !== NULL) {
      $dimensions['width'] = $dimensions['width'] + (int) $data['relative']['leftdiff'] + (int) $data['relative']['rightdiff'];
    }
    if ($dimensions['height'] !== NULL) {
      $dimensions['height'] = $dimensions['height'] + (int) $data['relative']['topdiff'] + (int) $data['relative']['bottomdiff'];
    }
  }
}

/**
 * Image effect form callback for the underlay (background) effect.
 *
 * @param array $data
 *   The current configuration for this image effect.
 *
 * @return array
 *   The form definition for this effect.
 */
function canvasactions_canvas2file_form(array $data) {
  $defaults = array(
    'xpos' => '0',
    'ypos' => '0',
    'alpha' => '100',
    'path' => '',
    'dimensions' => 'original',
  );
  $data = array_merge($defaults, (array) $data);
  $form = imagecache_actions_pos_form($data);
  $form['alpha'] = array(
    '#type' => 'textfield',
    '#title' => t('opacity'),
    '#default_value' => $data['alpha'],
    '#size' => 6,
    '#description' => t('Opacity: 0-100. Be aware that values other than 100% may be slow to process.'),
  );
  $form['path'] = array(
    '#type' => 'textfield',
    '#title' => t('file name'),
    '#default_value' => $data['path'],
    '#description' => imagecache_actions_file_field_description(),
    '#element_validate' => array(
      'imagecache_actions_validate_file',
    ),
  );
  $form['dimensions'] = array(
    '#type' => 'radios',
    '#title' => t('final dimensions'),
    '#default_value' => $data['dimensions'],
    '#options' => array(
      'original' => 'original (dimensions are retained)',
      'background' => 'background (image will be forced to match the size of the background)',
      'minimum' => 'minimum (image may be cropped)',
      'maximum' => 'maximum (image may end up with gaps)',
    ),
    '#description' => t('What to do when the background image is a different size from the source image. Backgrounds are not tiled, but may be arbitrarily large.'),
  );
  return $form;
}

/**
 * Implements theme_hook() for the underlay (background) effect summary.
 *
 * @param array $variables
 *   An associative array containing:
 *   - data: The current configuration for this image effect.
 *
 * @return string
 *   The HTML for the summary of this image effect.
 * @ingroup themeable
 */
function theme_canvasactions_canvas2file_summary($variables) {
  $data = $variables['data'];
  $file = $data['path'];
  return "xpos:{$data['xpos']} , ypos:{$data['ypos']} alpha:{$data['alpha']}%. file: {$file}, dimensions:{$data['dimensions']}";
}

/**
 * Image effect callback for the underlay (background) effect.
 *
 * @param stdClass $image
 * @param array $data
 *
 * @return boolean
 *   true on success, false otherwise.
 */
function canvasactions_canvas2file_effect(stdClass $image, array $data) {
  $underlay = imagecache_actions_image_load($data['path'], $image->toolkit);
  if ($underlay) {

    // To handle odd sizes, we will resize/crop the background image to the
    // desired dimensions before starting the merge. The built-in
    // imagecopymerge, and the watermark library both do not allow overlays to
    // be bigger than the target.
    // Adjust size.
    $crop_rules = array(
      'xoffset' => 0,
      'yoffset' => 0,
    );
    if (empty($data['dimensions'])) {
      $data['dimensions'] = 'original';
    }
    switch ($data['dimensions']) {
      case 'original':

        // If the underlay is smaller than the target size,
        // then when preparing the underlay by cropping it,
        // the offsets may need to be negative
        // which will produce a 'cropped' image larger than the original.
        // In this case, we need to calculate the position of the bg image
        // in relation to the space it will occupy under the top layer

        //$crop_rules['xoffset'] = $underlay->info['width'] - $image->info['width'] ;
        $crop_rules['width'] = $image->info['width'];
        $crop_rules['height'] = $image->info['height'];
        break;
      case 'background':
        $crop_rules['width'] = $underlay->info['width'];
        $crop_rules['height'] = $underlay->info['height'];
        break;
      case 'minimum':
        $crop_rules['width'] = min($underlay->info['width'], $image->info['width']);
        $crop_rules['height'] = min($underlay->info['height'], $image->info['height']);
        break;
      case 'maximum':
        $crop_rules['width'] = max($underlay->info['width'], $image->info['width']);
        $crop_rules['height'] = max($underlay->info['height'], $image->info['height']);
        break;
    }

    // imageapi crop assumes upsize is legal.
    // Crop both before processing to avoid unwanted processing.
    image_crop_effect($underlay, $crop_rules);

    // @todo: BUG - this doesn't position either
    // Actually this fails because imagecache_crop fills it with solid color when 'cropping' to a larger size.

    //imagecache_crop_image($image, $crop_rules);

    //dpm(get_defined_vars());

    // This func modifies the underlay image by ref, placing the current canvas on it.
    if (image_overlay($image, $underlay, $data['xpos'], $data['ypos'], $data['alpha'], TRUE)) {

      //$image->resource = $underlay->resource;

      //$image = $underlay; //@todo: this is a no-op.
      return TRUE;
    }
  }
  return FALSE;
}

/**
 * Image dimensions callback for the underlay (background) effect.
 *
 * @param array $dimensions
 *   Dimensions to be modified - an associative array containing the items
 *   'width' and 'height' (in pixels).
 * @param array $data
 *   An associative array containing the effect data.
 */
function canvasactions_canvas2file_dimensions(array &$dimensions, array $data) {
  if ($data['dimensions'] !== 'original') {
    $underlay = imagecache_actions_image_load($data['path']);
    if ($underlay) {

      // If the new dimensions are taken from the background, we don't need to
      // know the original dimensions, we can just set the new dimensions to the
      // dimensions of the background. Otherwise, we need to know the old
      // dimensions. If unknown we have to leave them unknown.
      switch ($data['dimensions']) {
        case 'background':
          $dimensions['width'] = $underlay->info['width'];
          $dimensions['height'] = $underlay->info['height'];
          break;
        case 'minimum':
          if ($dimensions['width'] !== NULL) {
            $dimensions['width'] = min($underlay->info['width'], $dimensions['width']);
          }
          if ($dimensions['height'] !== NULL) {
            $dimensions['height'] = min($underlay->info['height'], $dimensions['height']);
          }
          break;
        case 'maximum':
          if ($dimensions['width'] !== NULL) {
            $dimensions['width'] = max($underlay->info['width'], $dimensions['width']);
          }
          if ($dimensions['height'] !== NULL) {
            $dimensions['height'] = max($underlay->info['height'], $dimensions['height']);
          }
          break;
      }
    }
  }
}

/**
 * Image effect form callback for the overlay (watermark) effect.
 *
 * @param array $data
 *   The current configuration for this image effect.
 *
 * @return array
 *   The form definition for this effect.
 */
function canvasactions_file2canvas_form(array $data) {
  $defaults = array(
    'xpos' => '',
    'ypos' => '',
    'alpha' => '100',
    'scale' => '',
    'path' => '',
  );
  $data = array_merge($defaults, (array) $data);
  $form = array(
    'help' => array(
      '#markup' => t('Note that using a non transparent overlay that is larger than the source image may result in unwanted results - a solid background.'),
    ),
  );
  $form += imagecache_actions_pos_form($data);
  $form['alpha'] = array(
    '#type' => 'textfield',
    '#title' => t('opacity'),
    '#default_value' => $data['alpha'],
    '#field_suffix' => t('%'),
    '#size' => 6,
    '#description' => t('Opacity: 0-100. <b>Warning:</b> Due to a limitation in the GD toolkit, using an opacity other than 100% requires the system to use an algorithm that\'s much slower than the built-in functions. If you want partial transparency, you are better to use an already-transparent png as the overlay source image.'),
    '#element_validate' => array(
      'imagecache_actions_validate_number_non_negative',
    ),
  );
  $form['scale'] = array(
    '#type' => 'textfield',
    '#title' => t('scale'),
    '#default_value' => $data['scale'],
    '#field_suffix' => t('%'),
    '#size' => 6,
    '#description' => t('Scales the overlay with respect to the source, thus not its own dimensions. Leave empty to use the original size of overlay image.'),
    '#element_validate' => array(
      'imagecache_actions_validate_number_positive',
    ),
  );
  $form['path'] = array(
    '#type' => 'textfield',
    '#title' => t('file name'),
    '#default_value' => $data['path'],
    '#description' => imagecache_actions_file_field_description(),
    '#element_validate' => array(
      'imagecache_actions_validate_file',
    ),
  );
  return $form;
}

/**
 * Implements theme_hook() for the overlay (watermark) effect summary.
 *
 * @param array $variables
 *   An associative array containing:
 *   - data: The current configuration for this image effect.
 *
 * @return string
 *   The HTML for the summary of this image effect.
 * @ingroup themeable
 */
function theme_canvasactions_file2canvas_summary(array $variables) {
  $data = $variables['data'];
  return '<strong>' . $data['path'] . '</strong>, x:' . $data['xpos'] . ', y:' . $data['ypos'] . ', alpha:' . (!empty($data['alpha']) ? $data['alpha'] : 100) . '%' . ', scale:' . (!empty($data['scale']) ? $data['scale'] . '%' : '-');
}

/**
 * Image effect callback for the overlay (watermark) image effect.
 *
 * @param stdClass $image
 * @param array $data
 *
 * @return boolean
 *   true on success, false otherwise.
 */
function canvasactions_file2canvas_effect(stdClass $image, array $data) {
  $overlay = imagecache_actions_image_load($data['path']);
  if ($overlay) {
    if (!empty($data['scale']) && $data['scale'] > 0) {

      // Scale the overlay with respect to the dimensions of the source being
      // overlaid. To maintain the aspect ratio, only the width of the overlay
      // is scaled like that, the height of the overlay follows the aspect
      // ratio (that is why we use image_scale instead of image_resize).
      $overlay_w = $image->info['width'] * $data['scale'] / 100;
      image_scale($overlay, $overlay_w, NULL, TRUE);
    }
    if (!isset($data['alpha'])) {
      $data['alpha'] = 100;
    }
    return image_overlay($image, $overlay, $data['xpos'], $data['ypos'], $data['alpha']);
  }
  return FALSE;
}

/**
 * Image effect form callback for the overlay: source image to canvas effect.
 *
 * @param array $data
 *   The current configuration for this image effect.
 *
 * @return array
 *   The form definition for this effect.
 */
function canvasactions_source2canvas_form($data) {
  $defaults = array(
    'xpos' => '',
    'ypos' => '',
    'alpha' => '100',
    'path' => '',
  );
  $data = array_merge($defaults, (array) $data);
  $form = imagecache_actions_pos_form($data);
  $form['alpha'] = array(
    '#type' => 'textfield',
    '#title' => t('opacity'),
    '#default_value' => $data['alpha'],
    '#size' => 6,
    '#description' => t('Opacity: 0-100.'),
  );
  return $form;
}

/**
 * Implements theme_hook() for the overlay: source img to canvas effect summary.
 *
 * @param array $variables
 *   An associative array containing:
 *   - data: The current configuration for this image effect.
 *
 * @return string
 *   The HTML for the summary of this image effect.
 * @ingroup themeable
 */
function theme_canvasactions_source2canvas_summary(array $variables) {
  $data = $variables['data'];
  return 'xpos:' . $data['xpos'] . ', ypos:' . $data['ypos'] . ' alpha:' . $data['alpha'] . '%';
}

/**
 * Image effect callback for the overlay: source image to canvas effect.
 *
 * @param stdClass $image
 * @param array $data
 *
 * @return boolean
 *   true on success, false otherwise.
 */
function canvasactions_source2canvas_effect(stdClass $image, array $data) {
  $overlay = image_load($image->source, $image->toolkit);
  return image_overlay($image, $overlay, $data['xpos'], $data['ypos'], $data['alpha']);
}

/**
 * Image effect form callback for the aspect switcher effect.
 *
 * @param array $data
 *   The current configuration for this image effect.
 *
 * @return array
 *   The form definition for this effect.
 */
function canvasactions_aspect_form(array $data) {
  $defaults = array(
    'ratio_adjustment' => 1,
    'portrait' => '',
    'landscape' => '',
  );
  $data = array_merge($defaults, (array) $data);
  $form = array(
    'help' => array(
      '#markup' => t('You must create the two presets to use <em>before</em> enabling this process.'),
    ),
  );

  // The PASS_THROUGH parameter is new as of D7.23, and is added here to prevent
  // image_style_options() from double-encoding the human-readable image style
  // name, since the form API will already sanitize options in a select list.
  $styles = image_style_options(TRUE, PASS_THROUGH);

  // @todo: remove the current style to prevent (immediate) recursion?
  $form['portrait'] = array(
    '#type' => 'select',
    '#title' => t('Style to use if the image is portrait (vertical)'),
    '#default_value' => $data['portrait'],
    '#options' => $styles,
    '#description' => t('If you choose none, no extra processing will be done.'),
  );
  $form['landscape'] = array(
    '#type' => 'select',
    '#title' => t('Style to use if the image is landscape (horizontal)'),
    '#default_value' => $data['landscape'],
    '#options' => $styles,
    '#description' => t('If you choose none, no extra processing will be done.'),
  );
  $form['ratio_adjustment'] = array(
    '#type' => 'textfield',
    '#title' => t('Ratio Adjustment (advanced)'),
    '#size' => 3,
    '#default_value' => $data['ratio_adjustment'],
    '#description' => t("\nThis allows you to bend the rules for how different the proportions need to be to trigger the switch.\n<br/>If the (width/height)*n is greater than 1, use 'landscape', otherwise use 'portrait'.\n<br/>When n = 1 (the default) it will switch between portrait and landscape modes.\n<br/>If n > 1, images that are slightly wide will still be treated as portraits.\nIf n < 1 then blunt portraits will be treated as landscape.\n    "),
  );
  return $form;
}

/**
 * Implements theme_hook() for the aspect switcher effect summary.
 *
 * @param array $variables
 *   An associative array containing:
 *   - data: The current configuration for this image effect.
 *
 * @return string
 *   The HTML for the summary of this image effect.
 * @ingroup themeable
 */
function theme_canvasactions_aspect_summary(array $variables) {
  $data = $variables['data'];
  $label = imagecache_actions_get_style_label($data['portrait']);
  $output = t('Portrait size: %label', array(
    '%label' => $label,
  ));
  $label = imagecache_actions_get_style_label($data['landscape']);
  $output .= ', ' . t('Landscape size: %label', array(
    '%label' => $label,
  ));
  if ($data['ratio_adjustment'] != 1) {
    $output .= ', ' . t("(switch at 1:@ratio_adjustment)", array(
      '@ratio_adjustment' => $data['ratio_adjustment'],
    ));
  }
  return trim($output);
}

/**
 * Image effect callback for the aspect switcher effect.
 *
 * @param stdClass $image
 * @param array $data
 *
 * @return boolean
 *   true on success, false otherwise.
 */
function canvasactions_aspect_effect(stdClass $image, array $data) {
  $ratio_adjustment = isset($data['ratio_adjustment']) ? floatval($data['ratio_adjustment']) : 1;
  $aspect = $image->info['width'] / $image->info['height'];

  // width / height * adjustment. If > 1, it's wide.
  $style_name = $aspect * $ratio_adjustment > 1 ? $data['landscape'] : $data['portrait'];
  if (empty($style_name)) {

    // Do nothing. just return what we've got.
    return TRUE;
  }
  $style = image_style_load($style_name);
  if (empty($style)) {

    // Required preset has gone missing?
    watchdog('imagecache_actions', "When running 'aspect' action, I was unable to load sub-action %style_name. Either it's been deleted or the DB needs an update", array(
      '%style_name' => $style_name,
    ), WATCHDOG_ERROR);
    return FALSE;
  }

  // Run the preset actions ourself.
  foreach ($style['effects'] as $sub_effect) {
    image_effect_apply($image, $sub_effect);
  }
  return TRUE;
}

/**
 * Image dimensions callback for the aspect switcher effect.
 *
 * @param array $dimensions
 *   Dimensions to be modified - an associative array containing the items
 *   'width' and 'height' (in pixels).
 * @param array $data
 *   An associative array containing the effect data.
 */
function canvasactions_aspect_dimensions(array &$dimensions, array $data) {
  if (empty($dimensions['width']) || empty($dimensions['height'])) {

    // We cannot know which preset would be executed and thus cannot know the
    // resulting dimensions, unless both styles return the same dimensions:
    $landscape_dimensions = $portrait_dimensions = $dimensions;
    image_style_transform_dimensions($data['landscape'], $landscape_dimensions);
    image_style_transform_dimensions($data['portrait'], $portrait_dimensions);
    if ($landscape_dimensions == $portrait_dimensions) {
      $dimensions = $landscape_dimensions;
    }
    else {
      $dimensions['width'] = $dimensions['height'] = NULL;
    }
  }
  else {
    $ratio_adjustment = isset($data['ratio_adjustment']) ? floatval($data['ratio_adjustment']) : 1;
    $aspect = $dimensions['width'] / $dimensions['height'];
    $style_name = $aspect * $ratio_adjustment > 1 ? $data['landscape'] : $data['portrait'];
    image_style_transform_dimensions($style_name, $dimensions);
  }
}

/**
 * Image effect form callback for the resize percent effect.
 *
 * @param array $data
 *   The current configuration for this image effect.
 *
 * @return array
 *   The form definition for this effect.
 */
function canvasactions_resizepercent_form(array $data) {
  $defaults = array(
    'width' => '',
    'height' => '',
  );
  $data = array_merge($defaults, (array) $data);
  $form['#element_validate'] = array(
    'image_effect_scale_validate',
  );
  $form['width'] = array(
    '#type' => 'textfield',
    '#title' => t('Width'),
    '#default_value' => !empty($data['width']) ? (double) $data['width'] : '',
    '#field_suffix' => ' ' . t('percent'),
    '#required' => FALSE,
    '#size' => 10,
    '#element_validate' => array(
      'canvasactions_resizepercent_validate',
    ),
    '#allow_negative' => FALSE,
  );
  $form['height'] = array(
    '#type' => 'textfield',
    '#title' => t('Height'),
    '#default_value' => !empty($data['height']) ? (double) $data['height'] : '',
    '#field_suffix' => ' ' . t('percent'),
    '#required' => FALSE,
    '#size' => 10,
    '#element_validate' => array(
      'canvasactions_resizepercent_validate',
    ),
    '#allow_negative' => FALSE,
  );
  return $form;
}

/**
 * Element validate handler to ensure that a positive number is specified.
 *
 * @param array $element
 *   The form element to validate.
 * @param array $form_state
 *   The form state.
 */
function canvasactions_resizepercent_validate($element, &$form_state) {
  element_validate_number($element, $form_state);
  if (!form_get_error($element)) {
    if ($element['#value'] != '' && (double) $element['#value'] <= 0) {
      form_error($element, t('!name must be a positive number.', array(
        '!name' => $element['#title'],
      )));
    }
  }
}

/**
 * Calculate percent based on input, fallback if only one value is provided.
 *
 * @param array $data
 *
 * @return float[]|FALSE
 */
function _canvasactions_resizepercent_calculate_percent(array $data) {

  // Fallback if only one value is provided.
  if (empty($data['height'])) {
    if (empty($data['width'])) {
      return FALSE;
    }
    $data['height'] = $data['width'];
  }
  else {
    if (empty($data['width'])) {
      $data['width'] = $data['height'];
    }
  }

  // Get percentage values in decimal values.
  $data['width'] = (double) $data['width'] / 100;
  $data['height'] = (double) $data['height'] / 100;
  return $data;
}

/**
 * Implements theme_hook() for the resize percent effect summary.
 *
 * @param array $variables
 *   An associative array containing:
 *   - data: The current configuration for this image effect.
 *
 * @return string
 *   The HTML for the summary of this image effect.
 * @ingroup themeable
 */
function theme_canvasactions_resizepercent_summary(array $variables) {
  $data = _canvasactions_resizepercent_calculate_percent($variables['data']);
  if (!$data) {
    return t('Invalid effect data');
  }
  if ($data['width'] != $data['height']) {
    return t('@width%x@height%', array(
      '@width' => 100 * $data['width'],
      '@height' => 100 * $data['height'],
    ));
  }
  else {
    return t('scale to @percent%', array(
      '@percent' => (double) 100 * $data['height'],
    ));
  }
}

/**
 * Image effect callback for the resize percent effect.
 *
 * @param stdClass $image
 * @param array $data
 *
 * @return boolean
 *   true on success, false otherwise.
 */
function canvasactions_resizepercent_effect(stdClass $image, array $data) {
  $data = _canvasactions_resizepercent_calculate_percent($data);
  $data['width'] = (int) round($image->info['width'] * $data['width']);
  $data['height'] = (int) round($image->info['height'] * $data['height']);
  return image_resize_effect($image, $data);
}

/**
 * Image dimensions callback for the resize percent effect.
 *
 * @param array $dimensions
 *   Dimensions to be modified - an associative array containing the items
 *   'width' and 'height' (in pixels).
 * @param array $data
 *   An associative array containing the effect data.
 */
function canvasactions_resizepercent_dimensions(array &$dimensions, array $data) {
  $data = _canvasactions_resizepercent_calculate_percent($data);
  $dimensions['width'] = (int) round($dimensions['width'] * $data['width']);
  $dimensions['height'] = (int) round($dimensions['height'] * $data['height']);
}

/**
 * Image effect form callback for the blur effect.
 *
 * @param array $data
 *   The current configuration for this image effect.
 *
 * @return array
 *   The form definition for this effect.
 */
function canvasactions_blur_form(array $data) {
  $form['intensity'] = array(
    '#type' => 'textfield',
    '#title' => t('Blur intensity'),
    '#description' => t('A higher intensity results in more blur. The larger the image, the larger value you need to get a really blurred image, think 50 to 100 for 600x400 images.'),
    '#size' => 5,
    '#default_value' => isset($data['intensity']) ? (int) $data['intensity'] : 2,
    '#element_validate' => array(
      'element_validate_integer_positive',
    ),
  );
  return $form;
}

/**
 * Implements theme_hook() for the underlay (background) effect summary.
 *
 * @param array $variables
 *   An associative array containing:
 *   - data: The current configuration for this image effect.
 *
 * @return string
 *   The HTML for the summary of this image effect.
 * @ingroup themeable
 */
function theme_canvasactions_blur_summary($variables) {
  return t('Intensity: @intensity', array(
    '@intensity' => $variables['data']['intensity'],
  ));
}

/**
 * Image effect callback for the resize percent effect.
 *
 * @param stdClass $image
 * @param array $data
 *
 * @return boolean
 *   true on success, false otherwise.
 */
function canvasactions_blur_effect(stdClass $image, array $data) {
  return image_toolkit_invoke('blur', $image, $data);
}

/**
 * GD toolkit specific implementation of the blur effect.
 *
 * @param stdClass $image
 * @param int $intensity
 *   The number of times to apply the blur filter.
 *
 * @return boolean
 *   True on success, false otherwise.
 */
function image_gd_blur(stdClass $image, $intensity) {
  $intensity = (int) $intensity;
  $result = TRUE;
  $i = 0;
  while ($result && $i++ < $intensity) {
    $result = imagefilter($image->resource, IMG_FILTER_GAUSSIAN_BLUR);
  }
  return $result;
}

/**
 * Imagemagick toolkit specific implementation of the blur effect.
 *
 * See http://www.imagemagick.org/Usage/blur/.
 *
 * @param stdClass $image
 * @param int $intensity
 *   The "intensity" of the blur effect.
 *
 * @return boolean
 *   True on success, false otherwise.
 */
function image_imagemagick_blur(stdClass $image, $intensity) {

  // To get similar results asd with the GD factor, we use a formula to alter
  // the intensity into the sigma value that is passed to IM.
  $sigma = 4.0 + 0.8 * $intensity;
  $image->ops[] = '-blur ' . escapeshellarg(sprintf('0x%f', $sigma));
  return TRUE;
}

/**
 * Builds the interlace form.
 *
 * This effect has no options, only some help text, so the form is displayed
 * anyway.
 */
function canvasactions_interlace_form() {
  $form = array();
  $form['help'] = array(
    '#markup' => '<p><strong>There are no user-configurable options for this process.</strong></p>
      <p>This effect will save the derivative image in an interlace / progressive way
      which might improve perceived performance, especially for large images.
      File size and loading speed will not change, but the user will pretty quickly
      see a "degraded" copy of the entire image instead of a clear copy of the upper
      part of the image.</p>
      <p>Wikipedia: <a href="https://en.wikipedia.org/wiki/Interlacing_(bitmaps)">Interlacing (bitmaps)</a></p>',
  );
  return $form;
}

/**
 * Image effect callback for the Interlace / Progressive effect.
 *
 * @param stdClass $image
 * @param array $data
 *
 * @return bool
 *   true on success, false otherwise.
 */
function canvasactions_interlace_effect(stdClass $image, array $data) {
  return image_toolkit_invoke('interlace', $image, array(
    $data,
  ));
}

/**
 * GD toolkit specific implementation of the image interlace effect.
 *
 * @param stdClass $image
 *   Image object containing the GD image resource to operate on.
 * param array $data
 *   The current configuration for this image effect.
 *
 * @return bool
 *   true on success, false otherwise.
 */
function image_gd_interlace($image) {
  imageinterlace($image->resource, 1);
  return TRUE;
}

/**
 * Imagemagick toolkit specific implementation of the image interlace effect.
 *
 * @param stdClass $image
 *   Image object containing the image resource to operate on.
 * param array $data
 *   The current configuration for this image effect.
 *
 * @return bool
 *   true on success, false otherwise.
 */
function image_imagemagick_interlace($image) {
  $image->ops[] = '-interlace Plane';
  return TRUE;
}

/**
 * Image effect form callback for the Perspective effect.
 *
 * @param array $data
 *   The current configuration for this image effect.
 *
 * @return array
 *   The form definition for this effect.
 */
function canvasactions_perspective_form(array $data) {
  $defaults = array(
    'vanish' => 'right',
    'symmetry' => 'symmetrical',
    'distortion' => 14,
    'opposite_distortion' => 10,
  );
  $data = array_merge($defaults, $data);
  $form['vanish'] = array(
    '#type' => 'radios',
    '#title' => t('Vanishing point'),
    '#options' => array(
      'top' => t('Top'),
      'left' => t('Left'),
      'right' => t('Right'),
      'bottom' => t('Bottom'),
    ),
    '#theme' => 'canvasactions_perspective_anchor',
    '#default_value' => $data['vanish'],
    '#description' => t('The position of the vanishing point relative to the source image.'),
  );
  $form['symmetry'] = array(
    '#type' => 'radios',
    '#title' => t('Symmetry of image perspective'),
    '#description' => t('If symmetrical, the perspective effect will be built symmetrically. If asymmetrical, you can set different distortion values for both sides. Mathematically speaking: symmetrical distortion results in an isosceles trapezoid, whereas asymmetrical distortion results in just an acute trapezoid.'),
    '#default_value' => $data['symmetry'],
    '#options' => array(
      'symmetrical' => t('Symmetrical perspective'),
      'asymmetrical' => t('Asymmetrical perspective'),
    ),
  );
  $form['distortion'] = array(
    '#type' => 'textfield',
    '#title' => t('Distortion'),
    '#field_suffix' => '%',
    '#size' => 5,
    '#default_value' => $data['distortion'],
    '#element_validate' => array(
      'canvasactions_perspective_distortion_validate',
    ),
    '#description' => t('How much the corner(s) (on the vanishing point side of the image) should move to the horizon (i.e. the line containing the vanishing point). With 0% you will have no perspective effect at all and the vanishing point will be infinitely far away. With a sum of 100%, the 2 corner(s) and the vanishing point will be the same, resulting in a triangle instead of a trapezoid. For a pleasing effect, you should choose (a) number(s) between 0 and 35%, especially with ImageMagick as that toolkit also adds some stretching within the image.'),
  );
  $form['opposite_distortion'] = array(
    '#type' => 'textfield',
    '#title' => t('Distortion for opposite side'),
    '#states' => array(
      'visible' => array(
        ':input[name="data[symmetry]"]' => array(
          'value' => 'asymmetrical',
        ),
      ),
    ),
    '#field_suffix' => '%',
    '#size' => 5,
    '#default_value' => $data['opposite_distortion'],
    '#element_validate' => array(
      'canvasactions_perspective_distortion_validate',
    ),
    '#description' => t('How much the 2nd corner on the vanishing point side of the image should move to the horizon line containing the vanishing point.'),
  );
  $form['additional_help'] = array(
    '#markup' => '<p>Some notes:</p>
      <ul><li>This effect adds a perspective effect to an image.
      Normally, to get a realistic effect, the side that gets the perspective effect should be reduced in size.
      However, this effect does not do so, as it is easy to add a (percentage) resize effect to the image style yourself.
      A resize to 85% of the original size is a good start when experimenting.</li>
      <li>CSS3 also defines <a href="https://www.w3.org/TR/2009/WD-css3-3d-transforms-20090320/#perspective-property">3D perspective transformations</a>.
      So you might get some of the results of ths effect with pure CSS as well.</li></ul>',
  );
  return $form;
}

/**
 * Form element validation handler for distortion.
 *
 * @param array $element
 *   The form element to validate.
 * @param array $form_state
 *   The form state.
 */
function canvasactions_perspective_distortion_validate($element, &$form_state) {
  $symmetrical = $form_state['values']['data']['symmetry'] === 'symmetrical';
  $element_name = $element['#name'];

  // Do not check opposite distortion if it is hidden in the UI.
  if (!$symmetrical || $element_name === 'data[distortion]') {
    $value = $element['#value'];

    // Check value itself: a number between 0 and 100 (50 if symmetrical):
    $max_value = $symmetrical ? 50 : 100;
    if (!is_numeric($value) || $value < 0 || $value >= $max_value) {
      if ($symmetrical) {
        form_error($element, t('!name must be a value between 0 and 50.', array(
          '!name' => $element['#title'],
        )));
      }
      else {
        form_error($element, t('!name must be a value between 0 and 100.', array(
          '!name' => $element['#title'],
        )));
      }
    }

    // Sum of both distortion values should also be smaller then 100.
    if (!$symmetrical) {
      $other_value_name = $element_name === 'data[distortion]' ? 'opposite_distortion' : 'distortion';
      $other_value = $form_state['values']['data'][$other_value_name];
      if (is_numeric($other_value) && $value + $other_value >= 100) {
        form_error($element, t('The sum of %name and %name2 must be lower then 100.', array(
          '%name' => $element['#title'],
          '%name2' => $other_value_name === 'distortion' ? t('Distortion') : t('Distortion for opposite side'),
        )));
      }
    }
  }
}

/**
 * Implements theme_hook() for the define perspective effect summary.
 *
 * @param array $variables
 *   An associative array containing:
 *   - data: The current configuration for this image effect.
 *
 * @return string
 *   The HTML for the summary of this image effect.
 * @ingroup themeable
 */
function theme_canvasactions_perspective_summary(array $variables) {
  $data = $variables['data'];
  $output = array();
  $output[] = t('%symmetry. Vanishing point: %vanish.', array(
    '%symmetry' => $data['symmetry'],
    '%vanish' => $data['vanish'],
  ));
  if ($data['symmetry'] == 'asymmetrical') {
    switch ($data['vanish']) {
      case 'top':
      case 'bottom':
        $output[] = t('Left distortion: %distortion, right distortion: %opposite_distortion.', array(
          '%distortion' => $data['distortion'] . '%',
          '%opposite_distortion' => $data['opposite_distortion'] . '%',
        ));
        break;
      case 'right':
      case 'left':
        $output[] = t('Top distortion: %distortion, bottom distortion: %opposite_distortion.', array(
          '%distortion' => $data['distortion'] . '%',
          '%opposite_distortion' => $data['opposite_distortion'] . '%',
        ));
        break;
    }
  }
  else {
    $output[] = t('Distortion: %distortion.', array(
      '%distortion' => $data['distortion'] . '%',
    ));
  }
  return implode(' ', $output);
}

/**
 * Image effect callback for the Perspective effect.
 *
 * @param stdClass $image
 *   Image object containing the image to operate on.
 * @param array $data
 *   The current configuration for this image effect, contains the keys:
 *   distortion, vanish, symmetry and opposite_distortion options.
 *
 * @return bool
 *   True on success, false otherwise.
 */
function canvasactions_perspective_effect(stdClass $image, array $data) {
  if (!image_toolkit_invoke('perspective', $image, array(
    $data,
  ))) {
    watchdog('imagecache_canvasactions', 'Image perspective transform failed using the %toolkit toolkit on %path (%mimetype, %dimensions)', array(
      '%toolkit' => $image->toolkit,
      '%path' => $image->source,
      '%mimetype' => $image->info['mime_type'],
      '%dimensions' => $image->info['height'] . 'x' . $image->info['height'],
    ), WATCHDOG_ERROR);
    return FALSE;
  }
  return TRUE;
}

/**
 * GD toolkit specific implementation of the image Perspective effect.
 *
 * @param stdClass $image
 *   Image object containing the image resource to operate on.
 * @param array $data
 *   The current configuration for this image effect, contains the keys:
 *   distortion, vanish, symmetry and opposite_distortion options.
 *
 * @return bool
 *   True on success, false otherwise.
 */
function image_gd_perspective(stdClass $image, $data) {
  $width = $image->info['width'];
  $height = $image->info['height'];
  $distortion = $data['distortion'];
  $opposite_distortion = $data['symmetry'] === 'symmetrical' ? $distortion : $data['opposite_distortion'];

  // To reduce distortion, we work with a temporary hires version of the image.
  // @todo: during processing we have 2 resources this size: this might crash on memory limits: warn and/or prevent.
  $multiplier = 3;
  $hires_width = $width * $multiplier;
  $hires_height = $height * $multiplier;
  $hires_source_image = imagecreatetruecolor($hires_width, $hires_height);
  $transparent_white = imagecolorallocatealpha($hires_source_image, 255, 255, 255, 127);
  imagealphablending($hires_source_image, FALSE);
  imagefilledrectangle($hires_source_image, 0, 0, $hires_width, $hires_height, $transparent_white);
  imagesavealpha($hires_source_image, TRUE);
  imagecopyresized($hires_source_image, $image->resource, 0, 0, 0, 0, $hires_width, $hires_height, $width, $height);
  imagedestroy($image->resource);

  // Creating a hires target canvas to apply the perspective effect on.
  $hires_target_image = imagecreatetruecolor($hires_width, $hires_height);
  $transparent_white = imagecolorallocatealpha($hires_target_image, 255, 255, 255, 127);

  // We don't want to blend: the transparent background we set is only for the
  // parts that do not get covered.
  imagealphablending($hires_target_image, FALSE);
  imagefilledrectangle($hires_target_image, 0, 0, $hires_width, $hires_height, $transparent_white);

  // Building perspective effect with help four point distortion methods.
  // On each step found new distortion point by right triangle formula.
  switch ($data['vanish']) {
    case 'top':
      $left = round($hires_width * $distortion / 100);
      $right = round($hires_width - $hires_width * (100 - $opposite_distortion) / 100);
      $tg_beta_left = $left / $hires_height;
      $tg_beta_right = $right / $hires_height;
      for ($y = 0; $y < $hires_height; $y++) {
        $new_left = ($hires_height - $y) * $tg_beta_left;
        $new_right = ($hires_height - $y) * $tg_beta_right;
        $new_width = $hires_width - $new_left - $new_right;
        imagecopyresampled($hires_target_image, $hires_source_image, $new_left, $y, 0, $y, $new_width, 1, $hires_width, 1);
      }
      break;
    case 'bottom':
      $left = round($hires_width * $distortion / 100);
      $right = round($hires_width - $hires_width * (100 - $opposite_distortion) / 100);
      $tg_beta_left = $left / $hires_height;
      $tg_beta_right = $right / $hires_height;
      for ($y = $hires_height; $y > 0; $y--) {
        $new_left = $y * $tg_beta_left;
        $new_right = $y * $tg_beta_right;
        $new_width = $hires_width - $new_left - $new_right;
        imagecopyresampled($hires_target_image, $hires_source_image, $new_left, $y, 0, $y, $new_width, 1, $hires_width, 1);
      }
      break;
    case 'right':
      $top = round($hires_height * $distortion / 100);
      $bottom = round($hires_height - $hires_height * (100 - $opposite_distortion) / 100);
      $tg_beta_top = $top / $hires_width;
      $tg_beta_bottom = $bottom / $hires_width;
      for ($x = $hires_width; $x > 0; $x--) {
        $new_top = $x * $tg_beta_top;
        $new_bottom = $x * $tg_beta_bottom;
        $new_height = $hires_height - $new_top - $new_bottom;
        imagecopyresampled($hires_target_image, $hires_source_image, $x, $new_top, $x, 0, 1, $new_height, 1, $hires_height);
      }
      break;
    case 'left':
      $top = round($hires_height * $distortion / 100);
      $bottom = round($hires_height - $hires_height * (100 - $opposite_distortion) / 100);
      $tg_beta_top = $top / $hires_width;
      $tg_beta_bottom = $bottom / $hires_width;
      for ($x = 0; $x < $hires_width; $x++) {
        $new_top = ($hires_width - $x) * $tg_beta_top;
        $new_bottom = ($hires_width - $x) * $tg_beta_bottom;
        $new_height = $hires_height - $new_top - $new_bottom;
        imagecopyresampled($hires_target_image, $hires_source_image, $x, $new_top, $x, 0, 1, $new_height, 1, $hires_height);
      }
      break;
  }
  imagedestroy($hires_source_image);
  imagealphablending($hires_target_image, FALSE);
  imagesavealpha($hires_target_image, TRUE);

  // Return image with perspective effect to original size.
  $target_image = imagecreatetruecolor($width, $height);
  imagealphablending($target_image, FALSE);
  imagecopyresampled($target_image, $hires_target_image, 0, 0, 0, 0, $width, $height, $hires_width, $hires_height);
  imagedestroy($hires_target_image);
  imagesavealpha($target_image, TRUE);
  $image->resource = $target_image;
  return TRUE;
}

/**
 * Imagemagick toolkit specific implementation of the image Perspective effect.
 *
 * @param stdClass $image
 *   Image object containing the image to operate on.
 * @param array $data
 *   The current configuration for this image effect, contains the keys
 *   distortion, vanish, symmetry and opposite_distortion options.
 *
 * @return bool
 *   True on success, false otherwise.
 */
function image_imagemagick_perspective(stdClass $image, $data) {
  $width = $image->info['width'];
  $height = $image->info['height'];
  $distortion = $data['distortion'];
  $opposite_distortion = $data['symmetry'] === 'symmetrical' ? $distortion : $data['opposite_distortion'];
  switch ($data['vanish']) {
    case 'top':
      $left = round($width * $distortion / 100);
      $right = round($width * (100 - $opposite_distortion) / 100);
      $perspective_arg = "0,0,{$left},0 0,{$height},0,{$height} {$width},0,{$right},0 {$width},{$height},{$width},{$height}";
      break;
    case 'right':
    default:

      // Prevents warning about possibly undefined variable.
      $top = round($height * $distortion / 100);
      $bottom = round($height * (100 - $opposite_distortion) / 100);
      $perspective_arg = "0,0,0,0 0,{$height},0,{$height} {$width},0,{$width},{$top} {$width},{$height},{$width},{$bottom}";
      break;
    case 'bottom':
      $left = round($width * $distortion / 100);
      $right = round($width * (100 - $opposite_distortion) / 100);
      $perspective_arg = "0,0,0,0 0,{$height},{$left},{$height} {$width},0,{$width},0 {$width},{$height},{$right},{$height}";
      break;
    case 'left':
      $top = round($height * $distortion / 100);
      $bottom = round($height * (100 - $opposite_distortion) / 100);
      $perspective_arg = "0,0,0,{$top} 0,{$height},0,{$bottom} {$width},0,{$width},0 {$width},{$height},{$width},{$height}";
      break;
  }
  $transparent_white = escapeshellarg('#ffffffff');
  $perspective = escapeshellarg($perspective_arg);
  $image->ops[] = "-background {$transparent_white} -virtual-pixel background -distort Perspective {$perspective}";
  return TRUE;
}

/** @noinspection PhpDocMissingThrowsInspection */

/**
 * Implements theme_hook().
 *
 * @param array $variables
 *   An associative array containing:
 *   - element: A render element containing radio buttons.
 *
 * @return string
 *   The HTML for a 3x3 grid of checkboxes for image anchors.
 * @ingroup themeable
 */
function theme_canvasactions_perspective_anchor($variables) {
  $element = $variables['element'];
  $rows = $row = $option = array();
  $blank = array(
    '#markup' => '',
  );
  $blank = drupal_render($blank);

  /** @noinspection PhpUnhandledExceptionInspection */
  $image = array(
    '#markup' => theme('image', array(
      'path' => drupal_get_path('module', 'image') . '/sample.png',
      'attributes' => array(
        'width' => "40",
        'height' => "40",
      ),
    )),
  );
  $image = drupal_render($image);
  foreach (element_children($element) as $key) {
    $element[$key]['#attributes']['title'] = $element[$key]['#title'];
    unset($element[$key]['#title']);
    $option[] = drupal_render($element[$key]);
  }
  $row[] = $blank;
  $row[] = $option[0];
  $row[] = $blank;
  $rows[] = $row;
  $row = array();
  $row[] = $option[1];
  $row[] = $image;
  $row[] = $option[2];
  $rows[] = $row;
  $row = array();
  $row[] = $blank;
  $row[] = $option[3];
  $row[] = $blank;
  $rows[] = $row;

  /** @noinspection PhpUnhandledExceptionInspection */
  return theme('table', array(
    'header' => array(),
    'rows' => $rows,
    'attributes' => array(
      'class' => array(
        'image-anchor',
      ),
    ),
  ));
}

Functions

Namesort descending Description
canvasactions_aspect_dimensions Image dimensions callback for the aspect switcher effect.
canvasactions_aspect_effect Image effect callback for the aspect switcher effect.
canvasactions_aspect_form Image effect form callback for the aspect switcher effect.
canvasactions_blur_effect Image effect callback for the resize percent effect.
canvasactions_blur_form Image effect form callback for the blur effect.
canvasactions_canvas2file_dimensions Image dimensions callback for the underlay (background) effect.
canvasactions_canvas2file_effect Image effect callback for the underlay (background) effect.
canvasactions_canvas2file_form Image effect form callback for the underlay (background) effect.
canvasactions_definecanvas_dimensions Image dimensions callback for the define canvas effect.
canvasactions_definecanvas_effect Image effect callback for the define canvas effect.
canvasactions_definecanvas_form Image effect form callback for the define canvas effect.
canvasactions_file2canvas_effect Image effect callback for the overlay (watermark) image effect.
canvasactions_file2canvas_form Image effect form callback for the overlay (watermark) effect.
canvasactions_imagemask_effect Image effect callback for the image mask effect.
canvasactions_imagemask_form Image effect form callback for the image mask effect.
canvasactions_interlace_effect Image effect callback for the Interlace / Progressive effect.
canvasactions_interlace_form Builds the interlace form.
canvasactions_perspective_distortion_validate Form element validation handler for distortion.
canvasactions_perspective_effect Image effect callback for the Perspective effect.
canvasactions_perspective_form Image effect form callback for the Perspective effect.
canvasactions_resizepercent_dimensions Image dimensions callback for the resize percent effect.
canvasactions_resizepercent_effect Image effect callback for the resize percent effect.
canvasactions_resizepercent_form Image effect form callback for the resize percent effect.
canvasactions_resizepercent_validate Element validate handler to ensure that a positive number is specified.
canvasactions_source2canvas_effect Image effect callback for the overlay: source image to canvas effect.
canvasactions_source2canvas_form Image effect form callback for the overlay: source image to canvas effect.
image_gd_blur GD toolkit specific implementation of the blur effect.
image_gd_definecanvas GD toolkit specific implementation of the define canvas effect.
image_gd_imagemask GD toolkit specific implementation of the image mask effect.
image_gd_interlace GD toolkit specific implementation of the image interlace effect.
image_gd_perspective GD toolkit specific implementation of the image Perspective effect.
image_imagemagick_blur Imagemagick toolkit specific implementation of the blur effect.
image_imagemagick_definecanvas Imagemagick toolkit specific implementation of the define canvas effect.
image_imagemagick_imagemask Imagemagick toolkit specific implementation of the image mask effect.
image_imagemagick_interlace Imagemagick toolkit specific implementation of the image interlace effect.
image_imagemagick_perspective Imagemagick toolkit specific implementation of the image Perspective effect.
theme_canvasactions_aspect_summary Implements theme_hook() for the aspect switcher effect summary.
theme_canvasactions_blur_summary Implements theme_hook() for the underlay (background) effect summary.
theme_canvasactions_canvas2file_summary Implements theme_hook() for the underlay (background) effect summary.
theme_canvasactions_definecanvas_summary Implements theme_hook() for the define canvas effect summary.
theme_canvasactions_file2canvas_summary Implements theme_hook() for the overlay (watermark) effect summary.
theme_canvasactions_imagemask_summary Implements theme_hook() for the image mask effect summary.
theme_canvasactions_perspective_anchor Implements theme_hook().
theme_canvasactions_perspective_summary Implements theme_hook() for the define perspective effect summary.
theme_canvasactions_resizepercent_summary Implements theme_hook() for the resize percent effect summary.
theme_canvasactions_source2canvas_summary Implements theme_hook() for the overlay: source img to canvas effect summary.
_canvasactions_resizepercent_calculate_percent Calculate percent based on input, fallback if only one value is provided.