# coyote: CGMAP_SET

- coyote/Graphics
- coyote/Map Projections
- [Source code]

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. Positive
          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.
      Removed parameters E_GRID and E_CONTINENTS in call to MAP_SET so they don't interfere with later calls to cgMap_Grid and cgMap_Continents. 23 Nov 2015. Joe Sapp.
      Fix typo in passing extra parameters to cgMap_Continents. 23 Nov 2015. Joe Sapp.

Copyright

      Copyright (c) 2011-2012, Fanning Software Consulting, Inc.