Save Keyword

Used With Routines:   AXIS,  SHADE_SURF,  SHADE_SURF_IRR,  SURFACE

Corresponding System Variable: None.

Saves the 3D to 2D transformation matrix established by SURFACE and SHADE_SURF, and specified by the Ax and Az keywords, in the system variable field !P.T.

Use this keyword when combining the output of SURFACE and SHADE_SURF with the output of other routines in the same plot.

When used with AXIS, the Save keyword parameter saves the scaling parameters established by the call back in the appropriate axis system variable, !X, !Y, or !Z. This causes subsequent overplots to be scaled to the new axis.

Example

To display a two-dimensional array using SURFACE, and to then superimpose contours over the surface: (This example assumes that !P.T3d is zero, its default value.)

TEK_COLOR

; Make a surface plot and save the transformation.

z = DIST(10)

SURFACE, z, /Save

; Make contours, don't erase, use the 3D to 2D transform $

; placed in !P.T by SURFACE.

CONTOUR, z, /Noerase, /T3d, Color=WoColorConvert(6)

WAIT, 1

; Make a surface plot and save the transformation.

SURFACE, z, /Save

; Now display flat contour plot, at maximum Z value (normalized

; coordinates). Display the contour plot below the surface

; with a ZValue of 0.0.

CONTOUR, z, /Noerase, /T3d, ZValue=0.0, Color=WoColorConvert(11)