dBlur (Function)

ONLINE HELP
WINDEV, WEBDEV AND WINDEV MOBILE

Version:

Home | Sign in | English

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

Using the drawing functions

WINDEV

WEBDEV

WINDEV Mobile

Others

See also

dBlur (Function)

In french: dFlou

Blurs the entire given area:

in an Image control,
in a variable of type Image.
in a variable of type WDPic (on the background layer),
in a variable of type picLayer.

Example

// Blur image
dBlur(IMG_Drawing)

Syntax

Blurring an entire image Hide the details

dBlur([<Image>] [, <Radius>])

<Image>: Optional control name or optional Image, WDPic or picLayer variable

Image to use. The image can correspond to:
the name of an Image control.
the name of a variable of type Image.
the name of a variable of type WDPic. Only the background layer will be handled.
the name of a variable of type picLayer.
If this parameter is not specified, it is necessary to define the drawing destination with dStartDrawing.

<Radius>: Optional integer

Radius around a point in which nearby points are taken into account for blurring. The larger the radius, the more blurred the image will be and the longer the blur will take. The default value is 10.

Blurring an area of an image Hide the details

dBlur([<Image>, ] <Area to blur> [, <Radius>])

<Image>: Optional control name or optional Image, WDPic or picLayer variable

Image to use. The image can correspond to:
the name of an Image control.
the name of a variable of type Image.
the name of a variable of type WDPic. Only the background layer will be handled.
the name of a variable of type picLayer.
If this parameter is not specified, it is necessary to define the drawing destination with dStartDrawing.

<Area to blur>: Rectangle or Polygon variable

Image area to be blurred. This area can be defined by
a variable of type Rectangle (for simple areas).
a variable of type Polygon (for complex areas).
Remarks:
There is no need to close the polygon (the coordinates of last point do not have to be equal to the coordinates of first point). The polygon is automatically "closed".
A polygon can have a maximum of 100,000 points.
Coordinates are specified with respect to the upper-left corner of the image (coordinates: (0.0)).

<Radius>: Optional integer

Radius around a point in which nearby points are taken into account for blurring. The larger the radius, the more blurred the image will be and the longer the blur will take. The default value is 10.

Remarks

Using the drawing functions

The drawing functions can be used according to 2 methods:

Method 1: Using dStartDrawing
- dStartDrawing must be called before any other drawing function. dStartDrawing is used to define the element (Image control or variable) to which the drawing functions will be applied.
- When drawing on an Image control:
  - The drawing functions operate on a copy ("bitmap") of the image. You can use the drawing functions of Windows (via API or CallDLL32) but these functions must use the DC (Device Context) returned by dStartDrawing.
  - dEndDrawing and dStartDrawing must not be called in the same process.
    The drawing will not be displayed if dEndDrawing and dStartDrawing are called in the same process: it will be automatically erased.
Method 2: indicating the drawing target directly in the syntax (via a parameter)
The <Image> parameter is used to specify directly the target of the drawing. dStartDrawing becomes useless. This function must be deleted.

Component: wd300pnt.dll