shape_justify


Description:


public Bool shape_justify (Font font, Buffer buffer, Feature[]? features, string[]? shaper_list, float min_target_advance, float max_target_advance, ref float advance, out Tag var_tag, out float var_value)

See shape_full for basic details.

If shaper_list is not `NULL`, the specified shapers will be used in the given order, otherwise the default shapers list will be used.

In addition, justify the shaping results such that the shaping results reach the target advance width/height, depending on the buffer direction.

If the advance of the buffer shaped with shape_full is already known, put that in *advance. Otherwise set *advance to zero.

This API is currently experimental and will probably change in the future.

Parameters:

font

a mutable Font to use for shaping

buffer

an Buffer to shape

features

an array of user specified Feature or `NULL`

shaper_list

a `NULL`-terminated array of shapers to use or `NULL`

min_target_advance

Minimum advance width/height to aim for.

max_target_advance

Maximum advance width/height to aim for.

advance

Input/output advance width/height of the buffer.

var_tag

Variation-axis tag used for justification.

var_value

Variation-axis value used to reach target justification.

num_features

the length of features array

Returns:

false if all shapers failed, true otherwise

XSince: EXPERIMENTAL


Namespace: HarfBuzz