cairo_text_extents.RdGets the extents for a string of text. The extents describe a user-space rectangle that encloses the "inked" portion of the text, (as it would be drawn by cairo_show_text()). Additionally, the x_advance and y_advance values indicate the amount by which the current point would be advanced by cairo_show_text().
cairo_text_extents(cr, utf8, extents)
| cr | [ |
|---|---|
| utf8 | [ |
| extents | [ |
Note that whitespace characters do not directly contribute to the size of the rectangle (extents.width and extents.height). They do contribute indirectly by changing the position of non-whitespace characters. In particular, trailing whitespace characters are likely to not affect the size of the rectangle, though they will affect the x_advance and y_advance values.
Since: 1.0
C function prototype: void cairo_text_extents (cairo_t *cr, const char *utf8, cairo_text_extents_t *extents)
Other cairo--:
cairo_append_path(),
cairo_arc_negative(),
cairo_arc(),
cairo_clip_extents(),
cairo_clip_preserve(),
cairo_clip(),
cairo_close_path(),
cairo_copy_page(),
cairo_copy_path_flat(),
cairo_copy_path(),
cairo_create(),
cairo_curve_to(),
cairo_device_to_user_distance(),
cairo_device_to_user(),
cairo_fill_extents(),
cairo_fill_preserve(),
cairo_fill(),
cairo_font_extents(),
cairo_get_antialias(),
cairo_get_current_point(),
cairo_get_dash_count(),
cairo_get_dash(),
cairo_get_fill_rule(),
cairo_get_font_face(),
cairo_get_font_matrix(),
cairo_get_group_target(),
cairo_get_line_cap(),
cairo_get_line_join(),
cairo_get_line_width(),
cairo_get_matrix(),
cairo_get_miter_limit(),
cairo_get_operator(),
cairo_get_source(),
cairo_get_target(),
cairo_get_tolerance(),
cairo_has_current_point(),
cairo_identity_matrix(),
cairo_in_clip(),
cairo_in_fill(),
cairo_in_stroke(),
cairo_line_to(),
cairo_mask_surface(),
cairo_mask(),
cairo_move_to(),
cairo_new_path(),
cairo_new_sub_path(),
cairo_paint_with_alpha(),
cairo_paint(),
cairo_path_extents(),
cairo_pop_group_to_source(),
cairo_pop_group(),
cairo_push_group_with_content(),
cairo_push_group(),
cairo_rectangle(),
cairo_rel_curve_to(),
cairo_rel_line_to(),
cairo_rel_move_to(),
cairo_reset_clip(),
cairo_restore(),
cairo_rotate(),
cairo_save(),
cairo_scale(),
cairo_select_font_face(),
cairo_set_antialias(),
cairo_set_dash(),
cairo_set_fill_rule(),
cairo_set_font_face(),
cairo_set_font_matrix(),
cairo_set_font_size(),
cairo_set_line_cap(),
cairo_set_line_join(),
cairo_set_line_width(),
cairo_set_matrix(),
cairo_set_miter_limit(),
cairo_set_operator(),
cairo_set_source_rgba(),
cairo_set_source_rgb(),
cairo_set_source_surface(),
cairo_set_source(),
cairo_set_tolerance(),
cairo_show_page(),
cairo_show_text(),
cairo_status(),
cairo_stroke_extents(),
cairo_stroke_preserve(),
cairo_stroke(),
cairo_tag_begin(),
cairo_tag_end(),
cairo_text_path(),
cairo_transform(),
cairo_translate(),
cairo_user_to_device_distance(),
cairo_user_to_device()