Info: Performing the steps described in this article requires direct server access. Depending upon how your system is hosted and the level of access you have to that system, coordination may be required with your Partner or WoodWing Support team.
Integrating ImageMagick in Studio Server is a 4-step process:
Step 1. Checking the compatibility of ImageMagick with Studio Server
Step 2. Installing ImageMagick
Step 3. Configuring Studio Server
Step 4. Testing the integration
Step 5. (Optional) Integrating Ghostscript.
1. Checking compatibility
For details about which version of ImageMagick is compatible with which version of Studio Server, please check the Compatibility Matrix.
2. ImageMagick installation on Windows
Download and install ImageMagick for example from the following location:
Setting environment variables
The installation process will update the PATH setting. Once the installation is completed, reboot the system to use the modified PATH setting.
Use one of the following methods:
- Download and install ImageMagick for example from the following location:
- Download the ImageMagick source file from the following location and then compile and install it yourself:
3. Studio Server configuration
Step 1. Define the path where ImageMagick is installed:
- File: configserver.php (recommended: config_overrule.php file)
- Name of option: IMAGE_MAGICK_APP_PATH
- Values: The full path to the folder of the ImageMagick application.
Note: Use forward slashes and do NOT end with a slash.
- For Linux:
define( 'IMAGE_MAGICK_APP_PATH', '/usr/local/bin' );
- For Windows:
define( 'IMAGE_MAGICK_APP_PATH', 'C:/Program Files/ImageMagick-6.6.3-Q16' );
Step 2. Configure the preview and thumbnail quality:
- File: configserver.php file (recommended: config_overrule.php file)
- Name of option: IMAGE_MAGICK_OPTIONS
- Possible values: Any value mentioned on the ImageMagick Help page Command Line Options.
Note: The size (-size) is set by Studio Server and must not be set here.
- Default values used:
- -colorspace Sets the colorspace of the image. See ImageMagick Help.
- -quality Sets the compression level for the images. See ImageMagick Help.
- -sharpen Sharpens the image. See ImageMagick Help.
- -layers Handles multiple image as a set of image layers or animation frames. See ImageMagick Help.
- -depth Sets the number of bits in a color sample within a pixel. See ImageMagick Help.
- -strip Strips the image of any profiles or comments. See ImageMagick Help.
- -density Sets the horizontal and vertical resolution of an image for rendering to devices. See ImageMagick Help.
- Default setting: -colorspace sRGB -quality 100 -sharpen 5 -layers merge -depth 8 -strip -density
define ('IMAGE_MAGICK_OPTIONS', '-colorspace sRGB -quality 92 -sharpen 5 -layers merge -depth 8 -strip -density 72x72');
4. Testing the integration
To test ImageMagick from the command line:
- Add /usr/local/bin to the PATH setting one of the following locations:
- For the current user: ~/.profile
- For all users: /etc/profile
5. (Optional) Integrating Ghostscript
When Postscript based file types such as PDF and EPS need to be rendered, Ghostscript also needs to be integrated.
For details, see Ghostscript integration in Studio Server.