User:SvareJM/Sandbox/Using ImageViewer

ImageViewer is the preferred application for downloading images held by FamilySearch to be used in Historical Records articles.

The current version of Image Viewer can be found at:
 * 32-bit version
 * 64-bit version

Dependency
ImageViewer requires the Amazon Corretto 8 JRE to operate.

You need admin rights to your computer in order to complete these steps. If you do not have admin rights, please contact a TSR to help you.
 * 1) Install Amazon Corretto 8 JRE for Windows x64 (from Downloads for Amazon Corretto 8 - Amazon Corretto or the msi file)
 * 2) Add Amazon Corretto 8 to system path following these instructions:
 * In Control Panel, search for ‘Environment variables’ to find ‘Edit the system environment variables’
 * Click on ‘Environment Variables’ and then under ‘System variables’ edit the Path variable
 * Remove any references to paths which contain ‘Oracle\javapath’, ‘Program Files\Java\jre1.8.0_181’ (or similar) or 'AdoptOpenJDK'
 * Add the path to Amazon Corretto 8 (e.g. C:\Program Files\Amazon Corretto\jre8\bin)

Starting ImageViewer
When you start ImageViewer a dialog box will open displaying your username and a field to enter your password. Enter your password and press OK. If you typed in your password correctly a message box will appear stating Login successful.... Press OK to clear the message.

Layout
ImageViewer consists of four resizable and moveable windows. Thumbnails, Notes, Text View, and Image View. Text View is not used.

Thumbnails
This window displays thumbnail views of the images in the folder. Clicking on a thumbnail will display that image in the Image View window. Going from left to right the icons in this window have the following functions:
 * Previous page of thumbnails
 * Next page of thumbnails
 * Enlarge thumbnails
 * Reduce thumbnails
 * Save all images in folder - Do not use this
 * Display DOR (DCamX Operator Report)

Image View
This window displays the image selected in the Thumbnail window. You can click and drag the image to reposition it. Going from left to right the icons in this window have the following functions:
 * Shrink image to fit to window. This function will toggle by clicking the icon.
 * Enlarge image
 * Reduce image
 * Rotate image clockwise
 * Rotate image counter-clockwise
 * Invert colors (makes a black and white image a negative)
 * Save image - use this to save the image for use in the wiki. See Uploading Files to the FamilySearch Wiki for more information.
 * Print
 * Browse artifact metadata
 * Minimize window
 * Maximize window

Loading Images
To load images press Ctrl+D or, from the menu bar click File \ Distribution Store Viewer. Then press OK.
 * Enter the DGS number in the field labeled Enter film number, APID, or ARK:
 * If you have a microfilm number and not a DGS number, enter the film number in the second field labeled or enter GS number"
 * If you have a specific image you want to load enter the image number in the field labeled Enter image number (optional):

For example: Loading a specific image does not always work if a film number is entered.
 * To see images from DGS number 8515322 enter that number in the first field
 * To see images from film number 12345 enter than number in the second field
 * To load image 50 from DGS 8515322 enter the DGS number in the first field and the image number in the third field.

Thumbnail Window Navigation
You can move through the thumbnails several ways:
 * Using the mouse and/or the mouse's scroll wheel
 * Pressing the Page Up or Page Down keys
 * Clicking on the specific you wish to view
 * Pressing Ctrl+G opens the Go To Image window where you can specify an image to display. You do not need to enter the leading zeros of the image.

Error Messages
If you get a message that says "Unable to create image cache...." you need to delete the image cache folder.

The folder is located in this directory: C:\Users\ \AppData\Local\Temp\FamilySearch\imagecache
 * Click on the folder name and press Delete
 * Close Windows Explorer and restart Image Viewer

If you can't see the folder, make sure your Windows file explorer settings allow you to see hidden files.
 * Open Windows Explorer (Windows key +E)
 * On the Menu Bar go to View \ Show/hide
 * Check the box next to Hidden items