Design.setLightBulbOn Method

Parent Object: Design
Defined in namespace "adsk::fusion" and the header file is <Fusion/Fusion/Design.h>

Description

Sets the light bulb of many entities all at once. Changing them all at once is more efficient than setting the isLightBulbOn property of each entity one at a time, and the whole change is a single undo step.

Syntax

"design_var" is a variable referencing a Design object.

returnValue = design_var.setLightBulbOn(entities, isLightBulbOn)
"design_var" is a variable referencing a Design object.

#include <Fusion/Fusion/Design.h>

returnValue = design_var->setLightBulbOn(entities, isLightBulbOn);
"design_var" is a variable referencing a Design object.

returnValue = design_var.setLightBulbOn(entities, isLightBulbOn);

Return Value

Type Description
boolean Returns true if setting all of the light bulbs was successful. This is either all or none. If any of the entities does not support a light bulb, the call fails and none of them are changed.

Parameters

Name Type Description
entities Base[] The entities to change. Any object that supports the isLightBulbOn property can be used, for example Occurrence, BRepBody, and Sketch objects, and the array can contain a mix of those types. The entities must all exist within the Design object you're calling this method from.
isLightBulbOn boolean True to turn the light bulbs on and false to turn them off. Entities that are already in the requested state are left unchanged.

Version

Introduced in version September 2026