PgCreateGC()

Allocate a graphics context

Synopsis:

PhGC_t *PgCreateGC( int unused );

Arguments:

unused: PgCreateGC() doesn't use this argument; set it to 0.

Library:

ph

Description:

This function allocates a graphics context. A graphics context contains the entire draw state, including color, clipping, and current region.

Note:

If your application calls both Pg and Pt functions, you must provide one graphics context for the Pg functions and a separate context for the Pt functions. To do this, call PgSetGC() every time you switch from one API to the other.

Returns:

A pointer to a graphics context, or NULL if an error occurs.

Classification:

Photon

Safety:
Interrupt handler	No
Signal handler	No
Thread	No

See also:

PgDestroyGC(), PgSetDrawBufferSize(), PgSetGC()