1// Copyright (c) 2011 The Chromium Authors. All rights reserved.
2// Use of this source code is governed by a BSD-style license that can be
3// found in the LICENSE file.
4
5#ifndef UI_BASE_X_X11_UTIL_INTERNAL_H_
6#define UI_BASE_X_X11_UTIL_INTERNAL_H_
7
8// This file declares utility functions for X11 (Linux only).
9//
10// These functions require the inclusion of the Xlib headers. Since the Xlib
11// headers pollute so much of the namespace, this should only be included
12// when needed.
13
14extern "C" {
15#include <X11/Xatom.h>
16#include <X11/Xlib.h>
17#include <X11/extensions/XShm.h>
18#include <X11/extensions/Xrender.h>
19}
20
21#include "ui/base/ui_export.h"
22
23namespace ui {
24
25// --------------------------------------------------------------------------
26// NOTE: these functions cache the results and must be called from the UI
27// thread.
28// Get the XRENDER format id for ARGB32 (Skia's format).
29//
30// NOTE:Currently this don't support multiple screens/displays.
31XRenderPictFormat* GetRenderARGB32Format(Display* dpy);
32
33// Get the XRENDER format id for the default visual on the first screen. This
34// is the format which our GTK window will have.
35UI_EXPORT XRenderPictFormat* GetRenderVisualFormat(Display* dpy,
36                                                   Visual* visual);
37
38// --------------------------------------------------------------------------
39// X11 error handling.
40// Sets the X Error Handlers. Passing NULL for either will enable the default
41// error handler, which if called will log the error and abort the process.
42UI_EXPORT void SetX11ErrorHandlers(XErrorHandler error_handler,
43                                   XIOErrorHandler io_error_handler);
44
45// NOTE: This function should not be called directly from the
46// X11 Error handler because it queries the server to decode the
47// error message, which may trigger other errors. A suitable workaround
48// is to post a task in the error handler to call this function.
49UI_EXPORT void LogErrorEventDescription(Display* dpy,
50                                        const XErrorEvent& error_event);
51
52}  // namespace ui
53
54#endif  // UI_BASE_X_X11_UTIL_INTERNAL_H_
55