Inventor/misc/SoRefCounter.h

Go to the documentation of this file.

/*=======================================================================
 *** THE CONTENT OF THIS WORK IS PROPRIETARY TO FEI S.A.S, (FEI S.A.S.),            ***
 ***              AND IS DISTRIBUTED UNDER A LICENSE AGREEMENT.                     ***
 ***                                                                                ***
 ***  REPRODUCTION, DISCLOSURE,  OR USE,  IN WHOLE OR IN PART,  OTHER THAN AS       ***
 ***  SPECIFIED  IN THE LICENSE ARE  NOT TO BE  UNDERTAKEN  EXCEPT WITH PRIOR       ***
 ***  WRITTEN AUTHORIZATION OF FEI S.A.S.                                           ***
 ***                                                                                ***
 ***                        RESTRICTED RIGHTS LEGEND                                ***
 ***  USE, DUPLICATION, OR DISCLOSURE BY THE GOVERNMENT OF THE CONTENT OF THIS      ***
 ***  WORK OR RELATED DOCUMENTATION IS SUBJECT TO RESTRICTIONS AS SET FORTH IN      ***
 ***  SUBPARAGRAPH (C)(1) OF THE COMMERCIAL COMPUTER SOFTWARE RESTRICTED RIGHT      ***
 ***  CLAUSE  AT FAR 52.227-19  OR SUBPARAGRAPH  (C)(1)(II)  OF  THE RIGHTS IN      ***
 ***  TECHNICAL DATA AND COMPUTER SOFTWARE CLAUSE AT DFARS 52.227-7013.             ***
 ***                                                                                ***
 ***                   COPYRIGHT (C) 1996-2020 BY FEI S.A.S,                        ***
 ***                        BORDEAUX, FRANCE                                        ***
 ***                      ALL RIGHTS RESERVED                                       ***
**=======================================================================*/
/*=======================================================================
** Author      : VSG (MMM YYYY)
**=======================================================================*/

#ifndef SO_REF_COUNTER_H
#define SO_REF_COUNTER_H

#include <stdio.h>
#include <Inventor/SbBase.h>
#include <Inventor/threads/SbThreadSpinlock.h>
#include <Inventor/errors/SoDebugError.h>

class SoRefCounter;

// callback function prototypes
typedef void SoBaseRefCountCB(void *userData, const SoRefCounter *base);


class  SoRefCounter
{
public:
    void ref() const;

    void unref() const;

    void unrefNoDelete() const;

    inline int getRefCount() const
    { return m_refcount; }

    inline void lock() const
    { m_refMutex.lock(); }

    inline void unlock() const
    { m_refMutex.unlock(); }


private:
    static void initClass();

    static void exitClass();

    static void setRefCountCallback(SoBaseRefCountCB *f)
    { s_refCountCBFunc = f; }

    void setRefCountCallbackData(void *userData = NULL)
    { m_refCountCBData = userData; }

    void invokeRefCountCB() const;

    static inline void setTraceRefs(const bool enable)
    { s_traceRefs = enable; }

    static inline SbBool getTraceRefs()
    { return s_traceRefs; }

    void setRefCount(const int count);

private:
    SoRefCounter();

    SoRefCounter(const SoRefCounter &);

    SoRefCounter & operator=(const SoRefCounter &)
    { return *this; }

    virtual ~SoRefCounter();


    virtual bool notifyDelete() const
    { return true; }

    virtual void destroy()
    { delete this; }

private:
  static bool s_traceRefs;

  static SoBaseRefCountCB* s_refCountCBFunc;
  void* m_refCountCBData;

  mutable int m_refcount;
  mutable SbThreadSpinlock m_refMutex;

};

#define SO_UNREF_RESET(object)\
{\
  if ( object )\
  {\
    object->unref();\
    object=NULL;\
  }\
}

// Included here to provide this service by default everywhere SoRefCounter 
// is already used, avoiding app to add a #include <Inventor/misc/SoAutoRef.h>
#include <Inventor/misc/SoAutoRef.h>

#endif // SO_REF_COUNTER_H

---

Open Inventor Toolkit reference manual, generated on 12 Feb 2024
Copyright © Thermo Fisher Scientific All rights reserved. http://www.openinventor.com/