SAVE TO FILE EXAMPLE - IMAGE AND ANNOTATIONS


The Zoomify Image Viewer can save any current view or an entire image with related annotations to a JPEG or PNG file on your webserver. Enable image saving using the HTML parameter zFileHandlerPath. If only saving locally, a save image handler is not required but the parameter is still needed and should be set zSaveImageHandlerPath=local.*

Optional additional parameters include zSaveImageFilename to set the saved image file's name, zSaveImageFormat to set the file format (JPEG or PNG), zSaveImageCompression to set the compression level, and zSaveImageBackColor to set the background color. See the Parameters List in the Documentation folder for details.

The saved image will include labels even if they are outside of the image area, and will be formatted to provide a small outer margin if needed. Of course the resulting image can be edited in any image editing program to further format or crop its contents.

Saving setup requirements: Saving annotation edits requires the right files on the web server and the right permissions for those files and their directories. The needed files include the script that does the actual saving, typically 'uploadImage.php'. The pemissions include read, write, and/or execute, and are set for the annotations XML file and its directory as well as the upload file and its directory - and they are set differently for the file owner, group, and 'other'. And these settings can vary depending on the platform and hosting service, if any. For more information please see the User's Guide Chapter VII Appendix section "File locations and permissions".

*IMPORTANT NOTE: Saving locally is supported by Firefox and Chrome, however, at this time it is not supported by Internet Explorer, Edge, or Safari. Also note that the image file saved will be a JPEG.