From 7d68707a01588ffb5e67319cbde713c16a280e9c Mon Sep 17 00:00:00 2001 From: Johanna Vanhatapio Date: Wed, 8 Jul 2020 09:39:14 +0300 Subject: Doc: Describe the 3D effects in QDS Fixes: QDS-2224 Change-Id: I8d5737af34805e75eb74a3fe86591f86e99b6d4b Reviewed-by: Mahmoud Badri Reviewed-by: Leena Miettinen Reviewed-by: Miikka Heikkinen --- doc/qtcreator/src/qtcreator-toc.qdoc | 1 + .../images/effect-additive-color-gradient.png | Bin 0 -> 12712 bytes doc/qtdesignstudio/images/effect-blur.png | Bin 0 -> 14358 bytes doc/qtdesignstudio/images/effect-brush-strokes.png | Bin 0 -> 14641 bytes .../images/effect-chromatic-aberration.png | Bin 0 -> 17032 bytes doc/qtdesignstudio/images/effect-color-master.png | Bin 0 -> 16218 bytes .../images/effect-depth-of-field-hq-blur.png | Bin 0 -> 14798 bytes doc/qtdesignstudio/images/effect-desaturate.png | Bin 0 -> 16952 bytes .../images/effect-distortion-ripple.png | Bin 0 -> 17685 bytes .../images/effect-distortion-sphere.png | Bin 0 -> 15900 bytes .../images/effect-distortion-spiral.png | Bin 0 -> 15539 bytes doc/qtdesignstudio/images/effect-edge-detect.png | Bin 0 -> 16804 bytes doc/qtdesignstudio/images/effect-emboss.png | Bin 0 -> 12567 bytes doc/qtdesignstudio/images/effect-flip.png | Bin 0 -> 18382 bytes doc/qtdesignstudio/images/effect-fxaa.png | Bin 0 -> 13941 bytes doc/qtdesignstudio/images/effect-gaussian-blur.png | Bin 0 -> 16393 bytes .../images/effect-hdr-bloom-tonemap.png | Bin 0 -> 15304 bytes doc/qtdesignstudio/images/effect-motion-blur.png | Bin 0 -> 12745 bytes doc/qtdesignstudio/images/effect-scatter.png | Bin 0 -> 14700 bytes .../images/effect-scurve-tonemap.png | Bin 0 -> 15142 bytes doc/qtdesignstudio/images/effect-tilt-shift.png | Bin 0 -> 13749 bytes doc/qtdesignstudio/images/effect-vignette.png | Bin 0 -> 18708 bytes doc/qtdesignstudio/src/qtdesignstudio-toc.qdoc | 9 +- .../qtdesignstudio-3d-components.qdoc | 4 + .../qtdesignstudio-3d-effects.qdoc | 367 +++++++++++++++++++++ .../qtquick3d-editor/qtdesignstudio-3d-lights.qdoc | 2 +- .../qtdesignstudio-3d-texture.qdoc | 2 +- 27 files changed, 379 insertions(+), 6 deletions(-) create mode 100644 doc/qtdesignstudio/images/effect-additive-color-gradient.png create mode 100644 doc/qtdesignstudio/images/effect-blur.png create mode 100644 doc/qtdesignstudio/images/effect-brush-strokes.png create mode 100644 doc/qtdesignstudio/images/effect-chromatic-aberration.png create mode 100644 doc/qtdesignstudio/images/effect-color-master.png create mode 100644 doc/qtdesignstudio/images/effect-depth-of-field-hq-blur.png create mode 100644 doc/qtdesignstudio/images/effect-desaturate.png create mode 100644 doc/qtdesignstudio/images/effect-distortion-ripple.png create mode 100644 doc/qtdesignstudio/images/effect-distortion-sphere.png create mode 100644 doc/qtdesignstudio/images/effect-distortion-spiral.png create mode 100644 doc/qtdesignstudio/images/effect-edge-detect.png create mode 100644 doc/qtdesignstudio/images/effect-emboss.png create mode 100644 doc/qtdesignstudio/images/effect-flip.png create mode 100644 doc/qtdesignstudio/images/effect-fxaa.png create mode 100644 doc/qtdesignstudio/images/effect-gaussian-blur.png create mode 100644 doc/qtdesignstudio/images/effect-hdr-bloom-tonemap.png create mode 100644 doc/qtdesignstudio/images/effect-motion-blur.png create mode 100644 doc/qtdesignstudio/images/effect-scatter.png create mode 100644 doc/qtdesignstudio/images/effect-scurve-tonemap.png create mode 100644 doc/qtdesignstudio/images/effect-tilt-shift.png create mode 100644 doc/qtdesignstudio/images/effect-vignette.png create mode 100644 doc/qtdesignstudio/src/qtquick3d-editor/qtdesignstudio-3d-effects.qdoc diff --git a/doc/qtcreator/src/qtcreator-toc.qdoc b/doc/qtcreator/src/qtcreator-toc.qdoc index 0ac3e3c194..28ece9068c 100644 --- a/doc/qtcreator/src/qtcreator-toc.qdoc +++ b/doc/qtcreator/src/qtcreator-toc.qdoc @@ -136,6 +136,7 @@ \li \l{Adding Models} \li \l{Using Materials and Shaders} \li \l{Attaching Textures to Materials} + \li \l{Applying 3D Effects} \li \l{Using Lights} \li \l{Using Scene Camera} \li \l{Setting Scene Environment} diff --git a/doc/qtdesignstudio/images/effect-additive-color-gradient.png b/doc/qtdesignstudio/images/effect-additive-color-gradient.png new file mode 100644 index 0000000000..8eb89deb96 Binary files /dev/null and b/doc/qtdesignstudio/images/effect-additive-color-gradient.png differ diff --git a/doc/qtdesignstudio/images/effect-blur.png b/doc/qtdesignstudio/images/effect-blur.png new file mode 100644 index 0000000000..f170c7b6e2 Binary files /dev/null and b/doc/qtdesignstudio/images/effect-blur.png differ diff --git a/doc/qtdesignstudio/images/effect-brush-strokes.png b/doc/qtdesignstudio/images/effect-brush-strokes.png new file mode 100644 index 0000000000..a69dc95f94 Binary files /dev/null and b/doc/qtdesignstudio/images/effect-brush-strokes.png differ diff --git a/doc/qtdesignstudio/images/effect-chromatic-aberration.png b/doc/qtdesignstudio/images/effect-chromatic-aberration.png new file mode 100644 index 0000000000..d02b490eb7 Binary files /dev/null and b/doc/qtdesignstudio/images/effect-chromatic-aberration.png differ diff --git a/doc/qtdesignstudio/images/effect-color-master.png b/doc/qtdesignstudio/images/effect-color-master.png new file mode 100644 index 0000000000..9b8f13a566 Binary files /dev/null and b/doc/qtdesignstudio/images/effect-color-master.png differ diff --git a/doc/qtdesignstudio/images/effect-depth-of-field-hq-blur.png b/doc/qtdesignstudio/images/effect-depth-of-field-hq-blur.png new file mode 100644 index 0000000000..397dae92a1 Binary files /dev/null and b/doc/qtdesignstudio/images/effect-depth-of-field-hq-blur.png differ diff --git a/doc/qtdesignstudio/images/effect-desaturate.png b/doc/qtdesignstudio/images/effect-desaturate.png new file mode 100644 index 0000000000..535d703be6 Binary files /dev/null and b/doc/qtdesignstudio/images/effect-desaturate.png differ diff --git a/doc/qtdesignstudio/images/effect-distortion-ripple.png b/doc/qtdesignstudio/images/effect-distortion-ripple.png new file mode 100644 index 0000000000..54fd7652cc Binary files /dev/null and b/doc/qtdesignstudio/images/effect-distortion-ripple.png differ diff --git a/doc/qtdesignstudio/images/effect-distortion-sphere.png b/doc/qtdesignstudio/images/effect-distortion-sphere.png new file mode 100644 index 0000000000..3d5d2df106 Binary files /dev/null and b/doc/qtdesignstudio/images/effect-distortion-sphere.png differ diff --git a/doc/qtdesignstudio/images/effect-distortion-spiral.png b/doc/qtdesignstudio/images/effect-distortion-spiral.png new file mode 100644 index 0000000000..65e127e097 Binary files /dev/null and b/doc/qtdesignstudio/images/effect-distortion-spiral.png differ diff --git a/doc/qtdesignstudio/images/effect-edge-detect.png b/doc/qtdesignstudio/images/effect-edge-detect.png new file mode 100644 index 0000000000..5d85c9aa39 Binary files /dev/null and b/doc/qtdesignstudio/images/effect-edge-detect.png differ diff --git a/doc/qtdesignstudio/images/effect-emboss.png b/doc/qtdesignstudio/images/effect-emboss.png new file mode 100644 index 0000000000..1f4eb88df3 Binary files /dev/null and b/doc/qtdesignstudio/images/effect-emboss.png differ diff --git a/doc/qtdesignstudio/images/effect-flip.png b/doc/qtdesignstudio/images/effect-flip.png new file mode 100644 index 0000000000..efe68e7154 Binary files /dev/null and b/doc/qtdesignstudio/images/effect-flip.png differ diff --git a/doc/qtdesignstudio/images/effect-fxaa.png b/doc/qtdesignstudio/images/effect-fxaa.png new file mode 100644 index 0000000000..d1aab3b71d Binary files /dev/null and b/doc/qtdesignstudio/images/effect-fxaa.png differ diff --git a/doc/qtdesignstudio/images/effect-gaussian-blur.png b/doc/qtdesignstudio/images/effect-gaussian-blur.png new file mode 100644 index 0000000000..5f0d507077 Binary files /dev/null and b/doc/qtdesignstudio/images/effect-gaussian-blur.png differ diff --git a/doc/qtdesignstudio/images/effect-hdr-bloom-tonemap.png b/doc/qtdesignstudio/images/effect-hdr-bloom-tonemap.png new file mode 100644 index 0000000000..1d9a299ad2 Binary files /dev/null and b/doc/qtdesignstudio/images/effect-hdr-bloom-tonemap.png differ diff --git a/doc/qtdesignstudio/images/effect-motion-blur.png b/doc/qtdesignstudio/images/effect-motion-blur.png new file mode 100644 index 0000000000..c73e56eee6 Binary files /dev/null and b/doc/qtdesignstudio/images/effect-motion-blur.png differ diff --git a/doc/qtdesignstudio/images/effect-scatter.png b/doc/qtdesignstudio/images/effect-scatter.png new file mode 100644 index 0000000000..a1b25d53e9 Binary files /dev/null and b/doc/qtdesignstudio/images/effect-scatter.png differ diff --git a/doc/qtdesignstudio/images/effect-scurve-tonemap.png b/doc/qtdesignstudio/images/effect-scurve-tonemap.png new file mode 100644 index 0000000000..fec2599a18 Binary files /dev/null and b/doc/qtdesignstudio/images/effect-scurve-tonemap.png differ diff --git a/doc/qtdesignstudio/images/effect-tilt-shift.png b/doc/qtdesignstudio/images/effect-tilt-shift.png new file mode 100644 index 0000000000..fd9ce39085 Binary files /dev/null and b/doc/qtdesignstudio/images/effect-tilt-shift.png differ diff --git a/doc/qtdesignstudio/images/effect-vignette.png b/doc/qtdesignstudio/images/effect-vignette.png new file mode 100644 index 0000000000..d8e1e4c263 Binary files /dev/null and b/doc/qtdesignstudio/images/effect-vignette.png differ diff --git a/doc/qtdesignstudio/src/qtdesignstudio-toc.qdoc b/doc/qtdesignstudio/src/qtdesignstudio-toc.qdoc index fb79bbe41e..73a0166e40 100644 --- a/doc/qtdesignstudio/src/qtdesignstudio-toc.qdoc +++ b/doc/qtdesignstudio/src/qtdesignstudio-toc.qdoc @@ -106,10 +106,11 @@ \li \l{Setting Node Properties} \li \l{Adding Models} \li \l{Using Materials and Shaders} - \li \l{Attaching Textures to Materials} - \li \l{Using Lights} - \li \l{Using Scene Camera} - \li \l{Setting Scene Environment} + \li \l{Attaching Textures to Materials} + \li \l{Applying 3D Effects} + \li \l{Using Lights} + \li \l{Using Scene Camera} + \li \l{Setting Scene Environment} \endlist \endlist \li \l{Previewing} diff --git a/doc/qtdesignstudio/src/qtquick3d-editor/qtdesignstudio-3d-components.qdoc b/doc/qtdesignstudio/src/qtquick3d-editor/qtdesignstudio-3d-components.qdoc index 7f6e7c88ca..babe39a29f 100644 --- a/doc/qtdesignstudio/src/qtquick3d-editor/qtdesignstudio-3d-components.qdoc +++ b/doc/qtdesignstudio/src/qtquick3d-editor/qtdesignstudio-3d-components.qdoc @@ -58,6 +58,10 @@ You can use a Texture component to specify an image and how it is mapped to meshes in a 3D scene. Texture components can use image data either from a file or a Qt Quick QML type. + \li \l {Applying 3D Effects} + + You can use 3D effect components to generate post-processing + effects. \li \l{Using Lights} You can use several light types as the source of lighting in a diff --git a/doc/qtdesignstudio/src/qtquick3d-editor/qtdesignstudio-3d-effects.qdoc b/doc/qtdesignstudio/src/qtquick3d-editor/qtdesignstudio-3d-effects.qdoc new file mode 100644 index 0000000000..be366ea8ff --- /dev/null +++ b/doc/qtdesignstudio/src/qtquick3d-editor/qtdesignstudio-3d-effects.qdoc @@ -0,0 +1,367 @@ +/**************************************************************************** +** +** Copyright (C) 2020 The Qt Company Ltd. +** Contact: https://www.qt.io/licensing/ +** +** This file is part of Qt Design Studio. +** +** $QT_BEGIN_LICENSE:FDL$ +** Commercial License Usage +** Licensees holding valid commercial Qt licenses may use this file in +** accordance with the commercial license agreement provided with the +** Software or, alternatively, in accordance with the terms contained in +** a written agreement between you and The Qt Company. For licensing terms +** and conditions see https://www.qt.io/terms-conditions. For further +** information use the contact form at https://www.qt.io/contact-us. +** +** GNU Free Documentation License Usage +** Alternatively, this file may be used under the terms of the GNU Free +** Documentation License version 1.3 as published by the Free Software +** Foundation and appearing in the file included in the packaging of +** this file. Please review the following information to ensure +** the GNU Free Documentation License version 1.3 requirements +** will be met: https://www.gnu.org/licenses/fdl-1.3.html. +** $QT_END_LICENSE$ +** +****************************************************************************/ + +/*! + \page studio-3d-effects.html + \previouspage studio-3d-texture.html + \nextpage studio-3d-lights.html + + \title Applying 3D Effects + + \QDS provides a set of Qt Quick 3D effects that inherit the types in the + \l {Qt Quick 3D Effects QML Types}{Qt Quick 3D Effects} module. + + To apply a visual effect to a component, drag-and-drop an effect from + \uicontrol Library \uicontrol {Qt Quick 3D Effects} under the \uicontrol + {View 3D} object in \uicontrol Navigator. You can apply multiple effects to + one component. The effects you add to the project are listed in \uicontrol + Properties > \uicontrol {Scene Environment} > \uicontrol Effect and are + visible in \uicontrol {Form Editor}. + + See the following table for available effects and example images. + + \section1 Available Effects + \table + \header + \li 3D Effect + \li Example Image + \li Description + \row + \li Additive Color Gradient + \li \image effect-additive-color-gradient.png "Additive Color Gradient Effect" + \li A gradient with additive color effect that adds a vertical + gradient to the whole scene and then additively blends it with all other + components in a 3D view. Additive blending adds the pixel values of + the gradient and the 3D view, making the result lighter. White areas + do not change, and black areas are the same color as the gradient. + + The \uicontrol {Top Color} and \uicontrol {Bottom Color} properties + specify the colors used for the gradient at the top and bottom parts of + the screen. + + \row + \li Blur + \li \image effect-blur.png "The Blur effect" + \li A simple one-pass blur. + + The \uicontrol Amount property specifies the strength of the blur. + + \row + \li Brush Strokes + \li \image effect-brush-strokes.png "The Brush Strokes effect" + \li A brush strokes noise effect that simulates an artistic painting of + the image. + + The \uicontrol {Noise Sample Texture} property specifies the brush noise + texture map as a \l Texture. + + The \uicontrol Length property specifies how far to offset the image + with the brush. + + The \uicontrol Size property specifies the scale of the brush. Smaller + values result in a finer brush. + + The \uicontrol Angle property specifies the angle to rotate the brush + noise texture. + + \row + \li Chromatic Aberration + \li \image effect-chromatic-aberration.png "The Chromatic Aberration effect" + \li A chromatic aberration effect. + + In real life, chromatic aberration is an optical phenomenon causing + color fringes in high contrast areas. These color fringes are + caused by different colors refracting at different angles splitting + white light into a spectrum, which is referred to as dispersion. + + The \uicontrol {Mask Texture} property specifies a grayscale texture to + control the position and the strength of the effect. The effect is + strongest in white areas and weakest in black areas. + + The \uicontrol Amount property defines the amount of aberration. + A negative value inverses the effect. + + Dispersion scales in relation to the distance from the value of + the \uicontrol {Focus Depth} property. + + \row + \li Color Master + \li \image effect-color-master.png "The Color Master effect" + \li A color adjustment effect. + + The \uicontrol {Red Strength}, \uicontrol {Green Strength} and + \uicontrol {Blue Strength} properties can be used to adjust each color + separately, and the \uicontrol Saturation property to adjust the + strength of the overall saturation of the scene. + + \row + \li Depth Of Field HQ Blur + \li \image effect-depth-of-field-hq-blur.png "The Depth of Field HQ Blur effect" + \li A depth-based blur effect that performs a gradient blur on regions + of the image based on their deviation from a specified distance from the + camera. + + The \uicontrol {Blur Amount} property defines the strength of blur when + out of focus. + + The \uicontrol {Focus Distance} property specifies the distance from the + camera where the content is in perfect focus. + + The \uicontrol {Focus Range} property specifies the distance around the + \uicontrol {Focus Distance} where items are fully in focus. The focus + then fades away to fully blurred by the same distance on both the near + and far sides. + + \row + \li Desaturate + \li \image effect-desaturate.png "The Desaturate effect" + \li A desaturating effect that decreases the intensity of all colors in + the scene. + + The \uicontrol Amount property defines the amount of desaturation. + + \row + \li Distortion Ripple + \li \image effect-distortion-ripple.png "The Distortion Ripple effect" + \li A distortion effect that adds circular ripples, moving away + from the center of the effect. + + The \uicontrol Radius specifies the spread between ripples. + + The \uicontrol Width property specifies the width of a ripple, while + \uicontrol Height defines the amount of distortion. + + The \uicontrol Phase property specifies the offset of each wave. Animate + this property to see the waves move. + + The \uicontrol Center property defines the focus point of the + distortion. + + \row + \li Distortion Sphere + \li \image effect-distortion-sphere.png "The Distortion Sphere effect" + \li A distortion effect that creates a 3D effect of wrapping the + scene around a spherical shape. + + The \uicontrol Radius property specifies the area of distortion, while + \uicontrol Height defines the amount of distortion. + + The \uicontrol Center property defines the focus point of the + distortion. + + \row + \li Distortion Spiral + \li \image effect-distortion-spiral.png "The Distortion Spiral effect" + \li A distortion effect that creates a spiral-shaped distortion. + + The \uicontrol Radius property defines the area of distortion, while + \uicontrol Strength defines the amount of distortion. + + The \uicontrol Center property defines the focus point of the + distortion. + + \row + \li Edge Detect + \li \image effect-edge-detect.png "The Edge Detect effect" + \li An edge highlighting effect that turns smooth, unchanging areas of + the scene darker, while areas of the scene with sharp color changes are + brightened to highlight the edges. + + The \uicontrol Strength property defines the strength of the edge + highlighting. + + \row + \li Emboss + \li \image effect-emboss.png "The Emboss effect" + \li An emboss effect that replaces each pixel either by a highlight or a + shadow, depending on the light/dark boundaries on the scene. + Low contrast areas are replaced by a gray background. The embossed + result represents the rate of color change at each location. + + The \uicontrol Amount property defines the strength of the emboss + effect. + + \row + \li Flip + \li \image effect-flip.png "The Flip effect" + \li An effect that flips the whole scene either horizontally, + vertically, or in both directions. + + The \uicontrol {Horizontal} and \uicontrol {Vertical} properties define + the direction of the flip. + + \row + \li Fxaa + \li \image effect-fxaa.png "The Fxaa effect" + \li A fast approximate anti-aliasing effect that removes some of the + artifacts from the image without impacting performance as heavily as + super-sampling would. + + \row + \li Gaussian Blur + \li \image effect-gaussian-blur.png "The Gaussian Blur effect" + \li A two-pass gaussian blur effect that blurs all objects in the scene + evenly. To keep the effect performant, large blur amount produces a + mosaic result instead of smooth blurriness. + + The \uicontrol Amount property defines the strength of the blur. + + \row + \li HDR Bloom Tonemap + \li \image effect-HDR-bloom-tonemap.png "The HDR Bloom Tonemap effect" + \li A bloom with tonemapping effect that adjusts the gamma and exposure + of the high-dynamic range rendered content to achieve the image quality + you want. Also applies an adjustable bloom effect to very bright areas + (like the sun glinting off a car). + + The \uicontrol Gamma property affects the non-linear curve of the + lighting. Higher values increase the exposure of mid tones, brightening + the image and decreasing the contrast. + + The \uicontrol Exposure property functions as a linear multiplier on the + lighting, thus brightening or darkening the image overall. + + The \uicontrol {Blur Falloff} property adjusts the amount of bloom. + Lower values result in stronger bloom effect, and higher values make the + effect more subtle. + + The \uicontrol {Tonemapping Lerp} property defines the strength of the + overall bloom effect. There is usually no need to adjust this. + + The bloom effect is applied to areas where the lighting is greater than + the \uicontrol {Bloom Threshold} value. A value of \c{1.0} corresponds + to white in the original render result. Lowering this value causes more + areas of the rendered scene to bloom. + + The \uicontrol {Channel Threshold} defines the white point for the + image. There is usually no need to adjust this. + + \row + \li Motion Blur + \li \image effect-motion-blur.png "The Motion Blur effect" + \li A motion blur effect that creates an apparent streaking for rapidly + moving objects in the scene. + + \note Only has a visible effect if the background of the scene is set to + be transparent in the \uicontrol {Background Mode} field of the + \uicontrol {Scene Environment} component. Otherwise, the clear color of + the background hides the blur. For more information, see \l {Setting + Scene Environment}. + + The \uicontrol {Fade Amount} property defines the fade speed of the + trail. + + The \uicontrol Quality property can be adjusted to specify the quality + of the blur. Increasing quality will have impact on performance. + + \row + \li Scatter + \li \image effect-scatter.png "The Scatter effect" + \li A noise effect that scatters the pixels in a scene to create + a blurry or smeared appearance. Without changing the color of each + individual pixel, the effect redistributes the pixels randomly but in + the same general area as their original positions. + + The \uicontrol {Noise Sample Texture} functions as the scatter noise + texture map. + + The \uicontrol Amount property defines how much to scatter, while + \uicontrol Direction sets the direction in which to scatter the pixels. + Set to \c 0 for both horizontal and vertical, \c 1 for horizontal, and + \c 2 for vertical. + + The \uicontrol Randomize property specifies whether scattering changes + at each frame or not. + + \row + \li S-Curve Tonemap + \li \image effect-scurve-tonemap.png "The S-Curve Tonemap effect" + \li A tonemapping effect that maps the colors in the scene to others to + approximate the appearance of high-dynamic-range result. + + The \uicontrol {Shoulder Slope} property defines where highlights lose + contrast. + + The \uicontrol {Shoulder Emphasis} property defines the amount of + emphasis of the shoulder. + + The \uicontrol {Toe Slope} property defines where shadows lose contrast. + + The \uicontrol {Toe Emphasis} property defines the amount of emphasis + of the toe. + + The \uicontrol {Contrast Boost} property enhances or reduces the overall + contrast of the tonemap. + + The \uicontrol {Saturation Level} defines the overall saturation level + of the tonemap. + + The \uicontrol Gamma property defines the gamma value of the tonemap. + + The \uicontrol {Use Exposure} property specifies whether the \uicontrol + {White Point} value or the \uicontrol Exposure value will be used for + luminance calculations. + + The \uicontrol {White Point} property defines the value for the white + point. + + The \uicontrol Exposure property defines the value for exposure. + + \row + \li Tilt Shift + \li \image effect-tilt-shift.png "The Tilt Shift effect" + \li A tilt shift blur effect that simulates depth of field in a simple + and performant manner. Instead of blurring based on the depth buffer, + it blurs everything except for a horizontal or vertical stripe on the + layer. + + The \uicontrol {Focus Position} property specifies the placement of the + focus bar in normalized coordinates. + + The \uicontrol {Focus Width} property defines a normalized range for + Focus Position. Objects within this range will be in focus. + + The \uicontrol {Blur Amount} property defines the amount of blur. + Amounts above 4 may cause artifacts. + + The \uicontrol Vertical property changes the direction of the effect + from horizontal to vertical, while the \uicontrol Inverted property + inverts the blur area, causing the center of the object to become + blurred. + + \row + \li Vignette + \li \image effect-vignette.png "The Vignette effect" + \li A vignette effect that reduces brightness towards the periphery of + an object. + + The \uicontrol Strength property defines the strength of vignetting, + while \uicontrol Radius specifies its size. + + The \uicontrol Color property defines the color used for the effect. + \endtable +*/ diff --git a/doc/qtdesignstudio/src/qtquick3d-editor/qtdesignstudio-3d-lights.qdoc b/doc/qtdesignstudio/src/qtquick3d-editor/qtdesignstudio-3d-lights.qdoc index 361514e053..ccc158ad6d 100644 --- a/doc/qtdesignstudio/src/qtquick3d-editor/qtdesignstudio-3d-lights.qdoc +++ b/doc/qtdesignstudio/src/qtquick3d-editor/qtdesignstudio-3d-lights.qdoc @@ -27,7 +27,7 @@ /*! \page studio-3d-lights.html - \previouspage studio-3d-texture.html + \previouspage studio-3d-effects.html \nextpage studio-3d-camera.html \title Using Lights diff --git a/doc/qtdesignstudio/src/qtquick3d-editor/qtdesignstudio-3d-texture.qdoc b/doc/qtdesignstudio/src/qtquick3d-editor/qtdesignstudio-3d-texture.qdoc index 0dd0efda24..ab145f9ef2 100644 --- a/doc/qtdesignstudio/src/qtquick3d-editor/qtdesignstudio-3d-texture.qdoc +++ b/doc/qtdesignstudio/src/qtquick3d-editor/qtdesignstudio-3d-texture.qdoc @@ -28,7 +28,7 @@ /*! \page studio-3d-texture.html \previouspage studio-3d-materials.html - \nextpage studio-3d-lights.html + \nextpage studio-3d-effects.html \title Attaching Textures to Materials -- cgit v1.2.3