<picLayer variable>.DrawChord (Function)

ONLINE HELP
WINDEV, WEBDEV AND WINDEV MOBILE

Version:

Home | Sign in | English

Limits
Coordinates
Solid figure
Pattern and PHP
Drawing in Browser code

WINDEV

WEBDEV

WINDEV Mobile

Others

See also

<picLayer variable>.DrawChord (Function)

In french: <Variable picCalque>.DessineCorde

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

Versions 15 and later

This function is now available for WEBDEV sites in Linux.

New in version 15

This function is now available for WEBDEV sites in Linux.

Example

MyImage is WDPic = "Test.gif"
MyLayer is picLayer

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

IMG_MyDrawing = MyImage

Syntax

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

<X1>: Integer

X coordinate of top left corner of the rectangle containing the circle. These coordinates are expressed in pixels.

<Y1>: Integer

Y coordinate of top left corner of the rectangle containing the circle. These coordinates are expressed in pixels.

<X2>: Integer

X coordinate of bottom right corner of the rectangle containing the circle. These coordinates are expressed in pixels.

<Y2>: Integer

Y coordinate of bottom right corner of the rectangle containing the circle. These coordinates are expressed in pixels.

<X3>: Integer

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

<Y3>: Integer

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

<X4>: Integer

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

<Y4>: Integer

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

<Background color>: Integer or constant (optional)

Background color of chord. This color can correspond to:
an RGB color (returned by RGB),
an HSL color (returned by HSL),
a preset color of WLanguage,
a Color variable.
If this parameter is not specified, the background color:
is Transparent if function <picLayer variable>.Background has not been used before,
corresponds to the Color specified in the last call to function <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 preset color of WLanguage,
an Variable of the Color type.
If this parameter is not specified, the line color:
corresponds to the color specified in the last call to <Image>.Pen,
is identical to the Color used for the Background if the <Image>.Pen function has not been used..

Remarks

Limits

The <picLayer variable>.DrawChord function is not available in Anti-aliasing mode (see the <picLayer variable>.ChangeMode function help for details).
<picLayer variable>.DrawChord is not available for a drawing with management of alpha channel (see the help about <picLayer variable>.StartDrawing for more details). 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 indicated relative to the top left corner of the Image control (coordinates (0.0)).

Solid figure

<picLayer variable>.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 <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: wd260pnt.dll