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;
}

---