VLFLplotlightoff

by Tim C. Lueth, SG-Lib Toolbox: SolidGeometry 5.6 - Visualization
Introduced first in SolidGeometry 2.8, Creation date: 2016-01-10, Last change: 2025-08-18

switches the camlights on or off



See Also: rotate3dlight

Example Illustration

 missing image of VLFLplotlightoff

Syntax

VLFLplotlightoff




Copyright 2016-2025 Tim C. Lueth. All rights reserved. The code is the property of Tim C. Lueth and may not be redistributed or modified without explicit written permission. This software may be used free of charge for academic research and teaching purposes only. Commercial use, redistribution, modification, or reverse engineering is strictly prohibited. Access to source code is restricted and granted only under specific agreements. For licensing inquiries or commercial use, please contact: Tim C. Lueth

Algorithm (Workflow)

This MATLAB function, VLFLplotlightoff, is designed to switch off all light objects in the current axes of a figure. It is part of the SolidGeometry library and was introduced in version 2.8. The function does not take any input parameters and operates directly on the current axes.

Steps of the Algorithm:

  1. Retrieve all child objects of the current axes using get(gca, 'children'). This returns a list of handles to all objects contained within the current axes.
  2. Iterate over each child object using a for loop. The loop runs from 1 to the number of child objects.
  3. For each child object, check if its type is 'light' using strcmp(get(a(i), 'Type'), 'light'). This condition identifies light objects among the children.
  4. If the object is a light, set its visibility to 'off' using set(a(i), 'visible', 'off'). This effectively turns off the light in the plot.
  5. The function ends with a call to show, which is likely a custom function or command to update the display, though its implementation is not provided in the code snippet.

Assumptions:

Output:

The function does not return any output. Its effect is visual, as it turns off the visibility of light objects in the current plot.

Algorithm explaination created using ChatGPT on 2025-08-18 21:50. (Please note: No guarantee for the correctness of this explanation)

Last html export of this page out of FM database by TL: 2025-09-21