Coyote Graphics Routines

Date: Fri Mar 27 12:14:20 2015

single page | use frames     summary     class     fields     routine details     file attributes

.\

cgmap_set.pro


top cgMap_Set

Graphics, Map Projections

cgMap_Set [, p0lat] [, p0lon] [, rot] [, /ADDCMD], ADVANCE=ADVANCE, AITOFF=AITOFF, ALBERS=ALBERS, AZIMUTHAL=AZIMUTHAL [, BACKGROUND=string], BOX_AXES=BOX_AXES, CENTRAL_AZIMUTH=CENTRAL_AZIMUTH, CHARSIZE=CHARSIZE, CLIP=CLIP, COASTS=COASTS [, COLOR=string], CON_COLOR=CON_COLOR, CONIC=CONIC [, /CONTINENTS], COUNTRIES=COUNTRIES, CYLINDRICAL=CYLINDRICAL, E_CONTINENTS=E_CONTINENTS, E_HORIZON=E_HORIZON, E_GRID=E_GRID, ELLIPSOID=ELLIPSOID [, /ERASE], FILL_CONTINENTS=FILL_CONTINENTS, GLINESTYLE=GLINESTYLE, GLINETHICK=GLINETHICK [, /GRID], GOODESHOMOLOSINE=GOODESHOMOLOSINE, GNOMIC=GNOMIC, HAMMER=HAMMER, HIRES=HIRES, HORIZON=HORIZON, ISOTROPIC=ISOTROPIC, LAMBERT=LAMBERT, LABEL=LABEL, LATALIGN=LATALIGN, LATDEL=LATDEL, LATLAB=LATLAB, LIMIT=LIMIT, LONALIGN=LONALIGN, LONDEL=LONDEL, LONLAB=LONLAB, MERCATOR=MERCATOR, MILLER_CYLINDRICAL=MILLER_CYLINDRICAL, MLINESTYLE=MLINESTYLE, MLINETHICK=MLINETHICK, MOLLWEIDE=MOLLWEIDE, NAME=NAME, NOBORDER=NOBORDER, NOERASE=NOERASE [, /ONIMAGE], ORTHOGRAPHIC=ORTHOGRAPHIC [, POSITION=FltArr(4)], PROJECTION=PROJECTION, RIVERS=RIVERS, REVERSE=REVERSE, ROBINSON=ROBINSON, SAT_P=SAT_P, SATELLITE=SATELLITE, SCALE=SCALE, STANDARD_PARALLELS=STANDARD_PARALLELS, STEREOGRAPHIC=STEREOGRAPHIC, SINUSOIDAL=SINUSOIDAL, T3D=T3D, TITLE=TITLE, TRANSVERSE_MERCATOR=TRANSVERSE_MERCATOR, USA=USA, WHOLE_MAP=WHOLE_MAP [, /WINDOW], XMARGIN=XMARGIN, YMARGIN=YMARGIN, ZVALUE=ZVALUE

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.

Parameters

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.

ADVANCE
AITOFF
ALBERS
AZIMUTHAL
BACKGROUND in optional type=string default=white

The name of the background color. Using this keyword automatically sets the ERASE keyword to 1.

BOX_AXES
CENTRAL_AZIMUTH
CHARSIZE
CLIP
COASTS
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.

CON_COLOR
CONIC
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.

COUNTRIES
CYLINDRICAL
E_CONTINENTS
E_HORIZON
E_GRID
ELLIPSOID
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.

FILL_CONTINENTS
GLINESTYLE
GLINETHICK
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.

GOODESHOMOLOSINE
GNOMIC
HAMMER
HIRES
HORIZON
ISOTROPIC
LAMBERT
LABEL
LATALIGN
LATDEL
LATLAB
LIMIT
LONALIGN
LONDEL
LONLAB
MERCATOR
MILLER_CYLINDRICAL
MLINESTYLE
MLINETHICK
MOLLWEIDE
NAME
NOBORDER
NOERASE
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.

ORTHOGRAPHIC
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]

PROJECTION
RIVERS
REVERSE
ROBINSON
SAT_P
SATELLITE
SCALE
STANDARD_PARALLELS
STEREOGRAPHIC
SINUSOIDAL
T3D
TITLE
TRANSVERSE_MERCATOR
USA
WHOLE_MAP
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.

XMARGIN
YMARGIN
ZVALUE

Author information

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

Copyright:

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

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.

File attributes

Modification date: Fri Mar 27 11:07:36 2015
Lines: 637
Docformat: rst rst