Help / WLanguage / WLanguage functions / Controls, pages and windows / Drawing functions
  • Using the drawing functions
WindowsLinuxUniversal Windows 10 AppJavaReports and QueriesUser code (UMC)
WindowsLinuxPHPWEBDEV - Browser code
AndroidAndroid Widget iPhone/iPadIOS WidgetApple WatchMac CatalystUniversal Windows 10 App
Stored procedures
Declares the default color and style for the lines, rectangles, circles, ... found:
  • in an Image control,
  • in a variable of type Image.
// Initialize the drawing in an Image control
// Declare the default color and style for the different lines
dPen(LightGreen, 3)
Universal Windows 10 AppiPhone/iPadIOS WidgetMac Catalyst
// Declare the default color and style for the different lines
dPen(IMG_Drawing, LightGreen, 3)
dPen([<Image>, ] <Color> [, <Line style> [, <Line thickness> [, <Opacity>]]])
<Image>: Optional control name or optional Image, WDPic or picLayer variable
Universal Windows 10 AppAndroidiPhone/iPadIOS WidgetMac Catalyst Image to use. The image can correspond to:
  • the name of an Image control.
  • the name of a variable of type Image.
If this parameter is not specified, it is necessary to define the drawing destination with dStartDrawing.
<Color>: Integer or constant
Default color for the different lines. This color can correspond to:
  • an RGB color (returned by RGB),
  • an HSL color (returned by HSL),
  • a WLanguage preset color.
  • a variable of type Color. In this case, the opacity specified in the variable is taken into account.
<Line style>: Optional integer
Default style for the different lines:
  • 0 (by default): Solid line
  • 1: Dash (---)
  • 2: Dotted line (...)
  • 3: Dot and dash (-.-.-)
  • 4: Dash and two dots (-..-..-)
  • 5: Invisible line
<Line thickness>: Optional integer
Thickness of the line in pixels (1 by default).
<Opacity>: Optional integer
Opacity of color, included between 0 (transparent) and 255 (opaque). An opacity set to 128 is used to blend 50% of the color with the existing color found in the control.
  • This opacity will be taken into account if the drawing in the Image control has been initialized with the dWithOpacity constant (dStartDrawing).
  • If the <Color> parameter corresponds to a variable of type Color, this parameter must not be specified: the opacity specified in the variable will be taken into account.

Using the drawing functions

The drawing functions can be used according to 2 methods:
  • Method 1: Using dStartDrawing
    • 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.
        The drawing will not be displayed if dEndDrawing and dStartDrawing are called in the same process: it will be automatically erased.
  • Universal Windows 10 AppAndroidiPhone/iPadIOS WidgetMac Catalyst Method 2: indicating the drawing target directly in the syntax (via a parameter)
    The <Image> parameter is used to specify directly the target of the drawing. dStartDrawing becomes useless. This function must be deleted.
Related Examples:
The drawing functions Unit examples (WINDEV): The drawing functions
[ + ] Using the main drawing functions of WINDEV to:
- Initialize an Image control for drawing
- Draw simple shapes
- Write a text into a drawing
- Change the color in a drawing
Business / UI classification: Neutral code
Component: wd280pnt.dll
Minimum version required
  • Version 9
This page is also available for…
Click [Add] to post a comment

Last update: 06/22/2023

Send a report | Local help