Upload Formats for GIGAmacro Viewer
Published by: GIGAmacro, 455 Technology Way, Napa, CA 94558, USA +1 415 841 3322 (Pacific time zone)
Author: Graham Bird
Suggestions, improvements and updates to: <[email protected]>
Version: 2.1, Version Date: 2017-10-19
|Tips and hints are indicated like this.|
|Warnings are indicated like this.|
|Critical or important items are indicated like this.|
In order to view the large files that are the result of making very high-resolution macro images and in order to share those images easily for viewing, comment and annotation, we developed the GIGAmacro Viewer.
Using the GIGAmacro Viewer you can:
Use the GIGAmacro Viewer in demonstration mode to show images automatically
Use GIGAmacro images in your exhibits and/or your curriculum
Make side-by-side comparisons
Link GIGAmacro images together for synchronized movement
Make layered comparisons in “x-ray" mode
Take measurements on an image
Flip GIGAmacro images vertically or horizontally
View in fullscreen mode
Use and view GIGAmacro images on your own intranet or on internet website or cloud service
Load GIGAmacro images from your local hard drive or cloud storage
Load gigapixel images from a Zoomify or Gigapan tileset.
In order to be presented by the GIGAmacro Viewer, the original (usually a 'large Photoshop' or .psb image) needs to be processed into pieces that can be handled easily by the Viewer, these output files (the pieces) are called 'Tiles'.
Tiles are produced by breaking up the original image into small pieces that reflect different zoom levels and parts of the image. A number of software packages can do this, often the easiest option is to use Photoshop which produces Tiles in the Zoomify format. We’ll use that as the example here.
The original image in the example - wasp_moth.psb - is 2.6 Gb in size. Load it into Photoshop, and the go to Files>Export>Zoomify.
Set the location for the output files, and the other options can be left as the defaults. If you wish, you can reduce 'Image Tile Options Quality' to 8 or 10 which can significantly reduce the size of the resulting tiles, and the zip file for upload.
Choose 'OK" and let Photoshop do its thing - this image took about 4 minutes - and when complete you should have a folder called 'wasp_moth'. It will have a structure that looks like this:
Packaging for upload
Create a folder called 'tiles' inside the 'wasp_moth' folder and move all the files into 'tiles'.
|Previous versions of the GIGAmacro Viewer expected a folder called 'zoomify' inside the 'wasp_moth' folder. That will still work, but as the Viewer now works with multiple tile formats, we have changed the folder name to something more meaningful.|
|If you are uploading an image that you produced by any other means than the GIGAmacro Magnify2, you can ignore the instruction about 'capture_metadata_DATE_TIME.txt' file.|
If you are uploading an image produced on the GIGAmacro Magnify2 you will need to COPY (make sure you leave the original file in the project folder by copying, not moving) the file that contains all the information from the original capture - the metadata - to the folder. The file is always called 'capture_metadata_DATE_TIME.txt', locate that and COPY it to the 'wasp_moth' folder.
The packaging is now complete and we just have to compress the whole folder structure into a single zip file for uploading to the viewer.
On Windows right-click on the 'wasp_moth' folder and choose 'Send To > Compressed (Zipped) Folder'. On MacOS Control click the 'wasp_moth' folder and choose 'Compress'. You will now have the original 'wasp_moth' folder plus a 'wasp_moth.zip' file.
The 'wasp_moth.zip' should be uploaded to the GIGAmacro Viewer when you are logged in to your account by choosing the 'Add Image' option and then selecting the 'wasp_moth.zip' file for upload.