Skip to content

Commit efe6250

Browse files
mnoconadriendupuis
andauthored
Added doc for Gaussian Blur in Image Editor (#3046)
--------- Co-authored-by: Adrien Dupuis <61695653+adriendupuis@users.noreply.github.com>
1 parent c437d61 commit efe6250

2 files changed

Lines changed: 18 additions & 1 deletion

File tree

code_samples/back_office/image_editor/config/packages/image_editor.yaml

Lines changed: 1 addition & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -38,3 +38,4 @@ ibexa:
3838
id: dot
3939
priority: 50
4040
image_quality: 0.8
41+
gaussian_blur_strength: 0.05

docs/content_management/images/configure_image_editor.md

Lines changed: 17 additions & 1 deletion
Original file line numberDiff line numberDiff line change
@@ -33,7 +33,9 @@ The following example sets the aspect ratio values and label names for buttons u
3333
[[= include_file('code_samples/back_office/image_editor/config/packages/image_editor.yaml', 0, 36) =]]
3434
```
3535

36-
### Image quality
36+
### Image file size optimization
37+
38+
#### Image quality
3739

3840
You can configure the quality of the images modified in the Image Editor with the following configuration.
3941

@@ -44,6 +46,20 @@ The default quality is 0.92:
4446
[[= include_file('code_samples/back_office/image_editor/config/packages/image_editor.yaml', 0, 4) =]] [[= include_file('code_samples/back_office/image_editor/config/packages/image_editor.yaml', 39, 40) =]]
4547
```
4648

49+
#### Gaussian blur strength
50+
51+
You can configure the gaussian blur strength applied during image optimization with the following configuration.
52+
53+
``` yaml
54+
[[= include_file('code_samples/back_office/image_editor/config/packages/image_editor.yaml', 0, 4) =]] [[= include_file('code_samples/back_office/image_editor/config/packages/image_editor.yaml', 40, 41) =]]
55+
```
56+
57+
The setting accepts float values between 0 and 10.0, where higher values increase blur and reduce file size, while lower values maintain sharpness.
58+
The default value is 0.05.
59+
60+
Processing large images with high blur values (above 5) can be time-consuming and may result in request timeouts.
61+
Keep this in mind when configuring blur strength for environments that handle high-resolution images, and adjust [PHP's `max_execution_time`](https://www.php.net/manual/en/info.configuration.php#ini.max-execution-time) if needed.
62+
4763
### Additional information
4864

4965
Each image can be accompanied by additional information that isn't visible to the user.

0 commit comments

Comments
 (0)