-
mpDataBaseVersion
-
This resource of type NhlTMapDataBaseVersion
determines which database version MapPlot should use.
Currently there are two choices:
Ncarg4_0
- Use the original database as
supplied with MapPlot in version 4.0. This database
is out of date with respect to political boundaries and has much lower
resolution than the Ncarg4_1 database. Nevertheless, for global scale
plots that involve only geophysical boundaries, this database is the
recommended one to use. Because there are so many fewer points,
MapPlot can render the data much faster, particularly
when fill is involved. This database contains 583 named geographical
entities.
Ncarg4_1
- Use the database created for version
4.1. This database contains 1085 named geographical entities
arranged in an extensible hierarchical fashion. The database is
organized in such a way that new subdivisions of existing areas can
easily be added. The resolution is much higher than the original
database, and the political boundaries are up-to-date as of mid-year
1998. Use of this database is recommended when plotting limited areas
of the earth's surface, or any time up-to-date political boundaries are
required.
Note that the set of names provided with the 4.1 database is different
from set provided with the earlier database. Although you can switch
between databases after creating a mapplot, if you have
set any of the specifier resources (mpFillAreaSpecifiers,
mpOutlineSpecifiers, or mpMaskAreaSpecifiers), you will
be likely to encounter warning messages. These occur because names found
in one database often do not occur in the same form in the other
database. In particular, a hyphen character always separates multi-word
names in the 4.0 database. The 4.1 database uses spaces except where a
hyphen is part of the natural spelling of the name.
Default: Ncarg4_0
-
mpShapeMode
-
This resource of type NhlTMapShapeMode allows you to
control whether the map projection preserves its intrinsic shape
(aspect ratio), and in addition, if the aspect ratio is to be
preserved, whether the MapPlot bounding box should be
resized to fit the map projection extent exactly. It has three possible
settings:
FreeAspect
- Do not preserve the map projection aspect ratio. The projected
area is "stretched" along either the horizontal or the vertical
View axis such that it fills the specified
View area.
FixedAspectFitBB
- Preserve the map projection aspect ratio. The projected area is
made as large as possible and centered within the
View area. Then MapPlot resizes its
View area such that its perimeter matches the bounding box
of the projected area.
FixedAspectNoFitBB
- Preserve the map projection aspect ratio. The projected area is
made as large as possible and centered within the
View area. MapPlot does not resize
its View area.
Default: FixedAspectFitBB
-
mpAreaNames
-
mpAreaNames is a string array resource you can use to
retrieve the names of all areas in a MapPlot
database. You need to know these names, including specific
details of their spelling, in order to use the specifier resources
(mpFillAreaSpecifiers, mpOutlineSpecifiers, or
mpMaskAreaSpecifiers). There is a unique name for each
distinct area. However, the form of the names differs depending on the
database in use.
You can also set this resource to rename the area names, perhaps
to better represent the conventions of another locale. You must set
the complete list of names at the same time. Keep in mind that the
order of areas is fixed: a particular element of the array always
refers to the same area in the database you are using
regardless of the name you give it.
- When using the Ncarg4_0 database:
- All names that are compounds of several words use the hyphen
character ('-') to separate the individual words. In several cases
where the names would otherwise not be unique, an underscore character
('_') followed by a digit is appended to the end of the name. If you use a
SetValues call to rename the areas, it is your
responsibility to ensure that you do not duplicate the names of any
areas. Only one of a group of identically named areas will remain
accessible. See the Ncarg4_0 database table
for the list of area names.
- When using the Ncarg4_1 database:
- Names that are compounds of several words use the space character
(' ') to separate the individual words unless some or all of them are
normally hyphenated. See the Ncarg4_1
database table for the list of area names.
Default: <dynamic>
-
mpAreaTypes
-
This read-only integer array resource contains the integer value of the
type of each area in a MapPlot database. Each
element gives the type of the area named by the corresponding element
of the mpAreaNames array. The meaning and value of these types
vary depending on the value of mpMapDataBaseVersion.
- When using the Ncarg4_0 database:
- Areas are classified into eight types. These types are as follows:
- (0) mpOcean
- (1) mpContinent
- (2) mpLargeIsland
- (3) mpSmallIsland
- (4) mpInlandWater
- (5) mpNational
- (6) mpUSStateLand
- (7) mpUSStateWater
See the Ncarg4_0 database table to
find the area type associated with a particular area name.
- When using the Ncarg4_1 database:
- Areas are classified into
four types. These types represent the four levels of
the hierarchical classification scheme currently represented in the
database. More types may be added if and when areas at other levels of the
hierarchy are added to the database. The current types are as follows:
- (1) mpGeophysical
- (2) mpContinental
- (3) mpNational
- (4) mpState
See the Ncarg4_1 database table to
find the area type associated with a particular area name.
Default: <dynamic>
-
mpFixedAreaGroups
-
MapPlot maintains two arrays that assign area group numbers to each
area in a MapPlot database. MapPlot
uses the area's group numbers to determine its fill attributes,
assuming mpFillOn is True and you do not explicitly specify
fill attributes for the area. The mpFixedAreaGroups resource
allows read-only access for informational purposes only to the fixed
area group array, which, as its name implies, you cannot modify. The
elements of this array have the same order as the mpAreaNames
array. Within the array each area in the database is assigned to area
group 1, 2, or 3. These are respectively the Ocean group, the
Land group and the InlandWater group. For this
reason mpFixedAreaGroups is sometimes known as the
geophysical area groups array, since a map whose fill
attributes are based on these area groups shows only physical as
opposed to political features.
If fill is turned on and you set mpFillBoundarySets to the
value Geophysical
and do not explicitly specify any areas
using the mpFillAreaSpecifiers resource,
MapPlot will use the mpFixedAreaGroups group
numbers to determine fill attributes for all areas of the map. For
each of the three fill attribute types that has its Mono flag
resource set False, the area's group number is used as an index into
the fill attribute array resource. This yields, for
mpFillColors, an HLU color index, for
mpFillPatterns, an HLU fill pattern index, and for
mpFillScales, a fill pattern scaling factor. A more complete
description of the situations that result in
MapPlot indexing the fill attribute array resources
based on the contents of the mpFixedAreaGroups array is found
in the discussion of area fill in the MapPlot object
description.
Note that you can set the fill attributes of the area groups
assigned by the mpFixedAreaGroups array using a set of
convenience resources that act as named aliases for the
Ocean, Land, and InlandWater elements
of mpFillColors, mpFillPatterns, and
mpFillScales. These resources are as follows:
mpOceanFillColor, mpOceanFillPattern,
mpOceanFillScaleF, mpLandFillColor,
mpLandFillPattern, mpLandFillScaleF,
mpInlandWaterFillColor, mpInlandWaterFillPattern,
and mpInlandWaterFillScaleF.
- When using the Ncarg4_0 database:
- See the Ncarg4_0 database table to
find the fixed area group associated with a particular area name.
- When using the Ncarg4_1 database:
- See the Ncarg4_1 database table to
find the fixed area group associated with a particular area name.
Default: <dynamic>
-
mpDynamicAreaGroups
-
MapPlot maintains two arrays that assign area group numbers to each
area in a MapPlot database. MapPlot
uses the area's group numbers to determine its fill attributes,
assuming mpFillOn is True and you do not explicitly specify
fill attributes for the area. The mpDynamicAreaGroups
resource allows you to access and, if desired, set the elements of the
dynamic area group array. The elements of this array have the same
order as the mpAreaNames array. By default, within the
dynamic group arrray MapPlot assigns each area a
group number such that adjoining politically distinct land areas are
guaranteed to belong to a different group. For this reason the
mpDyanamicAreaGroups array is sometimes known as the
political groups array, since a map whose fill attributes are
based on these area groups shows national and perhaps state boundaries
as well as physical features. Anytime mpFillBoundarySets is
set in such a way that national or U.S. state areas must be
distinguished, and the fill attributes are not set explicitly,
MapPlot uses the group numbers in the
mpDyanamicAreaGroups array as indexes into the fill attribute
array resources whose associated Mono flag resource is set
False. A more
thorough description of the situations that result in
MapPlot indexing the fill attribute array resources
based on the contents of the mpDyanamicAreaGroups array is
found in the discussion of area fill in the MapPlot
object description.
You may reassign the group numbers in the
mpDyanamicAreaGroups array in any manner you please. At
minimum and by default there are 10 area groups, but by setting the
resource mpAreaGroupCount you can increase the number of area
groups to any number up to a maximum of 255.
- When using the Ncarg4_0 database:
- See the Ncarg4_0 database table to
find the dynamic area group associated with a particular area name.
- When using the Ncarg4_1 database:
- See the Ncarg4_1 database table to
find the dynamic area group associated with a particular area name.
Default: <dynamic>
-
mpAreaGroupCount
-
mpAreaGroupCount specifies the total number of area groups,
including the "default" group, the three fixed (or geophysical)
groups, and the dynamic (or political) groups (a minimum of six). The
minimum, as well as the default, value of mpAreaGroupCount is
10. The maximum value is 255. Attempts to set
mpAreaGroupCount to values outside this range result in a
warning and a restoration of the default value.
Default: 10
-
mpOutlineOn
-
This boolean resource is the master switch for drawing of
MapPlot area outlines. If True, the
MapPlot enables drawing of map area
outlines. Otherwise, these outlines will not appear, regardless of the
setting of any other area-outline-related resources. However, note
that this resource does not apply to MapPlot grid or
limb lines or to the perimeter line.
Default: True
-
mpOutlineDrawOrder
-
This resource of type NhlTDrawOrder determines
when MapPlot area outlines are drawn relative to
other elements of the plot. There are three choices:
PreDraw
- Draw the area outlines before the standard draw phase; the lines
will overlay MapPlot fill and grid or limb lines also
drawn during the predraw phase but will underlie
MapPlot labels and perimeter lines drawn during the predraw
phase and anything drawn during the draw and postdraw phases.
Draw
- Draw the area outlines during the standard draw; the lines will
overlay any elements drawn during the predraw phase, as well as
MapPlot fill and grid or limb lines drawn during the
standard draw phase, but will underlie MapPlot labels
and perimeter lines drawn during the draw phase and anything drawn
during the postdraw phase.
PostDraw
- Draw the lines after the standard draw; the lines will overlay all
MapPlot elements except for labels and perimeter lines
drawn during the postdraw phase.
Default: PostDraw
-
mpOutlineBoundarySets
-
You set this resource of type NhlTMapBoundarySets
to specify the basic boundary set used to render area outlines. Given
the basic boundaries, you can then add other outline areas by
specifying area names in the mpOutlineSpecifiers string
array resource. There are six choices:
NoBoundaries
- MapPlot will draw area outlines only for areas
specified by name in mpOutlineSpecifiers.
Geophysical
- MapPlot will draw area outlines for geophysical
features: continents, oceans, islands, and inland water
areas. Specific national boundary lines may be added by name in
mpOutlineSpecifiers.
National
- MapPlot will draw area outlines delineating all
national boundary areas as contained in the MapPlot
database being used. All the geophysical features specified by
Geophysical
are implicitly included. You may add
U.S. State area outlines by name using the
mpOutlineSpecifiers resource.
USStates
- MapPlot will draw area outlines delineating the
states of the United States. When using the Ncarg4_0
database, Alaska and Hawaii are not included, although a few areas
outside the U.S. proper, including the Bahamas and a few lakes
extending into Canadian territory, are drawn. When using the
Ncarg4_1 database, Alaska and Hawaii are drawn, but no
non-U.S. territory is included. You may add geophysical and/or
national areas by name using the mpOutlineSpecifiers
resource.
GeophysicalAndUSStates
- MapPlot will draw area outlines of all global
geophysical features as well as the states of the U.S.
Other national boundaries do not appear unless you specify
them by name using the mpOutlineSpecifiers resource.
AllBoundaries
- MapPlot draws area outlines of all national
boundaries as well as all U.S. State boundaries. All geophysical
features implicitly appear. When the Ncarg4_1 database is
in use, specifying an area name whose mpAreaType is 2 or 1
(
mpGeophysical
or mpContinental
) has the
effect of suppressing type 3 or higher boundaries within its borders.
For instance, setting mpOutlineSpecifiers to the value
"Africa" would have the effect of suppressing national boundaries
within the African continent.
Default: Geophysical
-
mpOutlineSpecifiers
- You use the array resource mpOutlineSpecifiers to specify
particular area outlines MapPlot is to draw by
name. These areas are added to the basic outline area set specified
using the resource mpOutlineBoundarySets. Note that the names
from different MapPlot databases are not necessarily
compatible. Therefore, if mpOutlineSpecifiers is non-NULL when
you set mpMapDatabaseVersion to a different value, you are likely
to encounter warning messages unless you also set mpOutlineSpecifiers
using names compatible with the new database. You can retrieve a list
of compatible names by getting the value of mpAreaNames. Case is
not significant for mpOutlineSpecifier string values.
- When using the Ncarg4_0 database:
- In addition to the individual area names, you may include certain
pre-defined groups of areas using a number of pre-defined
string constants. Moreover, there is a substring matching
facility that allows you to specify groups of areas sharing a common
substring.
- When using the Ncarg4_1 database:
- Only the "NullArea" string
constant is defined. Due to the hierarchical nature of this database,
however, many area groupings occur as named entities in their own
right. For instance, you can draw all islands of the Pacific Ocean by
including the string "Pacific Islands" as an element of
mpOutlineSpecifiers. The substring matching facility is not
currently supported.
Default: NULL
-
mpAreaMaskingOn
-
This boolean resource is the master switch for enabling the area
masking facility. If True, MapPlot enables area
masking, causing areas named in the mpMaskAreaSpecifiers array
to remain unfilled, consequently allowing previously drawn plot elements
to be visible within the areas' outlines. If False, no masking is performed,
regardless of the contents of mpMaskAreaSpecifiers. For convenience,
setting mpMaskAreaSpecifiers causes mpAreaMaskingOn to
be set True, if it is not explicitly set otherwise in the same call.
Default: False
-
mpMaskAreaSpecifiers
- You use the array resource mpMaskAreaSpecifiers to
specify the names of areas MapPlot is to mask. These
areas are subtracted from the fill area set specified using the
resource mpFillBoundarySets and
mpFillAreaSpecifiers. There is an order of precedence for
fill and masking. Explicitly named areas take precedence over area
groupings, and small areas take precedence over enclosing larger
areas. Otherwise masking takes precedence over filling.
Note that the names from different MapPlot
databases are not necessarily compatible. Therefore, if
mpMaskAreaSpecifiers is non-NULL when you set
mpMapDatabaseVersion to a different value, you are likely to
encounter warning messages unless you also set
mpMaskAreaSpecifiers using names compatible with the new
database. You can retrieve a list of compatible names by getting the
value of mpAreaNames. Case is not significant for
mpMaskAreaSpecifier string values.
- When using the Ncarg4_0 database:
- In addition to the individual area names, you may include certain
pre-defined groups of areas using a number of pre-defined
string constants. Moreover, there is a substring matching
facility that allows you to specify groups of areas sharing a common
substring.
- When using the Ncarg4_1 database:
- Only the "NullArea" string
constant is defined. Due to the hierarchical nature of this database,
however, many area groupings occur as named entities in their own
right. For instance, you can draw all islands of the Pacific Ocean by
including the string "Pacific Islands" as an element of
mpOutlineSpecifiers. The substring matching facility is not
currently supported.
Default: NULL
-
mpFillOn
-
This boolean resource is the master switch for drawing of
MapPlot area fill. If True, the
MapPlot enables drawing of map area fill.
Otherwise, no map fill will appear, regardless of the
setting of any other area-fill-related resources.
Default: False
-
mpFillDrawOrder
-
This resource of type NhlTDrawOrder determines
when MapPlot area fill is drawn relative to
other elements of the plot. There are three choices:
PreDraw
- Draw area fill before the standard draw phase; the fill underlies
all other MapPlot elements drawn during the predraw
phase and anything drawn during the draw and postdraw phases.
Draw
- Draw area fill during the standard draw; the fill overlays
anything drawn during the predraw phase but underlies any other
MapPlot elements drawn during the draw phase and
anything drawn during the postdraw phase.
PostDraw
- Draw area fill after the standard draw; the fill overlays
anything drawn during the predraw and draw phases but underlies any other
MapPlot elements drawn during the postdraw phase.
Default: Draw
-
mpFillBoundarySets
-
You set this resource of type NhlTMapBoundarySets
to specify the basic boundary set used for fill areas. Given the basic
boundaries, you can then add other areas by specifying area names
outlines in the mpFillAreaSpecifiers string array
resource. You can also desiginate areas to be masked (left unfilled)
by specifying area names in the mpMaskAreaSpecifiers string array
resource.
NoBoundaries
- MapPlot will draw area fill only for areas
specified by name in mpFillAreaSpecifiers and not specified in
mpMaskSpecifiers.
Geophysical
- MapPlot will draw area fill for geophysical
features: land, oceans, and inland water bodies.
You may specify by name other areas
to be filled in the mpFillAreaSpecifiers resource.
National
- MapPlot will individually fill all national
boundary areas. Geophysical features are implicitly included. You may
specify by name other areas to be filled in the
mpFillAreaSpecifiers resource.
USStates
- MapPlot will fill regions comprising the states of the
United States. When using the Ncarg4_0
database, Alaska and Hawaii are not included, although a few areas
outside the U.S. proper, including the Bahamas and a few lakes
extending into Canadian territory, are drawn. When using the
Ncarg4_1 database, Alaska and Hawaii are drawn, but no
non-U.S. territory is included. You may add geophysical and/or
national areas by name using the mpFillAreaSpecifiers resource.
GeophysicalAndUSStates
- MapPlot will draw area fill for all global
geophysical features as well as for the states of the United States.
Other national boundaries do not appear unless you specify them by
name using the mpFillAreaSpecifiers resource.
AllBoundaries
- MapPlot draws area fill for all national
boundaries as well as all U.S. states and inland water. All
geophysical features implicitly appear. You can explicitly set the
fill attributes for areas whose names are specified in the
mpFillAreaSpecifiers resource. When the Ncarg4_1
database is in use, specifying an area name whose mpAreaType
is 1 or 2 (
mpGeophysical
or mpContinental
)
has the effect of suppressing type 3 or higher boundaries within its
borders. For instance, setting mpOutlineSpecifiers to the
value "Africa" would have the effect of suppressing national
boundaries within the African continent.
Default: Geophysical
-
mpFillPatternBackground
-
mpFillPatternBackground specifies the HLU index of the color
used for the background in areas filled with any HLU fill pattern besides
SolidFill
. If this resource has the value
Transparent
(-1), no color will be appear behind the fill
pattern. The effect will be that the pattern appears transparently on
top of anything already drawn.
Default: Background
-
mpMonoFillColor
-
When set True, all MapPlot fill areas (other than
those whose color is set explicitly using the
mpSpecifiedFillColors array resource) are set to a single
color, as specified by the value of the scalar resource
cnFillColor. When False, the elements of the array resource
cnFillColors control the fill color indexes
for MapPlot areas based on the area group numbers
assigned to each area.
Default: False
-
mpFillColor
-
When cnMonoFillColor is set True, this resource of type NhlTColorIndex
sets a uniform fill color for all MapPlot areas,
except for those whose fill color is set explicitly using the
mpSpecifiedFillColors array resource.
Default: Foreground
-
mpFillColors
-
If mpMonoFillColor is False, each element of the array
specifies the HLU color index used to fill the
MapPlot areas belonging a particular area group. The
first element of the array specifies the default color for regions
within the map projection area that contain neither a filled nor a
masked area. The second, third, and fourth elements specify colors
for the fixed (geophysical) area groups: the Ocean group, the
Land group, and the InlandWater group. For
convenience, there are named alias resources for these first four
elements of the array: mpDefaultFillColor,
mpOceanFillColor, mpLandFillColor, and
mpInlandWaterFillColor. If you set any of the alias resources
at the same time as the mpFillColors array resource is set,
the named alias resource value overrides. The remaining elements (by
default, the fifth through the tenth elements) specify colors for the
dynamic groups. If mpAreaGroupCount is increased from its
minimum (and default) value of 10, more elements become available for
additional dynamic group colors.
Default: By default the first 10 elements are assigned the following
sequence of HLU color indexes: 16, 10, 8, 10, 26, 22, 11, 23, 13, 19. This
choice of colors is intended to look reasonable with the "default" color map.
-
mpMonoFillPattern
-
When set True, all MapPlot fill areas (other than
those whose pattern is set explicitly using the
mpSpecifiedFillPatterns array resource) are set to a single pattern, as specified by
the value of the scalar resource cnFillPattern. When False,
the elements of the array resource cnFillPatterns control the
fill pattern indexes for MapPlot areas based on the
area group numbers assigned to each area.
Default: True
-
mpFillPattern
-
When cnMonoFillPattern is set True, this resource of type NhlTFillIndex
sets a uniform fill pattern for
all MapPlot areas, except for those whose fill
pattern is set explicitly using the mpSpecifiedFillPatterns
array resource.
Default: SolidFill
-
mpFillPatterns
-
If mpMonoFillPattern is False, each element of the array
specifies the HLU fill pattern
index used to fill the MapPlot areas belonging a
particular area group. The first element of the array specifies the
default pattern for regions within the map projection area that
contain neither a filled nor a masked area. The second, third, and
fourth elements specify patterns for the fixed (geophysical) area
groups: the Ocean group, the Land group, and the
InlandWater group. For convenience, there are named alias
resources for these first four elements of the array:
mpDefaultFillPattern, mpOceanFillPattern,
mpLandFillPattern, and mpInlandWaterFillPattern. If
you set any of the alias resources at the same time as the
mpFillPatterns array resource is set, the named alias
resource value overrides. The remaining elements (by default, the
fifth through the tenth elements) specify patterns for the dynamic
groups. If mpAreaGroupCount is increased from its minimum
(and default) value of 10, more elements become available for
additional dynamic area group patterns.
Default: MapPlot assigns patterns sequentially,
beginning with HLU fill pattern
index 1 for the first element of mpFillPatterns.
-
mpMonoFillScale
-
When set True, all MapPlot fill areas (other than
those whose fill scale is set explicitly using the
mpSpecifiedFillScales array resource) use a single fill
pattern scale factor, as specified by the value of the scalar resource
cnFillScaleF. When False, the elements of the array resource
cnFillScales control the fill scale values for
MapPlot areas based on the area group numbers assigned
to each area.
Default: True
-
mpFillScaleF
-
When cnMonoFillPattern is set True, this floating point
resource sets a uniform fill
pattern scale factor for all MapPlot areas,
except for those whose fill scale factor is set explicitly using the
mpSpecifiedFillScales array resource.
Default: 1.0
-
mpFillScales
-
If mpMonoFillPattern is False, each element of the array
specifies the scale factor applied to the fill pattern used to fill
MapPlot areas belonging a particular area group. The
first element of the array specifies the default fill pattern scale
factor for regions within the map projection area that contain neither
a filled nor a masked area. The second, third, and fourth elements
specify scale factors for the fixed (geophysical) area groups: the
Ocean group, the Land group, and the
InlandWater group. For convenience, there are named alias
resources for these first four elements of the array:
mpDefaultFillScaleF, mpOceanFillScaleF,
mpLandFillScaleF, and mpInlandWaterFillScaleF. If
you set any of the alias resources at the same time as the
mpFillScales array resource is set, the named alias resource
value overrides. The remaining elements (by default, the fifth through
the tenth elements) specify patterns for the dynamic groups. If
mpAreaGroupCount is increased from its minimum (and default)
value of 10, more elements become available for additional dynamic
area group fill scale values.
Default: 1.0 for all elements
-
mpFillAreaSpecifiers
- You use the array resource mpFillAreaSpecifiers to
specify explicitly the names of areas MapPlot is to
fill. Your purpose may be to include an area that would not otherwise
be drawn (such as an interior national boundary when
mpFillBoundarySets has the value
Geophysical
) or
it may be simply that you want to control the area's fill attributes
explicitly using the associated specified fill attribute arrays. The
named areas are added to the basic set of fill areas specified using
the resource mpFillBoundarySets.
You may explicitly specify the fill attributes of areas named in
the mpFillAreaSpecifiers array using any or all of the three
associated attribute array resources, mpSpecifiedFillColors,
mpSpecifiedFillPatterns, and mpSpecifiedFillScales.
The elements of each of these arrays correspond one-for-one with the
elements of the mpFillAreaSpecifiers array. Attributes set
using these arrays override all other resources involving fill
attributes, including the fill attribute Mono flags. Each of
these arrays accept a pre-defined special value allowing you to
specify individual elements as "unset."
If you also using area masking, note that there is an order of
precedence for fill and masking. Explicitly named areas take
precedence over area groupings, and small areas take precedence over
enclosing larger areas. Otherwise masking takes precedence over
filling.
Note that the names from different MapPlot
databases are not necessarily compatible. Therefore, if
mpFillAreaSpecifiers is non-NULL when you set
mpMapDatabaseVersion to a different value, you are likely to
encounter warning messages unless you also set
mpFillAreaSpecifiers using names compatible with the new
database. You can retrieve a list of compatible names by getting the
value of mpAreaNames. Case is not significant for
mpFillAreaSpecifier string values.
- When using the Ncarg4_0 database:
- Within the list you may include groups of areas defined by a
number of pre-defined
string constants. In addition, a substring matching
facility allows you to specify groups of areas that share a common
substring. When a fill attribute for a specified fill area is not
explicitly set, MapPlot uses its normal method of
setting fill attributes based on area group assignments. The group
number is chosen from the mpFixedAreaGroups array or from the
mpDynamicAreaGroups array depending on the setting of the
resource mpSpecifiedFillPriority. You can override the
general priority for an individual area by prepending an exclamation
point ('!') to the area's name.
- When using the Ncarg4_1 database:
- Only the "NullArea" string
constant is defined. The substring matching facility is not currently
supported. When a fill attribute for a specified fill area is not
explicitly set, MapPlot uses its normal method of
setting fill attributes based on area group assignments. The group
number is chosen from the mpFixedAreaGroups array if the
area's type is 1 (mpGeophysical) or if its type is 2 (mpContinental)
and its parent is Water. Otherwise, the group number is chosen from
the mpDynamicAreaGroups array. The use of the exclamation
point ('!') prefix and the mpSpecifiedFillPriority resource
is not supported.
Default: NULL
- mpSpecifiedFillDirectIndexing
-
This boolean resource determines whether the values contained in the
specified fill attribute array resource
(mpSpecifiedFillColors, mpSpecifiedFillPatterns, and
mpSpecifiedFillScales) resource mpFillAreaColors
directly specify the attribute value, or whether they specify an area
group number used as an index into the regular fill attribute array
resources (mpFillColors, mpFillPatterns, and
mpFillScales). When mpSpecifiedFillDirectIndexing is
set True, the values of mpSpecifiedFillColors elements
represent HLU color indexes, the values of
mpSpecifiedFillPatterns elements represent HLU pattern
indexes, and the values of mpSpecifiedFillPatterns elements
represent fill pattern scaling factors. Otherwise, the elements of
these arrays are converted into integers that represent area group
numbers.
Default: True
-
mpSpecifiedFillPriority
-
- When using the Ncarg4_0 database:
-
Based on the setting of this resource of type NhlTSpecifiedFillPriority,
MapPlot decides how to choose a group number for
indexing into the regular fill attribute arrays for areas specified in
the mpFillAreaSpecifiers resource. The group number is only
used to determine fill attributes that have not been specified
explicitly using the specified fill attribute arrays. The choices are
as follows:
GeophysicalPriority
- Use group numbers from the mpFixedAreaGroups array as an
index into the fill attribute arrays.
PoliticalPriority
- Use group numbers from the mpDynamicAreaGroups array as
an index into the fill attribute arrays.
You can reverse the sense of the general fill priority value for
individual named areas in the mpFillAreaSpecifiers resource by
prefixing the name string with the exclamation point character ('!').
- When using the Ncarg4_1 database:
- The mpSpecifiedFillPriority resource is not supported.
Default: GeophysicalPriority
-
mpSpecifiedFillColors
-
You may use this array resource to set explicitly the fill color of any
MapPlot area specified by name in the
mpFillAreaSpecifiers array resource, overriding the usual
method of determining an area's fill color based on its assigned area
group numbers. The elements of the mpSpecifiedFillColors
array correspond one-for-one to the elements of the
mpFillAreaSpecifiers array.
Depending on the setting of the boolean resource
mpSpecifiedFillDirectIndexing, you control the level of
indirection in the way MapPlot interprets the values
in mpSpecifiedFillColors. If
mpSpecifiedFillDirectIndexing is True,
MapPlot treats the values of
mpSpecifiedFillColors as HLU color indexes directly
determining the fill color of the specified areas. Otherwise,
MapPlot considers each value as a
MapPlot group number that temporarily overrides the
group numbers normally assigned to the area. In this case,
MapPlot determines the HLU fill color by using
this temporary group number as an index into the
mpFillColors array.
You may cause any element of the mpFillAreaSpecifiers array
to retain its normal color by setting the corresponding element of
mpSpecifiedFillColors to the special value NullColor
(-1). If mpSpecifiedFillColors has fewer elements than
mpFillAreaSpecifiers MapPlot sets all the
extra elements of mpFillAreaSpecifiers using its normal
scheme. If mpSpecifiedFillColors has more elements,
MapPlot ignores them. If any of the elements of
mpSpecifiedFillColors are invalid, MapPlot issues
a warning and assigns the area a color using the normal scheme.
Default: <dynamic>
-
mpSpecifiedFillPatterns
-
You may use this array resource to set explicitly the fill pattern of any
MapPlot area specified by name in the
mpFillAreaSpecifiers array resource, overriding the usual
method of determining an area's fill pattern based on its assigned
area group numbers. The elements of the
mpSpecifiedFillPatterns array correspond one-for-one to the
elements of the mpFillAreaSpecifiers array.
Depending on the setting of the boolean resource
mpSpecifiedFillDirectIndexing, you control the level of
indirection in the way MapPlot interprets the values
in mpSpecifiedFillPatterns. If
mpSpecifiedFillDirectIndexing is True,
MapPlot treats the values of
mpSpecifiedFillPatterns as HLU pattern indexes directly
determining the fill pattern of the specified areas. Otherwise,
MapPlot considers each value as a
MapPlot group number that temporarily overrides the
group numbers normally assigned to the area. In this case,
MapPlot determines the HLU fill pattern by using
this temporary group number as an index into the
mpFillPatterns array.
You may cause any element of the mpFillAreaSpecifiers array
to retain its normal pattern by setting the corresponding element of
mpSpecifiedFillPatterns to the special value NullFill
(-1). If mpSpecifiedFillPatterns has fewer elements than
mpFillAreaSpecifiers, MapPlot sets all the
extra elements of mpFillAreaSpecifiers using its normal
scheme. If mpSpecifiedFillPatterns has more elements,
MapPlot ignores them. If any of the elements of
mpSpecifiedFillPatterns are invalid, MapPlot issues
a warning and assigns the area a pattern using the normal scheme.
Default: <dynamic>
-
mpSpecifiedFillScales
-
You may use this array resource to explicitly set the fill pattern
scale factor of any MapPlot area specified by name in
the mpFillAreaSpecifiers array resource, overriding the usual
method of determining an area's fill scale based on its assigned area
group numbers. The elements of the mpSpecifiedFillScales
array correspond one-for-one to the elements of the
mpFillAreaSpecifiers array.
Depending on the setting of the boolean resource
mpSpecifiedFillDirectIndexing, you control the level of
indirection in the way MapPlot interprets the values
in mpSpecifiedFillScales. If
mpSpecifiedFillDirectIndexing is True,
MapPlot treats the values of
mpSpecifiedFillScales as floating point values directly
determining the fill scale of the specified areas. Otherwise,
MapPlot converts each number into an integer and
treats it as a MapPlot group number that temporarily
overrides the group numbers normally assigned to the area. In this
case, MapPlot determines the fill scale value by using
this temporary group number as an index into the mpFillScales
array.
You may cause any element of the FillAreaSpecifiers array to
retain its normal fill scale value by setting the corresponding
element of mpSpecifiedFillScales to the special value 0.0. If
mpSpecifiedFillScales has fewer elements than
mpFillAreaSpecifiers, MapPlot sets all the
extra elements of mpFillAreaSpecifiers using its normal
scheme. If mpSpecifiedFillScales has more elements,
MapPlot ignores them. If any of the elements of
mpSpecifiedFillScales are invalid, MapPlot
issues a warning and assigns the area a scale using the normal scheme.
Note that a kludge is required if
mpSpecifiedFillDirectIndexing is set False, so that you are
indexing into the mpFillScales array using group numbers, and
you want to specify that a fill scale be determined by indexing into
element 0 of mpFillScales. You would need to set the element
of mpSpecifiedFillScales using a number larger than 0.0 but
less than 1.0. If you set the value to 0.0, it would be interpreted as
the special value causing MapPlot to use its "normal"
method of determining the fill scale for the area.
Default: <dynamic>
-
mpDefaultFillColor
-
This resource sets the HLU index of the color used to fill all areas
within the map projection that, given that mpFillOn is True,
are neither filled nor masked. mpDefaultFillColor is
constrained to values greater than
Transparent
(-1). This
resource provides an alternate method of setting the value of the
first element of mpFillColors. If both resources are set in
the same call, the value of mpDefaultFillColor takes
precedence.
Default: 16
-
mpDefaultFillPattern
-
This resource sets the HLU index of the fill pattern used to fill all
areas within the map projection that, given that mpFillOn is
True, are neither filled nor masked. If mpDefaultFillPattern
has the value
HollowFill
(-1), there will be no fill of
the ocean area, regardless of the setting of
mpDefaultFillColor. This resource provides an alternate
method of setting the value of the first element of
mpFillPatterns. If both resources are set in the same call,
the value of mpDefaultFillPattern takes precedence.
Default: SolidFill
-
mpDefaultFillScaleF
-
The mpDefaultFillScaleF resource controls the scaling of the
pattern used to fill all areas within the map projection that, given
that mpFillOn is True, are neither filled nor masked. It has
no effect for solid fill (
SolidFill
, fill index
0). Values greater than 1.0 make the pattern spacing bigger than the
default spacing, resulting in a fill that appears less dense. Values
less than 1.0 have the opposite effect. Values less than or equal to
0.0 are invalid, generate a warning message, and are reset to the
default value, 1.0. This resource provides an alternate method of
setting the value of the first element of mpFillScales. If
both resources are set in the same call, the value of
mpDefaultFillScaleF takes precedence.
Default: 1.0
-
mpOceanFillColor
-
This resource sets the HLU index of the color used to fill areas
representing the oceans. mpOceanFillColor is constrained to
values greater than -1 (
Transparent
). This resource
provides an alternate method of setting the value of the second
element of mpFillColors. If both resources are set in the
same call, the value of mpOceanFillColor takes precedence.
Default: 10
-
mpOceanFillPattern
-
This resource sets the HLU index of the fill pattern used to fill areas
representing the oceans. If mpOceanFillPattern has the value
HollowFill
(-1), there will be no fill of the ocean area,
regardless of the setting of mpOceanFillColor. This resource
provides an alternate method of setting the value of the second
element of mpFillPatterns. If both resources are set in the
same call, the value of mpOceanFillPattern takes precedence.
Default: SolidFill
-
mpOceanFillScaleF
-
The mpOceanFillScaleF resource controls the scaling of the
pattern used to fill areas representing the oceans. It has no effect
for solid fill (
SolidFill
, fill pattern index 0). Values
greater than 1.0 make the pattern spacing bigger than the default
spacing, resulting in a fill that appears less dense. Values less than
1.0 have the opposite effect. Values less than or equal to 0.0 are
invalid, generate a warning message, and are reset to the default
value, 1.0. This resource provides an alternate method of setting the
value of the second element of mpFillScales. If both
resources are set in the same call, the value of
mpOceanFillScaleF takes precedence.
Default: 1.0
-
mpLandFillColor
-
This resource sets the HLU index of the color used to fill areas of
land not given a special group color. mpLandFillColor is
constrained to values greater than -1 (
Transparent
). This
resource provides an alternate method of setting the value of the
third element of mpFillColors. If both resources are set in
the same call, the value of mpLandFillColor takes precedence.
Default: 8
-
mpLandFillPattern
-
This resource sets the HLU index of the fill pattern used to fill areas of
land not given a special group color. If mpLandFillPattern
has the value
HollowFill
(-1), there will be no fill of
the land area, regardless of the setting of
mpInlandWaterFillColor. This resource provides an alternate
method of setting the value of the third element of
mpFillPatterns. If both resources are set in the same call,
the value of mpLandFillPattern takes precedence.
Default: SolidFill
-
mpLandFillScaleF
-
The mpLandFillScaleF resource controls the scaling of the
pattern used to fill areas of land not given a special group color. It
has no effect for solid fill (
SolidFill
, fill pattern
index 0). Values greater than 1.0 make the pattern spacing bigger than
the default spacing, resulting in a fill that appears less
dense. Values less than 1.0 have the opposite effect. Values less
than or equal to 0.0 are invalid, generate a warning message, and are
reset to the default value, 1.0. This resource provides an alternate
method of setting the value of the third element of
mpFillScales. If both resources are set in the same call, the
value of mpLandFillScaleF takes precedence.
Default: 1.0
-
mpInlandWaterFillColor
-
This resource sets the HLU index of the color used to fill areas
representing bodies of water except for the oceans.
mpInlandWaterFillColor is constrained to values greater than
-1 (
Transparent
). This resource provides an alternate
method of setting the value of the fourth element of
mpFillColors. If both resources are set in the same call, the
value of mpInlandWaterFillColor takes precedence.
Default: 10
-
mpInlandWaterFillPattern
-
This resource sets the HLU index of the fill pattern used to fill areas
representing bodies of water except for the oceans. If
mpInlandWaterFillPattern has the value
HollowFill
(-1), there will be no fill of the inland
water area, regardless of the setting of
mpInlandWaterFillColor. This resource provides an alternate
method of setting the value of the fourth element of
mpFillPatterns. If both resources are set in the same call,
the value of mpInlandWaterFillPattern takes precedence.
Default: SolidFill
-
mpInlandWaterFillScaleF
-
The mpInlandWaterFillScaleF resource controls the scaling of
the pattern used to fill areas representing bodies of water except for
the oceans. It has no effect for solid fill (
SolidFill
, fill pattern index 0). Values greater than 1.0 make the pattern spacing
bigger than the default spacing, resulting in a fill that appears less
dense. Values less than 1.0 have the opposite effect. Values less
than or equal to 0.0 are invalid, generate a warning message, and are
reset to the default value, 1.0. This resource provides an alternate
method of setting the value of the fourth element of
mpFillScales. If both resources are set in the same
call, the value of mpInlandWaterFillScaleF takes precedence.
Default: 1.0
-
mpGeophysicalLineColor
-
This resource sets the HLU index of a color used to render
interior national boundary outlines. This resource applies to the
outlines of all continents and islands, except that when one or more
U.S. states are drawn, the portion of North America whose outline is
contiguous with the U.S. border is rendered using
USStatesLineColor.
Default: Foreground
-
mpGeophysicalLineDashPattern
-
This resource sets the HLU index of a dash pattern used to render
interior national boundary outlines. This resource applies to the
outlines of all continents and islands, except that when one or more
U.S. states are drawn, the portion of North America whose outline is
contiguous with the U.S. border is rendered using
USStatesLineDashPattern.
Default: SolidLine
-
mpGeophysicalLineDashSegLenF
-
This resource specifies the length of each segment of the dash
patterns used to draw geophysical boundary outlines. It is the length
in NDC before the dash pattern repeats itself. This
resource automatically scales with changes in the size of the viewport
of the MapPlot object. This resource applies to the
outlines of all continents and islands, except that when one or more
U.S. states are drawn, the portion of North America whose outline is
contiguous with the U.S. border is rendered using
USStatesLineDashSegLenF. MapPlot sets the
default value of mpNationalLineDashSegLenF dynamically based
on the ratio of the actual plot viewport width to a reference
viewport width of 0.6 and a reference dash segment length of 0.15.
Default: 0.15 (for a viewport width of 0.6)
-
mpGeophysicalLineThicknessF
-
Sets the thickness of the lines used to draw geophysical boundary
outlines. The value acts as a multiplier of a (device-dependent) unit
thickness. This resource applies to the outlines of all continents and
islands, except that when one or more U.S. states are drawn, the portion
of North America whose outline is contiguous with the U.S. border is
rendered using USStatesLineThicknessF.
Default: 1.0
-
mpUSStateLineColor
-
This resource sets the HLU index of a color used to render interior
U.S. state boundary outlines. This resource affects all exterior
boundaries of the U.S. if any U.S. state outlines are
included the MapPlot. Otherwise, U.S. boundaries are
rendered like other national boundaries using
mpNationalLineColor for interior boundaries and
mpGeophysicalLineColor for lines separating land and ocean.
Default: Foreground
-
mpUSStateLineDashPattern
-
This resource sets the HLU index of a dash pattern used to render
U.S. state boundary outlines. This resources affects all exterior
boundaries of the U.S. if any U.S. state outlines are
included the MapPlot. Otherwise, U.S. boundaries are
rendered like other national boundaries using
mpNationalLineDashPattern for interior boundaries and
mpGeophysicalLineDashPattern for lines separating land and
ocean. Note that this resource applies only to lines used to draw
interior national boundaries. Lines separating land and oceans are not
affected.
Default: SolidLine
-
mpUSStateLineDashSegLenF
-
This resource specifies the length of each segment of the dash
patterns used to draw U.S. state boundary outlines. It is the length
in NDC before the dash pattern repeats itself. This
resources affects all exterior boundaries of the U.S. if any
U.S. state outlines are included the
MapPlot. Otherwise, U.S. boundaries are rendered like
other national boundaries using mpNationalLineDashSegLenF for
interior boundaries and mpGeophysicalLineDashSegLenF for
lines separating land and ocean. mpUSStateLineDashSegLenF
automatically scales with changes in the size of the viewport of the
MapPlot object. MapPlot sets the
default value of mpNationalLineDashSegLenF dynamically based
on the ratio of the actual plot viewport width to a reference
viewport width of 0.6 and a reference dash segment length of 0.15.
Default: 0.15 (for a viewport width of 0.6)
-
mpUSStateLineThicknessF
-
Sets the thickness of the lines used to draw U.S. state boundary
outlines. The value acts as a multiplier of a (device-dependent) unit
thickness. This resources affects all exterior boundaries of the
U.S. if any U.S. state outlines are included the
MapPlot. Otherwise, U.S. boundaries are
rendered like other national boundaries using
mpNationalLineThicknessF for interior boundaries and
mpGeophysicalLineThicknessF for lines separating land and ocean.
Default: 1.0
-
mpNationalLineColor
-
This resource sets the HLU index of a color used to render interior
national boundary outlines. Note that this
resource applies only to lines used to draw interior national
boundaries. Lines separating land and oceans are not
affected.
Default: Foreground
-
mpNationalLineDashPattern
-
This resource sets the HLU index of a dash pattern used to render
interior national boundary outlines. Note that this resource applies
only to lines used to draw interior national boundaries. Lines
separating land and oceans are not affected.
Default: SolidLine
-
mpNationalLineDashSegLenF
-
This resource specifies the length of each segment of the dash
patterns used to draw national boundary outlines. It is the length in
NDC before the dash pattern repeats itself. This
resource automatically scales with changes in the size of the viewport
of the MapPlot object. Note that this resource
applies only to lines used to draw interior national boundaries. Lines
separating land and oceans are not affected. MapPlot
sets the default value of mpNationalLineDashSegLenF
dynamically based on the ratio of the actual plot viewport width to
a reference viewport width of 0.6 and a reference dash segment length
of 0.15.
Default: 0.15 (for a viewport width of 0.6)
-
mpNationalLineThicknessF
-
Sets the thickness of the lines used to draw national boundary
outlines. The value acts as a multiplier of a (device-dependent) unit
thickness. Note that this resource applies only to lines used to draw
interior national boundaries. Lines separating land and oceans are not
affected by this resource.
Default: 1.0
-
mpGridAndLimbOn
-
This boolean resource determines whether the MapPlot
object draws grid lines representing latitude and longitude as well as
(when appropriate) a limb line around the edge of the visible surface of
the map projection.
Default: True
-
mpGridAndLimbDrawOrder
-
This resource of type NhlTDrawOrder determines
when MapPlot draws the grid lines representing
latitude and longitude relative to other elements of the plot. When a
limb line representing the edge of the visible surface of the
projection is required, MapPlot always renders it at
the same time as the grid lines. There are three choices:
PreDraw
- Draw grid lines before the standard draw phase; the grid lines
overlay MapPlot fill drawn during the predraw phase
but underlie other predraw phase MapPlot elements and
anything drawn during the draw and postdraw phases.
Draw
- Draw grid lines during the standard draw; the grid lines overlay
anything drawn during the predraw phase and MapPlot
fill drawn during the draw phase but underlie other draw phase
MapPlot elements and anything drawn during the
postdraw phase.
PostDraw
- Draw grid lines after the standard draw; the grid lines overlay
anything drawn during the predraw and draw phases and
MapPlot fill drawn during the postdraw phase but
underlie other postdraw phase MapPlot elements.
Default: PostDraw
-
mpGridMaskMode
-
This resource of type NhlTMapGridMaskMode specifies
how the MapPlot object should mask the grid representing
latitudes and longitudes. There are seven choices:
MaskNone
- MapPlot does not mask the grid. Grid lines appear
over the entire visible map projection area.
MaskOcean
- MapPlot masks the grid over areas of the map occupied
by any part of the global ocean.
MaskNotOcean
- MapPlot masks the grid over areas of the map that
are not part of the global ocean, including bodies of water within
the interior of continents.
MaskLand
- MapPlot masks the grid over areas of the map
that represent land. Bodies of water within the interior of continents
remain unmasked.
MaskNotLand
- MapPlot masks the grid over all areas of the map
that do not represent land, including bodies of water within the
interior of continents.
MaskFillArea
- MapPlot masks the grid over filled or masked
areas in the map. The grid is drawn only over 'background' areas
within the map projection, that is, those areas of the
MapPlot that would be filled (assuming fill is
enabled) using the color specified by mpDefaultFillColor.
MaskMaskArea
- MapPlot masks the grid only over areas named
in the mpMaskSpecifiers array.
Default: MaskNone
-
mpGridSpacingF
-
This resource specifies the spacing, in degrees, between
MapPlot grid lines representing latitude and
longitude. Use this resource if you want the spacing to be equal in
latitude and longitude. Setting this resource overrides any
values set for the resources mpGridLatSpacingF and
mpGridLonSpacingF and causes them both to be set to the value
given mpGridSpacingF.
Default: 15.0
-
mpGridLatSpacingF
-
This resource specifies the spacing, in degrees, between
MapPlot grid lines representing latitude. Use this
resource if you want to set the latitude spacing independently of the
longitude spacing. Note that setting mpGridSpacingF at the
same time or subsequently overrides the value of this resource.
Default: 15.0
-
mpGridLonSpacingF
-
This resource specifies the spacing, in degrees, between
MapPlot grid lines representing longitude. Use this
resource if you want to set the longitude spacing independently of the
latitude spacing. Note that setting mpGridSpacingF at the
same time or subsequently overrides the value of this resource.
Default: 15.0
-
mpGridMaxLatF
-
This resource specifies the maximum absolute value of the latitude
at which a latitude grid line may appear. For instance, if you set
mpGridMaxLatF to 70.0, no latitude lines will appear between
70 degrees and 90 degrees or between -70 degrees and -90 degrees. If
the latitude spacing were set to 20.0, then, in this case, the highest and
lowest latitude lines would be at 60 degrees and -60 degrees.
Default: 90.0
-
mpGridPolarLonSpacingF
-
This resource has an effect only when the map projection is such that
the North and South poles project to single points. In this case, it
controls the way longitude lines are continued in the area between the
pole and the latitude line nearest the pole. Basically it allows you
to set an alternate spacing for longitude lines near the poles,
generally for the purpose of avoiding overcrowding. For instance, if
mpGridPolarLonSpacingF is set to its default value of 90.0
and the longitudinal spacing is set to 15.0, then only the longitude
lines that are multiples of 90.0 continue to the poles. Note that if
the longitudinal spacing were set to 20.0, lines would continue only
at multiples of 180.0, since there would be no longitude lines to
continue at 90.0 and 270.0.
Default: 15.0
-
mpGridLineColor
-
This resource sets the HLU index of a color used to draw the
grid representing latitudes and longitudes.
Default: Foreground
-
mpGridLineDashPattern
-
This resource sets the HLU index of a dash pattern used to draw the grid
representing latitudes and longitudes.
Default: SolidLine
-
mpGridLineDashSegLenF
-
This resource specifies the length of each segment of the dash
patterns used to draw the grid representing latitudes and
longitudes. It is the length in NDC before the dash pattern repeats itself. This
resource automatically scales with changes in the size of the viewport
of the MapPlot object. MapPlot sets
the default value of mpGridLineDashSegLenF dynamically based
on the ratio of the actual plot viewport width to a reference
viewport width of 0.6 and a reference dash segment length of 0.15.
Default: 0.15 (for a viewport width of 0.6)
-
mpGridLineThicknessF
-
This resource determines the thickness of the lines used to draw the
grid representing latitudes and longitudes. The value acts as a
multiplier of a (device-dependent) unit thickness.
Default: 1.0
-
mpLimbLineColor
-
This resource sets the HLU index of the color used for the limb
line drawn at the edge of visibility in certain map projections.
Default: Foreground
-
mpLimbLineDashPattern
-
This resource sets the HLU index of a dash pattern used for the limb line
drawn at the edge of visibility in certain map projections.
Default: SolidLine
-
mpLimbLineDashSegLenF
-
This resource specifies the length of each segment of the dash
patterns used for the limb line drawn at the edge of visibility in
certain map projections. It is the length in NDC before the dash pattern repeats itself. This
resource automatically scales with changes in the size of the viewport
of the MapPlot object. MapPlot sets
the default value of mpLimbLineDashSegLenF dynamically based
on the ratio of the actual plot viewport width to a reference
viewport width of 0.6 and a reference dash segment length of 0.15.
Default: 0.15 (for a viewport width of 0.6)
-
mpLimbLineThicknessF
-
This resource determines the thickness of the limb line drawn at the
edge of visibility in certain map projections. The value acts as a
multiplier of a (device-dependent) unit thickness.
Default: 1.0
-
mpPerimOn
-
This boolean resource determines whether the MapPlot
object draws a perimeter line around the edge of the map
projection. Depending on the setting of the
MapTransformation resource mpEllipticalBoundary,
this perimeter may have a rectangular or elliptical shape.
Default: False
-
mpPerimDrawOrder
-
This resource of type NhlTDrawOrder determines
when the perimeter line around the edge of the map projection is drawn
relative to other elements of the plot. There are three choices:
PreDraw
- Draw the perimeter before the standard draw phase; the perimeter
overlays all other MapPlot elements drawn during the
predraw phase except MapPlot labels but underlies
anything drawn during the draw and postdraw phases.
Draw
- Draw the perimeter during the standard draw; the perimeter
overlays anything drawn during the predraw phase and any other
MapPlot elements (except MapPlot
labels) drawn during the draw phase but underlies anything drawn
during the postdraw phase.
PostDraw
- Draw the perimeter after the standard draw; the perimeter overlays
anything drawn during the predraw and draw phases and all other
MapPlot elements (except MapPlot
labels) drawn during the postdraw phase.
Default: Draw
-
mpPerimLineColor
-
This resource sets the HLU index of the color used to render the
perimeter line around the edge of the map projection.
Default: Foreground
-
mpPerimLineDashPattern
-
This resource sets the HLU index of a dash pattern used to render the
perimeter line around the edge of the map projection.
Default: SolidLine
-
mpPerimLineDashSegLenF
-
This resource specifies the length of each segment of the dash
patterns used to draw the perimeter line around the edge of the map
projection. It is the length in NDC before the dash pattern repeats itself. This
resource automatically scales with changes in the size of the viewport
of the MapPlot object. MapPlot sets
the default value of mpPerimLineDashSegLenF dynamically based
on the ratio of the actual plot viewport width to a reference
viewport width of 0.6 and a reference dash segment length of 0.15.
Default: 0.15 (for a viewport width of 0.6)
-
mpPerimLineThicknessF
-
This resource determines the thickness of the perimeter line around
the edge of the map projection. The value acts as a multiplier of a
(device-dependent) unit thickness.
Default: 1.0
-
mpLabelsOn
-
This boolean resource determines whether the MapPlot object
draws labels identifying the equator ("EQ"), Greenwich Meridian ("GM"),
International Dateline ("ID"), North Pole ("NP"), and South Pole ("SP").
Default: False
-
mpLabelDrawOrder
-
This resource of type NhlTDrawOrder determines
when MapPlot labels are drawn relative to
other elements of the plot. There are three choices:
PreDraw
- Draw labels before the standard draw phase; the labels overlay
all other MapPlot elements drawn during the predraw
phase but underlie anything drawn during the draw and postdraw phases.
Draw
- Draw labels during the standard draw; the labels overlay
anything drawn during the predraw phase and any other
MapPlot elements drawn during the draw phase but
underlie anything drawn during the postdraw phase.
PostDraw
- Draw labels after the standard draw; the labels overlay
anything drawn during the predraw and draw phases and all other
MapPlot elements drawn during the postdraw phase.
Default: PostDraw
-
mpLabelFontHeightF
-
This resource controls the height in NDC of characters used in the
MapPlot labels. The MapPlot text
height scales with changes to the viewport width, unless you
explicitly set mpLabelFontHeightF during the same call.
Default: <dynamic> -- 0.008 for a viewport width of 0.6
-
mpLabelFontColor
-
This resource specifies the hlu color index used to draw the characters
used for MapPlot labels.
Default: True