cairo_pattern_create_radial: cairo_pattern_create_radial

In coolbutuseless/cairocore: Low-Level Cairo Bindings

Description

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().

Usage

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

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)

Value

[cairo_pattern_t *]

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()

coolbutuseless/cairocore documentation built on Aug. 31, 2020, 12:43 a.m.