'\"! tbl | mmdoc
'\"macro stdmacro
.ie n \{\
.   ds Cr \fB
.   ds Cb \fB
.\}
.el \{\
.   ds Cr \f7
.   ds Cb \f8
.\}
.TH SoXtMaterialList(3IV)
.SH NAME
SoXtMaterialList \(em component which lets you edit a material interactively 
.SH INHERITS FROM
SoXtComponent > SoXtMaterialList
.SH SYNOPSIS
.ps -1
\*(Cr#include <Inventor/Xt/SoXtMaterialList.h>
.sp
.ta 20m
.in 1i+20n
.ti 0.5i
.ta 20m
.ds Pt \*(Crtypedef void
.ie \w'\*(Pt'>=20n \{\
.ne 3
\*(Pt
.ti 0.5i
	\c\
\}
.el\{\
.ne 2
\*(Pt	\c\
\}
\*(CbSoXtMaterialListCB\*(Cr(void *userData, const SoMaterial *mtl)
.sp
.in 1i
\f1Methods from class SoXtMaterialList:
.in 0.5i
.sp
.ta 20m
.in 1i+20n
.ti 0.5i
.ta 20m
.ds Pt \*(Cr
.ie \w'\*(Pt'>=20n \{\
.ne 3
\*(Pt
.ti 0.5i
	\c\
\}
.el\{\
.ne 2
\*(Pt	\c\
\}
\*(CbSoXtMaterialList\*(Cr(Widget parent = NULL, const char *name = NULL, SbBool buildInsideParent = TRUE, const char *dir = NULL)
.br
.in 1i+20n
.ti 0.5i
.ta 20m
.ds Pt \*(Cr
.ie \w'\*(Pt'>=20n \{\
.ne 3
\*(Pt
.ti 0.5i
	\c\
\}
.el\{\
.ne 2
\*(Pt	\c\
\}
\*(Cb~SoXtMaterialList\*(Cr()
.br
.in 1i+20n
.ti 0.5i
.ta 20m
.ds Pt \*(Cr
.ie \w'\*(Pt'>=20n \{\
.ne 3
\*(Pt
.ti 0.5i
	\c\
\}
.el\{\
.ne 2
\*(Pt	\c\
\}
\*(CbaddCallback\*(Cr(SoXtMaterialListCB *f, void *userData = NULL)
.br
.in 1i+20n
.ti 0.5i
.ta 20m
.ds Pt \*(Cr
.ie \w'\*(Pt'>=20n \{\
.ne 3
\*(Pt
.ti 0.5i
	\c\
\}
.el\{\
.ne 2
\*(Pt	\c\
\}
\*(CbremoveCallback\*(Cr(SoXtMaterialListCB *f, void *userData = NULL)
.sp
.in 1i
\f1Methods from class SoXtComponent:
.in 0.5i
.sp
.ta 24m
.in 1i+24n
.ti 0.5i
.ta 24m
.ds Pt \*(Crvirtual void
.ie \w'\*(Pt'>=24n \{\
.ne 3
\*(Pt
.ti 0.5i
	\c\
\}
.el\{\
.ne 2
\*(Pt	\c\
\}
\*(Cbshow\*(Cr()
.br
.in 1i+24n
.ti 0.5i
.ta 24m
.ds Pt \*(Crvirtual void
.ie \w'\*(Pt'>=24n \{\
.ne 3
\*(Pt
.ti 0.5i
	\c\
\}
.el\{\
.ne 2
\*(Pt	\c\
\}
\*(Cbhide\*(Cr()
.br
.in 1i+24n
.ti 0.5i
.ta 24m
.ds Pt \*(CrSbBool
.ie \w'\*(Pt'>=24n \{\
.ne 3
\*(Pt
.ti 0.5i
	\c\
\}
.el\{\
.ne 2
\*(Pt	\c\
\}
\*(CbisVisible\*(Cr()
.br
.in 1i+24n
.ti 0.5i
.ta 24m
.ds Pt \*(CrWidget
.ie \w'\*(Pt'>=24n \{\
.ne 3
\*(Pt
.ti 0.5i
	\c\
\}
.el\{\
.ne 2
\*(Pt	\c\
\}
\*(CbgetWidget\*(Cr() const
.br
.in 1i+24n
.ti 0.5i
.ta 24m
.ds Pt \*(CrSbBool
.ie \w'\*(Pt'>=24n \{\
.ne 3
\*(Pt
.ti 0.5i
	\c\
\}
.el\{\
.ne 2
\*(Pt	\c\
\}
\*(CbisTopLevelShell\*(Cr() const
.br
.in 1i+24n
.ti 0.5i
.ta 24m
.ds Pt \*(CrWidget
.ie \w'\*(Pt'>=24n \{\
.ne 3
\*(Pt
.ti 0.5i
	\c\
\}
.el\{\
.ne 2
\*(Pt	\c\
\}
\*(CbgetShellWidget\*(Cr() const
.br
.in 1i+24n
.ti 0.5i
.ta 24m
.ds Pt \*(CrWidget
.ie \w'\*(Pt'>=24n \{\
.ne 3
\*(Pt
.ti 0.5i
	\c\
\}
.el\{\
.ne 2
\*(Pt	\c\
\}
\*(CbgetParentWidget\*(Cr() const
.br
.in 1i+24n
.ti 0.5i
.ta 24m
.ds Pt \*(Crvoid
.ie \w'\*(Pt'>=24n \{\
.ne 3
\*(Pt
.ti 0.5i
	\c\
\}
.el\{\
.ne 2
\*(Pt	\c\
\}
\*(CbsetSize\*(Cr(const SbVec2s &size)
.br
.in 1i+24n
.ti 0.5i
.ta 24m
.ds Pt \*(CrSbVec2s
.ie \w'\*(Pt'>=24n \{\
.ne 3
\*(Pt
.ti 0.5i
	\c\
\}
.el\{\
.ne 2
\*(Pt	\c\
\}
\*(CbgetSize\*(Cr()
.br
.in 1i+24n
.ti 0.5i
.ta 24m
.ds Pt \*(CrDisplay *
.ie \w'\*(Pt'>=24n \{\
.ne 3
\*(Pt
.ti 0.5i
	\c\
\}
.el\{\
.ne 2
\*(Pt	\c\
\}
\*(CbgetDisplay\*(Cr()
.br
.in 1i+24n
.ti 0.5i
.ta 24m
.ds Pt \*(Crvoid
.ie \w'\*(Pt'>=24n \{\
.ne 3
\*(Pt
.ti 0.5i
	\c\
\}
.el\{\
.ne 2
\*(Pt	\c\
\}
\*(CbsetTitle\*(Cr(const char *newTitle)
.br
.in 1i+24n
.ti 0.5i
.ta 24m
.ds Pt \*(Crconst char *
.ie \w'\*(Pt'>=24n \{\
.ne 3
\*(Pt
.ti 0.5i
	\c\
\}
.el\{\
.ne 2
\*(Pt	\c\
\}
\*(CbgetTitle\*(Cr() const
.br
.in 1i+24n
.ti 0.5i
.ta 24m
.ds Pt \*(Crvoid
.ie \w'\*(Pt'>=24n \{\
.ne 3
\*(Pt
.ti 0.5i
	\c\
\}
.el\{\
.ne 2
\*(Pt	\c\
\}
\*(CbsetIconTitle\*(Cr(const char *newIconTitle)
.br
.in 1i+24n
.ti 0.5i
.ta 24m
.ds Pt \*(Crconst char *
.ie \w'\*(Pt'>=24n \{\
.ne 3
\*(Pt
.ti 0.5i
	\c\
\}
.el\{\
.ne 2
\*(Pt	\c\
\}
\*(CbgetIconTitle\*(Cr() const
.br
.in 1i+24n
.ti 0.5i
.ta 24m
.ds Pt \*(Crvoid
.ie \w'\*(Pt'>=24n \{\
.ne 3
\*(Pt
.ti 0.5i
	\c\
\}
.el\{\
.ne 2
\*(Pt	\c\
\}
\*(CbsetWindowCloseCallback\*(Cr(SoXtComponentCB *func, void *data = NULL)
.br
.in 1i+24n
.ti 0.5i
.ta 24m
.ds Pt \*(Crstatic SoXtComponent *
.ie \w'\*(Pt'>=24n \{\
.ne 3
\*(Pt
.ti 0.5i
	\c\
\}
.el\{\
.ne 2
\*(Pt	\c\
\}
\*(CbgetComponent\*(Cr(Widget w)
.br
.in 1i+24n
.ti 0.5i
.ta 24m
.ds Pt \*(Crconst char *
.ie \w'\*(Pt'>=24n \{\
.ne 3
\*(Pt
.ti 0.5i
	\c\
\}
.el\{\
.ne 2
\*(Pt	\c\
\}
\*(CbgetWidgetName\*(Cr() const
.br
.in 1i+24n
.ti 0.5i
.ta 24m
.ds Pt \*(Crconst char *
.ie \w'\*(Pt'>=24n \{\
.ne 3
\*(Pt
.ti 0.5i
	\c\
\}
.el\{\
.ne 2
\*(Pt	\c\
\}
\*(CbgetClassName\*(Cr() const
.sp
.SH DESCRIPTION
This class is used to choose an \*(CbSoMaterial\f1 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. 
.SH METHODS
.ta 20m
.in 1i+20n
.ti 0.5i
.ta 20m
.ds Pt \*(Cr
.ie \w'\*(Pt'>=20n \{\
.ne 3
\*(Pt
.ti 0.5i
	\c\
\}
.el\{\
.ne 2
\*(Pt	\c\
\}
\*(CbSoXtMaterialList\*(Cr(Widget parent = NULL, const char *name = NULL, SbBool buildInsideParent = TRUE, const char *dir = NULL)
.br
.in 1i+20n
.ti 0.5i
.ta 20m
.ds Pt \*(Cr
.ie \w'\*(Pt'>=20n \{\
.ne 3
\*(Pt
.ti 0.5i
	\c\
\}
.el\{\
.ne 2
\*(Pt	\c\
\}
\*(Cb~SoXtMaterialList\*(Cr()
.br
.in 1i
\f1The 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. 
.sp
.in 0.5i
.in 1i+20n
.ti 0.5i
.ta 20m
.ds Pt \*(Cr
.ie \w'\*(Pt'>=20n \{\
.ne 3
\*(Pt
.ti 0.5i
	\c\
\}
.el\{\
.ne 2
\*(Pt	\c\
\}
\*(CbaddCallback\*(Cr(SoXtMaterialListCB *f, void *userData = NULL)
.br
.in 1i+20n
.ti 0.5i
.ta 20m
.ds Pt \*(Cr
.ie \w'\*(Pt'>=20n \{\
.ne 3
\*(Pt
.ti 0.5i
	\c\
\}
.el\{\
.ne 2
\*(Pt	\c\
\}
\*(CbremoveCallback\*(Cr(SoXtMaterialListCB *f, void *userData = NULL)
.br
.in 1i
\f1Register functions that will be called whenever the user chooses a new material from the list. Each callback when invoked will be passed the \*(CbuserData\f1 pointer, along with a pointer to the newly selected material. 
.sp
.in 0.5i
.SH SEE ALSO
\*(CbSoXtComponent, SoCallbackList, SoMaterial, SoXtMaterialEditor