Zoomify converter script

The Zoomify Annotation System SWF file s may not be redistributed, but may reside on one 1 server per license purchased. This License is your proof of license to exercise the rights granted herein and must be retained by you. You may not reverse engineer, decompile, or disassemble the SOFTWARE, except to the extent the foregoing restriction is expressly prohibited by applicable law.

This License Agreement restricts certain product uses subject to possession of a written reseller agreement. Zoomify reserves the right to designate resellers at Zoomify's sole discretion. Zoomify has selected Aperio Technologies, Inc. Zoomify's customers retain the rights granted in this License Agreement to create, sell, and distribute products based on Zoomify technology, whether to the digital pathology market or other markets, with restrictions as noted, including but not limited to, prohibition of redistribution of the Zoomify Converter, Zoomify Enterprise Converter, Zoomify Annotation Viewer, and Zoomify source code.

Zoomify retains the right to sell directly to customers in the digital pathology market, to transfer this right in the event of acquisition, and to designate resellers who may sell to customers in this market so long as their sales activities are not specifically and only addressed to the market, but rather, are horizontal in nature, encompassing multiple application areas.

You may modify but not redistribute unminified, unobfuscated JavaScript files including but not limited to "ZoomifyImageViewer-min.

FLA" and "Zoomify Components 2. In addition, you may not redistribute FLA files wherein Zoomify code resides. These files may only be redistributed as compiled SWF files with import protection enabled see Adobe Flash documentation.

In all cases, modifications must be clearly called-out. This license agreement must be redistributed with the files whether modified or not, regardless of the purpose of redistribution.

Works distributed for commercial purposes must clearly include modifications and works within the scope of which the Zoomify technology is not the primary source of value. Regarding other uses, or if you are unsure of your rights under this license, please contact Zoomify at business zoomify. Manufacturer is Zoomify Inc. Improved compatibility! Dozens of enhancements to ensure reliable performance in the latest OS versions, mobile devices, and browsers - including Microsoft Edge.

Side-by-Side Comparison! View two images together and use synchronized navigation to compare every detail! Add optional images lists see below to easily switch either image display! User Access Login! Add one HTML parameter to prompt site visitors for their name - or add a list to validate user's entries! Hotspot Zoom-Ranges and Popup Graphics!

Set the max and min zoom within which to display each hotspot - and easily create rollover graphics for enhanced tooltip displays! Set the max and min zoom within which to display each annotation label - and block editing of any label with a simple XML value! Image Lists! Use a simple list of image paths to present a choice list in the Viewer display! Advanced Image Filters!

Automatically display the latitude and longitude for the current cursor position over an image! Including annotations image lists, slidestack preloading option, and more! Use two or more zoomable images in synchronized layers - use PNG tiles for transparency! Including, free rotation, crosshairs, no-skin toolbar, optional preloading - and much more!

Significant quality improvements - including all the fixes listed below. Improved reliability. All Zoomify Image Viewer processes are now tracked and validated for more reliable data loading, caching, and interface updating. Just list your images' names in a simple file and Zoomify Image Viewer presents them in rapid - zoomable- succession.

Intuitive navigation includes mouse, slider, button, key, and mousewheel! Slidestack enhancements! Optimized loading enables large slide sets to display twice as fast. Improved navigation includes new toolbar slider and targeted mousewheel support. Extended annotation capabilities allow shared data across slides.

Data management optimized for fastest possible loading! Customize with 99 HTML parameters - 50 new. Ruler panel. Measurement polygons - for length, circumference, and area with customizable units. Hiding or replacing the logo is accomplished using a simple HTML parameter.

Technical support for Zoomify is provided for implementation issues system setup and deployment , design issues features such as layout and properties , development issues features related to JavaScript calls to the Zoomify API , and end-user issues display-time interaction on supported platforms.

Please note that source code for Zoomify Viewers and examples is provided to allow web developers the access and control necessary to understand and modify the functionality of the Viewer independently.

Given the resource requirements that would be required, Zoomify is not able to offer technical support for development below the level of the Zoomify API calls, nor for custom code created by our customers. We appreciate your understanding as we do our best to provide quality support and continued development while offering our products at reasonable prices.

At Zoomify our resources are completely focused on delivering innovative, high-quality imaging software. As a result, we are staffed and organized for product development rather than for providing custom development services.

We have developed custom projects for numerous clients and will continue to do so as resources permit, however, these projects tend to be large in scale, narrow in scope, and relevant in feature set to the evolution of our product line.

That is, the custom development projects we undertake are most typically pursued under terms that provide expedited access to desirable new features for a customer along with a license for use, while allowing Zoomify to retain primary access to the intellectual property created and expand the features and functionality of one or more products in ways that are relevant to a broad base of customers.

For all other purposes, we do our best to refer customers to a third-party developer more focused on custom development services. If you are a designer or developer with demonstrated skill and familiarity with Zoomify products and a desire to receive referrals please let us know.

We do our best to provide referrals to designers and developers with demonstrated skill and familiarity with our products. Please note that many of the talented professionals who fit this description are either in great demand or often hired for projects of considerable duration. It can therefore prove difficult to provide referrals to meet all needs. However, the Zoomify products are developed and documented to provide the smallest possible learning curve, and with millions of web designers and developers in the world it is almost always possible for the determined customer to identify a resource online or through contacts.

There are two factors that define 'good zoom'. The first is how much you are able to zoom in, the second is what you end up looking at. That is, zooming for a long time provides a certain sense of satisfaction, but ending up looking at something interesting is important too. How much you are able to zoom in depends on the size of the source image as compared to the size of the intended display area.

An image that is x pixels when zoomified will offer no zoom at all if displayed in a view area that is x If the same image is displayed in a postage stamp-sized view area, however, it will zoom one or two levels of magnification. What you end up looking at is also important as this determines whether the experience feels useful and is therefore satisfying. Users zooming on an image of a crowd expect to be able to clearly see a face. Users zooming on an image of a face expect to clearly see blood vessels in an eye.

This is simply how user expectations work, in our experience. A note regarding capture methods: scanning a 35mm negative at dpi gives about This will provide considerable zoom. Most digital cameras are multi-megapixel and their images will also provide significant zoom. It is exciting to have content like our Paris satellite image courtesy of GeoEye , however, an image pixels in each dimension - hundreds of megabytes in size when uncompressed - is much more than is needed for most subject matter.

Zoomify's technologies and products have been designed to support extreme file sizes. Zoomify's testing as well as actual implementations by many of Zoomify's customers have included images tens of gigabytes in size. Exact calculations of the maximum supported file size are difficult due to the many factors involved.

These include the types of programming variables used, the efficiency of memory and disk space usage, potential limitations in standard codec libraries that are leveraged in some areas, file format limitations, and potential operating system issues.

Please note that specific editions of the Zoomify Converter support image files of different sizes. The Zoomify Converter included in Zoomify's standard and Developer products can convert source images up to megapixels in size. The Converter included in our Enterprise products supports images up to megapixels in size.

Additional Converters are available which support images that are larger or even unlimited in size within operating system and file format constraints - that is, tens of gigabytes in size. Zoomify delivers maximum efficiency for maximum performance. Every aspect of Zoomify's zoom-and-pan viewing technology has been optimized: processing is distributed, image data downloads are minimized, redundant data requests are prevented, IT costs are minimized and the end-user experience is maximized.

Most importantly, viewing images with Zoomify prevents all unnecessary downloads. Image data is requested by the Zoomify Viewer only for the parts of the image that the user actually looks at and only at the zoom level they actually zoom to.

This provides a significant bandwidth savings as compared to common implementations involving large JPEGs, wherein, the entire image is downloaded even if two thirds of the image won't fit on the user's screen and only the center third is ever viewed.

Another key design efficiency in our system is that all logic and processing occur on the viewing computer rather than the web server - a fully distributed approach.

As site visitors navigate within an image, it is their systems and not the server that determine what the current view is, and what image data is needed for that view.

Note that where optional single-file PFF image storage is used, the Zoomify Servlet is used to fulfill requests for the parts byte ranges of the image file that the client computer has determined are needed for the current view. Fulfilling byte-range requests is a standard HTTP 1. The two tasks, file fulfillment and partial file fulfillment, show no discernable difference in processing speed or scaling performance.

Additional efficiencies include the use of all possible caches both server-side and client-side. Zoomify's solution is entirely standards based and is therefore perfectly suited to leveraging existing efficiencies of web servers, operating systems, and browsers.

Any requested image 'tile' at any resolution, is simply a JPEG and will therefore be automatically managed according to the web server cache settings you have in place. Similarly, these tiny JPEGs are stored on the client machine by the browser for fast subsequent accesses by the Viewer. A common question is whether extra hardware and bandwidth is needed to support zoomable images - it is not.

The better question is whether extra hardware needed to support image zooming - i. With more time devoted to viewing behavior, more bandwidth may be used. Predicting end-use behavior is a challenging task and quite specific to particular audiences and their style of use of images. As a broad generalization, users will spend significantly more time viewing zoomable images than low-res images - on the order of three to five times as much time.

At approximately 2. Of course, the above example illustrates a worst case scenario given hardware and bandwidth available at reasonable cost. Ultimately, it is not throughput which best informs site design choices regarding image presentation alternatives. The critical factor is not how much data can be passed through a system, but how little.

The Zoomify converter will convert any image file so long as it is at least pixels wide or tall, however, any file that is as small or smaller than the intended display area will simply fill the area and will not have additional resolution to zoom into.

All image content will show artifacts if stretched beyond a certain point. The only solution for this problem is higher quality source content - details can simply not be created where they do not exist. For an image to be displayed and zoomable, three steps must successfully occur:. See the example included in Zoomify Pro and Zoomify Enteprise for complete details!

A relative path should always be relative to the calling web page '. Browsers other than Firefox either block local viewing of dynamically loaded content or require special settings. The Zoomify Viewer includes special instructions to load image data using file system functions rather than internet function when viewing locally. Please see the Local Viewing example in the product for complete details! Simply drag-drop many files onto the converter and it will automatically convert them one by one.

Or, double-click the converter and within the standard Open File dialog that is presented, shift-click to select multiple image file names. For information on how many images can be batch converted at once please see the question ' How many images can I batch convert at once? For information on scripting the Enterprise Converter, please see the question ' How can I script conversion of one file after another?

Prior versions of the Zoomify Converter may, however, need to be run in Compatibility Mode. If errors are encountered regarding the excecutable being incompatible contact Zoomify to receive the latest Zoomify Converter or use the following steps to run the Converter in Compatibility Mode: Right-click the converter and select Properties, then the Compatibility tab, then check the box labeled "Run this program in compatibility mode for:" and select from the dropdown, 'Windows XP'.

Note that the converter also has to run in "Administrator mode". Zoomify is designed to deliver the maximum possible efficiency in image preparation and viewing. Image preparation is typically performed at site authoring time though it is also possible to implement at view-time using the scriptable Zoomify Converter included in Zoomify Enterprise.

The Zoomify Converter can process gigabytes of image data in minutes - actual performance varies according to processing power and memory availability.

Viewing of Zoomify images is significantly more efficient than with any other approach. Each new view that a site visitor zooms-and-pans to only involves the image data essential for that view at that resolution. The user experience is further optimized by server and client-side caching. For additional information on Zoomify performance please see the questions ' What performance benchmarks can I expect with Zoomify?

The default compression of the Zoomify Converter can be easily changed by locating the file zoomifyConvertPrefs. The file will be located immediately next to the Zoomify Converter after any conversion, or for some prior versions in the Zoomify Cache directory. The line that requires changing reads as follows by default:. The number 80 can be changed to anything from 1 to Note that settings below 80 may show JPEG compression artifacts. In Adobe Photoshop Zoomify conversion is an integrated feature.

Photoshop users can simply select File Export Zoomify While it may still be of interest for some Zoomify customers for the Zoomify Converter to directly support the RAW or PSB format, the built-in support provided by Adobe delivers excellent convenience and performance. Your input as to how direct support within the Zoomify Converter weighs against the development or enhancement of other Zoomify features is welcomed.

Please note that prior to exporting from within Photoshop users will want to ensure their image is 8-bit and in sRGB format in order to ensure consistent color presentation across Windows and Macintosh platforms. Unfortunately, vector content cannot currently be converted using the Zoomify Converter into a base image to be displayed within the Zoomify Viewer.

The benefit of the Zoomify technology is in the rapid, interactive viewing of bitmap photo files. This is essential as bitmap images of any reasonable quality typically make for very large files. Cutting these files into JPEG tiles and doing so at many different tiers of resolution enables the Zoomify Viewer to download only the small portion of the image that is essential for the current view that has been zoomed and panned to by the user.

This ensures that each new view will require only a download of perhaps k to k regardless of whether the source image is 5 megabytes or gigabytes in size. Vector content, in contrast, is typically small with respect to file size. It can be downloaded quickly and scaled with the built-in functionality of common browsers.

Where one's vector content is exceptionally complex or broad in scope - for example a street map for an entire city - tiling and tiering would prove valuable. Zoomify has explored this possible additional use and weighed the non-trivial vector tiling requirement against the apparent demand and the development has simply not been justifiable to-date.

There are many other features associated with much greater customer demand. We are, however, interested in the value of such a feature addition and we welcome your input about your needs and potential uses for such a feature. As a result, it is often helpful to first 'zip' or 'stuff' one or more folders prior to uploading. The uploaded file can then be unzipped or unstuffed on the server. This approach results in the transfer of a comparable amount of data but only a single file transfer.

The savings in client and server communication can reduce the copy time dramatically. This approach is also recommended due to the reduced risk of any individual JPEG file being corrupted or lost during the transfer process whether due to operating system or human error. Utilities for compressing and uncompressing files as described above can be downloaded from numerous sites including WinZip. Security restrictions have prevented web pages from dynamically loading content from domains other than the domain that the calling web page itself is in.

In some cases this restriction can be addressed through the use of a cross-domain policy file. A cross-domain policy file is simply an XML text file that provides a way for the server to indicate that its data and documents are available to web pages served from certain domains or from all domains.

When a web page attempts to load data from another domain, the page automatically looks for policy file on that domain.

If one is present, the data is automatically accessible. Using Javascript to talk into the Zoomify Viewer is very simple because the Viewer is simply JavaScript in the web page. The Zoomify API includes many functions that can be called from within the web page. This zoom-and-pan solution is completely standard in terms of web server hosting, caching, and other publishing considerations. Whether working with Akamai or another 'edge server' system, the small JPEG image files which make up any Zoomify view will be propagated over the network optimally and independently based on demand - just as if they were individually placed within a web page.

Zoomify's 'one-file' storage approach, in which the JPEG files that make up different views of an image are stored in a single file with a '. Support Frequently asked questions This Support FAQ provides answers to questions our support team frequently receives about Zoomify products, purchasing, and policies. Topics range from general presales questions, information about which product best serves your needs, and specific technical issues. Licensing: The Zoomify Unlimited Converter is licensed per user - just like Photoshop and other imaging software.

Your content is your own - no royalties, no strings. The same is true of customized versions, so long as the JavaScript file is 'minified' compressed using an online tool. For detailed information please refer to the Zoomify License Agreement. Custom Logo. Custom Layout. Zoom Rectangle. Virtual Pointer.

Ruler Panel. Measuring Tool. Rotation - Free. Tours With Audio. Slideshows - Gallery. Coordinate Finder. Hotspot Popups. Hotspot Categories. Hotspot Functions. Click Functions. Preload Option. Animation Object. Time Lapse. Animation Panorama. Animation JPEGs.