Middleware, development tools, realtime operating system
software and services for superior embedded design


Home
QNX Community Resources
QNX Documentation Library
PgReadScreenSize

PgReadScreenSize

QNX Software Systems
Developer Resources
Blogs
Board support packages
Foundry27 projects
Forums
Hardware support listing
Online video tutorials
Product documentation
Technical Articles

PgReadScreenSize()

Determine the memory requirements for reading an image from the screen

Synopsis:

unsigned long PgReadScreenSize( PhRect_t *rect );

Library:

ph

Description:

This function determines how much memory is required to store an image that would be generated by a corresponding call to PgReadScreen(). This function is useful only if you plan to allocate an image storage buffer yourself.

The PhRect_t structure pointed to by rect specifies the target area (in absolute Photon coordinates).


Note: You must target this function at a specific card by calling PdSetTargetDevice(). PgReadScreenSize() blocks until the operation is complete.

Returns:

The number of bytes required to store the image, including palette data (if applicable), or 0 if an error occurred.

Errors:

See PgReadScreen().

Classification:

Photon

Safety:
Interrupt handler No
Signal handler No
Thread No

See also:

PgReadScreen(), PhRect_t