PgClearDrawBuffer(), PgClearDrawBufferCx()

Reset the current draw buffer

Synopsis:

void PgClearDrawBuffer( void );

void PgClearDrawBufferCx(void *dc);

Arguments:

dc

PgClearDrawBufferCx() only. A void pointer to any type of draw context. Examples of draw contexts are:

• a PhDrawContext_t returned by PhDCCreate()
• a PmMemoryContext_t returned by PmMemCreateMC()
• a PpPrintContext_t returned by PpCreatePC()
• a PdOffscreenContext_t returned by PdCreateOffscreenContext()

Library:

ph

Description:

These functions reset the current draw buffer without flushing. PgClearDrawBuffer() works on the current draw context, while you can specify the draw context for PgClearDrawBufferCx().

Examples:

/*
 * Draw the following group of 3 lines
 */
PgDrawILine( 100, 100, 200, 300 );
PgDrawILine( 200, 300, 700, 700 );
PgDrawILine( 700, 700, 0,   0   );
PgFlush();

/*
 * Don't draw the following group of 3 lines
 */
PgDrawILine(  50, 100, 50, 300 );
PgDrawILine( 300,  20, 30, 700 );
PgDrawILine( 500, 700,  0, 100 );
PgClearDrawBuffer();
PgFlush();

Classification:

Photon

See also:

PgFlush*(), PgSetDrawBufferSize*()