Method
PangoLayoutLineget_x_ranges
Declaration [src]
void
pango_layout_line_get_x_ranges (
PangoLayoutLine* line,
int start_index,
int end_index,
int** ranges,
int* n_ranges
)
Description [src]
Gets a list of visual ranges corresponding to a given logical range.
This list is not necessarily minimal - there may be consecutive ranges which are adjacent. The ranges will be sorted from left to right. The ranges are with respect to the left edge of the entire layout, not with respect to the line.
Parameters
start_index
-
Type:
int
Start byte index of the logical range. If this value is less than the start index for the line, then the first range will extend all the way to the leading edge of the layout. Otherwise, it will start at the leading edge of the first character.
end_index
-
Type:
int
Ending byte index of the logical range. If this value is greater than the end index for the line, then the last range will extend all the way to the trailing edge of the layout. Otherwise, it will end at the trailing edge of the last character.
ranges
-
Type: An array of
int*
Location to store a pointer to an array of ranges. The array will be of length
2*n_ranges
, with each range starting at(*ranges)[2*n]
and of width(*ranges)[2*n + 1] - (*ranges)[2*n]
. This array must be freed with g_free(). The coordinates are relative to the layout and are in Pango units.The argument will be set by the function. The length of the array is specified in the n_ranges
argument.The caller of the method takes ownership of the returned data, and is responsible for freeing it. n_ranges
-
Type:
int*
The number of ranges stored in
ranges
.The argument will be set by the function.