Inventor/Xt/SoXtMaterialEditor.h

Go to the documentation of this file.

/*=======================================================================
 * Copyright 1991-1996, Silicon Graphics, Inc.
 * ALL RIGHTS RESERVED
 *
 * UNPUBLISHED -- Rights reserved under the copyright laws of the United
 * States.   Use of a copyright notice is precautionary only and does not
 * imply publication or disclosure.
 *
 * U.S. GOVERNMENT RESTRICTED RIGHTS LEGEND:
 * Use, duplication or disclosure by the Government is subject to restrictions
 * as set forth in FAR 52.227.19(c)(2) or subparagraph (c)(1)(ii) of the Rights
 * in Technical Data and Computer Software clause at DFARS 252.227-7013 and/or
 * in similar or successor clauses in the FAR, or the DOD or NASA FAR
 * Supplement.  Contractor/manufacturer is Silicon Graphics, Inc.,
 * 2011 N. Shoreline Blvd. Mountain View, CA 94039-7311.
 *
 * THE CONTENT OF THIS WORK CONTAINS CONFIDENTIAL AND PROPRIETARY
 * INFORMATION OF SILICON GRAPHICS, INC. ANY DUPLICATION, MODIFICATION,
 * DISTRIBUTION, OR DISCLOSURE IN ANY FORM, IN WHOLE, OR IN PART, IS STRICTLY
 * PROHIBITED WITHOUT THE PRIOR EXPRESS WRITTEN PERMISSION OF SILICON
 * GRAPHICS, INC.
**=======================================================================*/
/*=======================================================================
** Author      : Alain Dumesny (MMM yyyy)
** Modified by : David Mott (MMM yyyy)
**=======================================================================*/
/*=======================================================================
 *** THE CONTENT OF THIS WORK IS PROPRIETARY TO FEI S.A.S, (FEI S.A.S.),            ***
 ***              AND IS DISTRIBUTED UNDER A LICENSE AGREEMENT.                     ***
 ***                                                                                ***
 ***  REPRODUCTION, DISCLOSURE,  OR USE,  IN WHOLE OR IN PART,  OTHER THAN AS       ***
 ***  SPECIFIED  IN THE LICENSE ARE  NOT TO BE  UNDERTAKEN  EXCEPT WITH PRIOR       ***
 ***  WRITTEN AUTHORIZATION OF FEI S.A.S.                                           ***
 ***                                                                                ***
 ***                        RESTRICTED RIGHTS LEGEND                                ***
 ***  USE, DUPLICATION, OR DISCLOSURE BY THE GOVERNMENT OF THE CONTENT OF THIS      ***
 ***  WORK OR RELATED DOCUMENTATION IS SUBJECT TO RESTRICTIONS AS SET FORTH IN      ***
 ***  SUBPARAGRAPH (C)(1) OF THE COMMERCIAL COMPUTER SOFTWARE RESTRICTED RIGHT      ***
 ***  CLAUSE  AT FAR 52.227-19  OR SUBPARAGRAPH  (C)(1)(II)  OF  THE RIGHTS IN      ***
 ***  TECHNICAL DATA AND COMPUTER SOFTWARE CLAUSE AT DFARS 52.227-7013.             ***
 ***                                                                                ***
 ***                   COPYRIGHT (C) 1996-2020 BY FEI S.A.S,                        ***
 ***                        BORDEAUX, FRANCE                                        ***
 ***                      ALL RIGHTS RESERVED                                       ***
**=======================================================================*/
/*=======================================================================
** Modified by : VSG (MMM YYYY)
**=======================================================================*/


//
// Extended to support VRML 2.0 for Inventor version 3.0
//
// Mike Heck
//
// The "attach" and "setMaterial" methods are overloaded to allow passing
// in an SoVRMLMaterial node.  There is a new method "isAttachedVRML".
//
// This extension does not force any changes in existing applications.
// In order to attach to the material affecting a VRML 2.0 shape, existing
// applications will need to enhance their attach logic (see SceneViewer).
//

#ifdef SOQT
#  include <Inventor/Qt/SoQtMaterialEditor.h>
#elif defined _WIN32
#  include <Inventor/Win/SoWinMaterialEditor.h>
#else // _WIN32

#ifndef _SO_XT_MATERIAL_EDITOR_
#define _SO_XT_MATERIAL_EDITOR_

#include <Xm/Xm.h>
#include <Inventor/SbBasic.h>
#include <Inventor/misc/SoCallbackList.h>
#include <Inventor/Xt/SoXtComponent.h>

class SoBaseColor;
class SoXtClipboard;
class SoXtColorEditor;
class SoNodeSensor;
class SoSensor;
class SoDirectionalLight;
class SoMaterial;
class SoXtMaterialList;
class SoPathList;
class SoXtRenderArea;
class SoSelection;
class SoXtColorSlider;
class SoMFColor;
class SbColor;
class SoBase;
class SoSeparator;
class SoVRMLMaterial;
class SoNode;
class SoSFColor;

// callback function prototypes
typedef void SoXtMaterialEditorCB(void *userData, const SoMaterial *mtl);

//
//  Class: SoXtMaterialEditor
//
//  This editor lets you interactively edit a material
//

class  SoXtMaterialEditor : public SoXtComponent {
 public:
  enum UpdateFrequency {
    CONTINUOUS,
    AFTER_ACCEPT
  };

  SoXtMaterialEditor(
                     SoWidget parent = NULL,
                     const char *name = NULL,
                     SbBool buildInsideParent = TRUE);
  ~SoXtMaterialEditor();

  void attach(SoMaterial *material, int index = 0);

  void attach(SoVRMLMaterial *material);

  void                detach();
  SbBool              isAttached()    { return (material != NULL); }

  inline void         addMaterialChangedCallback(
                                                 SoXtMaterialEditorCB *f,
                                                 void *userData = NULL);
  inline void         removeMaterialChangedCallback(
                                                    SoXtMaterialEditorCB *f,
                                                    void *userData = NULL);

  void        setUpdateFrequency(SoXtMaterialEditor::UpdateFrequency freq);
  SoXtMaterialEditor::UpdateFrequency getUpdateFrequency()
    { return updateFreq; }

  // Redefine these since there are multiple windows -
  // the color editor, directional light editor, and this component
  virtual void        show();
  virtual void        hide();

  void                setMaterial(const SoMaterial &mtl);

  void setMaterial(const SoVRMLMaterial &mtl);

  const SoMaterial &  getMaterial() const { return *localMaterial; }

  SbBool isAttachedVRML() { return (isVRMLMaterial); }

 private:

  // This constructor takes a boolean whether to build the widget now.
  // Subclasses can pass FALSE, then call SoXtMaterialEditor::buildWidget()
  // when they are ready for it to be built.
  SoEXTENDER
    SoXtMaterialEditor(
                       SoWidget parent,
                       const char *name,
                       SbBool buildInsideParent,
                       SbBool buildNow);

  SoWidget                  buildWidget(SoWidget parent);

  // redefine these
  virtual SbString    getDefaultWidgetName() const;
  virtual SbString    getDefaultTitle() const;
  virtual SbString    getDefaultIconTitle() const;

 private:
  // attach vars
  SoNode              *material;  // material we are editing
  SoMaterial          *imat;
  SoVRMLMaterial      *vmat;
  SbBool              isVRMLMaterial; // What kind of matl we are editing
  int                 index;      // material index number
  SoNodeSensor        *sensor;
  SoCallbackList      *callbackList;
  SoWidget              acceptButton, diamondButtons[4], radioButtons[4];
  SoXtMaterialEditor::UpdateFrequency updateFreq;

  // widgets to edit the material
  SoWidget              mgrWidget;      // topmost widget
  SoXtColorEditor     *colorEditor;
  SoXtColorSlider     *sliders[6];
  SbBool              changedIt[6];
  SoXtMaterialList    *materialList;
  SbBool              ignoreCallback; // TRUE while callback should be ignored
  SbBool              openMaterialList;
  static void         colorEditorCloseCB(void *, SoXtComponent *);
  static void         materialListCloseCB(void *, SoXtComponent *);

  // copy/paste support
  SoXtClipboard       *clipboard;

  // local scene vars
  SoXtRenderArea      *renderArea;
  SoMaterial          *localMaterial;     // local copy of the material
  SoDirectionalLight  *light0;
  SoDirectionalLight  *light1;
  SoBaseColor         *tileColor;
  SoSeparator         *root;

  // keep the menu items around so we can update them before menu display
  SoWidget              *menuItemsList;

  int32_t             activeColor;        // field which color editor edits

  // update the sliders/colorEditor based on the local material
  void                updateLocalComponents();

  // update the colorEditor based on the activeColor flag
  void                updateColorEditor(SbBool updateTitle = FALSE);

  // update a color slider (amb/diff/spec/emiss) based of a material color
  // (split the base color from the intensity).
  void                updateColorSlider(SoXtColorSlider *, const float rgb[3]);

  // update a material field when a color slider changes.
  void                updateMaterialColor(
                                          SoMFColor   *editMtlColor,
                                          SoMFColor   *localMtlColor,
                                          const float *rgb,
                                          float       intensity);
  void                updateMaterialColor(
                                          SoSFColor   *editMtlColor,
                                          SoMFColor   *localMtlColor,
                                          const float *rgb,
                                          float       intensity);

  // copies mat2 onto mat1
  void                copyMaterial(SoNode *mat1, int index1,
                                   const SoNode *mat2, int index2);

  // For each of the 6 sliders (or sets of sliders) sets the ignore flag of
  // the material node being editted to FALSE if it has been changed.
  void                undoIgnoresIfChanged();

  // copy/paste support
  static void         pasteDone(void *userData, SoPathList *pathList);

  // Callback routines from components
  static void         materialListCB(void *, const SoMaterial *);
  static void         colorEditorCB(void *, const SbColor *);
  static void         ambientSliderCB(void *, float);
  static void         diffuseSliderCB(void *, float);
  static void         specularSliderCB(void *, float);
  static void         emissiveSliderCB(void *, float);
  static void         shininessSliderCB(void *, float);
  static void         transparencySliderCB(void *, float);

  // Callback routines from Xt/Motif
  static void         menuPick(SoWidget, int, XmAnyCallbackStruct *);
  static void         menuDisplay(SoWidget, SoXtMaterialEditor *, XtPointer);
  static void         radioButtonPick(SoWidget, int, XtPointer);
  static void         diamondButtonPick(SoWidget, int, XtPointer);
  static void         acceptButtonCB(SoWidget, SoXtMaterialEditor *, XtPointer);

  // Sensor callbacks
  static void         sensorCB(void *, SoSensor *);

  // Build routines
  SoWidget              buildPulldownMenu(SoWidget parent);
  SoWidget              buildControls(SoWidget parent);
  SoWidget              buildSlidersForm(SoWidget parent);

  static void visibilityChangeCB(void *pt, SbBool visible);
  void        activate();             // connects the sensor
  void        deactivate();           // disconnects the sensor

  // this is called by both constructors
  void constructorCommon(SbBool buildNow);

};


// Inline functions
void
SoXtMaterialEditor::addMaterialChangedCallback(
                                               SoXtMaterialEditorCB *f,
                                               void *userData)
{ callbackList->addCallback((SoCallbackListCB *) f, userData); }

void
SoXtMaterialEditor::removeMaterialChangedCallback(
                                                  SoXtMaterialEditorCB *f,
                                                  void *userData)
{ callbackList->removeCallback((SoCallbackListCB *) f, userData); }

#endif // _SO_XT_MATERIAL_EDITOR_

#endif // _WIN32

---

Open Inventor Toolkit reference manual, generated on 12 Feb 2024
Copyright © Thermo Fisher Scientific All rights reserved. http://www.openinventor.com/