Quelle  gdkdebugprivate.h

/* GDK - The GIMP Drawing Kit
 * Copyright (C) 2020 Red Hat, Inc.
 *
 * This library is free software; you can redistribute it and/or
 * modify it under the terms of the GNU Lesser General Public
 * License as published by the Free Software Foundation; either
 * version 2 of the License, or (at your option) any later version.
 *
 * This library is distributed in the hope that it will be useful,
 * but WITHOUT ANY WARRANTY; without even the implied warranty of
 * MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.  See the GNU
 * Lesser General Public License for more details.
 *
 * You should have received a copy of the GNU Lesser General Public
 * License along with this library. If not, see <http://www.gnu.org/licenses/>.
 */

#pragma once

#include <glib.h>

#include "gdktypes.h"
#include <glib/gstdio.h>

G_BEGIN_DECLS

typedef enum {
  GDK_DEBUG_MISC               = 1 <<  0,
  GDK_DEBUG_EVENTS             = 1 <<  1,
  GDK_DEBUG_DND                = 1 <<  2,
  GDK_DEBUG_INPUT              = 1 <<  3,
  GDK_DEBUG_EVENTLOOP          = 1 <<  4,
  GDK_DEBUG_FRAMES             = 1 <<  5,
  GDK_DEBUG_SETTINGS           = 1 <<  6,
  GDK_DEBUG_OPENGL             = 1 <<  7,
  GDK_DEBUG_VULKAN             = 1 <<  8,
  GDK_DEBUG_SELECTION          = 1 <<  9,
  GDK_DEBUG_CLIPBOARD          = 1 << 10,
  GDK_DEBUG_DMABUF             = 1 << 11,
  GDK_DEBUG_D3D12              = 1 << 12,
  GDK_DEBUG_OFFLOAD            = 1 << 13,
  GDK_DEBUG_LINEAR             = 1 << 14,
  GDK_DEBUG_HDR                = 1 << 15,
  GDK_DEBUG_PORTALS            = 1 << 16,
  GDK_DEBUG_NO_PORTALS         = 1 << 17,
  GDK_DEBUG_FORCE_OFFLOAD      = 1 << 18,
  GDK_DEBUG_GL_PREFER_GL       = 1 << 19,
  GDK_DEBUG_GL_DEBUG           = 1 << 20,
  GDK_DEBUG_DEFAULT_SETTINGS   = 1 << 21,
  GDK_DEBUG_HIGH_DEPTH         = 1 << 22,
  GDK_DEBUG_NO_VSYNC           = 1 << 23,
  GDK_DEBUG_COLOR_MANAGEMENT   = 1 << 24,
  GDK_DEBUG_DCOMP              = 1 << 25,
} GdkDebugFlags;

typedef enum {
  GDK_FEATURE_OPENGL           = 1 << 0,
  GDK_FEATURE_GL_API           = 1 << 1,
  GDK_FEATURE_GLES_API         = 1 << 2,
  GDK_FEATURE_EGL              = 1 << 3,
  GDK_FEATURE_GLX              = 1 << 4,
  GDK_FEATURE_WGL              = 1 << 5,
  GDK_FEATURE_VULKAN           = 1 << 6,
  GDK_FEATURE_DMABUF           = 1 << 7,
  GDK_FEATURE_D3D11            = 1 << 8,
  GDK_FEATURE_D3D12            = 1 << 9,
  GDK_FEATURE_OFFLOAD          = 1 << 10,
  GDK_FEATURE_THREADS          = 1 << 11,
} GdkFeatures;

#define GDK_ALL_FEATURES ((1 << 12) - 1)

extern guint _gdk_debug_flags;

GdkDebugFlags    gdk_display_get_debug_flags    (GdkDisplay       *display);
void             gdk_display_set_debug_flags    (GdkDisplay       *display,
                                                 GdkDebugFlags     flags);

gboolean         gdk_has_feature                (GdkFeatures       feature);

static inline void
gdk_debug_message (const char *format, ...) G_GNUC_PRINTF(1, 2);
static inline void
gdk_debug_message (const char *format, ...)
{
  va_list args;

  va_start (args, format);
#ifdef GLIB_USING_SYSTEM_PRINTF
  vfprintf (stderr, format, args);
#else
  g_vfprintf (stderr, format, args);
#endif
  va_end (args);

  fprintf (stderr, "\n");
}

static inline void
gdk_help_message (const char *format, ...) G_GNUC_PRINTF(1, 2);
static inline void
gdk_help_message (const char *format, ...)
{
  va_list args;

  va_start (args, format);
#ifdef GLIB_USING_SYSTEM_PRINTF
  vfprintf (stderr, format, args);
#else
  g_vfprintf (stderr, format, args);
#endif
  va_end (args);

  fprintf (stderr, "\n");
}

#define GDK_DISPLAY_DEBUG_CHECK_FULL(display, types) \
  G_UNLIKELY (gdk_display_get_debug_flags (display) & (types))

#define GDK_DISPLAY_DEBUG_CHECK(display, type) \
  GDK_DISPLAY_DEBUG_CHECK_FULL ((display), GDK_DEBUG_##type)

#define GDK_DISPLAY_DEBUG_FULL(display, types, ...)        \
  G_STMT_START                                             \
  {                                                        \
    if (GDK_DISPLAY_DEBUG_CHECK_FULL ((display), (types))) \
      gdk_debug_message (__VA_ARGS__);                     \
  }                                                        \
  G_STMT_END

#define GDK_DISPLAY_DEBUG(display, type, ...) \
  GDK_DISPLAY_DEBUG_FULL ((display), GDK_DEBUG_##type, __VA_ARGS__)

#define GDK_DEBUG_CHECK(type) GDK_DISPLAY_DEBUG_CHECK (NULL,type)
#define GDK_DEBUG_CHECK_FULL(types) GDK_DISPLAY_DEBUG_CHECK (NULL, (types))
#define GDK_DEBUG(type,...) GDK_DISPLAY_DEBUG (NULL,type,__VA_ARGS__)
#define GDK_DEBUG_FULL(types, ...) \
  GDK_DISPLAY_DEBUG_FULL (NULL, (types), __VA_ARGS__)

typedef struct
{
  const char *key;
  guint value;
  const char *help;
} GdkDebugKey;

guint gdk_parse_debug_var (const char        *variable,
                           const char        *docs,
                           const GdkDebugKey *keys,
                           guint              nkeys);

G_END_DECLS