...
As images (chest x-rays, photographs of rashes, etc.) are loaded into OpenMRS, we will need tools to allow users to view and manipulate these images. We would like a clinician to be able to bring up one of the images in OpenMRS and easily manipulate the image to view details and potentially annotate the image. For example, a radiologist could bring up a patient's chest x-ray, zoom in to part of the image and adjust the image contrast to diagnose tuberculosis, and then add their impression to the database  e.g., add an arrow to the image along with a comment like "this is consistent with tuberculosis."
...
The Google Maps Image Viewer module is based on Bmckown's Complex Obs Support system. It should only be installed in OpenMRS deployments built from the complex-obs branch. The complex obs system handles storage and loading of image files.
...
- Make sure you are running the complex obs version of OpenMRS
- Deploy the module in the normal way
- Go to the Google Maps API page and get a developer key. This is free, but a Google account is required. Each key is valid for only one domain, so a new key must be obtained if the OpenMRS deployment is moved. More details about the developer key can be found here: http://code.google.com/apis/maps/faq.html#keysystem
- Save the developer key in the OpenMRS global property mapsimageviewer.googleMapsDevKey. This may be done using the Manage Global Properties page.
- If using very large images, the image viewer will use a lot of memory. Please make sure that Java has a large heap space, refer to the wiki page on Troubleshooting Memory Errors.
When the module is loaded, a new link appears in the Administration page, 'Complex obs list'. This allows easy access to any images that may be stored in the database.
Using the image viewer
- Click and drag the image or use the arrow buttons in the top left corner to pan and navigate.
- Use the vertical slider in the top left corner or the mouse scroll wheel to zoom in and out.
- The current zoom level is shown in the top right corner. Clicking that text changes the zoom level to 100%.
- If the image has annotations, they are shown as red markers on the image. Click a marker to read the text.
- Markers can be moved, edited or deleted. To place a new marker, double-click the desired location.
- The bottom right corner contains a thumbnail view of the image. To hide it, click the small button with an arrow.
...