NAME

       SoXtDirectionalLightEditor — component for editing directional lights

INHERITS FROM

       SoXtComponent > SoXtDirectionalLightEditor

SYNOPSIS

       #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

DESCRIPTION

       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.

METHODS

                                 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.

SEE ALSO

       SoXtComponent, SoDirectionalLight

                                                                               SoXtDirectionalLightEditor(3IV)()