# 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.