Info: This article is aimed at Studio Server versions 10.26 and lower. For versions 10.27 and higher, see Image preview generation in Studio Server 10.27 or higher.
Without installing additional components, Studio Server is capable of generating previews for the following types of images:
Note: Generating the images is handled by the Server plug-in named "PHP Preview and Metadata" (enabled by default).
Adding more image formats
Support for additional image formats — such as PDF, TIFF and PSD — can be added by installing one of the following applications (see "Installation steps" below):
- ImageMagick. Free software (under the General Public License), available for all major operating systems. Also requires Ghostscript to render Postscript based file types such as PDF and EPS.
Visit the ImageMagick Web site
- Ghostscript (for PDF, EPS and Adobe Illustrator support). Copyrighted and available under several licenses.
Visit the Ghostscript Web Site
Studio Server and ImageMagick
Studio Server is shipped with an ImageMagick Preview Server plug-in that can be activated after installing ImageMagick and optionally Ghostscript.
The ImageMagick Preview Server plug-in uses ImageMagick (and optionally Ghostscript) to generate previews from uploaded native files.
Note: Whether or not the image preview generation is actually handled by the plug-in depends on whether or not an image preview is already provided by the client application:
Uploading large images could lead to a heavy CPU load. Make sure that you have enough CPU power available on the server machine, or even set up a dedicated application server for this task and, for example, let photographers upload to it.
Tip: Alternatively, you can disable the ImageMagick Server plug-in and have no previews generated for uploaded PSD, PDF, AI, or EPS files. You could enable the PHP Preview and Metadata Server plug-in (enabled by default) to still have previews generated for JPG, GIF, or PNG files, which runs through PHP’s GD library and is a much lighter task.
However, this requires extra memory to be configured for the PHP processes and large images could run PHP out of memory which would block the image upload. For example, a 15 megapixel 24 bit RGB JPEG image takes roughly 10 MB to upload and 15 x (24/8) = 45 MB to extract (in PHP) before it can be processed.
Using it with the PHP Preview and Metadata Server plug-in
Info: Performing the described steps 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. For a full overview of the steps that need to be done by WoodWing and how to request them, see WoodWing Cloud - Change management.
When both the ImageMagick Preview and the PHP Preview and Metadata Server plug-ins are enabled, ImageMagick will only be used to create previews in the following image formats:
Preview creations of JPG, GIF, and PNG files is then controlled by the PHP Preview and Metadata plug-in—a much faster working setup.
Step 2. Set Read & Write access rights to the Temp subdirectory of the ATTACHMENTDIRECTORY for the Web Server user:
- Windows: “IUSR_<servername>”
- Linux: “nobody”
Note: The ATTACHMENTDIRECTORY is specified in the config.php file (recommended: config_overrule.php file).
Step 3. Ensure that the Web Server user has execute access for the ImageMagick and Ghostscript executables ("convert" and "gs").
Step 4. Install the ImageMagick Preview Studio Server plug-in. (See About the ImageMagick Preview Server plug-in.)
- 1 June 2023: Renamed from 'Image preview generation in Studio Server'.