Component which lets you edit a material interactively. More...

#include <Inventor/Xt/SoXtMaterialEditor.h>

Inheritance diagram for SoXtMaterialEditor:

Public Types
enum	UpdateFrequency { CONTINUOUS , AFTER_ACCEPT }
	UpdateFrequency is how often new values should be sent to the node or the callback routine. More...

Public Member Functions
	SoXtMaterialEditor (SoWidget parent=NULL, const char *name=NULL, SbBool buildInsideParent=TRUE)
	Constructor.

	~SoXtMaterialEditor ()
	Destructor.

void	attach (SoMaterial *material, int index=0)
	Attaches the editor to a material node and edits the material of the given index.

void	detach ()
	Detaches the editor from the material node.

SbBool	isAttached ()
	Returns TRUE if the editor is attached.

void	addMaterialChangedCallback (SoXtMaterialEditorCB f, void userData=NULL)
	Additional way of using the material editor, by registering a callback which will be called whenever the material changes (check the UpdateFrequency to find when the callbacks will be called).

void	removeMaterialChangedCallback (SoXtMaterialEditorCB f, void userData=NULL)
	Removes the material changed callback.

void	setUpdateFrequency (SoXtMaterialEditor::UpdateFrequency freq)
	Sets the update frequency.

SoXtMaterialEditor::UpdateFrequency	getUpdateFrequency ()
	Gets the update frequency.

virtual void	show ()
	This shows the component.

virtual void	hide ()
	This hides the component.

void	setMaterial (const SoMaterial &mtl)
	Sets a new material value.

const SoMaterial &	getMaterial () const
	Gets the current material value.

Public Member Functions inherited from SoXtComponent
SbBool	isVisible ()
	Returns TRUE if this component is mapped onto the screen.

SoWidget	getWidget () const
	This returns the base widget for this component.

SbBool	isTopLevelShell () const
	Returns TRUE if this component is a top level shell component (has its own window).

SoWidget	getShellWidget () const
	Returns the shell widget (NULL if the shell hasn't been created by this component).

SoWidget	getParentWidget () const
	Returns the parent widget, be it a shell or not.

void	setSize (const SbVec2s &size)
	Convenience routine on the widget.

SbVec2s	getSize ()
	Convenience routine on the widget.

SbBool	setFullScreen (const SbBool enable)
	Switches the viewer into (or out of) fullscreen mode.

SbBool	isFullScreen (void) const
	Queries if the viewer is in fullscreen mode.

void	setFullScreenEnable (const SbBool enable)
	Enables/disables fullscreen mode.

SbBool	isFullScreenEnable () const
	Queries if it is possible to put the viewer in fullscreen mode.

Display *	getDisplay ()
	Returns the X display associated with this components widget.

SoNONUNICODE void	setTitle (const char *newTitle)
	Sets window title.

void	setTitle (const SbString &newTitle)
	Sets window title.

SbString	getTitle () const
	Gets window title.

SoNONUNICODE void	setIconTitle (const char *newIconTitle)
	Sets icon title.

void	setIconTitle (const SbString &newIconTitle)
	Sets icon title.

SbString	getIconTitle () const
	Gets icon title.

void	setWindowCloseCallback (SoXtComponentCB func, void data=NULL)
	Sets which callback to call when the user closes this component (double click in the upper left corner) - by default hide() is called on this component, unless a callback is set to something other than NULL.

SbString	getWidgetName () const
	Returns the widget name.

SbString	getClassName () const
	Returns the class name.

Additional Inherited Members
Static Public Member Functions inherited from SoXtComponent
static void	displayHelp (const char *filename, UINT contextID)
	Static method to display the specified topic of the specified help file.

static SoXtComponent *	getComponent (SoWidget w)
	This returns the SoXtComponent for this widget.

Detailed Description

Component which lets you edit a material interactively.

This class is used to edit the material properties of an SoMaterial node. The editor can also directly be used using callbacks instead of attaching it to a node. The component consists of a render area displaying a test sphere, some sliders, a set of radio buttons, and a menu. The sphere displays the current material being edited. There is one slider for each material coefficient. Those fields are ambient, diffuse, specular, emissive (all of which are colors); and transparency and shininess (which are scalar values). A color editor can be opened to edit the color slider base color. A material list displays palettes of predefined materials from which to choose.

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

RESOURCES

  !!------------------------------------------------
  !! Material Editor !!
  !!------------------------------------------------
  *IvMaterialEditorTitle.labelString: Material Editor
  *IvMaterialEditorIconTitle.labelString: Mat Editor
  *IvMaterialAmbientTitle.labelString: Material Ambient Color
  *IvMaterialDiffuseTitle.labelString: Material Diffuse Color
  *IvMaterialSpecularTitle.labelString: Material Specular Color
  *IvMaterialEmissiveTitle.labelString: -Material Emissive Color
  *IvMaterialEditorMaterial.labelString: Material /
  *IvMaterialEditorAmb.labelString: Amb /
  *IvMaterialEditorDiff.labelString: Diff /
  *IvMaterialEditorSpec.labelString: Spec /
  *IvMaterialEditorEmis.labelString: Emis /
  *IvMaterialEditorColor.labelString: Color
  *IvMEMenuBar.IvEdit.labelString: Edit
  *IvMEMenuBar*IvEditPullDown.IvMaterialList.labelString: Material List
  *IvMEMenuBar*IvEditPullDown.IvContinuous.labelString: Continuous
  *IvMEMenuBar*IvEditPullDown.IvManual.labelString: Manual
  *IvMEMenuBar*IvEditPullDown.IvCopy.labelString: Copy
  *IvMEMenuBar*IvEditPullDown.IvPaste.labelString: Paste
  *IvMEMenuBar*IvEditPullDown.IvHelp.labelString: Help
  *IvControls.IvEditColor.labelString: Edit Color
  *IvsliderForm.IvtextForm.IvAmb.labelString: Amb:
  *IvsliderForm.IvtextForm.IvDiff.labelString: Diff
  *IvsliderForm.IvtextForm.IvSpec.labelString: Spec
  *IvsliderForm.IvtextForm.IvEmis.labelString: Emis
  *IvsliderForm.IvtextForm.IvShininess.labelString: Shininess
  *IvsliderForm.IvtextForm.IvTransp.labelString: Transp:
  *IvMETop.IvAccept.labelString: Accept

Member Enumeration Documentation

◆ UpdateFrequency

enum SoXtMaterialEditor::UpdateFrequency

UpdateFrequency is how often new values should be sent to the node or the callback routine.

Enumerator
CONTINUOUS	Send updates with every mouse motion.
AFTER_ACCEPT	Only send updates after user hits accept button.

Definition at line 162 of file SoXtMaterialEditor.h.

Constructor & Destructor Documentation

◆ SoXtMaterialEditor()

SoXtMaterialEditor::SoXtMaterialEditor	(	SoWidget	parent = `NULL`,
		const char *	name = `NULL`,
		SbBool	buildInsideParent = `TRUE`
	)

Constructor.

◆ ~SoXtMaterialEditor()

SoXtMaterialEditor::~SoXtMaterialEditor ( )

Destructor.

Member Function Documentation

◆ addMaterialChangedCallback()

void SoXtMaterialEditor::addMaterialChangedCallback	(	SoXtMaterialEditorCB *	f,
		void *	userData = `NULL`
	)

inline

Additional way of using the material editor, by registering a callback which will be called whenever the material changes (check the UpdateFrequency to find when the callbacks will be called).

Definition at line 366 of file SoXtMaterialEditor.h.

◆ attach()

void SoXtMaterialEditor::attach	(	SoMaterial *	material,
		int	index = `0`
	)

Attaches the editor to a material node and edits the material of the given index.

◆ detach()

void SoXtMaterialEditor::detach ( )

Detaches the editor from the material node.

◆ getMaterial()

const SoMaterial & SoXtMaterialEditor::getMaterial ( ) const

inline

Gets the current material value.

Definition at line 238 of file SoXtMaterialEditor.h.

◆ getUpdateFrequency()

SoXtMaterialEditor::UpdateFrequency SoXtMaterialEditor::getUpdateFrequency ( )

inline

Gets the update frequency.

See the UpdateFrequency enum declaration.

Definition at line 222 of file SoXtMaterialEditor.h.

◆ hide()

virtual void SoXtMaterialEditor::hide ( )

virtual

This hides the component.

Reimplemented from SoXtComponent.

◆ isAttached()

SbBool SoXtMaterialEditor::isAttached ( )

inline

Returns TRUE if the editor is attached.

Definition at line 198 of file SoXtMaterialEditor.h.

◆ removeMaterialChangedCallback()

void SoXtMaterialEditor::removeMaterialChangedCallback	(	SoXtMaterialEditorCB *	f,
		void *	userData = `NULL`
	)

inline

Removes the material changed callback.

Definition at line 372 of file SoXtMaterialEditor.h.

◆ setMaterial()

void SoXtMaterialEditor::setMaterial ( const SoMaterial & mtl )

Sets a new material value.

◆ setUpdateFrequency()

void SoXtMaterialEditor::setUpdateFrequency ( SoXtMaterialEditor::UpdateFrequency freq )

Sets the update frequency.

See the UpdateFrequency enum declaration.

◆ show()

virtual void SoXtMaterialEditor::show ( )

virtual

This shows the component.

Reimplemented from SoXtComponent.

The documentation for this class was generated from the following file:

Inventor/Xt/SoXtMaterialEditor.h

Open Inventor Release 2024.1.0

Public Types

Public Member Functions

Additional Inherited Members

Detailed Description

RESOURCES

SEE ALSO

Member Enumeration Documentation

◆ UpdateFrequency

Constructor & Destructor Documentation

◆ SoXtMaterialEditor()

◆ ~SoXtMaterialEditor()

Member Function Documentation

◆ addMaterialChangedCallback()

◆ attach()

◆ detach()

◆ getMaterial()

◆ getUpdateFrequency()

◆ hide()

◆ isAttached()

◆ removeMaterialChangedCallback()

◆ setMaterial()

◆ setUpdateFrequency()

◆ show()