function hook_image_effect_info

Define information about image effects provided by a module.

This hook enables modules to define image manipulation effects for use with an image style.

Return value

An array of image effects. This array is keyed on the machine-readable effect name. Each effect is defined as an associative array containing the following items:

  • "label": The human-readable name of the effect.
  • "effect callback": The function to call to perform this image effect.
  • "dimensions passthrough": (optional) Set this item if the effect doesn't change the dimensions of the image.
  • "dimensions callback": (optional) The function to call to transform dimensions for this effect.
  • "help": (optional) A brief description of the effect that will be shown when adding or configuring this image effect.
  • "form callback": (optional) The name of a function that will return a $form array providing a configuration form for this image effect.
  • "summary theme": (optional) The name of a theme function that will output a summary of this image effect's configuration.

See also

hook_image_effect_info_alter()

Related topics

2 functions implement hook_image_effect_info()

Note: this list is generated by pattern matching, so it may include some functions that are not actually implementations of this hook.

image_image_effect_info in modules/image/image.effects.inc
Implements hook_image_effect_info().
image_module_test_image_effect_info in modules/image/tests/image_module_test.module
Implements hook_image_effect_info().
1 invocation of hook_image_effect_info()
image_effect_definitions in modules/image/image.module
Returns a set of image effects.

File

modules/image/image.api.php, line 38

Code

function hook_image_effect_info() {
    $effects = array();
    $effects['mymodule_resize'] = array(
        'label' => t('Resize'),
        'help' => t('Resize an image to an exact set of dimensions, ignoring aspect ratio.'),
        'effect callback' => 'mymodule_resize_effect',
        'dimensions callback' => 'mymodule_resize_dimensions',
        'form callback' => 'mymodule_resize_form',
        'summary theme' => 'mymodule_resize_summary',
    );
    return $effects;
}

Buggy or inaccurate documentation? Please file an issue. Need support? Need help programming? Connect with the Drupal community.