WinBinder Manual/wb create image

Syntax

int wb_create_image (int width, int height)

• Creates a true-color image measuring width by height pixels.
• The resulting image must be destroyed by a call to <winterpostwiki>wb_destroy_image</winterpostwiki>().

Syntax using additional DIB parameters

int wb_create_image (int width, int height [int dibbmi, int dibbits])

• The optional dibbmi and dibbits parameters are used together to convert an image from another format to the internal Windows bitmap representation (DIB) or to create an image from raw binary data.
• dibbmi must be a pointer to a BITMAPINFO structure with information about the DIB
• dibbits must be a pointer to the DIB color data of the bitmap, as used in the API function SetDIBits().
• For more information consult the Windows API documentation.

This feature is useful to read bitmap information from image formats that cannot be read directly by the Windows API, like PNG, JPEG, and GIF.

For example, the FreeImage library is a standalone DLL that provides a comprehensive set of image functions. This library (and other DLLs as well) can be easily integrated into WinBinder using functions wb_load_library(), wb_call_function() and wb_get_function_address(). The script freeimage.inc.php already implements some useful functions and is included in the distribution.

Example

<?

// Use the FreeImage library to display a JPEG image
// NOTE: This kind of application does not need a window handler function

include_once("../include/winbinder.php");
include_once("../include/fi/freeimage.inc.php");

// Create main window

$mainwin = wb_create_window(NULL, PopupWindow, "DIB", WBC_CENTER, WBC_CENTER, 175, 160, 0, 0);

// Perform the conversion

$filename = "../resources/cassini.jpg";
$dib = FreeImage_Load(FIF_JPEG, $filename, 0);          // Open JPEG image file
$width = FreeImage_GetWidth($dib);                      // Get its dimensions
$height = FreeImage_GetHeight($dib);
$bmp = wb_create_image($width, $height,                 // Create a WinBinder handle to it
  FreeImage_GetInfoHeader($dib),
  FreeImage_GetBits($dib));
FreeImage_Unload($dib);                                 // Release FreeImage handler

// Create control with image on it

$frame = wb_create_control($mainwin, Frame, "", 20, 20, $width, $height, 101, WBC_IMAGE);
wb_set_image($frame, $bmp);
wb_destroy_image($bmp);

wb_main_loop();

?>

See also

• <winterpostwiki>wb_destroy_image</winterpostwiki>
• <winterpostwiki>wb_get_image_data</winterpostwiki>
• <winterpostwiki>Image functions</winterpostwiki>
• <winterpostwiki>Low-Level functions</winterpostwiki>