<Image variable>.ChangeMode (Function)

ONLINE HELP
WINDEV, WEBDEV AND WINDEV MOBILE

Version:

Home | Sign in | English

Help

WLanguage

WLanguage functions

Controls, pages and windows

Drawing functions

Prefix syntax

Drawing functions on Image variables

ChangeMode

Presentation

Example

Anti-aliasing

Drawing in PHP

Drawing in Browser code

Related examples

See also

<Image variable>.ChangeMode (Function)

In french: <Variable Image>.ChangeMode

Changes the drawing mode on an Image control. This drawing mode is used by the drawing functions (<Image>.DrawLine, <Image>.DrawRectangle, etc.).

Example

// Draws a rectangle in an Image control and erases it
IMG_Drawing.ChangeMode(drawXOR)
// Displays the rectangle (in XOR mode)
IMG_Drawing.DrawRectangle(0, 0, 100, 100)
Multitask(10)
// Erases the rectangle
IMG_Drawing.DrawRectangle(0, 0, 100, 100)

Syntax

<Image variable>.ChangeMode(<New mode>)

<Image variable>: Image variable

Name of the Image control to be used.

<New mode>: Integer constant

Mode for drawing in the image:
drawAntiAliasing Uses the GDI+ and/or the features of the video card to draw the lines and the circles without jagged effects. This drawing mode is slower but the results are better than with the standard mode.
drawDefault Standard colors.
drawXOR Colors applied via an "exclusive or" operation with the background. Erases a drawing if this option is used twice.
CAUTION: This drawing mode is not compatible with the management of opacity (the drawing is not erased anymore).
Caution:
The drawing in XOR mode is available for the Image controls only. The drawing in XOR mode is not available for the Image variables.
The drawXOR constant cannot be combined with the drawAntiAliasing constant.

Remarks

Anti-aliasing

The anti-aliasing consists in drawing the lines and the circles without jagged effects. This feature requires the GDI+ framework (which means the WINDEV framework). Example:

Limits:

<Image>.DrawChord is not supported in this mode.
To avoid the jagged edges, the colors and the lines of elements are smoothed out. Some drawing functions can have an unexpected behavior because the specified colors are no longer found. For example, if a borderline color is specified for <Image>.Fill, this color is not found: the entire area is filled up.
For a drawing with anti-aliasing, <Image>.DrawPolygon and <Image>.DrawSlice have the following behavior. The outline is drawn above the inside of the polygon: therefore, the line is partly combined with the inside of the polygon. If the line is very thick, it will be displayed in two colors.
For more details on the use of GDI+, see GDI+ framework.

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: wd280pnt.dll