since: 3.10

Declaration [src]

gdk_cursor_new_from_surface (
  GdkDisplay* display,
  cairo_surface_t* surface,
  gdouble x,
  gdouble y

Description [src]

Creates a new cursor from a cairo image surface.

Not all GDK backends support RGBA cursors. If they are not supported, a monochrome approximation will be displayed. The functions gdk_display_supports_cursor_alpha() and gdk_display_supports_cursor_color() can be used to determine whether RGBA cursors are supported; gdk_display_get_default_cursor_size() and gdk_display_get_maximal_cursor_size() give information about cursor sizes.

On the X backend, support for RGBA cursors requires a sufficently new version of the X Render extension.

Available since: 3.10



Type: GdkDisplay

The GdkDisplay for which the cursor will be created.

The data is owned by the caller of the function.

Type: cairo_surface_t

The cairo image surface containing the cursor pixel data.

The data is owned by the caller of the function.

Type: gdouble

The horizontal offset of the “hotspot” of the cursor.


Type: gdouble

The vertical offset of the “hotspot” of the cursor.

Return value

Type: GdkCursor

A new GdkCursor.

The caller of the function takes ownership of the data, and is responsible for freeing it.