Documentation

This is machine translation

Translated by Microsoft
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.

Introduced before R2006a

Was this topic helpful?