diff --git a/core/lib/Drupal/Core/Image/Image.php b/core/lib/Drupal/Core/Image/Image.php index 90e72fa..136c81e 100644 --- a/core/lib/Drupal/Core/Image/Image.php +++ b/core/lib/Drupal/Core/Image/Image.php @@ -286,14 +286,19 @@ protected function processInfo() { * Passes through calls that represent image toolkit operations onto the * image toolkit. * - * By implementing this magic method, image operations are accessible directly - * from the Image object as if it were methods of \Drupal\Core\Image\Image. - * For example next calls can be performed on an Image object: + * This is a temporary solution to keep patches reviewable. The __call() + * method will be replaced in https://drupal.org/node/2073759 with a new + * interface method ImageInterface::apply(). An image operation will be + * performed as in the next example: * @code * $image = new Image($path, $toolkit); - * $image->scale(50, 100); - * $image->rotate(30); + * $image->apply('scale', array('width' => 50, 'height' => 100)); * @endcode + * Also in https://drupal.org/node/2073759 operation arguments sent to toolkit + * will be moved to a keyed array, unifying the interface of toolkit + * operations. + * + * @todo Drop this in https://drupal.org/node/2073759 in favor of new apply(). */ public function __call($method, $arguments) { if (is_callable(array($this->toolkit, $method))) {