PDL_GetScreenMetrics

Description

Fills the passed PDL_ScreenMetrics struct (that your app has allocated) with the device's screen metrics.

For a Palm Pre it would be set like this:

outMetrics->horizontalPixels = 320; // Number of pixels horizontally
outMetrics->verticalPixels = 480;   // Number of pixels vertically
outMetrics->horizontalDPI = 213;    // Number of pixels per inch horizontally
outMetrics->verticalDPI = 183;      // Number of pixels per inch vertically
outMetrics->aspectRatio = 1.164;    // horizontalDPI/verticalDPI

Palm Pixi would return this:

outMetrics->horizontalPixels = 320;
outMetrics->verticalPixels = 400;
outMetrics->horizontalDPI = 190;
outMetrics->verticalDPI = 190;
outMetrics->aspectRatio = 1.0;

Syntax

PDL_Err PDL_GetScreenMetrics(PDL_ScreenMetrics *outMetrics);

Argument Description
outMetrics Pointer to a PDL_ScreenMetrics struct that your app has allocated.

Returns

PDL_INVALIDINPUT - outMetrics is null.
PDL_EOTHER - Device is not Pre or Pixi.
PDL_NOERROR - Success.