Coin Logo Coin3D is Free Software,
published under the BSD 3-clause license.
https://bitbucket.org/Coin3D/
http://www.kongsberg.com/kogt/
SoBase Class Referenceabstract

The SoBase class is the top-level superclass for a number of class-hierarchies. More...

#include <Inventor/misc/SoBase.h>

Inheritance diagram for SoBase:
SoFieldContainer SoPath SoEngine SoNode SoFullPath SoNodeKitPath SoBoolOperation SoCalculator SoComposeMatrix SoComposeRotation SoComposeRotationFromTo SoComposeVec2f SoComposeVec3f SoComposeVec4f SoComputeBoundingBox SoConcatenate SoCounter SoDecomposeMatrix SoDecomposeRotation SoDecomposeVec2f SoDecomposeVec3f SoDecomposeVec4f SoElapsedTime SoFieldConverter SoGate SoInterpolate SoOneShot SoOnOff SoProfilerTopEngine SoSelectOne SoTexture2Convert SoTimeCounter SoTransformVec3f SoTriggerAny SoAlphaTest SoBaseColor SoBaseKit SoBumpMap SoBumpMapCoordinate SoBumpMapTransform SoCacheHint SoCallback SoCamera SoClipPlane SoColorIndex SoComplexity SoCoordinate3 SoCoordinate4 SoDepthBuffer SoDrawStyle SoEnvironment SoEventCallback SoFile SoFont SoGeoCoordinate SoGeoOrigin SoGroup SoInfo SoLabel SoLight SoLightModel SoListener SoMaterial SoMaterialBinding SoNodeEngine SoNodeKitListPart SoNormal SoNormalBinding SoPackedColor SoPickStyle SoPolygonOffset SoProfile SoProfileCoordinate2 SoProfileCoordinate3 SoProfilerStats SoProto SoProtoInstance SoSceneTexture2 SoSceneTextureCubeMap SoShaderObject SoShaderParameter SoShaderProgram SoShadowCulling SoShadowStyle SoShape SoShapeHints SoTexture SoTexture2Transform SoTexture3Transform SoTextureCombine SoTextureCoordinate2 SoTextureCoordinate3 SoTextureCoordinateBinding SoTextureCoordinateCube SoTextureCoordinateCylinder SoTextureCoordinateFunction SoTextureCoordinateSphere SoTextureMatrixTransform SoTextureScalePolicy SoTextureUnit SoTransformation SoTransparencyType SoVertexAttribute SoVertexAttributeBinding SoVertexProperty SoVRMLAppearance SoVRMLAudioClip SoVRMLBackground SoVRMLColor SoVRMLCoordinate SoVRMLFog SoVRMLFontStyle SoVRMLInline SoVRMLLight SoVRMLMaterial SoVRMLNavigationInfo SoVRMLNormal SoVRMLProximitySensor SoVRMLScript SoVRMLSensor SoVRMLShape SoVRMLSound SoVRMLTexture SoVRMLTextureCoordinate SoVRMLTextureTransform SoVRMLTouchSensor SoVRMLViewpoint SoVRMLVisibilitySensor SoVRMLWorldInfo SoWWWInline SoTempPath

Public Member Functions

void ref (void) const
 
void unref (void) const
 
void unrefNoDelete (void) const
 
int32_t getRefCount (void) const
 
void touch (void)
 
virtual SoType getTypeId (void) const =0
 Returns the type identification of an object derived from a class inheriting SoBase. This is used for run-time type checking and "downward" casting. More...
 
SbBool isOfType (SoType type) const
 Returns TRUE if the type of this object is either of the same type or inherited from type. More...
 
virtual SbName getName (void) const
 
virtual void setName (const SbName &newname)
 
virtual void startNotify (void)
 
virtual void notify (SoNotList *l)
 
void addAuditor (void *const auditor, const SoNotRec::Type type)
 
void removeAuditor (void *const auditor, const SoNotRec::Type type)
 
const SoAuditorListgetAuditors (void) const
 
virtual void addWriteReference (SoOutput *out, SbBool isfromfield=FALSE)
 
SbBool shouldWrite (void)
 
void assertAlive (void) const
 

Static Public Member Functions

static void initClass (void)
 Sets up initialization for data common to all instances of this class, like submitting necessary information to the Coin type system.
 
static SoType getClassTypeId (void)
 This static method returns the SoType object associated with objects of this class.
 
static void addName (SoBase *const base, const char *const name)
 
static void removeName (SoBase *const base, const char *const name)
 
static void incrementCurrentWriteCounter (void)
 
static void decrementCurrentWriteCounter (void)
 
static SoBasegetNamedBase (const SbName &name, SoType type)
 
static int getNamedBases (const SbName &name, SoBaseList &baselist, SoType type)
 
static SbBool read (SoInput *input, SoBase *&base, SoType expectedtype)
 
static void setInstancePrefix (const SbString &c)
 
static void setTraceRefs (SbBool trace)
 
static SbBool getTraceRefs (void)
 
static SbBool connectRoute (SoInput *input, const SbName &fromnodename, const SbName &fromfieldname, const SbName &tonodename, const SbName &tofieldname)
 
static SbBool readRoute (SoInput *input)
 

Protected Types

enum  BaseFlags { IS_ENGINE = 0x01, IS_GROUP = 0x02 }
 

Protected Member Functions

 SoBase (void)
 
virtual ~SoBase ()
 
virtual void destroy (void)
 
SbBool hasMultipleWriteRefs (void) const
 
SbBool writeHeader (SoOutput *out, SbBool isgroup, SbBool isengine) const
 
void writeFooter (SoOutput *out) const
 
virtual const char * getFileFormatName (void) const
 
virtual SbBool readInstance (SoInput *input, unsigned short flags)=0
 
virtual SoNotRec createNotRec (void)
 

Static Protected Member Functions

static uint32_t getCurrentWriteCounter (void)
 
static void staticDataLock (void)
 
static void staticDataUnlock (void)
 

Detailed Description

The SoBase class is the top-level superclass for a number of class-hierarchies.

SoBase provides the basic interfaces and methods for doing reference counting, type identification and import/export. All classes in Coin which uses these mechanisms are descendent from this class.

One important issue with SoBase-derived classes is that they should not be statically allocated, neither in static module memory nor on function's stack-frames. SoBase-derived classes must always be allocated dynamically from the memory heap with the new operator.

This is so because SoBase-derived instances are reference counted, and will self-destruct on the approriate time. For this to work, they must be explicitly allocated in heap-memory. See the class documentation of SoNode for more information.

Member Enumeration Documentation

◆ BaseFlags

enum SoBase::BaseFlags
protected

This API member is considered internal to the library, as it is not likely to be of interest to the application programmer.

Constructor & Destructor Documentation

◆ SoBase()

SoBase::SoBase ( void  )
protected

Constructor. The initial reference count will be set to zero.

◆ ~SoBase()

SoBase::~SoBase ( )
protectedvirtual

Destructor. There should not be any normal circumstance where you need to explicitly delete an object derived from the SoBase class, as the reference counting should take care of deallocating unused objects.

See also
unref(), unrefNoDelete()

Member Function Documentation

◆ ref()

void SoBase::ref ( void  ) const

Increase the reference count of the object. This might be necessary to do explicitly from user code for certain situations (chiefly to avoid premature deletion), but is usually called from other instances within the Coin library when objects are made dependent on each other.

See the class documentation of SoNode for more extensive information about reference counting.

See also
unref(), unrefNoDelete()

◆ unref()

void SoBase::unref ( void  ) const

Decrease the reference count of an object. If the reference count reaches zero, the object will delete itself. Be careful when explicitly calling this method, beware that you usually need to match user level calls to ref() with calls to either unref() or unrefNoDelete() to avoid memory leaks.

See also
ref(), unrefNoDelete()

◆ unrefNoDelete()

void SoBase::unrefNoDelete ( void  ) const

Decrease reference count, but do not delete ourself if the count reaches zero.

See also
unref()

◆ getRefCount()

int32_t SoBase::getRefCount ( void  ) const

Returns number of objects referring to this object.

◆ touch()

void SoBase::touch ( void  )

Force an update, in the sense that all objects connected to this object as an auditor will have to re-check the values of their inter-dependent data.

This is often used as an effective way of manually triggering a redraw by application programmers.

◆ getTypeId()

SoType SoBase::getTypeId ( void  ) const
pure virtual

Returns the type identification of an object derived from a class inheriting SoBase. This is used for run-time type checking and "downward" casting.

Usage example:

void foo(SoNode * node)
{
if (node->getTypeId() == SoFile::getClassTypeId()) {
SoFile * filenode = (SoFile *)node; // safe downward cast, knows the type
}
}

For application programmers wanting to extend the library with new nodes, engines, nodekits, draggers or others: this method needs to be overridden in all subclasses. This is typically done as part of setting up the full type system for extension classes, which is usually accomplished by using the pre-defined macros available through for instance Inventor/nodes/SoSubNode.h (SO_NODE_INIT_CLASS and SO_NODE_CONSTRUCTOR for node classes), Inventor/engines/SoSubEngine.h (for engine classes) and so on.

For more information on writing Coin extensions, see the class documentation of the toplevel superclasses for the various class groups.

Implemented in SoShaderStateMatrixParameter, SoShaderParameterMatrixArray, SoShaderParameterMatrix, SoShaderParameterArray4i, SoShaderParameterArray4f, SoShaderParameterArray3i, SoShaderParameterArray3f, SoShaderParameterArray2i, SoShaderParameterArray2f, SoShaderParameterArray1i, SoShaderParameterArray1f, SoShaderParameter4i, SoShaderParameter4f, SoShaderParameter3i, SoShaderParameter3f, SoShaderParameter2i, SoShaderParameter2f, SoShaderParameter1i, SoShaderParameter1f, SoUniformShaderParameter, SoExtSelection, SoShaderParameter, SoBaseKit, SoDragger, SoCamera, SoPath, SoWWWInline, SoProto, SoVRMLInline, SoVRMLScript, SoVRMLSwitch, SoEventCallback, SoShape, SoVertexAttribute, SoNodeVisualize, SoTrackballDragger, SoDirectionalLightManip, SoVRMLElevationGrid, SoVRMLFontStyle, SoSpotLightManip, SoInteractionKit, SoSelection, SoVertexShape, SoSTLFileKit, SoProfilerTopEngine, SoScrollingGraphKit, SoComposeMatrix, SoClipPlaneManip, SoPointLightManip, SoTransformManip, SoProtoInstance, SoShaderObject, SoShaderProgram, SoTexture2, SoWWWAnchor, SoVRMLAudioClip, SoVRMLImageTexture, SoVRMLVertexShape, SoComposeRotation, SoComposeRotationFromTo, SoComposeVec2f, SoComposeVec3f, SoComposeVec4f, SoTexture3, SoTextureCubeMap, SoVRMLAnchor, SoVRMLIndexedFaceSet, SoVRMLMovieTexture, SoVRMLViewpoint, SoProfilerStats, SoRotateSphericalDragger, SoSpotLightDragger, SoTransformerDragger, SoDecomposeMatrix, SoDecomposeVec2f, SoDecomposeVec3f, SoDecomposeVec4f, SoImage, SoSceneTexture2, SoSceneTextureCubeMap, SoText3, SoVRMLDragSensor, SoVRMLSound, SoHandleBoxDragger, SoScale2UniformDragger, SoTabPlaneDragger, SoTranslate1Dragger, SoTranslate2Dragger, SoDecomposeRotation, SoBumpMap, SoGeoCoordinate, SoGeoSeparator, SoPendulum, SoRotor, SoShuttle, SoSwitch, SoVertexProperty, SoVRMLBackground, SoVRMLBillboard, SoVRMLFog, SoVRMLIndexedLineSet, SoVRMLNavigationInfo, SoVRMLText, SoVRMLTimeSensor, SoShadowGroup, SoForeignFileKit, SoCenterballDragger, SoDirectionalLightDragger, SoJackDragger, SoRotateCylindricalDragger, SoRotateDiscDragger, SoScale1Dragger, SoScale2Dragger, SoScaleUniformDragger, SoTransformBoxDragger, SoCalculator, SoComputeBoundingBox, SoNodeKitListPart, SoCacheHint, SoFontStyle, SoGeoLocation, SoIndexedFaceSet, SoIndexedLineSet, SoIndexedTriangleStripSet, SoVRMLCollision, SoVRMLExtrusion, SoVRMLGroup, SoVRMLLOD, SoVRMLPositionInterpolator, SoProfilerTopKit, SoProfilerVisualizeKit, SoDragPointDragger, SoPointLightDragger, SoTabBoxDragger, SoElapsedTime, SoGate, SoOneShot, SoTimeCounter, SoAsciiText, SoIndexedNurbsCurve, SoIndexedNurbsSurface, SoLocateHighlight, SoMaterial, SoProfile, SoRotationXYZ, SoSeparator, SoTexture3Transform, SoTextureCoordinatePlane, SoVRMLColorInterpolator, SoVRMLMaterial, SoVRMLOrientationInterpolator, SoVRMLParent, SoVRMLProximitySensor, SoVRMLSphereSensor, SoVRMLTextureTransform, SoSelectOne, SoBlinker, SoDrawStyle, SoEnvironment, SoFile, SoGeoOrigin, SoIndexedPointSet, SoLOD, SoListener, SoNurbsCurve, SoNurbsSurface, SoSurroundScale, SoTextureCombine, SoTextureCoordinateReflectionMap, SoTransform, SoVRMLAppearance, SoVRMLColor, SoVRMLCoordinate, SoVRMLCoordinateInterpolator, SoVRMLInterpolator, SoVRMLLight, SoVRMLNormal, SoVRMLNormalInterpolator, SoVRMLPixelTexture, SoVRMLShape, SoVRMLTextureCoordinate, SoVRMLTouchSensor, SoVRMLVertexPoint, SoVRMLVisibilitySensor, SoShadowDirectionalLight, SoShadowSpotLight, SoBoolOperation, SoCounter, SoAntiSquish, SoArray, SoBumpMapTransform, SoCube, SoDepthBuffer, SoFaceSet, SoIndexedMarkerSet, SoIndexedShape, SoLevelOfDetail, SoNormal, SoPolygonOffset, SoShapeHints, SoText2, SoTexture2Transform, SoTextureCoordinateNormalMap, SoVRMLCone, SoVRMLCylinder, SoVRMLCylinderSensor, SoVRMLGeometry, SoVRMLPlaneSensor, SoVRMLPointLight, SoVRMLScalarInterpolator, SoVRMLSpotLight, SoVRMLTransform, SoVRMLVertexLine, SoVRMLWorldInfo, SoConcatenate, SoHeightMapToNormalMap, SoOnOff, SoTransformVec3f, SoTriggerAny, SoCenterballManip, SoHandleBoxManip, SoJackManip, SoTabBoxManip, SoTrackballManip, SoTransformBoxManip, SoTransformerManip, SoBaseColor, SoComplexity, SoCone, SoCoordinate3, SoCoordinate4, SoCylinder, SoGeometryShader, SoLight, SoNonIndexedShape, SoNurbsProfile, SoPackedColor, SoSpotLight, SoTextureCoordinate3, SoVRMLBox, SoVRMLDirectionalLight, SoVRMLIndexedLine, SoVRMLIndexedShape, SoVRMLPointSet, SoVRMLSphere, SoVRMLTexture, SoShadowCulling, SoShadowStyle, SoFieldConverter, SoInterpolate, SoTexture2Convert, SoSeparatorKit, SoAlphaTest, SoCallback, SoClipPlane, SoDirectionalLight, SoFont, SoFrustumCamera, SoGroup, SoLightModel, SoLineSet, SoMarkerSet, SoMaterialBinding, SoMatrixTransform, SoMultipleCopy, SoNormalBinding, SoPathSwitch, SoPickStyle, SoPointLight, SoPointSet, SoQuadMesh, SoResetTransform, SoRotation, SoScale, SoSphere, SoTextureCoordinate2, SoTextureCoordinateBinding, SoTextureCoordinateEnvironment, SoTextureCoordinateObject, SoTextureScalePolicy, SoTextureUnit, SoTranslation, SoTransparencyType, SoTriangleStripSet, SoUnits, SoVertexAttributeBinding, SoVRMLSensor, SoAppearanceKit, SoCameraKit, SoLightKit, SoSceneKit, SoAnnotation, SoBumpMapCoordinate, SoColorIndex, SoFragmentShader, SoInfo, SoLabel, SoLinearProfile, SoOrthographicCamera, SoPerspectiveCamera, SoProfileCoordinate2, SoProfileCoordinate3, SoReversePerspectiveCamera, SoTextureCoordinateDefault, SoTextureMatrixTransform, SoTransformSeparator, SoInterpolateFloat, SoInterpolateRotation, SoInterpolateVec2f, SoInterpolateVec3f, SoInterpolateVec4f, SoShapeKit, SoWrapperKit, SoTextureCoordinateCube, SoTextureCoordinateCylinder, SoTextureCoordinateFunction, SoTextureCoordinateSphere, SoTransformation, SoTexture, SoVertexShader, and SoProfilerOverlayKit.

◆ isOfType()

SbBool SoBase::isOfType ( SoType  type) const

Returns TRUE if the type of this object is either of the same type or inherited from type.

This is used for run-time type checking and "downward" casting.

Usage example:

void foo(SoNode * node)
{
if (node->isOfType(SoGroup::getClassTypeId())) {
SoGroup * group = (SoGroup *)node; // safe downward cast, knows the type
}
}

◆ getName()

SbName SoBase::getName ( void  ) const
virtual

Returns name of object. If no name has been given to this object, the returned SbName will contain the empty string.

◆ setName()

void SoBase::setName ( const SbName newname)
virtual

Set the name of this object.

Some characters are invalid to use as parts of names for SoBase derived objects, as object names needs to be consistent with the syntax of Inventor and VRML files upon file export / import operations (so one must for instance avoid using special token characters).

Invalid characters will be automatically replaced by underscore characters. If the name starts with an invalid character, the new name will be preceded by an underscore character.

For the exact definitions of what constitutes legal and illegal characters for SoBase names, see the SbName functions listed below.

See also
getName(), SbName::isBaseNameStartChar(), SbName::isBaseNameChar()

◆ addName()

void SoBase::addName ( SoBase *const  b,
const char *const  name 
)
static

Adds a name<->object mapping to the global dictionary.

◆ removeName()

void SoBase::removeName ( SoBase *const  base,
const char *const  name 
)
static

Removes a name<->object mapping from the global dictionary.

◆ startNotify()

void SoBase::startNotify ( void  )
virtual

This is the method which starts the notification sequence after changes.

At the end of a notification sequence, all "immediate" sensors (i.e. sensors set up with a zero priority) are triggered.

Reimplemented in SoNode.

◆ notify()

◆ addAuditor()

void SoBase::addAuditor ( void *const  auditor,
const SoNotRec::Type  type 
)

Add an auditor to notify whenever the object changes in any significant way.

See also
removeAuditor()

◆ removeAuditor()

void SoBase::removeAuditor ( void *const  auditor,
const SoNotRec::Type  type 
)

Remove an auditor from the list. auditor will then no longer be notified whenever any updates are made to this object.

See also
addAuditor()

◆ getAuditors()

const SoAuditorList & SoBase::getAuditors ( void  ) const

Returns list of objects auditing this object.

See also
addAuditor(), removeAuditor()

◆ addWriteReference()

void SoBase::addWriteReference ( SoOutput out,
SbBool  isfromfield = FALSE 
)
virtual

This method is used during the first write pass of a write action to count the number of references to this object in the scene graph.

Reimplemented in SoBaseKit, SoFieldContainer, and SoGroup.

◆ shouldWrite()

SbBool SoBase::shouldWrite ( void  )

Returns TRUE if this object should be written out during a write action. Will return FALSE if no references to this object has been made in the scene graph.

Note that connections from the fields of fieldcontainer objects is not alone a valid reason for writing out the object – there must also be at least one reference directly from another SoBase (like a parent/child relationship, for instance).

This method will return a valid result only during the second pass of write actions.

◆ incrementCurrentWriteCounter()

void SoBase::incrementCurrentWriteCounter ( void  )
static

This API member is considered internal to the library, as it is not likely to be of interest to the application programmer.

◆ decrementCurrentWriteCounter()

void SoBase::decrementCurrentWriteCounter ( void  )
static

This API member is considered internal to the library, as it is not likely to be of interest to the application programmer.

◆ getNamedBase()

SoBase * SoBase::getNamedBase ( const SbName name,
SoType  type 
)
static

Returns the object of type, or derived from type, registered under name. If several has been registered under the same name with the same type, returns the last one which was registered.

If no object of a valid type or subtype has been registered with the given name, returns NULL.

◆ getNamedBases()

int SoBase::getNamedBases ( const SbName name,
SoBaseList baselist,
SoType  type 
)
static

Returns the number of objects of type type, or derived from type, registered under name.

All matches will also be appended to baselist.

◆ read()

SbBool SoBase::read ( SoInput in,
SoBase *&  base,
SoType  expectedtype 
)
static

Read next SoBase derived instance from the in stream, check that it is derived from expectedtype and place a pointer to the newly allocated instance in base.

FALSE is returned on read errors, mismatch with the expectedtype, or if there are attempts at referencing (through the USE keyword) unknown instances.

If we return TRUE with base equal to NULL, three things might have happened:

  1. End-of-file. Use SoInput::eof() after calling this method to detect end-of-file conditions.
  2. in didn't have a valid identifier name at the stream for us to read. This happens either in the case of errors, or when all child nodes of a group has been read. Check if the next character in the stream is a '}' to detect the latter case.
  3. A child was given as the NULL keyword. This can happen when reading the contents of SoSFNode fields (note that NULL is not allowed for SoMFNode)

If TRUE is returned and base is not NULL upon return, the instance was allocated and initialized according to what was read from the in stream.

◆ setInstancePrefix()

void SoBase::setInstancePrefix ( const SbString c)
static

Referenced instances of SoBase are written as "DEF NamePrefixNumber" when exported. "Name" is the name of the base instance from setName(), "Prefix" is common for all objects and can be set by this method (default is "+"), and "Number" is a unique id which is necessary if multiple objects have the same name.

If you want the prefix to be something else than "+", use this method.

◆ setTraceRefs()

void SoBase::setTraceRefs ( SbBool  trace)
static

Set to TRUE to activate debugging of reference counting, which could aid in finding hard to track down problems with accesses to freed memory or memory leaks. Note: this will produce lots of debug information in any "normal" running system, so use sensibly.

The reference tracing functionality will be disabled in "release versions" of the Coin library.

◆ getTraceRefs()

SbBool SoBase::getTraceRefs ( void  )
static

Return the status of the reference tracing flag.

See also
setTraceRefs()

◆ connectRoute()

SbBool SoBase::connectRoute ( SoInput in,
const SbName fromnodename,
const SbName fromfieldname,
const SbName tonodename,
const SbName tofieldname 
)
static

Connect a route from the node named fromnodename's field fromfieldname to the node named tonodename's field tofieldname. This method will consider the fields types (event in, event out, etc) when connecting.

This function is an extension for Coin, and it is not available in the original SGI Open Inventor v2.1 API.

Since
Coin 2.0

◆ assertAlive()

void SoBase::assertAlive ( void  ) const

This API member is considered internal to the library, as it is not likely to be of interest to the application programmer.

There are 4 bits allocated for each SoBase-object for a bitpattern that indicates the object is still "alive". The pattern is changed when the object is destructed. If this method is then called after destruction, an assert will hit.

This is used internally in Coin (in for instance SoBase::ref()) to try to detect when the instance has been prematurely destructed. This is a very common mistake to make by application programmers (letting the refcount dip to zero before it should, that is), so the extra piece of assistance through the accompanying assert() in this method to detect dangling references to the object, with subsequent memory corruption and mysterious crashes, should be a Good Thing.

This function is an extension for Coin, and it is not available in the original SGI Open Inventor v2.1 API.

Since
Coin 2.0

◆ readRoute()

SbBool SoBase::readRoute ( SoInput in)
static

This API member is considered internal to the library, as it is not likely to be of interest to the application programmer.

Reads a (VRML97) ROUTE. We decided to also add support for routes in Coin, as a generic feature, since we think it is nicer than setting up field connections inside the nodes.

◆ destroy()

void SoBase::destroy ( void  )
protectedvirtual

Cleans up all hanging references to and from this instance, and then commits suicide.

Called automatically when the reference count goes to zero.

Reimplemented in SoProto.

◆ hasMultipleWriteRefs()

SbBool SoBase::hasMultipleWriteRefs ( void  ) const
protected

Returns TRUE if this object will be written more than once upon export. Note that the result from this method is only valid during the second pass of a write action (and partly during the COUNT_REFS pass).

◆ writeHeader()

SbBool SoBase::writeHeader ( SoOutput out,
SbBool  isgroup,
SbBool  isengine 
) const
protected

Write out the header of any SoBase derived object. The header consists of the DEF keyword and the object name (if the object has a name, otherwise these will be skipped), the class name and a left bracket.

Alternatively, the object representation may be made up of just the USE keyword plus the object name, if this is the second or subsequent reference written to the file.

If the object has been completed just by writing the header (which will be the case if we're writing multiple references of an object), we return TRUE, otherwise FALSE.

If we return FALSE (i.e. there's more to write), we will increment the indentation level.

See also
writeFooter(), SoOutput::indent()

◆ writeFooter()

void SoBase::writeFooter ( SoOutput out) const
protected

This method will terminate the block representing an SoBase derived object.

◆ getFileFormatName()

const char * SoBase::getFileFormatName ( void  ) const
protectedvirtual

Returns the class name this object should be written under. Default string returned is the name of the class from the type system.

User extensions nodes and engines override this method to return the name of the extension (instead of "UnknownNode" or "UnknownEngine").

Reimplemented in SoProtoInstance.

◆ readInstance()

SbBool SoBase::readInstance ( SoInput in,
unsigned short  flags 
)
protectedpure virtual

This method is mainly intended for internal use during file import operations.

It reads a definition of an instance from the input stream in. The input stream state points to the start of a serialized / persistant representation of an instance of this class type.

TRUE or FALSE is returned, depending on if the instantiation and configuration of the new object of this class type went ok or not. The import process should be robust and handle corrupted input streams by returning FALSE.

flags is used internally during binary import when reading user extension nodes, group nodes or engines.

Implemented in SoNode, SoBaseKit, SoWWWInline, SoVRMLSwitch, SoFieldContainer, SoVRMLLOD, SoInteractionKit, SoTextureCubeMap, SoNodeKitListPart, SoSeparator, SoTexture2, SoVRMLParent, SoImage, SoTexture3, SoShaderObject, SoProto, SoGroup, SoFile, SoVRMLImageTexture, SoEngine, SoProtoInstance, SoNormalBinding, SoBumpMap, SoVertexAttribute, SoTextureCoordinateBinding, SoVRMLBackground, SoNodeEngine, and SoVRMLPixelTexture.

◆ getCurrentWriteCounter()

uint32_t SoBase::getCurrentWriteCounter ( void  )
staticprotected

This API member is considered internal to the library, as it is not likely to be of interest to the application programmer.


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