PmMemStart()

Make a memory context active

Synopsis:

#include <photon/PhRender.h>

PhDrawContext_t * PmMemStart( 
                      PmMemoryContext_t *mc );

Library:

ph

Description:

This function makes the provided memory context mc active. That is, from this point until the memory context is deactivated, everything drawn becomes part of the memory image.

All subsequent Photon draw commands are routed through this memory context until:

• the memory context is made inactive by a call to PmMemStop() or PmMemReleaseMC()

  Or

• a different memory, print, or draw context is made active. In this case, the memory context is automatically deactivated as if PmMemStop() had been called

Returns:

A pointer to the previously active draw context, or NULL if the provided context couldn't be made active -- see errno for details.

Errors:

ENOMEM

There wasn't enough memory for the context's work buffers.

Examples:

See PmMemCreateMC().

Classification:

Photon

See also:

PmMemCreateMC(), PmMemReleaseMC(), PmMemStop()

"Flickerless animation" in the Raw Drawing and Animation chapter of the Photon Programmer's Guide