SoContextHandler.3coin3 - Man Page

The SoContextHandler class is for now to be treated as an internal class.

Synopsis

#include <Inventor/misc/SoContextHandler.h>

Public Types

typedef void ContextDestructionCB(uint32_t contextid, void *userdata)

Static Public Member Functions

static void destructingContext (uint32_t contextid)
static void addContextDestructionCallback (ContextDestructionCB *func, void *closure)
static void removeContextDestructionCallback (ContextDestructionCB *func, void *closure)

Detailed Description

The SoContextHandler class is for now to be treated as an internal class.

Since

Coin 2.0

Member Function Documentation

void SoContextHandler::destructingContext (uint32_t contextid) [static]

This method must be called by client code which destructs a context, to guarantee that there are no memory leaks upon context destruction.

This will take care of correctly freeing context-bound resources, like OpenGL texture objects and display lists.

Before calling this function, the context must be made current.

Note that if you are using one of the standard GUI-binding libraries from Kongsberg Oil & Gas Technologies, this is taken care of automatically for contexts for canvases set up by SoQt, SoWin, etc.

void SoContextHandler::addContextDestructionCallback (ContextDestructionCB * func, void * closure) [static]

Add a callback which will be called every time a GL context is destructed. The callback should delete all GL resources tied to that context.

All nodes/classes that allocate GL resources should set up a callback like this. Add the callback in the constructor of the node/class, and remove it in the destructor.

See also

removeContextDestructionCallback()

void SoContextHandler::removeContextDestructionCallback (ContextDestructionCB * func, void * closure) [static]

Remove a context destruction callback.

See also

addContextDestructionCallback()

Author

Generated automatically by Doxygen for Coin from the source code.

Referenced By

The man page SoContextHandler.3coin2(3) is an alias of SoContextHandler.3coin3(3).

Mon Jan 25 2021 Version 3.1.3 Coin