ONLINE HELP
 WINDEVWEBDEV AND WINDEV MOBILE

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
WindowsLinuxJavaReports and QueriesUser code (UMC)
WEBDEV
WindowsLinuxPHPWEBDEV - Browser code
WINDEV Mobile
AndroidAndroid Widget iPhone/iPadIOS WidgetApple WatchMac Catalyst
Others
Stored procedures
Identifies the color of a pixel found:
  • in an Image control,
  • in a variable of type Image.
// 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
AndroidiPhone/iPadIOS WidgetMac Catalyst 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.
  • AndroidiPhone/iPadIOS WidgetMac Catalyst 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
Minimum version required
  • Version 9
This page is also available for…
Comments
Click [Add] to post a comment

Last update: 05/30/2025

Send a report | Local help