MATLAB Function Reference

lightangle

Create or position light object in spherical coordinates

Syntax

lightangle(az,el)
light_handle = lightangle(az,el)
lightangle(light_handle,az,el)
[az,el] = lightangle(light_handle)

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.

light_handle = lightangle(az,el) creates a light and returns the handle of the light in light_handle.

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

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

Remarks

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.

Examples

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

See Also

light, camlight, view

Lighting as a Visualization Tool for more information about lighting

Lighting for related functions

Light Properties

lighting