<picLayer variable>.DrawChord (Function)

ONLINE HELP
WINDEV, WEBDEV AND WINDEV MOBILE

Version:

Home | Sign in | English

Help / WLanguage / WLanguage functions / Controls, pages and windows / Drawing functions

Limitations
Coordinates
Solid figure
Drawing in PHP
Drawing in Browser code

WINDEV

WEBDEV

WINDEV Mobile

Others

See also

<picLayer variable>.DrawChord (Function)

In french: <Variable picCalque>.DessineCorde

Draws the chord of a circle (intersection between an ellipse and a straight line) in a variable of type picLayer.

Example

MonImage is WDPic = "Test.gif"
MonCalque is picLayer

// Dessin dans un calque d'une corde de cercle dont le 
// fond est jaune clair et le bord bleu clair
MonCalque.DrawChord(10, 10, 50, 50, 20, 20, 40, 50, LightYellow, LightBlue)

IMG_MonDessin = MonImage

Syntax

Drawing a chord, specifying all the coordinates of the bounding rectangle Hide the details

<picLayer image>.DrawChord(<X1> , <Y1> , <X2> , <Y2> , <X3> , <Y3> , <X4> , <Y4> [, <Background color> [, <Line color>]])

<picLayer image>: picLayer variable

Name of the picLayer variable to be used.

<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.

<X3>: Integer

X-coordinate of the start point of the chord. These coordinates are expressed in pixels.

<Y3>: Integer

Y-coordinate of the start point of the chord. These coordinates are expressed in pixels.

<X4>: Integer

X-coordinate of the end point of the chord. These coordinates are expressed in pixels.

<Y4>: Integer

Y-coordinate of the end point of the chord. These coordinates are expressed in pixels.

<Background color>: Integer or constant (optional)

Background color of the chord. 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.
If this parameter is not specified, the background color:
is Transparent if has not been used beforehand,
corresponds to the color specified in the last call to <picLayer variable>.Background.

<Line color>: Integer or constant (optional)

Line color for the circle chord. 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.
If this parameter is not specified, the line color:
is Transparent if <Image>.Pen 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 <Image>.Pen.

Drawing a chord using a Rectangle variable Hide the details

<picLayer image>.DrawChord(<Rectangle> , <X3> , <Y3> , <X4> , <Y4> [, <Background color> [, <Line color>]])

<picLayer image>: picLayer variable

Name of the picLayer variable to be used.

<Rectangle>: Rectangle variable

Name of the Rectangle variable that corresponds to the rectangle containing the circle.}

<X3>: Integer

X-coordinate of the start point of the chord. These coordinates are expressed in pixels.

<Y3>: Integer

Y-coordinate of the start point of the chord. These coordinates are expressed in pixels.

<X4>: Integer

X-coordinate of the end point of the chord. These coordinates are expressed in pixels.

<Y4>: Integer

Y-coordinate of the end point of the chord. These coordinates are expressed in pixels.

<Background color>: Integer or constant (optional)

Background color of the chord. 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.
If this parameter is not specified, the background color:
is Transparent if <picLayer variable>.Background has not been used beforehand,
corresponds to the color specified in the last call to <picLayer variable>.Background.

<Line color>: Integer or constant (optional)

Line color for the circle chord. 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.
If this parameter is not specified, the line color:
is Transparent if <Image>.Pen 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 <Image>.Pen.

Remarks

Limitations

<picLayer variable>.DrawChord is not available in anti-aliasing mode (for more details, see the help about <picLayer variable>.ChangeMode).
<picLayer variable>.DrawChord is not available for a drawing with management of alpha channel (for more details, see the help about <picLayer variable>.StartDrawing). This function has no effect.

Coordinates

If the start and end points are not located on the outline of the circle (or on the outline of the ellipse), the point taken into account is the intersection between the circle and the line that joins the specified point and the center of the rectangle (which means the center of the circle).

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

Solid figure

The <picLayer variable>.DrawChord function can only be used to draw a chord: contour only or chord area.. To draw a solid figure (portion defined by the center of the circle and the two points on the circle), use <picLayer variable>.DrawSlice.

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

Component: wd300pnt.dll