dCopyBlt (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

Drawing in Browser code

See also

dCopyBlt (Function)

In french: dCopieImage

Warning
From version 18, this function is kept for backward compatibility for most of the platforms. It is recommended to use dCopy. Indeed:

dCopy manages transparency,
the different copy modes of dCopyBlt are replaced with:
- functions applicable to the Image type (dEncrustColor, dInvertColor, etc.),
- access to pixels.

Copies an image:

from an Image control to another Image control.
in a variable of type Image.
This type of variable is not available.

Versions 16 and later

This function is now available for Android applications.

This function is now available in Browser code.

New in version 16

This function is now available for Android applications.

This function is now available in Browser code.

This function is now available for Android applications.

This function is now available in Browser code.

Versions 18 and later

This function is now available in Windows Store apps mode.

This function is now available for iPhone/iPad applications.

Only the first syntax can be used with the Image type.

New in version 18

This function is now available in Windows Store apps mode.

This function is now available for iPhone/iPad applications.

Only the first syntax can be used with the Image type.

This function is now available in Windows Store apps mode.

This function is now available for iPhone/iPad applications.

Only the first syntax can be used with the Image type.

Example

// Simple copy of content from the "IMG_ImageDrawing" control
// into the "IMG_ImageCopy" Image control
ResCopy = dCopyBlt(IMG_ImageDrawing, IMG_ImageCopy)

// Copy the image of the screen into an Image control
dCopyBlt(copyScreen, IMG_MyImage)

Syntax

Copying images from Image controls Hide the details

<Result> = dCopyBlt(<Source image control> , <Destination Image control> [, <Copy mode> [, <Source image X-coordinate> [, <Source image Y-coordinate> [, <Source image height> [, <Source image width> [, <Destination image X-coordinate> [, <Destination image Y-coordinate> [, <Destination image height> [, <Destination image width>]]]]]]]]])

<Result>: Boolean

True if the image was copied,
False otherwise.
Remark: dCopyBlt can return False if the screen driver does not support this function. In this case, a message is displayed in the copied image. We recommend that you update your screen driver in order to get the proper behavior.

<Source image control>: Control name

Name of the source Image control to be used.
To take a screenshot, use the copyScreen constant: the entire screen content is copied.
The copyScreen constant is not available. The image to copy must necessarily be found in an Image control and it must be a generated image.
The copyScreen constant is not available.
Versions 18 and later
This parameter can correspond to:
the name of an Image control,
the name of a variable of type Image.
New in version 18
This parameter can correspond to:
the name of an Image control,
the name of a variable of type Image.
This parameter can correspond to:
the name of an Image control,
the name of a variable of type Image.

<Destination Image control>: Control name

Name of the destination Image control the image will be copied to.
Versions 18 and later
This parameter can correspond to:
the name of an Image control,
the name of a variable of type Image.
New in version 18
This parameter can correspond to:
the name of an Image control,
the name of a variable of type Image.
This parameter can correspond to:
the name of an Image control,
the name of a variable of type Image.
The destination Image control must contain a generated image.

<Copy mode>: Optional constant

Copy mode to be used.
copyBlackness Fills the destination Image control with black.
This constant is not available.
copyDstInvert Inverts the colors of the destination Image control.
This constant is not available.
copyImage Combines the source image with the destination image using the transparency information of the destination image
Can be used to include a logo in the destination image for example.
Remark: The size and position in the source are ignored. No homothety and no zoom are allowed in this mode.
This constant is not available.
copyMergeCopy Merges the source Image control and the destination Image control.
This constant is not available.
copyMergePaint Combines the source Image control with the "pattern" of the destination Image control via the "Logical AND" method.
This constant is not available.
copyNotSrcCopy Inverts the colors of the source Image control.
This constant is not available.
copyNotSrcErase Inverts the combination between the source and the destination Image controls via the "OR" method.
This constant is not available.
copyPatCopy Copies the "pattern" from the source Image control to the destination Image control.
This constant is not available.
copyPatInvert Combines the pattern of the source and destination Image controls via the "XOR" (Exclusive Or) method. The current brush, defined by dBackground, is used.
This constant is not available.
copyPatPaint Combines the inverted source Image control with the "pattern" of the destination Image control via the "OR" method.
This constant is not available.
copySrcAnd Combines the pixels of the source and destination Image controls via the "AND" method.
This constant is not available.
copySrcCopy
(Default value) Copies the source Image control to the destination Image control (simple copy).
copySrcErase Inverts the destination Image control and combines the result with the copy of the source Image control.
This constant is not available.
copySrcInvert Combines the pixels of the source and destination Image controls via the "XOR" (Exclusive Or) method.
This constant is not available.
copySrcPaint Combines the pixels of the source and destination Image controls via the "OR" method.
This constant is not available.
copyWhiteness Fills the destination Image control with white.
This constant is not available.

<Source image X-coordinate>: Optional integer

X-coordinate (in pixels) of the upper-left corner of the area to copy (upper-left corner of the source Image control by default).

<Source image Y-coordinate>: Optional integer

Y-coordinate (in pixels) of the upper-left corner of the area to copy (upper-left corner of the source Image control by default).

<Source image height>: Optional integer

Height (in pixels) of the area to copy (height of the source Image control by default).

<Source image width>: Optional integer

Width (in pixels) of the area to copy (width of the source Image control by default).

<Destination image X-coordinate>: Optional integer

X-coordinate (in pixels) of the upper-left corner of the copy destination area (upper-left corner of the destination Image control by default).

<Destination image Y-coordinate>: Optional integer

Y-coordinate (in pixels) of the upper-left corner of the copy destination area (upper-left corner of the destination Image control by default).

<Destination image height>: Optional integer

Height (in pixels) of the area the image will be copied to (height of the destination Image control by default). If this height is greater than the height of the source image, the image will be enlarged when copied.

<Destination image width>: Optional integer

Width (in pixels) of the area the image will be copied to (width of the destination Image control by default). If this width is greater than the width of the source image, the image will be enlarged when copied.

Copying the images found in the Image variables Hide the details

<Result> = dCopyBlt(<Source image name> , <Destination image name> [, <Source image X-coordinate> [, <Source image Y-coordinate> [, <Source image height> [, <Source image width> [, <Destination image X-coordinate> [, <Destination image Y-coordinate> [, <Destination image height> [, <Destination image width>]]]]]]]])

<Result>: Boolean

True if the image was copied,
False otherwise.
Remark: dCopyBlt can return False if the screen driver does not support this function. In this case, a message is displayed in the copied image. We recommend that you update your screen driver in order to get the proper behavior.

<Source image name>: Image variable

Name of the Image variable to be used. This image is the source image.

<Destination image name>: Image variable

Name of the Image variable the image will be copied to.

<Source image X-coordinate>: Optional integer

X-coordinate (in pixels) of the upper-left corner of the area to copy (upper-left corner of the source image by default).

<Source image Y-coordinate>: Optional integer

Y-coordinate (in pixels) of the upper-left corner of the area to copy (upper-left corner of the source image by default).

<Source image height>: Optional integer

Height (in pixels) of the area to copy (height of the source image by default).

<Source image width>: Optional integer

Width (in pixels) of the area to copy (width of the source image by default).

<Destination image X-coordinate>: Optional integer

X-coordinate (in pixels) of the upper-left corner of the copy destination area (upper-left corner of the destination image by default).

<Destination image Y-coordinate>: Optional integer

Y-coordinate (in pixels) of the upper-left corner of the copy destination area (upper-left corner of the destination image by default).

<Destination image height>: Optional integer

Height (in pixels) of the area the image will be copied to (height of the destination image by default). If this height is greater than the height of the source image, the image will be enlarged when copied.

<Destination image width>: Optional integer

Width (in pixels) of the area the image will be copied to (width of the destination image by default). If this width is greater than the width of the source image, the image will be enlarged when copied.

Remarks

Zoom on an image

During a copy, you can enlarge or reduce a section of the source image when copying it to the destination image. To do so:

Define the area to enlarge (or reduce) in the source image (with the <Source image X-coordinate>, <Source image Y-coordinate>, <Source image height> and <Source image width> parameters),
Define the display area of the result image. This area must be larger to enlarge the image and smaller to reduce the image. By default, the entire destination image is taken into account. Use <Destination image X-coordinate>, <Destination image Y-coordinate>, <Destination image height> and <Destination image width> if necessary.

The zoom percentage depends on the multiplying coefficient between the dimensions of the two areas.

For example:


1. The area to zoom is included in a rectangle whose width is et to 30 pixels and whose height is set to 40 pixels.	2. To perform a 200% zoom, the destination area must be twice the size of the source area: rectangle whose width is set to 60 pixels and whose height is set to 80 pixels.

In this case, the following line of code is used to perform the zoom operation during the copy:

dCopyBlt(IMG_SourceControl, IMG_DestinationControl, copySrcCopy, 10, 10, 30, 40, 10, 10, 60, 80)

Drawing in 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.

Versions 16 and later

Drawing in Browser code

Some drawing functions are available in Browser code. The drawing functions in Browser code are based on the HTML 5 standard. More specifically, these functions are based on the "canvas" tag of HTML 5.

The drawing features in browser code are available for the recent browsers only (supporting the HTML 5 standard). To find out whether the drawing features are proposed by your browser, use DrawingAvailable.

Caution: To use the drawing functions with Internet Explorer 9, the project must include the reference to the DTD file. To do so, the HTML mode must be "HTML 4.01 Transitional + DTD". This option is available in the "Advanced" tab of the description window of project.
Reminder: To open the project description window, go to the "Project" tab, "Project" group and click "Description".

Special case: Drawing in the browser of an Android phone: The browser drawing functions are only available starting with version 3 of Android.

New in version 16

Drawing in Browser code

Special case: Drawing in the browser of an Android phone: The browser drawing functions are only available starting with version 3 of Android.

Drawing in Browser code

Special case: Drawing in the browser of an Android phone: The browser drawing functions are only available starting with version 3 of Android.

Component: wd270obj.dll