---
name: "lqr_carver_set_enl_step"
section: "3"
platform: "linux"
package: "liblqr-1-0-dev"
version: "0.4.1-2"
release: "Debian 7 (Wheezy)"
platforms: ["linux"]
url: "https://new.carta.tech/lqr_carver_set_enl_step"
---

# lqr\_carver\_set\_enl\_step(3)

set the enlargement step of a LqrCarver object

## NAME

lqr\_carver\_set\_enl\_step - set the enlargement step of a LqrCarver object

## SYNOPSIS

```
#include <lqr.h>
```

**LqrRetVal lqr\_carver\_set\_enl\_step(LqrCarver\*** *carver***, gfloat** *enl\_step***);**

## DESCRIPTION

The function **lqr\_carver\_set\_enl\_step** sets the enlargement step of the LqrCarver object pointed to by *carver* to the value specified in *enl\_step*, which must be strictly greater than 1 and less than 2.

The enlargement step is the maximum enlargement ratio (with respect to either the original width or original height of *carver*) which the function **lqr\_carver\_resize** applies in a single step; if that function is asked a greater enlargement, it divides the process in multiple steps (and updates the original sizes accordingly at each new step - these can be readout at any time with [**lqr\_carver\_get\_ref\_width**(3)](/lqr_carver_get_ref_width/3.md) and [**lqr\_carver\_get\_ref\_height**(3)](/lqr_carver_get_ref_height/3.md)).

The default value for new LqrCarver objects is 2.0.

## RETURN VALUE

The return value follows the Liquid Rescale library signalling system. **LQR\_ERROR** is returned if the *enl\_step* parameter is out of bounds.

## SEE ALSO

[**lqr\_carver\_resize**(3)](/lqr_carver_resize/3.md), [**lqr\_carver\_get\_enl\_step**(3)](/lqr_carver_get_enl_step/3.md), [**lqr\_carver\_get\_ref\_width**(3)](/lqr_carver_get_ref_width/3.md), [**lqr\_carver\_get\_ref\_height**(3)](/lqr_carver_get_ref_height/3.md), [**lqr\_carver\_set\_dump\_vmaps**(3)](/lqr_carver_set_dump_vmaps/3.md), [**lqr\_carver\_set\_side\_switch\_frequency**(3)](/lqr_carver_set_side_switch_frequency/3.md), [**lqr\_carver\_set\_progress**(3)](/lqr_carver_set_progress/3.md), [**lqr\_carver\_set\_preserve\_input\_image**(3)](/lqr_carver_set_preserve_input_image/3.md), [**lqr\_carver\_set\_use\_cache**(3)](/lqr_carver_set_use_cache/3.md)

## COPYRIGHT

Copyright © 2007-2009 Carlo Baldassi\