# Documentation

### This is machine translation

Translated by
Mouseover text to see original. Click the button below to return to the English verison of the page.

Note: This page has been translated by MathWorks. Please click here
To view all translated materals including this page, select Japan from the country navigator on the bottom of this page.

# lightangle

Create or position light object in spherical coordinates

## Syntax

```lightangle(az,el) lightangle(ax,az,el) lgt = lightangle(...) lightangle(lgt,az,el) [az,el] = lightangle(lgt) ```

## Description

`lightangle(az,el)` creates a light at the position specified by azimuth and elevation. `az` is the azimuthal (horizontal) rotation and `el` is the vertical elevation (both in degrees). The interpretation of azimuth and elevation is the same as that of the `view` command.

`lightangle(ax,az,el)` creates a light in the axes specified by `ax` instead of the current axes.

`lgt = lightangle(...)` creates a light and returns the light object as `lgt`. You can specify an output argument with any of the previous input argument combinations.

`lightangle(lgt,az,el)` sets the position of the light specified by `lgt`.

`[az,el] = lightangle(lgt)` returns the azimuth and elevation of the light specified by `lgt`.

## Examples

collapse all

Create a surface. Add a light and move the position of the light.

```surf(peaks) axis vis3d h = light; for az = -50:10:50 lightangle(h,az,30) pause(.1) end```

## Tips

By default, when a light is created, its style is `infinite`. If the light handle passed in to `lightangle` refers to a local light, the distance between the light and the camera target is preserved as the position is changed.

## See Also

### Topics

#### Introduced before R2006a

Was this topic helpful?

#### Beyond Excel: The Manager's Guide to Solving the Big Data Conundrum

Download white paper