DrupalAPI.de

1. drupal
   1. drupal7

Load an image file and return an image object.

Any changes to the file are not saved until image_save() is called.

see image_save()

Übergabeparameter

$file Path to an image file.

$toolkit An optional, image toolkit name to override the default.

Rückgabewert

An image object or FALSE if there was a problem loading the file. The image object has the following properties:

• 'source' - The original file path.
• 'info' - The array of information returned by image_get_info()
• 'toolkit' - The name of the image toolkit requested when the image was loaded.

Image tookits may add additional properties. The caller is advised not to monkey about with them.

See also

image_get_info()

image_get_available_toolkits()

image_gd_load()

Verwandte Themen

Image toolkits

Drupal's image toolkits provide an abstraction layer for common image file manipulations like scaling, cropping, and rotating. The abstraction frees module authors from the need to support multiple image libraries, and it allows site…

Code

includes/image.inc, line 339

<?php
function image_load($file, $toolkit = FALSE) {
  if (!$toolkit) {
    $toolkit = image_get_toolkit();
  }
  if ($toolkit) {
    $image = new stdClass();
    $image->source = $file;
    $image->info = image_get_info($file);
    $image->toolkit = $toolkit;
    if (image_toolkit_invoke('load', $image)) {
      return $image;
    }
  }
  return FALSE;
}
?>