small_light_radius_max
The `small_light_radius_max` directive sets the maximum allowable radius for image transformations in the small_light module of NGINX.
Description
The small_light_radius_max directive is used in conjunction with image transformation processes provided by the small_light module in NGINX. This directive defines the maximum radius that can be applied when processing images for effects such as blurring or sharpening. By setting a maximum value, it helps maintain performance and resource management by preventing excessively large transformations that could lead to high memory usage or slow response times.
This directive accepts a single argument, which is specified in pixels. It is applicable in various contexts including http, server, and location blocks, allowing for flexible configuration at different levels of NGINX configuration. The small_light module itself supports dynamic image processing features, and this directive plays a critical role in fine-tuning how these transformations are executed, particularly in preserving the quality of images while managing the computational overhead.
It's important to note that setting an appropriate value for this directive is essential for balancing image processing quality against performance constraints. Administrators should test image processing with various radius settings to find an optimal configuration that meets their quality requirements without overwhelming server resources.
Config Example
http {
small_light_radius_max 50;
server {
location /images/ {
small_light;
}
}
}Values that are too high can lead to increased memory usage and may slow down response times.
Ensure the module is properly compiled and enabled in NGINX; otherwise, this directive will have no effect.
The value must be a positive integer; any invalid or negative values will cause an error during configuration loading.