GSP
Quick Navigator

Search Site

Unix VPS
A - Starter
B - Basic
C - Preferred
D - Commercial
MPS - Dedicated
Previous VPSs
* Sign Up! *

Support
Contact Us
Online Help
Handbooks
Domain Status
Man Pages

FAQ
Virtual Servers
Pricing
Billing
Technical

Network
Facilities
Connectivity
Topology Map

Miscellaneous
Server Agreement
Year 2038
Credits
 

USA Flag

 

 

Man Pages


Manual Reference Pages  -  SOMATERIAL (3)

NAME

SoMaterial — surface material definition node

CONTENTS

Inherits From
Synopsis
Description
Fields
Methods
Action Behavior
File Format/defaults
See Also

INHERITS FROM

SoBase > SoFieldContainer > SoNode > SoMaterial

SYNOPSIS

#include <Inventor/nodes/SoMaterial.h>

Fields from class SoMaterial:

    SoMFColor    
                    
SoMFColor            ambientColor    
SoMFColor    
                    
SoMFColor            diffuseColor    
SoMFColor    
                    
SoMFColor            specularColor    
SoMFColor    
                    
SoMFColor            emissiveColor    
SoMFFloat    
                    
SoMFFloat            shininess    
SoMFFloat    
                    
SoMFFloat            transparency

Methods from class SoMaterial:

       
                    
                     SoMaterial()    
static SoType    
                    
static SoType        getClassTypeId()

Methods from class SoNode:

    void    
                    
void                 setOverride(SbBool state)    
SbBool    
                    
SbBool               isOverride() const    
SoNode *    
                    
SoNode *             copy(SbBool copyConnections = FALSE) const    
virtual SbBool    
                    
virtual SbBool       affectsState() const    
static SoNode *    
                    
static SoNode *      getByName(const SbName &name)    
static int    
                    
static int           getByName(const SbName &name, SoNodeList &list)

Methods from class SoFieldContainer:

    void    
                    
void                 setToDefaults()    
SbBool    
                    
SbBool               hasDefaultValues() const    
SbBool    
                    
SbBool               fieldsAreEqual(const SoFieldContainer *fc) const    
void    
                    
void                 copyFieldValues(const SoFieldContainer *fc, SbBool copyConnections = FALSE)    
SbBool    
                    
SbBool               set(const char *fieldDataString)    
void    
                    
void                 get(SbString &fieldDataString)    
virtual int    
                    
virtual int          getFields(SoFieldList &resultList) const    
virtual SoField *    
                    
virtual SoField *    getField(const SbName &fieldName) const    
SbBool    
                    
SbBool               getFieldName(const SoField *field, SbName &fieldName) const    
SbBool    
                    
SbBool               isNotifyEnabled() const    
SbBool    
                    
SbBool               enableNotify(SbBool flag)

Methods from class SoBase:

    void    
                    
void                 ref()    
void    
                    
void                 unref() const    
void    
                    
void                 unrefNoDelete() const    
void    
                    
void                 touch()    
virtual SoType    
                    
virtual SoType       getTypeId() const    
SbBool    
                    
SbBool               isOfType(SoType type) const    
virtual void    
                    
virtual void         setName(const SbName &name)    
virtual SbName    
                    
virtual SbName       getName() const

DESCRIPTION

This node defines the current surface material properties for all subsequent shapes. SoMaterial sets several components of the current material during traversal.

Multiple values can be specified for the diffuseColor and transparency. Different shapes interpret materials with multiple values differently. To bind materials to shapes, use an SoMaterialBinding node.

FIELDS

    SoMFColor    
                    
SoMFColor            ambientColor
Ambient color of the surface.

    SoMFColor    
                    
SoMFColor            diffuseColor
Diffuse color(s) of the surface.

    SoMFColor    
                    
SoMFColor            specularColor
Specular color of the surface.

    SoMFColor    
                    
SoMFColor            emissiveColor
Emissive color of the surface.

    SoMFFloat    
                    
SoMFFloat            shininess
Shininess coefficient of the surface. Values can range from 0.0 for no shininess (a diffuse surface) to 1.0 for maximum shininess (a highly polished surface).

    SoMFFloat    
                    
SoMFFloat            transparency
Transparency value(s) of the surface. Values can range from 0.0 for opaque surfaces to 1.0 for completely transparent surfaces. If the transparency type is SoGLRenderAction::SCREEN_DOOR then only the first transparency value will be used. With other transparency types, multiple transparencies will be used, if the SoMaterial node contains as many transparencies as diffuse colors. If there are not as many transparencies as diffuse colors, only the first transparency will be used.

METHODS

       
                    
                     SoMaterial()
Creates a material node with default settings.

    static SoType    
                    
static SoType        getClassTypeId()
Returns type identifier for this class.

ACTION BEHAVIOR

SoGLRenderAction, SoCallbackAction
Sets the ambient color, the diffuse color, the specular color, the emissive color, the shininess, and the transparency of the current material.

FILE FORMAT/DEFAULTS

Material {



ambientColor   0.2 0.2 0.2
diffuseColor   0.8 0.8 0.8
specularColor  0 0 0
emissiveColor  0 0 0
shininess      0.2
transparency   0


}

SEE ALSO

SoBaseColor, SoLightModel, SoMaterialBinding, SoPackedColor

Search for    or go to Top of page |  Section 3 |  Main Index


SOMATERIAL(3IV) (-->)

Powered by GSP Visit the GSP FreeBSD Man Page Interface.
Output converted with manServer 1.07.