BitmapInfo (Function)

ONLINE HELP
WINDEV, WEBDEV AND WINDEV MOBILE

Version:

Home | Sign in | English

Help

WLanguage

WLanguage functions

Controls, pages and windows

Drawing functions

Graphic strings management functions

See also

BitmapInfo (Function)

In french: InfoBitmap

Retrieves the characteristics of an image file or the characteristics of a PDF file:

format,
width and height,
number of bits per pixel.

Versions 16 and later

This function is now available in Browser code.

This function is now available for WINDEV applications in Linux.

Caution: A specific configuration is required to use this function in Linux. For more details, see The drawings.

New in version 16

This function is now available in Browser code.

This function is now available for WINDEV applications in Linux.

Caution: A specific configuration is required to use this function in Linux. For more details, see The drawings.

This function is now available in Browser code.

This function is now available for WINDEV applications in Linux.

Caution: A specific configuration is required to use this function in Linux. For more details, see The drawings.

Versions 24 and later

This function is now available for WEBDEV sites in Linux.

New in version 24

This function is now available for WEBDEV sites in Linux.

Example

ImageInfo, Format are strings
Height, Width are int
// Retrieve the characteristics of the image
ImageInfo = BitmapInfo("C:\Windows\TILES.BMP")
// In Windows Mobile:
// ImageInfo = BitmapInfo("\Windows\TILES.BMP")
Format = ExtractString(ImageInfo, 1)
Width = Val(ExtractString(ImageInfo, 2))
Height = Val(ExtractString(ImageInfo, 3))
// Display the characteristics
Info("Format of the image: " + Format, "Width: " + Width, "Height: " + Height)

// Resize an Image control in WEBDEV
ImageInfo is string
sImagePath is string = CompleteDir(fWebDir()) + "MyImage.jpg"

ImageInfo = BitmapInfo(sImagePath)

// IMG_Image1 is an Image control
IMG_Image1..Width = Val(ExtractString(ImageInfo, 2))
IMG_Image1..Height = Val(ExtractString(ImageInfo, 3))
IMG_Image1 = "./../MyImage.jpg"

Syntax

<Result> = BitmapInfo(<Name of image file>)

<Result>: Character string

Characteristics of the image in the following format:

<Format> + TAB + <Width> + TAB + <Height> + TAB + <Bits/pixel>

<Format> Character string
Three characters are used to identify the image format: "BMP", "GIF", "PDF", ...
"BAD" if the image nameis an non-existing file or if the format is unknown
<Width> Integer Width of image in pixels.
<Height> Integer Height of image in pixels.
<Bits/pixel> Character string Number of bits per pixel:
1 (monochrome image)
4 (16-color palette)
8 (256-color palette)
24 (no palette, 16 millions of colors)
32 (no palette, true color)
If an error occurs, the following string is returned:

"BAD" + TAB + TAB + TAB

<Name of image file>: Character string (with quotes)

Name of image file or name of PDF file, including its full or relative path (up to 260 characters). A UNC path can be used.
Name of control linked to an image memo item.

Remarks

Various

BitmapInfo can be used with the files in PDF format.
Caution: the GDI + framework must be installed on the computer.
For the images in WMF or EMF format, <Bits/pixel> is equal to 0.
The following formats of image files are supported:
- All the formats described in fGraphicFilter.
- JPG, PNG, GIF, BMP. Depending on the version of the GD library, these formats may not be supported.

Pattern and PHP

In PHP, the drawing functions are based on the graphic library GD. This library is commonly used by the PHP hosting companies and therefore it is always enabled. The version of the GD library must be version 2.0.28 (or later). This library can be downloaded from the PHP site.

To enable (if necessary) this library locally, the following elements are required:

PHP installed.
the PHP.INI file found in the Windows directory must contain the following line: "extension=php_gd2.dll" (instead of ";extension=php_gd2.dll").
the php_gd2.dll file must exist in the directory of PHP extensions. This directory is defined in the PHP.INI file by the "extension_dir" variable.

Business / UI classification: Neutral code

Component: wd260obj.dll