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)()