>>> [!note] Migrated issue <!-- Drupal.org comment --> <!-- Migrated from issue #2941093. --> Reported by: [mondrake](https://www.drupal.org/user/1307444) >>> <p>Preparation issue for ImageMagick release 8.x-2.3</p> <p>todo:</p> <ul> <li><del>add empty update function to clear caches to discover the changes to the 'imagemagick.exec_manager' service</del></li> <li><del>deprecate <code>ImagemagickToolkit::EXIF_ORIENTATION_NOT_FETCHED</code></del></li> <li><del>summarize release notes</del></li> </ul> <h2>Release notes - draft</h2> <p>This release of the ImageMagick module introduces the functionality to retrieve images' colorspace and embedded profiles while parsing the image (only if the <em>ImageMagick</em> package is installed, the <em>GraphicsMagick</em> does not support that). Also, provides a more structured way to specify if command line arguments are to be added before or after the source image loading (and to specify internal use arguments).</p> <p>As of this release, parsing image files via PHP <code>getimagesize</code> function is deprecated - it simply can not cope with all the data that can be fetched with the default parsing via the <code>identify</code> command. While this still works in this release, this functionality will be dropped in the next major release.</p> <p>Finally, a lot of methods (see below) have been deprecated and will be removed in the next major.</p> <p><strong>NOTE:</strong> please ensure to run the database updates after updating to this release.</p> <h3>More details:</h3> <ul> <li>Deprecated using the PHP <code>getimagesize</code> function to parse image files.</li> <li>When using ImageMagick as the graphics package:</li> <ul> <li>the toolkit now retrieves the image's colorspace when parsing the image file. Use <code>$image-&gt;getToolkit()-&gt;getColorspace()</code> to access the information from code.</li> <li>the toolkit now retrieves the image's embedded profiles when parsing the image file. Use <code>$image-&gt;getToolkit()-&gt;getProfiles()</code> to access the information from code.</li> <li>it's now possible to specify command line arguments to be placed <em>before</em> loading the source image file when executing the <code>convert</code> command. This is useful to provide ImageMagick settings that have to be considered before loading the image. For example, it may be needed to provide a <code>-density</code> option before loading a vector image to specify how ImageMagick should render it internally in memory. Use <code>$image-&gt;getToolkit()-&gt;arguments()-&gt;add($argument, ImagemagickExecArguments::PRE_SOURCE)</code>.</li> </ul> <li>Some <a href="https://www.drupal.org/project/issues/search/imagemagick?project_issue_followers=&amp;issue_tags_op=%3D&amp;issue_tags=String+change%2C+string+change">string changes</a>.</li> <li>Only PRE_SOURCE arguments will be passed to <code>identify</code> as of the next major release. If you are specifying arguments in the 'Prepend arguments' textbox in the Image Tollkit setup UI, make sure you tick the 'Before source' box in the form, otherwise they will not be added as of next major release.</li> <li>Arguments added via the new <code>ImagemagickExecArguments::add()</code> can store additional context information. The <code>ImagemagickImageToolkitOperationBase::addArgument()</code> method is adding information about the Image Toolkit operation and plugin id, that can be used by the <code>ImagemagickExecArguments::find()</code> method to target arguments added by a specific operation.</li> </ul> <h3>Newly added methods:</h3> <ul> <li>ImagemagickExecArguments::escape()</li> <li>ImagemagickExecArguments::find()</li> <li>ImagemagickExecArguments::remove()</li> <li>ImagemagickExecArguments::reset()</li> <li>ImagemagickExecArguments::setSourceFormatFromExtension()</li> <li>ImagemagickExecArguments::setDestinationFormatFromExtension()</li> <li>ImagemagickExecArguments::toString()</li> <li>ImagemagickExecManager::getFormatMapper()</li> <li>ImagemagickExecManager::getModuleHandler()</li> <li>ImagemagickToolkit::arguments()</li> <li>ImagemagickToolkit::ensureSourceLocalPath()</li> <li>ImagemagickToolkit::getColorspace()</li> <li>ImagemagickToolkit::getExecManager()</li> <li>ImagemagickToolkit::getProfiles()</li> <li>ImagemagickToolkit::setColorspace()</li> <li>ImagemagickToolkit::setProfiles()</li> <li>ImagemagickImageToolkitOperationBase::addArgument()</li> <li>ImagemagickImageToolkitOperationBase::escapeArgument()</li> </ul> <h3>Deprecated methods/constants:</h3> <ul> <li>ImagemagickExecArguments::INTERNAL_ARGUMENT_IDENTIFIER</li> <li>ImagemagickExecArguments::addArgument()</li> <li>ImagemagickExecArguments::countArguments()</li> <li>ImagemagickExecArguments::escapeShellArg()</li> <li>ImagemagickExecArguments::findArgument()</li> <li>ImagemagickExecArguments::getArguments()</li> <li>ImagemagickExecArguments::getStringForBinary()</li> <li>ImagemagickExecArguments::prependArgument()</li> <li>ImagemagickExecArguments::removeArgument()</li> <li>ImagemagickExecArguments::resetArguments()</li> <li>ImagemagickToolkit::EXIF_ORIENTATION_NOT_FETCHED</li> <li>ImagemagickToolkit::addArgument()</li> <li>ImagemagickToolkit::checkPath()</li> <li>ImagemagickToolkit::countArguments()</li> <li>ImagemagickToolkit::escapeShellArg()</li> <li>ImagemagickToolkit::findArgument()</li> <li>ImagemagickToolkit::getArguments()</li> <li>ImagemagickToolkit::getDestination()</li> <li>ImagemagickToolkit::getDestinationFormat()</li> <li>ImagemagickToolkit::getDestinationLocalPath()</li> <li>ImagemagickToolkit::getPackage()</li> <li>ImagemagickToolkit::getPackageLabel()</li> <li>ImagemagickToolkit::getSourceFormat()</li> <li>ImagemagickToolkit::getSourceLocalPath()</li> <li>ImagemagickToolkit::getStringForBinary()</li> <li>ImagemagickToolkit::prependArgument()</li> <li>ImagemagickToolkit::removeArgument()</li> <li>ImagemagickToolkit::resetArguments()</li> <li>ImagemagickToolkit::setDestination()</li> <li>ImagemagickToolkit::setDestinationFormat()</li> <li>ImagemagickToolkit::setDestinationFormatFromExtension()</li> <li>ImagemagickToolkit::setDestinationLocalPath()</li> <li>ImagemagickToolkit::setSourceFormat()</li> <li>ImagemagickToolkit::setSourceFormatFromExtension()</li> <li>ImagemagickToolkit::setSourceLocalPath()</li> </ul> <p>Additionally, marking an argument 'internal' via prefixing it with ImagemagickExecArguments::INTERNAL_ARGUMENT_IDENTIFIER is deprecated.</p>