cairo_create.Rd
Creates a new #cairo_t with all graphics state parameters set to default values and with target as a target surface. The target surface should be constructed with a backend-specific function such as cairo_image_surface_create() (or any other <function>cairo_<emphasis>backend</emphasis>_surface_create(<!-- -->)</function> variant).
cairo_create(target)
target | [ |
---|
[cairo_t *
]
This function references target, so you can immediately call cairo_surface_destroy() on it if you don't need to maintain a separate reference to it.
Return value: a newly allocated #cairo_t with a reference count of 1. The initial reference count should be released with cairo_destroy() when you are done using the #cairo_t. This function never returns %NULL. If memory cannot be allocated, a special #cairo_t object will be returned on which cairo_status() returns %CAIRO_STATUS_NO_MEMORY. If you attempt to target a surface which does not support writing (such as #cairo_mime_surface_t) then a %CAIRO_STATUS_WRITE_ERROR will be raised. You can use this object normally, but no drawing will be done.
Since: 1.0
C function prototype: cairo_t * cairo_create (cairo_surface_t *target)
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_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_extents()
,
cairo_text_path()
,
cairo_transform()
,
cairo_translate()
,
cairo_user_to_device_distance()
,
cairo_user_to_device()