data-raw/headers-r/cairo-surface-subsurface-header.R

In coolbutuseless/cairocore: Low-Level Cairo Bindings

cairo_surface_subsurface_header <- list(

  cairo_surface_create_for_rectangle = list(
    include = TRUE,
    gtkdoc = r"{/**
    * cairo_surface_create_for_rectangle:
    * @target: an existing surface for which the sub-surface will point to
    * @x: the x-origin of the sub-surface from the top-left of the target surface (in device-space units)
    * @y: the y-origin of the sub-surface from the top-left of the target surface (in device-space units)
    * @width: width of the sub-surface (in device-space units)
    * @height: height of the sub-surface (in device-space units)
    *
    * Create a new surface that is a rectangle within the target surface.
    * All operations drawn to this surface are then clipped and translated
    * onto the target surface. Nothing drawn via this sub-surface outside of
    * its bounds is drawn onto the target surface, making this a useful method
    * for passing constrained child surfaces to library routines that draw
    * directly onto the parent surface, i.e. with no further backend allocations,
    * double buffering or copies.
    *
    * <note><para>The semantics of subsurfaces have not been finalized yet
    * unless the rectangle is in full device units, is contained within
    * the extents of the target surface, and the target or subsurface's
    * device transforms are not changed.</para></note>
    *
    * Return value: a pointer to the newly allocated surface. The caller
    * owns the surface and should call cairo_surface_destroy() when done
    * with it.
    *
    * This function always returns a valid pointer, but it will return a
    * pointer to a "nil" surface if @other is already in an error state
    * or any other error occurs.
    *
    * Since: 1.10
    **/}",
    proto_text = "cairo_surface_t *
cairo_surface_create_for_rectangle (cairo_surface_t *target,
				    double x, double y,
				    double width, double height)"
  )
)