pfInit(3pf) OpenGL Performer 3.2.2 libpf Reference Pages pfInit(3pf)NAME
pfInit, pfIsInited, pfExit - Initialize and terminate OpenGL Performer
processes.
FUNCTION SPECIFICATION
#include <Performer/pf.h>
int pfInit(void);
int pfIsInited(void);
void pfExit(void);
DESCRIPTION
pfInit initializes internal OpenGL Performer data structures and must be
the first OpenGL Performer call in an application except for the
following:
pfNotifyLevel
pfSharedArenaSize
pfSharedArenaBase
pfTmpDir
pfInit is required by all Performer applications whether they use libpf
or not. But pfInit has slightly different behavior applications that
only use libpr and do not include pf.h. for these applications, pfInit
does not set up any shared memory arenas. If shared memory is required,
it should be explicitly set up by calling pfInitArenas before pfInit.
pfInit returns a value of 1 if successful and -1 if an error is detected.
pfIsInited returns a value of 1 if pfInit has successfully been called
and 0 otherwise.
pfExit closes graphics windows, frees all OpenGL Performer data
structures, deletes all OpenGL Performer shared memory arenas (see
pfGetSharedArena), kills all spawned OpenGL Performer processes, then
returns control to the application. pfExit also turns off the video
retrace clock (see pfVClock). After calling pfExit an application may
restart OpenGL Performer with pfInit.
User processes forked or sproced after pfConfig will be terminated by
pfExit. Those forked or sproced before pfConfig will be sent a SIGCLD
signal.
NOTES
Since pfExit deletes all shared memory arenas, any memory used by the
application that was created out of OpenGL Performer shared memory is now
invalid.
Page 1
pfInit(3pf) OpenGL Performer 3.2.2 libpf Reference Pages pfInit(3pf)BUGS
Currently pfExit returns directly to the operating system, terminating
the simulation application as well. However, it does turn off video
retrace CPU interrupts while exiting (see pfVClock).
SEE ALSO
pfConfig, pfGetSharedArena, pfMalloc, pfVClock
Page 2
