Create light object
handle = light(...)
For a list of properties, see Light Properties.
light creates a light object in the current axes. Lights affect only patch and surface objects.
light('PropertyName',propertyvalue,...) creates a light object using the specified values for the named properties. For a description of the properties, see Light Properties. The MATLAB® software parents the light to the current axes unless you specify another axes with the Parent property.
handle = light(...) returns the handle of the light object created.
Light the peaks surface plot with a light source located at infinity and oriented along the direction defined by the vector [1 0 0], that is, along the x-axis.
h = surf(peaks); set(h,'FaceLighting','phong','FaceColor','interp',... 'AmbientStrength',0.5) light('Position',[1 0 0],'Style','infinite');
set(0,'DefaultLightProperty',PropertyValue...) set(gcf,'DefaultLightProperty',PropertyValue...) set(gca,'DefaultLightProperty',PropertyValue...)
For more information about lighting, see Lighting Overview.
You cannot see a light object per se, but you can see the effects of the light source on patch and surface objects. You can also specify an axes-wide ambient light color that illuminates these objects. However, ambient light is visible only when at least one light object is present and visible in the axes.
See also the patch and surface AmbientStrength, DiffuseStrength, SpecularStrength, SpecularExponent, SpecularColorReflectance, and VertexNormals properties. Also see the lighting and material commands.