.TH "SoBase" 3 "Fri Sep 6 2024 15:32:06" "Version 4.0.3" "Coin" \" -*- nroff -*- .ad l .nh .SH NAME SoBase \- The \fBSoBase\fP class is the top-level superclass for a number of class-hierarchies\&. .SH SYNOPSIS .br .PP .PP \fR#include \fP .PP Inherited by \fBSoFieldContainer\fP, and \fBSoPath\fP\&. .SS "Public Member Functions" .in +1c .ti -1c .RI "void \fBref\fP (void) const" .br .ti -1c .RI "void \fBunref\fP (void) const" .br .ti -1c .RI "void \fBunrefNoDelete\fP (void) const" .br .ti -1c .RI "int32_t \fBgetRefCount\fP (void) const" .br .ti -1c .RI "void \fBtouch\fP (void)" .br .ti -1c .RI "virtual \fBSoType\fP \fBgetTypeId\fP (void) const =0" .br .RI "Returns the type identification of an object derived from a class inheriting \fBSoBase\fP\&. This is used for runtime type checking and 'downward' casting\&. " .ti -1c .RI "SbBool \fBisOfType\fP (\fBSoType\fP type) const" .br .RI "Returns \fRTRUE\fP if the type of this object is either of the same type or inherited from \fItype\fP\&. " .ti -1c .RI "virtual \fBSbName\fP \fBgetName\fP (void) const" .br .ti -1c .RI "virtual void \fBsetName\fP (const \fBSbName\fP &newname)" .br .ti -1c .RI "virtual void \fBstartNotify\fP (void)" .br .ti -1c .RI "virtual void \fBnotify\fP (\fBSoNotList\fP *l)" .br .ti -1c .RI "void \fBaddAuditor\fP (void *const auditor, const \fBSoNotRec::Type\fP type)" .br .ti -1c .RI "void \fBremoveAuditor\fP (void *const auditor, const \fBSoNotRec::Type\fP type)" .br .ti -1c .RI "const \fBSoAuditorList\fP & \fBgetAuditors\fP (void) const" .br .ti -1c .RI "virtual void \fBaddWriteReference\fP (\fBSoOutput\fP *out, SbBool isfromfield=FALSE)" .br .ti -1c .RI "SbBool \fBshouldWrite\fP (void)" .br .ti -1c .RI "void \fBassertAlive\fP (void) const" .br .in -1c .SS "Static Public Member Functions" .in +1c .ti -1c .RI "static void \fBinitClass\fP (void)" .br .RI "Sets up initialization for data common to all instances of this class, like submitting necessary information to the Coin type system\&. " .ti -1c .RI "static \fBSoType\fP \fBgetClassTypeId\fP (void)" .br .RI "This static method returns the \fBSoType\fP object associated with objects of this class\&. " .ti -1c .RI "static void \fBaddName\fP (\fBSoBase\fP *const base, const char *const name)" .br .ti -1c .RI "static void \fBremoveName\fP (\fBSoBase\fP *const base, const char *const name)" .br .ti -1c .RI "static void \fBincrementCurrentWriteCounter\fP (void)" .br .ti -1c .RI "static void \fBdecrementCurrentWriteCounter\fP (void)" .br .ti -1c .RI "static \fBSoBase\fP * \fBgetNamedBase\fP (const \fBSbName\fP &name, \fBSoType\fP type)" .br .ti -1c .RI "static int \fBgetNamedBases\fP (const \fBSbName\fP &name, \fBSoBaseList\fP &baselist, \fBSoType\fP type)" .br .ti -1c .RI "static SbBool \fBread\fP (\fBSoInput\fP *input, \fBSoBase\fP *&base, \fBSoType\fP expectedtype)" .br .ti -1c .RI "static void \fBsetInstancePrefix\fP (const \fBSbString\fP &c)" .br .ti -1c .RI "static void \fBsetTraceRefs\fP (SbBool trace)" .br .ti -1c .RI "static SbBool \fBgetTraceRefs\fP (void)" .br .ti -1c .RI "static SbBool \fBconnectRoute\fP (\fBSoInput\fP *input, const \fBSbName\fP &fromnodename, const \fBSbName\fP &fromfieldname, const \fBSbName\fP &tonodename, const \fBSbName\fP &tofieldname)" .br .ti -1c .RI "static SbBool \fBreadRoute\fP (\fBSoInput\fP *input)" .br .in -1c .SS "Protected Types" .in +1c .ti -1c .RI "enum \fBBaseFlags\fP { \fBIS_ENGINE\fP = 0x01, \fBIS_GROUP\fP = 0x02 }" .br .in -1c .SS "Protected Member Functions" .in +1c .ti -1c .RI "\fBSoBase\fP (void)" .br .ti -1c .RI "virtual \fB~SoBase\fP ()" .br .ti -1c .RI "virtual void \fBdestroy\fP (void)" .br .ti -1c .RI "SbBool \fBhasMultipleWriteRefs\fP (void) const" .br .ti -1c .RI "SbBool \fBwriteHeader\fP (\fBSoOutput\fP *out, SbBool isgroup, SbBool isengine) const" .br .ti -1c .RI "void \fBwriteFooter\fP (\fBSoOutput\fP *out) const" .br .ti -1c .RI "virtual const char * \fBgetFileFormatName\fP (void) const" .br .ti -1c .RI "virtual SbBool \fBreadInstance\fP (\fBSoInput\fP *input, unsigned short flags)=0" .br .ti -1c .RI "virtual \fBSoNotRec\fP \fBcreateNotRec\fP (void)" .br .in -1c .SS "Static Protected Member Functions" .in +1c .ti -1c .RI "static uint32_t \fBgetCurrentWriteCounter\fP (void)" .br .ti -1c .RI "static void \fBstaticDataLock\fP (void)" .br .ti -1c .RI "static void \fBstaticDataUnlock\fP (void)" .br .in -1c .SH "Detailed Description" .PP The \fBSoBase\fP class is the top-level superclass for a number of class-hierarchies\&. \fBSoBase\fP 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\&. .PP One important issue with SoBase-derived classes is that they should \fInot\fP be statically allocated, neither in static module memory nor on function's stack frames\&. SoBase-derived classes must \fIalways\fP be allocated dynamically from the memory heap with the \fRnew\fP operator\&. .PP This is so because SoBase-derived instances are reference counted, and will self destruct on the appropriate time\&. For this to work, they must be explicitly allocated in heap memory\&. See the class documentation of \fBSoNode\fP for more information\&. .SH "Member Enumeration Documentation" .PP .SS "enum \fBSoBase::BaseFlags\fP\fR [protected]\fP" \fIThis API member is considered internal to the library, as it is not likely to be of interest to the application programmer\&.\fP .br .br .SH "Constructor & Destructor Documentation" .PP .SS "SoBase::SoBase (void )\fR [protected]\fP" Constructor\&. The initial reference count will be set to zero\&. .SS "SoBase::~SoBase ()\fR [protected]\fP, \fR [virtual]\fP" Destructor\&. There should not be any normal circumstance where you need to explicitly delete an object derived from the \fBSoBase\fP class, as the reference counting should take care of deallocating unused objects\&. .PP \fBSee also\fP .RS 4 \fBunref()\fP, \fBunrefNoDelete()\fP .RE .PP .SH "Member Function Documentation" .PP .SS "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 (mainly to avoid premature deletion), but is usually called from other instances within the Coin library when objects are made dependent on each other\&. .PP See the class documentation of \fBSoNode\fP for more extensive information about reference counting\&. .PP \fBSee also\fP .RS 4 \fBunref()\fP, \fBunrefNoDelete()\fP .RE .PP .SS "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 \fBref()\fP with calls to either \fBunref()\fP or \fBunrefNoDelete()\fP to avoid memory leaks\&. .PP \fBSee also\fP .RS 4 \fBref()\fP, \fBunrefNoDelete()\fP .RE .PP .SS "void SoBase::unrefNoDelete (void ) const" Decrease reference count, but do \fInot\fP delete ourself if the count reaches zero\&. .PP \fBSee also\fP .RS 4 \fBunref()\fP .RE .PP .SS "int32_t SoBase::getRefCount (void ) const" Returns number of objects referring to this object\&. .SS "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\&. .PP This is often used as an effective way of manually triggering a redraw by application programmers\&. .SS "virtual \fBSoType\fP SoBase::getTypeId (void ) const\fR [pure virtual]\fP" .PP Returns the type identification of an object derived from a class inheriting \fBSoBase\fP\&. This is used for runtime type checking and 'downward' casting\&. Usage example: .PP .PP .nf void foo(SoNode * node) { if (node\->getTypeId() == SoFile::getClassTypeId()) { SoFile * filenode = (SoFile *)node; // safe downward cast, knows the type } } .fi .PP .PP For application programmers wanting to extend the library with new nodes, engines, nodekits, draggers or others: this method needs to be overridden in \fIall\fP subclasses\&. This is typically done as part of setting up the full type system for extension classes, which is usually accomplished by using the predefined macros available through for instance \fBInventor/nodes/SoSubNode\&.h\fP (SO_NODE_INIT_CLASS and SO_NODE_CONSTRUCTOR for node classes), \fBInventor/engines/SoSubEngine\&.h\fP (for engine classes) and so on\&. .PP For more information on writing Coin extensions, see the class documentation of the top level superclasses for the various class groups\&. .PP Implemented in \fBSoAlphaTest\fP, \fBSoAnnotation\fP, \fBSoAntiSquish\fP, \fBSoAppearanceKit\fP, \fBSoArray\fP, \fBSoAsciiText\fP, \fBSoBaseColor\fP, \fBSoBaseKit\fP, \fBSoBlinker\fP, \fBSoBoolOperation\fP, \fBSoBumpMap\fP, \fBSoBumpMapCoordinate\fP, \fBSoBumpMapTransform\fP, \fBSoCacheHint\fP, \fBSoCalculator\fP, \fBSoCallback\fP, \fBSoCamera\fP, \fBSoCameraKit\fP, \fBSoCenterballDragger\fP, \fBSoCenterballManip\fP, \fBSoClipPlane\fP, \fBSoClipPlaneManip\fP, \fBSoColorIndex\fP, \fBSoComplexity\fP, \fBSoComposeMatrix\fP, \fBSoComposeRotation\fP, \fBSoComposeRotationFromTo\fP, \fBSoComposeVec2f\fP, \fBSoComposeVec3f\fP, \fBSoComposeVec4f\fP, \fBSoComputeBoundingBox\fP, \fBSoConcatenate\fP, \fBSoCone\fP, \fBSoCoordinate3\fP, \fBSoCoordinate4\fP, \fBSoCounter\fP, \fBSoCube\fP, \fBSoCylinder\fP, \fBSoDecomposeMatrix\fP, \fBSoDecomposeRotation\fP, \fBSoDecomposeVec2f\fP, \fBSoDecomposeVec3f\fP, \fBSoDecomposeVec4f\fP, \fBSoDepthBuffer\fP, \fBSoDirectionalLight\fP, \fBSoDirectionalLightDragger\fP, \fBSoDirectionalLightManip\fP, \fBSoDragger\fP, \fBSoDragPointDragger\fP, \fBSoDrawStyle\fP, \fBSoElapsedTime\fP, \fBSoEnvironment\fP, \fBSoEventCallback\fP, \fBSoExtSelection\fP, \fBSoFaceSet\fP, \fBSoFieldConverter\fP, \fBSoFile\fP, \fBSoFont\fP, \fBSoFontStyle\fP, \fBSoForeignFileKit\fP, \fBSoFragmentShader\fP, \fBSoFrustumCamera\fP, \fBSoGate\fP, \fBSoGeoCoordinate\fP, \fBSoGeoLocation\fP, \fBSoGeometryShader\fP, \fBSoGeoOrigin\fP, \fBSoGeoSeparator\fP, \fBSoGroup\fP, \fBSoHandleBoxDragger\fP, \fBSoHandleBoxManip\fP, \fBSoHeightMapToNormalMap\fP, \fBSoImage\fP, \fBSoIndexedFaceSet\fP, \fBSoIndexedLineSet\fP, \fBSoIndexedMarkerSet\fP, \fBSoIndexedNurbsCurve\fP, \fBSoIndexedNurbsSurface\fP, \fBSoIndexedPointSet\fP, \fBSoIndexedShape\fP, \fBSoIndexedTriangleStripSet\fP, \fBSoInfo\fP, \fBSoInteractionKit\fP, \fBSoInterpolate\fP, \fBSoInterpolateFloat\fP, \fBSoInterpolateRotation\fP, \fBSoInterpolateVec2f\fP, \fBSoInterpolateVec3f\fP, \fBSoInterpolateVec4f\fP, \fBSoJackDragger\fP, \fBSoJackManip\fP, \fBSoLabel\fP, \fBSoLevelOfDetail\fP, \fBSoLight\fP, \fBSoLightKit\fP, \fBSoLightModel\fP, \fBSoLinearProfile\fP, \fBSoLineSet\fP, \fBSoListener\fP, \fBSoLocateHighlight\fP, \fBSoLOD\fP, \fBSoMarkerSet\fP, \fBSoMaterial\fP, \fBSoMaterialBinding\fP, \fBSoMatrixTransform\fP, \fBSoMultipleCopy\fP, \fBSoNodeKitListPart\fP, \fBSoNodeVisualize\fP, \fBSoNonIndexedShape\fP, \fBSoNormal\fP, \fBSoNormalBinding\fP, \fBSoNurbsCurve\fP, \fBSoNurbsProfile\fP, \fBSoNurbsSurface\fP, \fBSoOneShot\fP, \fBSoOnOff\fP, \fBSoOrthographicCamera\fP, \fBSoPackedColor\fP, \fBSoPath\fP, \fBSoPathSwitch\fP, \fBSoPendulum\fP, \fBSoPerspectiveCamera\fP, \fBSoPickStyle\fP, \fBSoPointLight\fP, \fBSoPointLightDragger\fP, \fBSoPointLightManip\fP, \fBSoPointSet\fP, \fBSoPolygonOffset\fP, \fBSoProfile\fP, \fBSoProfileCoordinate2\fP, \fBSoProfileCoordinate3\fP, \fBSoProfilerOverlayKit\fP, \fBSoProfilerStats\fP, \fBSoProfilerTopEngine\fP, \fBSoProfilerTopKit\fP, \fBSoProfilerVisualizeKit\fP, \fBSoProto\fP, \fBSoProtoInstance\fP, \fBSoQuadMesh\fP, \fBSoResetTransform\fP, \fBSoReversePerspectiveCamera\fP, \fBSoRotateCylindricalDragger\fP, \fBSoRotateDiscDragger\fP, \fBSoRotateSphericalDragger\fP, \fBSoRotation\fP, \fBSoRotationXYZ\fP, \fBSoRotor\fP, \fBSoScale1Dragger\fP, \fBSoScale2Dragger\fP, \fBSoScale2UniformDragger\fP, \fBSoScale\fP, \fBSoScaleUniformDragger\fP, \fBSoSceneKit\fP, \fBSoSceneTexture2\fP, \fBSoSceneTextureCubeMap\fP, \fBSoScrollingGraphKit\fP, \fBSoSelection\fP, \fBSoSelectOne\fP, \fBSoSeparator\fP, \fBSoSeparatorKit\fP, \fBSoShaderObject\fP, \fBSoShaderParameter1f\fP, \fBSoShaderParameter1i\fP, \fBSoShaderParameter2f\fP, \fBSoShaderParameter2i\fP, \fBSoShaderParameter3f\fP, \fBSoShaderParameter3i\fP, \fBSoShaderParameter4f\fP, \fBSoShaderParameter4i\fP, \fBSoShaderParameter\fP, \fBSoShaderParameterArray1f\fP, \fBSoShaderParameterArray1i\fP, \fBSoShaderParameterArray2f\fP, \fBSoShaderParameterArray2i\fP, \fBSoShaderParameterArray3f\fP, \fBSoShaderParameterArray3i\fP, \fBSoShaderParameterArray4f\fP, \fBSoShaderParameterArray4i\fP, \fBSoShaderParameterMatrix\fP, \fBSoShaderParameterMatrixArray\fP, \fBSoShaderProgram\fP, \fBSoShaderStateMatrixParameter\fP, \fBSoShadowCulling\fP, \fBSoShadowDirectionalLight\fP, \fBSoShadowGroup\fP, \fBSoShadowSpotLight\fP, \fBSoShadowStyle\fP, \fBSoShape\fP, \fBSoShapeHints\fP, \fBSoShapeKit\fP, \fBSoShuttle\fP, \fBSoSphere\fP, \fBSoSpotLight\fP, \fBSoSpotLightDragger\fP, \fBSoSpotLightManip\fP, \fBSoSTLFileKit\fP, \fBSoSurroundScale\fP, \fBSoSwitch\fP, \fBSoTabBoxDragger\fP, \fBSoTabBoxManip\fP, \fBSoTabPlaneDragger\fP, \fBSoText2\fP, \fBSoText3\fP, \fBSoTexture2\fP, \fBSoTexture2Convert\fP, \fBSoTexture2Transform\fP, \fBSoTexture3\fP, \fBSoTexture3Transform\fP, \fBSoTexture\fP, \fBSoTextureCombine\fP, \fBSoTextureCoordinate2\fP, \fBSoTextureCoordinate3\fP, \fBSoTextureCoordinateBinding\fP, \fBSoTextureCoordinateCube\fP, \fBSoTextureCoordinateCylinder\fP, \fBSoTextureCoordinateDefault\fP, \fBSoTextureCoordinateEnvironment\fP, \fBSoTextureCoordinateFunction\fP, \fBSoTextureCoordinateNormalMap\fP, \fBSoTextureCoordinateObject\fP, \fBSoTextureCoordinatePlane\fP, \fBSoTextureCoordinateReflectionMap\fP, \fBSoTextureCoordinateSphere\fP, \fBSoTextureCubeMap\fP, \fBSoTextureMatrixTransform\fP, \fBSoTextureScalePolicy\fP, \fBSoTextureUnit\fP, \fBSoTimeCounter\fP, \fBSoTrackballDragger\fP, \fBSoTrackballManip\fP, \fBSoTransform\fP, \fBSoTransformation\fP, \fBSoTransformBoxDragger\fP, \fBSoTransformBoxManip\fP, \fBSoTransformerDragger\fP, \fBSoTransformerManip\fP, \fBSoTransformManip\fP, \fBSoTransformSeparator\fP, \fBSoTransformVec3f\fP, \fBSoTranslate1Dragger\fP, \fBSoTranslate2Dragger\fP, \fBSoTranslation\fP, \fBSoTransparencyType\fP, \fBSoTriangleStripSet\fP, \fBSoTriggerAny\fP, \fBSoUniformShaderParameter\fP, \fBSoUnits\fP, \fBSoVertexAttribute\fP, \fBSoVertexAttributeBinding\fP, \fBSoVertexProperty\fP, \fBSoVertexShader\fP, \fBSoVertexShape\fP, \fBSoVRMLAnchor\fP, \fBSoVRMLAppearance\fP, \fBSoVRMLAudioClip\fP, \fBSoVRMLBackground\fP, \fBSoVRMLBillboard\fP, \fBSoVRMLBox\fP, \fBSoVRMLCollision\fP, \fBSoVRMLColor\fP, \fBSoVRMLColorInterpolator\fP, \fBSoVRMLCone\fP, \fBSoVRMLCoordinate\fP, \fBSoVRMLCoordinateInterpolator\fP, \fBSoVRMLCylinder\fP, \fBSoVRMLCylinderSensor\fP, \fBSoVRMLDirectionalLight\fP, \fBSoVRMLDragSensor\fP, \fBSoVRMLElevationGrid\fP, \fBSoVRMLExtrusion\fP, \fBSoVRMLFog\fP, \fBSoVRMLFontStyle\fP, \fBSoVRMLGeometry\fP, \fBSoVRMLGroup\fP, \fBSoVRMLImageTexture\fP, \fBSoVRMLIndexedFaceSet\fP, \fBSoVRMLIndexedLine\fP, \fBSoVRMLIndexedLineSet\fP, \fBSoVRMLIndexedShape\fP, \fBSoVRMLInline\fP, \fBSoVRMLInterpolator\fP, \fBSoVRMLLight\fP, \fBSoVRMLLOD\fP, \fBSoVRMLMaterial\fP, \fBSoVRMLMovieTexture\fP, \fBSoVRMLNavigationInfo\fP, \fBSoVRMLNormal\fP, \fBSoVRMLNormalInterpolator\fP, \fBSoVRMLOrientationInterpolator\fP, \fBSoVRMLParent\fP, \fBSoVRMLPixelTexture\fP, \fBSoVRMLPlaneSensor\fP, \fBSoVRMLPointLight\fP, \fBSoVRMLPointSet\fP, \fBSoVRMLPositionInterpolator\fP, \fBSoVRMLProximitySensor\fP, \fBSoVRMLScalarInterpolator\fP, \fBSoVRMLScript\fP, \fBSoVRMLSensor\fP, \fBSoVRMLShape\fP, \fBSoVRMLSound\fP, \fBSoVRMLSphere\fP, \fBSoVRMLSphereSensor\fP, \fBSoVRMLSpotLight\fP, \fBSoVRMLSwitch\fP, \fBSoVRMLText\fP, \fBSoVRMLTexture\fP, \fBSoVRMLTextureCoordinate\fP, \fBSoVRMLTextureTransform\fP, \fBSoVRMLTimeSensor\fP, \fBSoVRMLTouchSensor\fP, \fBSoVRMLTransform\fP, \fBSoVRMLVertexLine\fP, \fBSoVRMLVertexPoint\fP, \fBSoVRMLVertexShape\fP, \fBSoVRMLViewpoint\fP, \fBSoVRMLVisibilitySensor\fP, \fBSoVRMLWorldInfo\fP, \fBSoWrapperKit\fP, \fBSoWWWAnchor\fP, and \fBSoWWWInline\fP\&. .SS "SbBool SoBase::isOfType (\fBSoType\fP type) const" .PP Returns \fRTRUE\fP if the type of this object is either of the same type or inherited from \fItype\fP\&. This is used for runtime type checking and 'downward' casting\&. .PP Usage example: .PP .PP .nf void foo(SoNode * node) { if (node\->isOfType(SoGroup::getClassTypeId())) { SoGroup * group = (SoGroup *)node; // safe downward cast, knows the type } } .fi .PP .SS "\fBSbName\fP SoBase::getName (void ) const\fR [virtual]\fP" Returns name of object\&. If no name has been given to this object, the returned \fBSbName\fP will contain the empty string\&. .SS "void SoBase::setName (const \fBSbName\fP & newname)\fR [virtual]\fP" Set the name of this object\&. .PP Some characters are invalid to use as parts of names for \fBSoBase\fP 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)\&. .PP Invalid characters will be automatically replaced by underscore characters\&. If the name \fIstarts\fP with an invalid character, the new name will be \fIpreceded\fP by an underscore character\&. .PP For the exact definitions of what constitutes legal and illegal characters for \fBSoBase\fP names, see the \fBSbName\fP functions listed below\&. .PP \fBSee also\fP .RS 4 \fBgetName()\fP, \fBSbName::isBaseNameStartChar()\fP, \fBSbName::isBaseNameChar()\fP .RE .PP .SS "void SoBase::addName (\fBSoBase\fP *const b, const char *const name)\fR [static]\fP" Adds a name<->object mapping to the global dictionary\&. .SS "void SoBase::removeName (\fBSoBase\fP *const base, const char *const name)\fR [static]\fP" Removes a name<->object mapping from the global dictionary\&. .SS "void SoBase::startNotify (void )\fR [virtual]\fP" This is the method which starts the notification sequence after changes\&. .PP At the end of a notification sequence, all 'immediate' sensors (i\&.e\&. sensors set up with a zero priority) are triggered\&. .PP Reimplemented in \fBSoNode\fP\&. .SS "void SoBase::notify (\fBSoNotList\fP * l)\fR [virtual]\fP" Notifies all auditors for this instance when changes are made\&. .PP Reimplemented in \fBSoAsciiText\fP, \fBSoBlinker\fP, \fBSoBumpMap\fP, \fBSoEngine\fP, \fBSoFieldContainer\fP, \fBSoImage\fP, \fBSoIndexedLineSet\fP, \fBSoIndexedPointSet\fP, \fBSoLevelOfDetail\fP, \fBSoLOD\fP, \fBSoMaterial\fP, \fBSoNode\fP, \fBSoNodeEngine\fP, \fBSoPackedColor\fP, \fBSoProfilerStats\fP, \fBSoSceneTexture2\fP, \fBSoSceneTextureCubeMap\fP, \fBSoSeparator\fP, \fBSoShadowGroup\fP, \fBSoShape\fP, \fBSoSwitch\fP, \fBSoText3\fP, \fBSoTexture2\fP, \fBSoTexture3\fP, \fBSoTextureCubeMap\fP, \fBSoVertexAttribute\fP, \fBSoVertexProperty\fP, \fBSoVertexShape\fP, \fBSoVRMLAppearance\fP, \fBSoVRMLBillboard\fP, \fBSoVRMLCollision\fP, \fBSoVRMLElevationGrid\fP, \fBSoVRMLExtrusion\fP, \fBSoVRMLGeometry\fP, \fBSoVRMLGroup\fP, \fBSoVRMLIndexedLine\fP, \fBSoVRMLIndexedLineSet\fP, \fBSoVRMLIndexedShape\fP, \fBSoVRMLLOD\fP, \fBSoVRMLParent\fP, \fBSoVRMLPixelTexture\fP, \fBSoVRMLProximitySensor\fP, \fBSoVRMLScript\fP, \fBSoVRMLShape\fP, \fBSoVRMLSwitch\fP, \fBSoVRMLText\fP, \fBSoVRMLTimeSensor\fP, \fBSoVRMLTouchSensor\fP, \fBSoVRMLTransform\fP, \fBSoVRMLVertexLine\fP, \fBSoVRMLVertexPoint\fP, and \fBSoVRMLVertexShape\fP\&. .SS "void SoBase::addAuditor (void *const auditor, const \fBSoNotRec::Type\fP type)" Add an auditor to notify whenever the object changes in any significant way\&. .PP \fBSee also\fP .RS 4 \fBremoveAuditor()\fP .RE .PP .SS "void SoBase::removeAuditor (void *const auditor, const \fBSoNotRec::Type\fP type)" Remove an auditor from the list\&. \fIauditor\fP will then no longer be notified whenever any updates are made to this object\&. .PP \fBSee also\fP .RS 4 \fBaddAuditor()\fP .RE .PP .SS "const \fBSoAuditorList\fP & SoBase::getAuditors (void ) const" Returns list of objects auditing this object\&. .PP \fBSee also\fP .RS 4 \fBaddAuditor()\fP, \fBremoveAuditor()\fP .RE .PP .SS "void SoBase::addWriteReference (\fBSoOutput\fP * out, SbBool isfromfield = \fRFALSE\fP)\fR [virtual]\fP" 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\&. .PP Reimplemented in \fBSoBaseKit\fP, \fBSoFieldContainer\fP, and \fBSoGroup\fP\&. .SS "SbBool SoBase::shouldWrite (void )" Returns \fRTRUE\fP if this object should be written out during a write action\&. Will return \fRFALSE\fP if no references to this object have been made in the scene graph\&. .PP Note that connections from the fields of field container objects is not alone a valid reason for writing out the object -- there must also be at least one reference directly from another \fBSoBase\fP (like a parent/child relationship, for instance)\&. .PP This method will return a valid result only during the second pass of write actions\&. .SS "void SoBase::incrementCurrentWriteCounter (void )\fR [static]\fP" \fIThis API member is considered internal to the library, as it is not likely to be of interest to the application programmer\&.\fP .br .br .SS "void SoBase::decrementCurrentWriteCounter (void )\fR [static]\fP" \fIThis API member is considered internal to the library, as it is not likely to be of interest to the application programmer\&.\fP .br .br .SS "\fBSoBase\fP * SoBase::getNamedBase (const \fBSbName\fP & name, \fBSoType\fP type)\fR [static]\fP" Returns the object of \fItype\fP, or derived from \fItype\fP, registered under \fIname\fP\&. If several objects have been registered under the same name with the same type, returns the \fIlast\fP one which was registered\&. .PP If no object of a valid type or subtype has been registered with the given name, returns \fRNULL\fP\&. .SS "int SoBase::getNamedBases (const \fBSbName\fP & name, \fBSoBaseList\fP & baselist, \fBSoType\fP type)\fR [static]\fP" Returns the number of objects of type \fItype\fP, or derived from \fItype\fP, registered under \fIname\fP\&. .PP All matches will also be appended to \fIbaselist\fP\&. .SS "SbBool SoBase::read (\fBSoInput\fP * in, \fBSoBase\fP *& base, \fBSoType\fP expectedtype)\fR [static]\fP" Read next \fBSoBase\fP derived instance from the \fIin\fP stream, check that it is derived from \fIexpectedtype\fP and place a pointer to the newly allocated instance in \fIbase\fP\&. .PP \fRFALSE\fP is returned on read errors, mismatch with the \fIexpectedtype\fP, or if there are attempts at referencing (through the \fRUSE\fP keyword) unknown instances\&. .PP If we return \fRTRUE\fP with \fIbase\fP equal to \fRNULL\fP, three things might have happened: .PP .IP "1." 4 End-of-file\&. Use \fBSoInput::eof()\fP after calling this method to detect end-of-file conditions\&. .IP "2." 4 \fIin\fP 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 have been read\&. Check if the next character in the stream is a '}' to detect the latter case\&. .IP "3." 4 A child was given as the \fRNULL\fP keyword\&. This can happen when reading the contents of \fBSoSFNode\fP fields (note that NULL is not allowed for \fBSoMFNode\fP) .PP .PP If \fRTRUE\fP is returned and \fIbase\fP is not \fRNULL\fP upon return, the instance was allocated and initialized according to what was read from the \fIin\fP stream\&. .SS "void SoBase::setInstancePrefix (const \fBSbString\fP & c)\fR [static]\fP" Referenced instances of \fBSoBase\fP are written as 'DEF NamePrefixNumber' when exported\&. 'Name' is the name of the base instance from \fBsetName()\fP, '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\&. .PP If you want the prefix to be something else than '+', use this method\&. .SS "void SoBase::setTraceRefs (SbBool trace)\fR [static]\fP" Set to \fRTRUE\fP 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\&. .PP The reference tracing functionality will be disabled in 'release versions' of the Coin library\&. .SS "SbBool SoBase::getTraceRefs (void )\fR [static]\fP" Return the status of the reference tracing flag\&. .PP \fBSee also\fP .RS 4 \fBsetTraceRefs()\fP .RE .PP .SS "SbBool SoBase::connectRoute (\fBSoInput\fP * in, const \fBSbName\fP & fromnodename, const \fBSbName\fP & fromfieldname, const \fBSbName\fP & tonodename, const \fBSbName\fP & tofieldname)\fR [static]\fP" Connect a route from the node named \fIfromnodename's\fP field \fIfromfieldname\fP to the node named \fItonodename's\fP field \fItofieldname\fP\&. This method will consider the fields types (event in, event out, etc) when connecting\&. .PP This function is an extension for Coin, and it is not available in the original SGI Open Inventor v2\&.1 API\&. .br .PP \fBSince\fP .RS 4 Coin 2\&.0 .RE .PP .SS "void SoBase::assertAlive (void ) const" \fIThis API member is considered internal to the library, as it is not likely to be of interest to the application programmer\&.\fP .br .br 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\&. .PP This is used internally in Coin (in for instance \fBSoBase::ref()\fP) to try to detect when the instance has been prematurely destructed\&. This is a very common mistake made by application programmers (letting the refcount drop 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\&. .PP This function is an extension for Coin, and it is not available in the original SGI Open Inventor v2\&.1 API\&. .br .PP \fBSince\fP .RS 4 Coin 2\&.0 .RE .PP .SS "SbBool SoBase::readRoute (\fBSoInput\fP * in)\fR [static]\fP" \fIThis API member is considered internal to the library, as it is not likely to be of interest to the application programmer\&.\fP .br .br 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\&. .SS "void SoBase::destroy (void )\fR [protected]\fP, \fR [virtual]\fP" Cleans up all hanging references to and from this instance, and then commits suicide\&. .PP Called automatically when the reference count goes to zero\&. .PP Reimplemented in \fBSoProto\fP\&. .SS "SbBool SoBase::hasMultipleWriteRefs (void ) const\fR [protected]\fP" Returns \fRTRUE\fP 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 partially during the COUNT_REFS pass)\&. .SS "SbBool SoBase::writeHeader (\fBSoOutput\fP * out, SbBool isgroup, SbBool isengine) const\fR [protected]\fP" Write out the header of any \fBSoBase\fP derived object\&. The header consists of the \fRDEF\fP keyword and the object name (if the object has a name, otherwise these will be skipped), the class name and a left bracket\&. .PP Alternatively, the object representation may be made up of just the \fRUSE\fP keyword plus the object name, if this is the second or subsequent reference written to the file\&. .PP 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 \fRTRUE\fP, otherwise \fRFALSE\fP\&. .PP If we return \fRFALSE\fP (i\&.e\&. there's more to write), we will increment the indentation level\&. .PP \fBSee also\fP .RS 4 \fBwriteFooter()\fP, \fBSoOutput::indent()\fP .RE .PP .SS "void SoBase::writeFooter (\fBSoOutput\fP * out) const\fR [protected]\fP" This method will terminate the block representing an \fBSoBase\fP derived object\&. .SS "const char * SoBase::getFileFormatName (void ) const\fR [protected]\fP, \fR [virtual]\fP" Returns the class name this object should be written under\&. Default string returned is the name of the class from the type system\&. .PP User extensions nodes and engines override this method to return the name of the extension (instead of 'UnknownNode' or 'UnknownEngine')\&. .PP Reimplemented in \fBSoProtoInstance\fP\&. .SS "virtual SbBool SoBase::readInstance (\fBSoInput\fP * in, unsigned short flags)\fR [protected]\fP, \fR [pure virtual]\fP" This method is mainly intended for internal use during file import operations\&. .PP It reads a definition of an instance from the input stream \fIin\fP\&. The input stream state points to the start of a serialized / persistent representation of an instance of this class type\&. .PP \fRTRUE\fP or \fRFALSE\fP 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 \fRFALSE\fP\&. .PP \fIflags\fP is used internally during binary import when reading user extension nodes, group nodes or engines\&. .PP Implemented in \fBSoBaseKit\fP, \fBSoBumpMap\fP, \fBSoEngine\fP, \fBSoFieldContainer\fP, \fBSoFile\fP, \fBSoGroup\fP, \fBSoImage\fP, \fBSoInteractionKit\fP, \fBSoNode\fP, \fBSoNodeEngine\fP, \fBSoNodeKitListPart\fP, \fBSoNormalBinding\fP, \fBSoProto\fP, \fBSoProtoInstance\fP, \fBSoSeparator\fP, \fBSoShaderObject\fP, \fBSoTexture2\fP, \fBSoTexture3\fP, \fBSoTextureCoordinateBinding\fP, \fBSoTextureCubeMap\fP, \fBSoVertexAttribute\fP, \fBSoVRMLBackground\fP, \fBSoVRMLImageTexture\fP, \fBSoVRMLLOD\fP, \fBSoVRMLParent\fP, \fBSoVRMLPixelTexture\fP, \fBSoVRMLSwitch\fP, and \fBSoWWWInline\fP\&. .SS "uint32_t SoBase::getCurrentWriteCounter (void )\fR [static]\fP, \fR [protected]\fP" \fIThis API member is considered internal to the library, as it is not likely to be of interest to the application programmer\&.\fP .br .br .SS "void SoBase::staticDataLock (void )\fR [static]\fP, \fR [protected]\fP" Lock access to static data\&. .SS "void SoBase::staticDataUnlock (void )\fR [static]\fP, \fR [protected]\fP" Unlock access to static data\&. .SS "\fBSoNotRec\fP SoBase::createNotRec (void )\fR [protected]\fP, \fR [virtual]\fP" Create a record entry for notification lists\&. .PP Reimplemented in \fBSoGroup\fP\&. .SH "Author" .PP Generated automatically by Doxygen for Coin from the source code\&.