---

PgSetDrawBufferSize(), PgSetDrawBufferSizeCx()

Resize a draw buffer

Synopsis:

int PgSetDrawBufferSize(
        unsigned short cmd_buf_len );

int PgSetDrawBufferSizeCx(
        void *dc,
        unsigned short cmd_buf_len );

Library:

ph

Description:

These functions resize the current draw buffer. The default size, allocated with every PhAttach(), is at least 4K. If cmd_buf_len is less than 1K, then 4K is allocated. The draw buffer stores all drawing data except for data stored in shared memory.

If the draw buffer contains unflushed data when these functions are called, the function will flush the data before reallocating the buffer.

PgSetDrawBufferSize() works on the current draw context, while you can specify the draw context dc for PgSetDrawBufferSizeCx().

Returns:

0

Success.

-1

An error occurred.

Examples:

// Allocate a 16K draw buffer
PgSetDrawBufferSize( 16 * 1024 );

Classification:

Photon

Safety:
Interrupt handler	No
Signal handler	No
Thread	No

See also:

PgClearDrawBuffer*(), PgFlush*(), PhAttach(), PhGetMsgSize()

---