function image_effect_definition_load in Drupal 7

Loads the definition for an image effect.

The effect definition is a set of core properties for an image effect, not containing any user-settings. The definition defines various functions to call when configuring or executing an image effect. This loader is mostly for internal use within image.module. Use image_effect_load() or image_style_load() to get image effects that contain configuration.

Parameters

$effect: The name of the effect definition to load.

$style: An image style array to which this effect will be added.

Return value

An array containing the image effect definition with the following keys:

• "effect": The unique name for the effect being performed. Usually prefixed with the name of the module providing the effect.
• "module": The module providing the effect.
• "help": A description of the effect.
• "function": The name of the function that will execute the effect.
• "form": (optional) The name of a function to configure the effect.
• "summary": (optional) The name of a theme function that will display a one-line summary of the effect. Does not include the "theme_" prefix.

4 calls to image_effect_definition_load()

image_effects in modules/image/image.module

Loads all image effects from the database.

image_help in modules/image/image.module

Implements hook_help().

image_styles in modules/image/image.module

Gets an array of all styles and their settings.

image_style_form_add_submit in modules/image/image.admin.inc

Submit handler for adding a new image effect to an image style.

File

modules/image/image.module, line 1217

Exposes global functionality for creating image styles.

Code

function image_effect_definition_load($effect, $style_name = NULL) {
  $definitions = image_effect_definitions();

  // If a style is specified, do not allow loading of default style
  // effects.
  if (isset($style_name)) {
    $style = image_style_load($style_name, NULL);
    if ($style['storage'] == IMAGE_STORAGE_DEFAULT) {
      return FALSE;
    }
  }
  return isset($definitions[$effect]) ? $definitions[$effect] : FALSE;
}