lqr_progress_set_init(3)

lqr_progress_set_init3

Execude custom code before each rescaling operation

Usage

#include <lqr.h>

LqrRetVal lqr_progress_set_init(LqrProgress* p, LqrProgressFuncInit init_func);

Overview

The function lqr_progress_set_init sets the hook init_func to the LqrProgress object pointed to by p.

The function init_func is of type LqrProgressFuncInit, whose prototype is defined by:

typedef LqrRetVal (*LqrProgressFuncInit) (const gchar* init_message);

Each time that the function lqr_carver_resize(3) performs a rescale operation (recall that it can perform more than one rescale operation at each call) this function will be called first, with a string argument passed through the parameter init_message, which is different for horizontal and vertical rescalings.

The message arguments can be set with the functions lqr_progress_set_init_width_message(3) and lqr_progress_set_init_height_message(3).

The default values for newly created LqrProgress objects are:

Horizontal:

"Resizing width..."

Vertical:

"Resizing height..."

Return value

The return value follows the Liquid Rescale library signalling system.

Releases

Unchanged in 2 releases since Debian 6.0 (Squeeze).

  1. 6.0–7

From liblqr-1-0-dev 0.4.1-2 in Debian 7 (Wheezy). Parsed by carta from the page's man source.