BitmapInfo (Function)

ONLINE HELP
WINDEV, WEBDEV AND WINDEV MOBILE

Version:

Home | Sign in | English

Help

WLanguage

WLanguage functions

Controls, pages and windows

Drawing functions

Functions for handling graphic strings

Drawing in WINDEV, WEBDEV and WINDEV Mobile

DrawingAvailable

Functions for handling graphic strings

Various

WINDEV

WEBDEV

WINDEV Mobile

Others

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.

The PDF files are not supported.

Versions 16 and later

This function is now available for the WINDEV applications in Linux.

Caution: A specific configuration is required to use this function in Linux. See The drawings for more details.

New in version 16

This function is now available for the WINDEV applications in Linux.

Caution: A specific configuration is required to use this function in Linux. See The drawings for more details.

This function is now available for the WINDEV applications in Linux.

Caution: A specific configuration is required to use this function in Linux. See The drawings for more details.

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 stringsHeight, 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)

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)
The number of bits per pixel is always equal to 0.
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.
The PDF files are not supported.

Remarks

Various

BitmapInfo can be used with the files in PDF format.
Caution: the GDI + framework must be installed on the computer.
This feature is not available.
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.
- JPEG, PNG, GIF or BMP.

Business / UI classification : Neutral code

Component : wd260obj.dll