<Image>.DrawSlice (Function)

ONLINE HELP
WINDEV, WEBDEV AND WINDEV MOBILE

Version:

Home | Sign in | English

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

Coordinates
Non-solid figure
Drawing with opacity or anti-aliasing
Drawing in PHP
Drawing in Browser code

WINDEV

WEBDEV

WINDEV Mobile

Others

See also

<Image>.DrawSlice (Function)

In french: <Image>.DessinePortion

Draws a circle or an ellipse section in an Image control.

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

Example

// Draw a circle section whose
// background is light yellow and whose border is light blue
IMG_Drawing.DrawSlice(10, 10, 50, 50, 20, 20, 40, 50, LightYellow, LightBlue)

Syntax

Drawing a sector of a circle, specifying all the coordinates of the rectangle containing the circle Hide the details

<Image control>.DrawSlice(<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 circle section. These coordinates are expressed in pixels.

<Y3>: Integer

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

<X4>: Integer

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

<Y4>: Integer

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

<Background color>: Integer or constant (optional)

Background color of the circle section. 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)

Color of the line for the circle section. 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 sector of a circle using a Rectangle variable Hide the details

<Image control>.DrawSlice(<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 circle section. These coordinates are expressed in pixels.

<Y3>: Integer

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

<X4>: Integer

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

<Y4>: Integer

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

<Background color>: Integer or constant (optional)

Background color of the circle section. 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)

Color of the line for the circle section. 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

Coordinates

If the start point and the end point are not located on the border of the circle (or on the border of the ellipse), the point taken into account corresponds to 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)).

The drawing sections are drawn anticlockwise.

Non-solid figure

To draw a non-solid figure (without taking into account the center of the circle), use <Image>.DrawChord.

Drawing with opacity or anti-aliasing

For a drawing with opacity (<Image>.StartDrawing with the dWithOpacity constant) or anti-aliasing (<Image>.ChangeMode with the drawAntiAliasing constant), the outline is drawn inside the section: therefore, the line is partly combined with the inside of the section. If the line is very thick, it will be displayed in two colors.

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