ONLINE HELP
 WINDEVWEBDEV AND WINDEV MOBILE

Help / WLanguage / WLanguage functions / Controls, pages and windows / Drawing functions
  • Coordinates
  • 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
Draws a circle or an ellipse:
  • in an Image control,
  • in a variable of type Image.
// Draw a circle whose background is light yellow and 
// whose border is light blue in an Image control
dStartDrawing(IMG_Drawing)
dCircle(10, 10, 50, 50, LightYellow, LightBlue)
AndroidiPhone/iPadIOS WidgetMac Catalyst
// Draw a circle whose background is light yellow and 
// whose border is light blue in an Image control
dCircle(IMG_Drawing, 10, 10, 50, 50, LightYellow, LightBlue)
Syntax

Drawing a circle, specifying all the coordinates of the rectangle containing the circle Hide the details

dCircle([<Image>, ] <X1> , <Y1> , <X2> , <Y2> [, <Background color> [, <Line color>]])
<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, it is necessary to define the drawing destination with dStartDrawing.
<X1>: Integer
X-coordinate of the upper-left corner of the rectangle containing the circle. These coordinates are expressed in pixels.
<Y1>: Integer
Y-coordinate of the upper-left corner of the rectangle containing the circle. These coordinates are expressed in pixels.
<X2>: Integer
X-coordinate of the lower-right corner of the rectangle containing the circle. These coordinates are expressed in pixels.
<Y2>: Integer
Y-coordinate of the lower-right corner of the rectangle containing the circle. These coordinates are expressed in pixels.
<Background color>: Integer or constant (optional)
Circle background color. This color can correspond to:If this parameter is not specified, the background color:
  • is Transparent if dBackground has not been used beforehand,
  • corresponds to the color specified in the last call to dBackground.
<Line color>: Integer or constant (optional)
Color of the circle line. This color can correspond to:If this parameter is specified, the characteristics defined with dPen are ignored. The line thickness will be set to 1.
If this parameter is not specified, the line color:
  • is Transparent if dPen has not been previously used.
    For a variable of type Image, the line will be black.
  • corresponds to the color specified in the last call to dPen.
AndroidiPhone/iPadIOS WidgetMac Catalyst

Drawing a circle using a Rectangle variable Hide the details

dCircle([<Image>, ] <Rectangle> [, <Background color> [, <Line color>]])
<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, it is necessary to define the drawing destination with dStartDrawing.
<Rectangle>: Rectangle variable
Name of the Rectangle variable that corresponds to the rectangle containing the circle.
<Background color>: Integer or constant (optional)
Circle background color. This color can correspond to:If this parameter is not specified, the background color:
  • is Transparent if dBackground has not been used beforehand,
  • corresponds to the color specified in the last call to dBackground.
<Line color>: Integer or constant (optional)
Color of the circle line. This color can correspond to:If this parameter is specified, the characteristics defined with dPen are ignored. The line thickness will be set to 1.
If this parameter is not specified, the line color:
  • is Transparent if dPen has not been previously used.
    For a variable of type Image, the line will be black.
  • corresponds to the color specified in the last call to dPen.
Remarks

Coordinates

Coordinates are specified with respect to the upper-left corner of the Image control (coordinates: (0,0)).

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.
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: wd300pnt.dll
Minimum version required
  • Version 9
This page is also available for…
Comments
Click [Add] to post a comment

Last update: 05/28/2025

Send a report | Local help