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
  • Using the drawing functions
WINDEV
WindowsLinuxUniversal Windows 10 AppJavaReports and QueriesUser code (UMC)
WEBDEV
WindowsLinuxPHPWEBDEV - Browser code
WINDEV Mobile
AndroidAndroid Widget iPhone/iPadIOS WidgetApple WatchMac CatalystUniversal Windows 10 App
Others
Stored procedures
Draws a circle or an ellipse:
  • in an Image control,
  • in a variable of type Image.
// Dessin d'un cercle dont le fond est jaune clair et
// le bord bleu clair dans un champ Image
dStartDrawing(IMG_Dessin)
dCircle(10, 10, 50, 50, LightYellow, LightBlue)
Universal Windows 10 AppAndroidiPhone/iPadIOS WidgetMac Catalyst
// Dessin d'un cercle dont le fond est jaune clair et
// le bord bleu clair dans un champ Image
dCircle(IMG_Dessin, 10, 10, 50, 50, LightYellow, LightBlue)
Syntax

Draw 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
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.
<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 the function dPen has not been used before.
    New in version 2024
    In the case of an Variable type Image, the row will have the black Color..
  • corresponds to the color specified in the last call to dPen.
New in version 2024
Universal Windows 10 AppAndroidiPhone/iPadIOS WidgetMac Catalyst

Drawing a circle using a rectangle-type Variable Hide the details

dCircle([<Image>, ] <Rectangle> [, <Background color> [, <Line color>]])
<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.
<Rectangle>: Rectangle variable
Name of the Variable type Rectangle Receiver in which the circle is inscribed..
<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 the function dPen has not been used before.
    New in version 2024
    In the case of an Variable type Image, the row will have the black Color..
  • 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 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: wd290pnt.dll
Minimum version required
  • Version 9
This page is also available for…
Comments
Click [Add] to post a comment

Last update: 01/18/2024

Send a report | Local help