dLoadImage (Function)

ONLINE HELP
FOR WINDEV, WEBDEV AND WINDEV MOBILE

Version:

Home | Sign in | English

Help

WLanguage

WLanguage functions

Controls, pages and windows

Drawing functions (Image controls and variables)

Functions for handling graphic strings

See also

dLoadImage (Function)

In french: dChargeImage

Loads an image in an Image variable from a memo, a file or a binary buffer (buffer containing the full data of a recognized image file).

Versions 18 and later

This function is now available in Windows Store apps mode.

This function is now available for Android applications.

This function is now available for the Java applications.

New in version 18

This function is now available in Windows Store apps mode.

This function is now available for Android applications.

This function is now available for the Java applications.

This function is now available in Windows Store apps mode.

This function is now available for Android applications.

This function is now available for the Java applications.

Versions 21 and later

This function is now available in Universal Windows 10 App mode.

New in version 21

This function is now available in Universal Windows 10 App mode.

Example

// Load an image from a file in the executable directory
MyImage is Image
MyImage = dLoadImage("image.png")

sPDFFileName is string = fDataDir() + fSep() + "MyFile.pdf"
// Load a vector image (here a PDF, it could be an SVG)
// Retrieve the characteristics of the image
sPDFInfo is string = BitmapInfo(sPDFFileName)
// Vector images are transformed into bitmap images (raster, therefore not vector images)
// Define the desired image resolution
nDesiredDPI is int = 300
set nPixelWidth = Val(ExtractString(sPDFInfo,2))*nDesiredPDI / 96
set nPixelHeight = Val(ExtractString(sPDFInfo,3))*nDesiredPDI / 96
// (Divided by 96 because it is the resolution used
// to define the size of a vector image with BitmapInfo)
// Load the image on the screen in an Image control with the size corresponding to the desired DPI
IMG_PDF = dLoadImage(sPDFFileName, imgConvert, nPixelWidth,nPixelHeight)
// Or if the image is not displayed, use an Image variable:
MyImage is Image = dLoadImage(sPDFFileName, imgConvert, nPixelWidth, nPixelHeight)

Syntax

<Result> = dLoadImage(<Image> [, <Options> [, <Width> [, <Height>]]])

<Result>: Image variable

Name of Image variable into which the image will be loaded.

<Image>: Character string

Image to load. This image can correspond to:
the full path of image file,
the name of an image file (if the image file is found in the executable directory),
a binary memo item found in a data file,
a binary buffer containing the full data of a recognized image file (result of a function for saving images such as dSaveImagePNG).

<Options>: Optional Integer constant

Options for loading the image:
imgConvert Convert an image from the 8-bit format to the 24-bit format. This option is used to apply the effect algorithms to this image for example. This constant can be used for the images corresponding to PDF files for example.
For the vectorial images (SVG), this constant is mandatory. It is used to specify that the image must be converted into bitmap image (raster) before it is loaded (indeed, the Image type does not support the vectorial images).
This constant is not available.
imgDefault
(Default value) Load the image as it is.

<Width>: Optional integer

Requested destination width (vectorial image only). This width is expressed in pixels.

<Height>: Optional integer

Requested destination height (vectorial image only). This height is expressed in pixels.

Component : wd240pnt.dll