meshlsrm (Mapping Toolbox)

Project 3-D lighted shaded relief of a general matrix map

Syntax

meshlsrm(map,maplegend)
meshlsrm(map,maplegend,[azim elev])
meshlsrm(map,maplegend,[azim elev],cmap)
meshlsrm(map,maplegend,[azim elev],cmap,clim)
h = meshlsrm(...)

Description

meshlsrm(map,maplegend) displays the regular matrix map colored according to elevation and surface slopes. The current axes must have a valid map projection definition.

meshlsrm(map,maplegend,[azim elev]) displays the regular matrix map with the light coming from the specified azimuth and elevation. Lighting is applied before the data is projected. Angles are in degrees, with the azimuth measured clockwise from North and elevation up from the zero plane of the surface. By default, the direction of the light source is East (90° azimuth) at an elevation of 45°.

meshlsrm(map,maplegend,[azim elev],cmap) displays the regular matrix map using the provided colormap. The number of grayscales is chosen to keep the size of the shaded colormap below 256. By default, the colormap is constructed from 16 colors and 16 grays. If the vector of azimuth and elevation is empty, the default locations are used.

meshlsrm(map,maplegend,[azim elev],cmap,clim) uses the provided color axis limits, which by default, are computed from the data.

h = meshlsrm(...) returns the handle to the surface drawn.

Remarks

This function effectively multiplies two colormaps, one with color based on elevation, the other with a grayscale based on the slope of the surface, to create a new colormap. This produces an effect similar to using a light on a surface, but with all of the visible colors actually in the colormap. Lighting calculations are performed on the unprojected data.

Examples

Create a new colormap using demcmap, with white colors for the sea and default colors for land. Use this colormap for a lighted shaded relief map of the world.

load topo
[cmap,clim] = demcmap(topo,[],[1 1 1],[]);
axesm loximuth
meshlsrm(topo,topolegend,[],cmap,clim)

See Also

meshm
Regular matrix map warped to projected graticule mesh

pcolorm
Project a matrix map in the z = 0 plane

shaderel
Construct cdata and colormap for colored shaded relief

surfacem
Matrix map warped to projected graticule mesh

surflm
Display a lighted matrix map warped to a projected graticule

surfm
Matrix map projected a map axes

surflsrm
Project a 3-D lighted shaded relief of a general matrix map

`meshm`	Regular matrix map warped to projected graticule mesh
`pcolorm`	Project a matrix map in the z = 0 plane
`shaderel`	Construct cdata and colormap for colored shaded relief
`surfacem`	Matrix map warped to projected graticule mesh
`surflm`	Display a lighted matrix map warped to a projected graticule
`surfm`	Matrix map projected a map axes
`surflsrm`	Project a 3-D lighted shaded relief of a general matrix map

meshgrat meshm