Constructor

GdkCursornew_from_surface

since: 3.10

Declaration [src]

GdkCursor*
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

Parameters

display

Type: GdkDisplay

The GdkDisplay for which the cursor will be created.

The data is owned by the caller of the function.

surface

Type: cairo_surface_t

The cairo image surface containing the cursor pixel data.

The data is owned by the caller of the function.

x

Type: gdouble

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

y

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.