# Function Reference

# _WinAPI_CreateBitmap

Creates a bitmap with the specified width, height, and color format

#include <WinAPIGdi.au3>
_WinAPI_CreateBitmap ( $iWidth, $iHeight [, $iPlanes = 1 [, $iBitsPerPel = 1 [, $pBits = 0]]] )

## Parameters

$iWidth | Specifies the bitmap width, in pixels
$iHeight | Specifies the bitmap height, in pixels
$iPlanes | [optional] Specifies the number of color planes used by the device
$iBitsPerPel | [optional] Specifies the number of bits required to identify the color of a single pixel
$pBits | [optional] Pointer to an array of color data used to set the colors in a rectangle of pixels. Each scan line in the rectangle must be word aligned (scan lines that are not word aligned must be padded with zeros). If this parameter is 0, the contents of the new bitmap is undefined.

## Return Value

Success: | the handle to a bitmap.
Failure: | 0.

## See Also

Search CreateBitmap in MSDN Library.