pfuInit(3pf) OpenGL Performer 3.2.2 libpfutil Reference Pages pfuInit(3pf)NAME
pfuInit, pfuInitClasses, pfuGetUtilDPool, pfuExitUtil, pfuDPoolSize,
pfuGetDPoolSize, pfuFindUtilDPData - Initialize and reset OpenGL
Performer utility library.
FUNCTION SPECIFICATION
#include <Performer/pfutil.h>
void pfuInit(void);
void pfuInitClasses(void);
pfDataPool * pfuGetUtilDPool(void);
void pfuExitUtil(void);
void pfuDPoolSize(long size);
long pfuGetDPoolSize();
volatile void* pfuFindUtilDPData(int id);
DESCRIPTION
pfuInit must be called before pfConfig and before making any calls to the
utility library. pfuInit initializes C++ classes internal to libpfutil
which must be done before pfConfig. It creates a pfDataPool which
libpfutil uses for multiprocess operation. The pfDataPool is created in
"/usr/tmp" or the directory specified by the environment variable,
PFTMPDIR, if it is set.
In order to change the amount of memory that pfuInit will allocate for
the libpfutil data pool, call pfuDPoolSize. pfuGetDPoolSize returns the
size of the data pool. Note that the default data pool size is optimal
for libpfutil's memory allocation. You should only use pfuDPoolSize to
increase the size of the data pool. Changes to the data pool size only
take effect when your application calls pfuInit.
pfuInitClasses is called by pfuInit to construct all C++ classes defined
in the utility library. It contains calls to each class'es init routine.
This routine does one-time initialization for the entire class, such as
setting the class type variable. The class constructor is used for class
object initialization.
pfuGetUtilDPool returns a pointer to the utility library pfDataPool.
pfuFindUtilDPData returns a pointer to the block of memory identified by
id in the utility library pfDataPool or NULL if id is not found.
pfuExitUtil removes the utility library pfDataPool from the file system.
Page 1
pfuInit(3pf) OpenGL Performer 3.2.2 libpfutil Reference Pages pfuInit(3pf)NOTES
If a calling program exits abnormally, the pfDataPool will not be
deleted.
The libpfutil source code, object code and documentation are provided as
unsupported software. Routines are subject to change in future releases.
pfuInitUtil has been obsoleted by pfuInit. pfuInitUtil is provided as a
macro to pfuInit for compatibility.
SEE ALSO
pfDataPool
Page 2
