GIGAmacro Magnify2 and Control Box

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.

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 '' file.

The '' 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 '' file for upload.

Date: 2017-10-19