DOKK / manpages / debian 11 / inventor-doc / SoXtDirectionalLightEditor.3iv.en
SoXtDirectionalLightEditor(3IV)() SoXtDirectionalLightEditor(3IV)()

SoXtDirectionalLightEditor — component for editing directional lights

SoXtComponent > SoXtDirectionalLightEditor

#include <Inventor/Xt/SoXtDirectionalLightEditor.h>


typedef void SoXtDirectionalLightEditorCB(void *userData, const SoDirectionalLight *light)


Methods from class SoXtDirectionalLightEditor:


SoXtDirectionalLightEditor(Widget parent = NULL, const char *name = NULL, SbBool buildInsideParent = TRUE)

~SoXtDirectionalLightEditor()

void attach(SoPath *pathToLight)

void detach()

SbBool isAttached()

void addLightChangedCallback(SoXtDirectionalLightEditorCB *f, void *userData = NULL)

void removeLightChangedCallback(SoXtDirectionalLightEditorCB *f, void *userData = NULL)

void setLight(const SoDirectionalLight &newLight)

const SoDirectionalLight & getLight() const


Methods from class SoXtComponent:


virtual void show()

virtual void hide()

SbBool isVisible()

Widget getWidget() const

SbBool isTopLevelShell() const

Widget getShellWidget() const

Widget getParentWidget() const

void setSize(const SbVec2s &size)

SbVec2s getSize()

Display * getDisplay()

void setTitle(const char *newTitle)

const char * getTitle() const

void setIconTitle(const char *newIconTitle)

const char * getIconTitle() const

void setWindowCloseCallback(SoXtComponentCB *func, void *data = NULL)

static SoXtComponent * getComponent(Widget w)

const char * getWidgetName() const

const char * getClassName() const

This class is used to edit an SoDirectionalLight node (color, intensity, and direction are changed). In addition to directly editing directional light nodes, the editor can also be used with callbacks which will be called whenever the light is changed. The component consists of a render area and a value slider in the main window, with controls to display a color picker. In the render area there appears a sphere representing the world, and a directional light manipulator representing the direction of the light. Picking on the manipulator and moving the mouse provides direct manipulation of the light direction. The color picker is used to edit the color, and the value slider edits the intensity.

The editor can currently be attached to only one light at a time. Attaching to two different lights will automatically detach the first one before attaching the second.


SoXtDirectionalLightEditor(Widget parent = NULL, const char *name = NULL, SbBool buildInsideParent = TRUE)

~SoXtDirectionalLightEditor()

Constructor and destructor.



void attach(SoPath *pathToLight)

void detach()

Attach/detach the editor to/from a directional light. When attached, changes made in the editor directly affect the attached light.



SbBool isAttached()

Returns TRUE if the editor is attached.



void addLightChangedCallback(SoXtDirectionalLightEditorCB *f, void *userData = NULL)

void removeLightChangedCallback(SoXtDirectionalLightEditorCB *f, void *userData = NULL)

Additional way of using the directional light editor, by registering a callback and setting the light.



void setLight(const SoDirectionalLight &newLight)

const SoDirectionalLight & getLight() const

Set new light values, and get the current light values.


SoXtComponent, SoDirectionalLight