NAME

       SoXtMaterialList — component which lets you edit a material interactively

INHERITS FROM

       SoXtComponent > SoXtMaterialList

SYNOPSIS

       #include <Inventor/Xt/SoXtMaterialList.h>

     typedef void        SoXtMaterialListCB(void *userData, const SoMaterial *mtl)

          Methods from class SoXtMaterialList:

                         SoXtMaterialList(Widget   parent   =   NULL,   const   char   *name   =   NULL,  SbBool
                              buildInsideParent = TRUE, const char *dir = NULL)
                         ~SoXtMaterialList()
                         addCallback(SoXtMaterialListCB *f, void *userData = NULL)
                         removeCallback(SoXtMaterialListCB *f, void *userData = NULL)

          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 choose an SoMaterial from palettes of  predefined  materials  (for  example,  gold,
       silver,  or  bronze  from the metal palette; emerald, pearl, or ruby from the stones palette). The chosen
       material is passed to callback functions registered with this component.

METHODS

                         SoXtMaterialList(Widget  parent   =   NULL,   const   char   *name   =   NULL,   SbBool
                              buildInsideParent = TRUE, const char *dir = NULL)
                         ~SoXtMaterialList()
          The  constructor  is  passed  a  directory  name  which  serves as the home directory for the material
          palettes. You can have any number of palettes in this directory. A  palette  is  a  subdirectory  that
          contains  Inventor  data  files, where each file describes one material. Predefined Inventor materials
          are found in /usr/share/data/materials.

                         addCallback(SoXtMaterialListCB *f, void *userData = NULL)
                         removeCallback(SoXtMaterialListCB *f, void *userData = NULL)
          Register functions that will be called whenever the user chooses a new material from  the  list.  Each
          callback  when invoked will be passed the userData pointer, along with a pointer to the newly selected
          material.

SEE ALSO

       SoXtComponent, SoCallbackList, SoMaterial, SoXtMaterialEditor

                                                                                         SoXtMaterialList(3IV)()