aura-x11: Add custom web cursor support.

ui/base/x/x11_util.h

 // Copyright (c) 2012 The Chromium Authors. All rights reserved.
 // Use of this source code is governed by a BSD-style license that can be
 // found in the LICENSE file.
 
 #ifndef UI_BASE_X_X11_UTIL_H_
 #define UI_BASE_X_X11_UTIL_H_
 #pragma once
 
 // This file declares utility functions for X11 (Linux only).
 //
 // These functions do not require the Xlib headers to be included (which is why
 // we use a void* for Visual*). The Xlib headers are highly polluting so we try
 // hard to limit their spread into the rest of the code.
 
 #include <string>
 #include <vector>
 
 #include "base/basictypes.h"
 #include "ui/base/events.h"
 #include "ui/base/ui_export.h"
 
 typedef unsigned long Atom;
 typedef unsigned long XID;
 typedef unsigned long XSharedMemoryId;  // ShmSeg in the X headers.
 typedef struct _XDisplay Display;
 typedef unsigned long Cursor;
+typedef struct _XcursorImage XcursorImage;
 
 #if defined(TOOLKIT_USES_GTK)
 typedef struct _GdkDrawable GdkWindow;
 typedef struct _GtkWidget GtkWidget;
 typedef struct _GtkWindow GtkWindow;
 #endif
 
 namespace gfx {
 class Rect;
 }
@@ skipping 33 matching lines @@
 int GetDefaultScreen(Display* display);
 
 // TODO(xiyuan): Fix the stale XCursorCache problem per http://crbug.com/102759.
 // A special cursor that makes GetXCursor below to clear its XCursorCache.
 const int kCursorClearXCursorCache = -1;
 
 // Returns an X11 Cursor, sharable across the process.
 // |cursor_shape| is an X font cursor shape, see XCreateFontCursor().
 UI_EXPORT Cursor GetXCursor(int cursor_shape);
 
+#if defined(USE_AURA)
+// Creates a custom X cursor from the image. This takes ownership of image. The
+// caller must not free/modify the image. The refcount of the newly created
+// cursor is set to 1.
+UI_EXPORT Cursor CreateReffedCustomXCursor(XcursorImage* image);

[Daniel Erat, 2012/02/24 21:04:36]

will defer to others on "Reffed" vs. "Refed" vs. "Referenced"

+
+// Increases the refcount of the custom cursor.
+UI_EXPORT void RefCustomXCursor(Cursor cursor);
+
+// Decreases the refcount of the custom cursor, and destroys it if it reaches 0.
+UI_EXPORT void UnrefCustomXCursor(Cursor cursor);
+#endif
+
 // These functions do not cache their results --------------------------
 
 // Get the X window id for the default root window
 UI_EXPORT XID GetX11RootWindow();
 
 // Returns the user's current desktop.
 bool GetCurrentDesktop(int* desktop);
 
 #if defined(TOOLKIT_USES_GTK)
 // Get the X window id for the given GTK widget.
@@ skipping 176 matching lines @@
 
  private:
   char* string_;
 
   DISALLOW_COPY_AND_ASSIGN(XScopedString);
 };
 
 }  // namespace ui
 
 #endif  // UI_BASE_X_X11_UTIL_H_