dPixelColor (Function)

ONLINE HELP
WINDEV, WEBDEV AND WINDEV MOBILE

Version:

Home | Sign in | English

This content has been translated automatically. Click here to view the French version.

Help / WLanguage / WLanguage functions / Controls, pages and windows / Drawing functions

Coordinates
How to retrieve the components of the color?
Using the drawing functions

WINDEV

WEBDEV

WINDEV Mobile

Others

See also

dPixelColor (Function)

In french: dPixelCouleur

Identifies the color of a pixel found:

in an Image control,
in a variable of type Image.

Example

See additional examples

// Identification de la couleur du pixel (15, 25)
// sur le champ Image "IMG_Dessin"
ResCouleur = dPixelColor(IMG_Dessin, 15, 25)

Syntax

<Result> = dPixelColor([<Image>, ] <X-coordinate> , <Y-coordinate>)

<Result>: Integer

Color of the specified pixel in RGB format.
Please note: the value returned may differ depending on the display configuration (resolution, etc.).

<Image>: Optional control name or optional Image, WDPic or picLayer variable

Image to use. This image can correspond to:
the name of an Image control.
the name of a variable of type Image.
If this parameter is not specified, the image handled by dStartDrawing will be used.
This parameter is not available in a report. To specify the image to use, dStartDrawing must be used before the call to dPixelColor.

<X-coordinate>: Integer

Horizontal position of pixel to use.

<Y-coordinate>: Integer

Vertical position of pixel to use.

Remarks

Coordinates

Coordinates are given in pixels with respect to the upper-left corner of the image (coordinates: (0.0)).

To retrieve the position of a mouse click in an Image control, use MouseXPos and MouseYPos.

How to retrieve the components of the color?

To retrieve the components of the color returned by :

To get the red component, use RGBRed (or perform a division modulo 256 of <Result>),
To get the green component, use RGBGreen (or perform a division modulo 256 of <Result>/256),
To get the blue component, use RGBBlue (or perform a division modulo 256 of <Result>/256/256).

Using the drawing functions

The drawing functions can be used according to 2 methods:

Method 1: Using the dDrawingStartfunction
- dStartDrawing must be called before any other drawing function. dStartDrawing is used to define the element (Image control or variable) to which the drawing functions will be applied.
- When drawing on an Image control:
  - The drawing functions operate on a copy ("bitmap") of the image. You can use the drawing functions of Windows (via API or CallDLL32) but these functions must use the DC (Device Context) returned by dStartDrawing.
  - dEndDrawing and dStartDrawing must not be called in the same process.
    If function dEndDrawing is called in the same process as function dStartDrawing, the drawing will not appear: it will be automatically deleted.
Method 2: specify design destination directly in syntax (via parameter)
The <Image> parameter is used to specify directly the target of the drawing. dStartDrawing becomes useless. This function must be deleted.

Component: wd300obj.dll