Routines (alphabetical) > Routines: X > XSURFACE Procedure

# XSURFACE Procedure

The XSURFACE procedure is a utility that provides a graphical interface to the SURFACE and SHADE_SURF commands. Different controls are provided to change the viewing angle and other plot parameters. The command used to generate the resulting surface plot is shown in a text window. Note that this procedure does not accept SURFACE or SHADE_SURF keywords. Because XSURFACE relies on IDL direct graphics rather than object graphics, the image manipulation facilities are less sophisticated than those of XOBJVIEW.

This routine is written in the IDL language. Its source code can be found in the file `xsurface.pro` in the `lib/utilities` subdirectory of the IDL distribution.

## Examples

; Make a 2-D array:
z = DIST(30)
; Call XSURFACE. The XSURFACE widget appears:
XSURFACE, z

## Syntax

XSURFACE, Data [, /BLOCK] [, GROUP=widget_id]

## Arguments

### Data

The two-dimensional array to display as a wire-mesh or shaded surface.

## Keywords

### BLOCK

Set this keyword to have XMANAGER block when this application is registered. By default, BLOCK is set equal to zero, providing access to the command line if active command line processing is available. Note that setting BLOCK=1 will cause all widget applications to block, not just this application. For more information, see the documentation for the NO_BLOCK keyword to XMANAGER.

Note: Only the outermost call to XMANAGER can block. Therefore, to have XSURFACE block, any earlier calls to XMANAGER must have been called with the NO_BLOCK keyword. See the documentation for the NO_BLOCK keyword to XMANAGER for an example.

### GROUP

Set this keyword to the widget ID of the widget that calls XSURFACE. When GROUP is specified, the death of the calling widget results in the death of XSURFACE.

## Version History

Pre-4.0 | Introduced

## See Also

ISURFACE, SHADE_SURF Procedure, SURFACE Procedure