Parallax effect

ONLINE HELP
WINDEV, WEBDEV AND WINDEV MOBILE

Version:

Home | Sign in | English

Help

Editors

Controls (window/page/report)

Common

Parallax effect

Overview

The parallax effect in the window editor

The parallax effect in the page editor

See also

Parallax effect

Overview

The "Parallax" effects are used to scroll the elements found in the interface at different speeds when the scrollbar is used.

You can define:

a parallax of controls: In a window or in a page, the parallax animations are used to configure the speed at which the control is moved or reduced in relation to the scrollbar move in the window (or in the page).
a parallax of background image: In a page, a parallax animation can be used on the background images. When the scrollbar is used, the background image will move at a specific speed relative to the movement of the scrollbar.

The Parallax effects are available:

for all the window controls. For more details, see The parallax effect in the window editor.
for the container controls of a page: Cell, Layout area, Rich Text Area, Control Template control. For more details, see The parallax effect in the page editor.

The parallax effect in the window editor

Overview

The window editor proposes a parallax effect of control.

For example:

If no parallax is defined, the controls and the window scrollbar move at the same speed.
If the control is fixed, the control will not move even if the scrollbar is used.
The parallax is used to perform specific effects, for example by making the move speed of the control (or its reduction rate) change in relation to the move speed of the window scrollbar.

Defining the parallax effect in the window editor

To define the parallax effect of a control:

Open the control description window.
In the "UI" tab, expand the "Parallax" option.
Choose the requested option:
- No parallax: The control moves vertically following the movement of the window scrollbar.
- Material Design effect without reduction: The control moves vertically proportionally to the movement of the window scrollbar. In this case, the movement speed is set to 50% and the reduction speed is set to 0%.
- Material Design effect with reduction: The control is reduced vertically in relation to the movement of the scrollbar in the window. In this case, the move speed is set to 50% and the reduction speed is set to 50%.
  For an Image control, the image follows the display mode.
  - If the image is stretched, it will be distorted to be entirely displayed in the height of the control.
  - If the image is homothetic centered, it will be reduced proportionally to the control height.
- Fixed control: The control is fixed. It does not move in the window. It is always visible when the scrollbar moves in the window. In this case, the move speed is set to 0% and the reduction speed is set to 100%.
- Customize the effect: You have the ability to specify the Y parallax rate (move speed of control) and the Height parallax rate (reduction speed of control).

Remark: The parallax effect is available for all types of controls.

Defining the parallax through programming

The following properties are used to define the parallax of a control through programming:


ParallaxRateHeight	The ParallaxRateHeight property is used to determine and specify how fast a control is reduced when the scrollbar in the window, internal window or page moves.
ParallaxRateY	The ParallaxRateY property is used to determine and specify how fast a control moves when the scrollbar in the window, internal window or page moves.

The parallax effect in the page editor

Overview

The page editor proposes a parallax effect of controls and a parallax effect of background image.

These parallax effects are available for the following controls:

Cell.
Layout area.
Rich text area.
"Control template" control.

Defining the parallax effect in the page editor

To define the parallax effect of a control:

Open the control description window.
In the "Style" tab, select the "Effects" element.

To add a parallax effect of control:

Click the "Add an effect" button and select "Parallax".
The effect is added to the style. Click the "Details" button to configure the effect.

In the window that is displayed, choose the requested option:

Configuring the parallax effect of control

Effect triggered through programming. In this case:

the Y and height parallax rates are set to zero. The effect is configured by the properties:


ParallaxRateHeight	The ParallaxRateHeight property is used to determine and specify how fast a control is reduced when the scrollbar in the window, internal window or page moves.
ParallaxRateY	The ParallaxRateY property is used to determine and specify how fast a control moves when the scrollbar in the window, internal window or page moves.

Material Design effect without reduction: The control moves in height proportionally to the scrollbar move in the page. In this case, the movement speed is set to 50% and the reduction speed is set to 0%.
Material Design effect with reduction: The control is reduced in height proportionally to the scrollbar move in the page. In this case, the move speed is set to 50% and the reduction speed is set to 50%.
Fixed control: The control is fixed. It does not move in the page. It is always visible when the scrollbar moves in the page. In this case, the move speed is set to 0% and the reduction speed is set to 100%.
Customize the effect: You have the ability to specify the Y parallax rate (move speed of control) and the Height parallax rate (reduction speed of control).

Validate.

To add a parallax effect of background image:
- Click the "Add an effect" button and select "Parallax on the background image".
- The effect is added to the style. Click the "Details" button to configure the effect.
- In the window that is displayed, choose the requested option:
  - Fixed background in the browser: The image is fixed. It does not move in the window. It is always visible when the scrollbar moves in the window. It is the container control that is moved along with the page. The image section displayed in the background changes according to the size of the container control. In this case, the move speed is set to 0% and the reduction speed is set to 100%.
  - Customize the effect: You have the ability to specify the Y parallax rate (move speed of control). In this case, the background image moves more or less faster according to the move of the associated control.
- Validate.

Remarks:

The parallax effect on background image can be viewed in the page editor (WYSIWYG). All you have to do is move the vertical scrollbar.
If the background image used is not big enough to get the expected effect, the image is enlarged in homothetic way.
The parallax effect on background image cannot be modified through programming.

Regardless of the options defined for the parallax effect of control, it can be configured through programming with the properties:


ParallaxRateHeight	The ParallaxRateHeight property is used to determine and specify how fast a control is reduced when the scrollbar in the window, internal window or page moves.
ParallaxRateY	The ParallaxRateY property is used to determine and specify how fast a control moves when the scrollbar in the window, internal window or page moves.