# SaveBitmapToPNGFile

int SaveBitmapToPNGFile (int bitmapID, const char filename[]);

## Purpose

Saves a bitmap image to a .png file. The .png file format is the only format in which you can save alpha-channel transparency data. You also can save any mask you have applied to the bitmap. The file will retain full transparency on masked pixels.

## Parameters

Input
Name | Type | Description
bitmapID | integer | ID of the bitmap object that contains the image. Obtain the ID from NewBitmapEx, GetBitmapFromFile, GetCtrlBitmap, ClipboardGetBitmap, GetCtrlDisplayBitmap, GetPanelDisplayBitmap, GetScaledPanelDisplayBitmap, GetScaledCtrlDisplayBitmap, or DuplicateBitmap.
filename | string | Pathname of the file in which to save the image. You can use a complete pathname or a simple filename. If the name is a simple filename, the file is saved in the directory that contains the executable.

## Return Value

Name | Type | Description
status | integer | Return value indicating whether the function was successful. A negative number indicates that an error occurred.
Code | Error Message String
xx | Success