cairo_pattern_create_radial

Creates a new radial gradient #cairo_pattern_t between the two circles defined by (cx0, cy0, radius0) and (cx1, cy1, radius1). Before using the gradient pattern, a number of color stops should be defined using cairo_pattern_add_color_stop_rgb() or cairo_pattern_add_color_stop_rgba().

cairo_pattern_create_radial(cx0, cy0, radius0, cx1, cy1, radius1)

Arguments

cx0

[double] x coordinate for the center of the start circle
cy0

[double] y coordinate for the center of the start circle
radius0

[double] radius of the start circle
cx1

[double] x coordinate for the center of the end circle
cy1

[double] y coordinate for the center of the end circle
radius1

[double] radius of the end circle

Value

[cairo_pattern_t *]

Details

Note: The coordinates here are in pattern space. For a new pattern, pattern space is identical to user space, but the relationship between the spaces can be changed with cairo_pattern_set_matrix().

Return value: the newly created #cairo_pattern_t if successful, or an error pattern in case of no memory. The caller owns the returned object and should call cairo_pattern_destroy() when finished with it.

This function will always return a valid pointer, but if an error occurred the pattern status will be set to an error. To inspect the status of a pattern use cairo_pattern_status().

Since: 1.0

C function prototype: cairo_pattern_t * cairo_pattern_create_radial (double cx0, double cy0, double radius0, double cx1, double cy1, double radius1)

See also

Other cairo-pattern: cairo_mesh_pattern_begin_patch(), cairo_mesh_pattern_curve_to(), cairo_mesh_pattern_end_patch(), cairo_mesh_pattern_get_control_point(), cairo_mesh_pattern_get_corner_color_rgba(), cairo_mesh_pattern_get_patch_count(), cairo_mesh_pattern_get_path(), cairo_mesh_pattern_line_to(), cairo_mesh_pattern_move_to(), cairo_mesh_pattern_set_control_point(), cairo_mesh_pattern_set_corner_color_rgba(), cairo_mesh_pattern_set_corner_color_rgb(), cairo_pattern_add_color_stop_rgba(), cairo_pattern_add_color_stop_rgb(), cairo_pattern_create_for_surface(), cairo_pattern_create_linear(), cairo_pattern_create_mesh(), cairo_pattern_create_rgba(), cairo_pattern_create_rgb(), cairo_pattern_get_color_stop_count(), cairo_pattern_get_color_stop_rgba(), cairo_pattern_get_extend(), cairo_pattern_get_filter(), cairo_pattern_get_linear_points(), cairo_pattern_get_matrix(), cairo_pattern_get_radial_circles(), cairo_pattern_get_rgba(), cairo_pattern_get_type(), cairo_pattern_set_extend(), cairo_pattern_set_filter(), cairo_pattern_set_matrix(), cairo_pattern_status()