cairo_set_dash.RdSets the dash pattern to be used by cairo_stroke(). A dash pattern is specified by dashes, an array of positive values. Each value provides the length of alternate "on" and "off" portions of the stroke. The offset specifies an offset into the pattern at which the stroke begins.
cairo_set_dash(cr, dashes, num_dashes, offset)
| cr | [ |
|---|---|
| dashes | [ |
| num_dashes | [ |
| offset | [ |
Each "on" segment will have caps applied as if the segment were a separate sub-path. In particular, it is valid to use an "on" length of 0.0 with %CAIRO_LINE_CAP_ROUND or %CAIRO_LINE_CAP_SQUARE in order to distributed dots or squares along a path.
Note: The length values are in user-space units as evaluated at the time of stroking. This is not necessarily the same as the user space at the time of cairo_set_dash().
If num_dashes is 0 dashing is disabled.
If num_dashes is 1 a symmetric pattern is assumed with alternating on and off portions of the size specified by the single value in dashes.
If any value in dashes is negative, or if all values are 0, then cr will be put into an error state with a status of %CAIRO_STATUS_INVALID_DASH.
Since: 1.0
C function prototype: void cairo_set_dash (cairo_t *cr, const double *dashes, int num_dashes, double offset)
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_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_extents(),
cairo_text_path(),
cairo_transform(),
cairo_translate(),
cairo_user_to_device_distance(),
cairo_user_to_device()