- Coordinates
- Drawing with opacity or anti-aliasing
- Using the drawing functions
- Drawing in PHP
- Drawing in Browser code
dPolygon (Function) In french: dPolygone
dStartDrawing(IMG_Drawing)
dPolygon(4, 10, 20, 20, 50, 40, 60, 50, 10, LightYellow, LightBlue)
Syntax
Building a polygon point by point Hide the details
dPolygon([<Image>, ] <Number of sides> , <X1> , <Y1> , <X2> , <Y2> [, <X3> , <Y3> [... [, <Xn> , <Yn>]]] [, <Background color> [, <Side color>]])
<Image>: Optional control name or optional Image, WDPic or picLayer variable
<Number of sides>: Integer Number of sides in the polygon (up to 23 sides). This parameter defines the number of <X>, <Y> pairs to specify in the function. <X1>: Integer X-coordinate of first point of the polygon. These coordinates are expressed in pixels. <Y1>: Integer Y-coordinate of first point of the polygon. These coordinates are expressed in pixels. <X2>: Integer X-coordinate of second point of the polygon. These coordinates are expressed in pixels. <Y2>: Integer Y-coordinate of second point of the polygon. These coordinates are expressed in pixels. <X3>: Integer X-coordinate of 3rd point of the polygon. These coordinates are expressed in pixels. <Y3>: Integer Y-coordinate of 3rd point of the polygon. These coordinates are expressed in pixels. <Xn>: Optional integer X-coordinate of nth point of the polygon. These coordinates are expressed in pixels. <Yn>: Optional integer Y-coordinate of nth point of the polygon. These coordinates are expressed in pixels. <Background color>: Integer or constant (optional) Polygon 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.
<Side color>: Integer or constant (optional) Color of polygon sides. This color can correspond to: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.
Building a polygon via an array of X and Y-coordinates Hide the details
dPolygon([<Image>, ] <Array of coordinates> [, <Background color> [, <Side color>]])
<Image>: Optional control name or optional Image, WDPic or picLayer variable
<Array of coordinates>: Array of integers or array of points - WLanguage array of integers containing the coordinates of polygon points. The even indexes represent the X-coordinates while the odd indexes represent the Y-coordinates of the points. These coordinates are expressed in pixels.
WLanguage array of Point variables containing the coordinates of the polygon points. These coordinates are expressed in pixels.
<Background color>: Integer or constant (optional) Polygon 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.
<Side color>: Integer or constant (optional) Color of polygon sides. This color can correspond to: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 Drawing a polygon:
dPolygon(5, 80, 10, 10, 150, 100, 200, 160, 80, 140, 40)
Coordinates are specified with respect to the upper-left corner of the image (coordinates: (0.0)). Important: It's not necessary to close the polygon (the coordinates of the last point don't have to be equal to the coordinates of the first point).. The polygon is automatically "closed". Limits: a polygon can have a maximum of 100,000 points in WINDEV, WEBDEV and Java, and 1,000 points in Windows CE. 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: Indicate the design destination 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:
|
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
This page is also available for…
|
|
|