SoSFPath

Langue: en

Autres versions - même langue

Version: 323481 (ubuntu - 08/07/09)

Section: 3 (Bibliothèques de fonctions)

NAME

SoSFPath -

SYNOPSIS


#include <Inventor/fields/SoSFPath.h>

Inherits SoSField.

Detailed Description

The SoSFPath class is a container for a single path.

This field container stores a pointer to a Coin path. It takes care of the necessary functionality for handling copy, import and export operations.

Note that the path pointer stored in a field instance of this type may be a NULL pointer.

See also:

SoPath, SoMFPath

Public Member Functions


virtual SoType getTypeId (void) const

virtual void copyFrom (const SoField &field)

const SoSFPath & operator= (const SoSFPath &field)

virtual SbBool isSame (const SoField &field) const

SoPath * getValue (void) const

void setValue (SoPath *newvalue)

SoPath * operator= (SoPath *newvalue)

int operator== (const SoSFPath &field) const

int operator!= (const SoSFPath &field) const

virtual void notify (SoNotList *l)

virtual void fixCopy (SbBool copyconnections)

virtual SbBool referencesCopy (void) const

Static Public Member Functions


static void * createInstance (void)

static SoType getClassTypeId (void)

static void initClass (void)

Protected Attributes


SoPath * value

Friends


class SoMFPath

Member Function Documentation

SoType SoSFPath::getClassTypeId (void) [static]

Returns a unique type identifier for this field class.

See also:

getTypeId(), SoType

Reimplemented from SoSField.

SoType SoSFPath::getTypeId (void) const [virtual]

Returns the type identification instance which uniquely identifies the Coin field class the object belongs to.

See also:

getClassTypeId(), SoType

Implements SoField.

void SoSFPath::copyFrom (const SoField & f) [virtual]

Copy value(s) from f into this field. f must be of the same type as this field.

Implements SoField.

SbBool SoSFPath::isSame (const SoField & f) const [virtual]

Check for equal type and value(s).

Implements SoField.

void SoSFPath::initClass (void) [static]

Internal method called upon initialization of the library (from SoDB::init()) to set up the type system.

Reimplemented from SoSField.

Referenced by SoField::initClasses().

void SoSFPath::notify (SoNotList * nlist) [virtual]

Notify auditors that this field has changed.

Reimplemented from SoField.

References SoBase::addAuditor(), SoPath::getHead(), SoField::notify(), SoBase::ref(), SoBase::removeAuditor(), and SoBase::unref().

void SoSFPath::fixCopy (SbBool copyconnections) [virtual]

This method is internally called after SoField::copyFrom() during scene graph copies, and should do the operations necessary for fixing up the field instance after it has gotten a new value.

The default method in the SoField superclass does nothing.

The application programmer should normally not need to consider this method, unless he constructs a complex field type which contains new references to container instances (i.e. nodes or engines). Overriding this method is then necessary to update the reference pointers, as they could have been duplicated during the copy operation.

Reimplemented from SoField.

References SoBase::assertAlive(), SoPath::copy(), and SoFieldContainer::findCopy().

SbBool SoSFPath::referencesCopy (void) const [virtual]

Returns TRUE if this field has references to any containers in the scene graph which are also duplicated during the copy operation.

Note that this method only is valid to call during copy operations.

See also the note about the relevance of the fixCopy() method for application programmers, as it is applicable on this method aswell.

Reimplemented from SoField.

References SoFieldContainer::checkCopy(), SoPath::getClassTypeId(), SoEngine::getClassTypeId(), SoNode::getClassTypeId(), SoPath::getHead(), SoBase::isOfType(), and SoField::referencesCopy().

Author

Generated automatically by Doxygen for Coin from the source code.