MATLAB Function Reference (Volume 2: Graphics)

camlightPurpose2camlightCreate or move a light object in camera coordinatesSyntaxDescriptioncamlight headlightcamlight rightcamlight leftcamlightcamlight(az,el)camlight(...‘style’)camlight(light_handle,...)light_handle = camlight(...)camlight('headlight') creates a light at the camera position.camlight('right') creates a light right and up from camera.camlight('left') creates a light left and up from camera.camlight with no arguments is the same as camlight('right').camlight(az,el) creates a light at the specified azimuth (az) and elevation(el) with respect to the camera position. The camera target is the center ofrotation and az and el are in degrees.camlight(...,'style') The style argument can take on the two values:• local (default) – the light is a point source that radiates from the location inall directions.• infinite – the light shines in parallel rays.camlight(light_handle,...) uses the light specified in light_handle.light_handle = camlight(...) returns the light’s handle.Remarkscamlight sets the light object Position and Style properties. A light createdwith camlight will not track the camera. In order for the light to stay in aconstant position relative to the camera, you must call camlight whenever youmove the camera.2-53