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  -  SOINDEXEDSHAPE (3)

NAME

SoIndexedShape — abstract base class for all indexed vertex-based shapes

CONTENTS

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

INHERITS FROM

SoBase > SoFieldContainer > SoNode > SoShape > SoVertexShape > SoIndexedShape

SYNOPSIS

#include <Inventor/nodes/SoIndexedShape.h>

Fields from class SoIndexedShape:

    SoMFInt32    
                    
SoMFInt32            coordIndex    
SoMFInt32    
                    
SoMFInt32            materialIndex    
SoMFInt32    
                    
SoMFInt32            normalIndex    
SoMFInt32    
                    
SoMFInt32            textureCoordIndex

Fields from class SoVertexShape:

    SoSFNode    
                    
SoSFNode             vertexProperty

Methods from class SoIndexedShape:

    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 is the abstract base class for all vertex-based shapes that are constructed from indices, including SoIndexedFaceSet, SoIndexedTriangleStripSet, and SoIndexedLineSet. SoIndexedShape defines fields that are used in all of its subclasses.

All subclasses of SoNonIndexedShape construct objects by using the coordinates specified by the vertexProperty field (from SoVertexShape), or the current inherited coordinates. The coordIndex field defined by this class contains the indices into the current coordinates of the vertices of the shape. These indices are also used for materials, normals, or texture coordinates when the appropriate binding is PER_VERTEX_INDEXED.

Material and normal bindings are interpreted as follows for each subclass:



OVERALL             One material for the entire shape. PER_PART            Specific to the subclass. PER_PART_INDEXED    Same as PER_PART, using indices from the                     materialIndex or normalIndex field. PER_FACE            Specific to the subclass. PER_FACE_INDEXED    Same as PER_FACE, using indices from the                     materialIndex or normalIndex field. PER_VERTEX          One material per vertex. PER_VERTEX_INDEXED  One material per vertex, using indices from the                     materialIndex or normalIndex field.

When any _INDEXED binding is used for materials or normals, the materialIndex or normalIndex field is used to determine the indices for the materials or normals. If this field contains a single value of -1 (the default), the coordinate indices from the coordIndex field are used as well for materials or normals. When the binding is PER_VERTEX_INDEXED, indices in these fields that correspond to negative indices in coordIndex are skipped; for other index bindings all the values in the fields are used, in order.

Explicit texture coordinates (as defined by SoTextureCoordinate2) may be bound to vertices of an indexed shape consecutively (if the texture coordinate binding is PER_VERTEX) or by using the indices in the textureCoordIndex field (if the binding is PER_VERTEX_INDEXED). As with all vertex-based shapes, if there is a current texture but no texture coordinates are specified, a default texture coordinate mapping is calculated using the bounding box of the shape.

Be sure that the indices contained in the coordIndex, materialIndex, normalIndex, and textureCoordIndex fields are valid with respect to the current state, or errors will occur.

FIELDS

    SoMFInt32    
                    
SoMFInt32            coordIndex
The indices of the coordinates that the shape uses as its vertices. The coordinates connect to form faces, lines, or other shapes. Each subclass defines special negative indices to use to indicate separation between faces, lines, and so on.

    SoMFInt32    
                    
SoMFInt32            materialIndex    
SoMFInt32    
                    
SoMFInt32            normalIndex    
SoMFInt32    
                    
SoMFInt32            textureCoordIndex
The indices of the materials, normals, and texture coordinates that are used for the shape. These fields are used only when the appropriate binding is one of the _INDEXED bindings. By default, the values of these fields indicate that the coordinate indices should be used for materials, normals, or texture coordinates as well.

METHODS

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

FILE FORMAT/DEFAULTS

This is an abstract class. See the reference page of a derived class for the format and default values.

SEE ALSO

SoIndexedFaceSet, SoIndexedLineSet, SoIndexedTriangleStripSet, SoMaterialBinding, SoNonIndexedShape, SoNormalBinding, SoShapeHints, SoTextureCoordinateBinding

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


SOINDEXEDSHAPE(3IV) (-->)

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