coyote: CGMAP_SET

Description
Provides a modified MAP_SET command that can work together with other Coyote Graphics
commands and be used in resizeable graphics windows. Any keyword appropriate for MAP_SET,
MAP_CONTINENTS, or MAP_GRID can be used with this routine. Additional or modified 
keywords are documented.
Categories
Graphics, Map Projections
Params
p0lat: in, optional, type=float
    The center latitude of the map projection.
p0lon: in, optional, type=float
    The center longitude of the map projection.
rot: in, optional, type=float, default=0.0
    The angle through which the map projection should be rotated. Positve 
    values are in a clockwise direction.
Keywords
addcmd: in, optional, type=boolean, default=0
   If this keyword is set, the command is added to the resizeable graphics
   window, cgWindow. 
background: in, optional, type=string, default='white'
   The name of the background color. Using this keyword automatically sets 
   the ERASE keyword to 1.
color: in, optional, type=string, default='opposite'
   The name of the drawing color for the program.
   erase: in, optional, type=boolean, default=0
   Set this keyword if you wish to the current graphics content of the window
   before drawing the map projection. The graphics display will be erased
   in the background color. This is a more intuitive way to set this behavior
   than to set NOERASE to 0, which does the same thing.
continents: in, optional, type=boolean, default=0
    Set this keyword to display continental outlines on the map projection.
    Any keyword appropriate to the IDL command Map_Continents can be used to
    modify the look of the continental outlines.
erase: in, optional, type=boolean, default=0
    A more intuitive way to set NOERASE=0. If ERASE is set, the display window
    is erased in the BACKGROUND color.
grid: in, optional, type=boolean, default=0
    Set this keyword to display a map grid on the map projection. And keyword
    appropriate to the IDL command Map_Grid can be used to modify the look of the
    map grid.
onimage: in, optional, type=boolean, default=0
   If this keyword is set, the position of the map projection in the graphics window
   is obtained from the last image displayed with cgImage. This makes it extremely
   easy to display an image and immediately set up a map projection space that will
   allow you to annotate the image using map locations. This keyword is ignored if
   the 'Position` keyword is used.
position: in, optional, type=FltArr(4)
   The normalized position of the map projection space in the graphics window.
   The default is [0.075, 0.075, 0.925, 0.925]
window: in, optional, type=boolean, default=0
    If this keyword is set, the command replaces any commands in a current
    cgWindow or it opens a new cgWindow and adds itself to it.
Author
FANNING SOFTWARE CONSULTING::
   David W. Fanning 
   1645 Sheely Drive
   Fort Collins, CO 80526 USA
   Phone: 970-221-0438
   E-mail: david@idlcoyote.com
   Coyote's Guide to IDL Programming: http://www.idlcoyote.com
History
Written by David W. Fanning, 7 November 2011.
Added ONIMAGE keyword to allow the position to be specified at the last
   image position from cgImage. 3 March 2012. DWF.
Several MAP_CONTINENTS keywords seem to have gone missing. Added COASTS,
   COUNTRIES, FILL_CONTINENTS, and RIVERS. 4 Dec 2012. DWF.
Forgot to pass the "extra" information in (e.g., E_HORIZON keyword) to Map_Set. 18 Jan 2013. DWF.
HORIZON keyword not being passed along to Map_Set. 28 Feb 2013. DWF.
Forgot to look at !P.Multi before setting a POSITION. Fixed. 11 March 2013. DWF.
Modified the E_GRID and E_HORIZON structure code to allow color names. 29 April 2013. Joe Sapp.
In some situations, the "extra" continents structure was not being passed along. 29 May 2013. DWF.
Now, when "extra" structures are passed along, they can have duplicate fields. Put check in place. 22 June 2013. DWF.
Copyright
Copyright (c) 2011-2012, Fanning Software Consulting, Inc.