Versions Compared

Key

  • This line was added.
  • This line was removed.
  • Formatting was changed.
Comment: Update link to go to OpenMRS Add-ons index instead

...

Usage notes

Getting the module

...

  • 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 Settings (formerly Global Properties from platform 1.8 downwards) 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.

Using the image viewer

  • Create a new concept:
    • set Class to GoogleImageViewer,
    • set Datatype to Complex,
    • set Handler to AnnotatedImageHandler
  • Add a new Observation and set Concept to the new concept created above.
    • Browse and upload an image.
    • Save the observation.
  • Click on the Value link or "View current complex value in a new window"
  • The new image would be displayed using the Google Maps 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.

...