# view

## Purpose

3-D graph viewpoint specification.

## Synopsis

    view(az,el)
    view([az,el])
    view([x,y,z])
    view(2)
    view(3)
    view(T)
    [az,el] = view;
    T = view

## Description

`view(az,el)` and `view([az,el])` set the viewing angle for a three-dimensional plot. `az` is the azimuth or horizontal rotation and `el` is the vertical elevation (both in degrees). Azimuth revolves about the z-axis, with positive values indicating counterclockwise rotation of the viewpoint. Positive values of elevation correspond to moving above the object; negative values move below.

`view([x,y,z])` sets the viewing angle in cartesian coordinates. The magnitude of `(x,y,z)` is ignored.

`view(2)` sets the default two-dimensional view, `az = 0,` `el = 90`.

`view(3)` sets the default three-dimensional view, `az = -37.5,` `el = 30`.

`view(T)` accepts a 4-by-4 transformation matrix, such as the perspective transformations generated by `viewmtx`.

`[az,el] = view` returns the current azimuth and elevation.

`T = view` returns the current 4-by-4 transformation matrix.

## Examples

- `el = 90` is directly overhead.
- `az = el = 0` looks directly up the first column of the matrix.
- `az = 180` is behind the matrix.
- `az = -37.5,` `el = 30` is the default for three-dimensional.

  ## See Also

      viewmtx
      axes object properties View and XForm

  (c) Copyright 1994 by The MathWorks, Inc.