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

<Image>.DrawChord (Function)

In french: <Image>.DessineCorde

Draws the chord of a circle (intersection between an ellipse and a straight line) in an Image control.

Caution: A specific configuration is required to use this function in Linux. For more details, see The drawings.

Example

// In an Image control, draw the chord of a circle whose 
// background is light yellow and whose border is light blue
IMG_Drawing.DrawChord(10, 10, 50, 50, 20, 20, 40, 50, LightYellow, LightBlue)

Syntax

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

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

<Image control>: Control name

Name of the Image control 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 <Image>.Background has not been used beforehand,
corresponds to the color specified in the last call to <Image>.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

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

<Image control>: Control name

Name of the Image control 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 <Image>.Background has not been used beforehand,
corresponds to the color specified in the last call to <Image>.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

<Image>.DrawChord is not available in anti-aliasing mode (for more details, see the help about <Image>.ChangeMode).
<Image>.DrawChord is not available for a drawing with management of alpha channel (for more details, see the help about <Image>.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).

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

Solid figure

<Image>.DrawChord can only be used to draw a chord: outline 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 <Image>.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