cogl/cogl-debug-options.h

   1 /*
   2  * Cogl
   3  *
   4  * An object oriented GL/GLES Abstraction/Utility Layer
   5  *
   6  * Copyright (C) 2010 Intel Corporation.
   7  *
   8  * This library is free software; you can redistribute it and/or
   9  * modify it under the terms of the GNU Lesser General Public
  10  * License as published by the Free Software Foundation; either
  11  * version 2 of the License, or (at your option) any later version.
  12  *
  13  * This library is distributed in the hope that it will be useful,
  14  * but WITHOUT ANY WARRANTY; without even the implied warranty of
  15  * MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.  See the GNU
  16  * Lesser General Public License for more details.
  17  *
  18  * You should have received a copy of the GNU Lesser General Public
  19  * License along with this library. If not, see <http://www.gnu.org/licenses/>.
  20  *
  21  *
  22  */
  23
  24 OPT (HANDLE,
  25      N_("Cogl Tracing"),
  26      "ref-counts",
  27      N_("CoglObject references"),
  28      N_("Debug ref counting issues for CoglObjects"))
  29 OPT (SLICING,
  30      N_("Cogl Tracing"),
  31      "slicing",
  32      N_("Trace Texture Slicing"),
  33      N_("debug the creation of texture slices"))
  34 OPT (ATLAS,
  35      N_("Cogl Tracing"),
  36      "atlas",
  37      N_("Trace Atlas Textures"),
  38      N_("Debug texture atlas management"))
  39 OPT (BLEND_STRINGS,
  40      N_("Cogl Tracing"),
  41      "blend-strings",
  42      N_("Trace Blend Strings"),
  43      N_("Debug CoglBlendString parsing"))
  44 OPT (JOURNAL,
  45      N_("Cogl Tracing"),
  46      "journal",
  47      N_("Trace Journal"),
  48      N_("View all the geometry passing through the journal"))
  49 OPT (BATCHING,
  50      N_("Cogl Tracing"),
  51      "batching",
  52      N_("Trace Batching"),
  53      N_("Show how geometry is being batched in the journal"))
  54 OPT (MATRICES,
  55      N_("Cogl Tracing"),
  56      "matrices",
  57      N_("Trace matrices"),
  58      N_("Trace all matrix manipulation"))
  59 /* XXX we should replace the "draw" option its very hand wavy... */
  60 OPT (DRAW,
  61      N_("Cogl Tracing"),
  62      "draw",
  63      N_("Trace Misc Drawing"),
  64      N_("Trace some misc drawing operations"))
  65 OPT (PANGO,
  66      N_("Cogl Tracing"),
  67      "pango",
  68      N_("Trace Pango Renderer"),
  69      N_("Trace the Cogl Pango renderer"))
  70 OPT (TEXTURE_PIXMAP,
  71      N_("Cogl Tracing"),
  72      "texture-pixmap",
  73      N_("Trace CoglTexturePixmap backend"),
  74      N_("Trace the Cogl texture pixmap backend"))
  75 OPT (RECTANGLES,
  76      N_("Visualize"),
  77      "rectangles",
  78      N_("Outline rectangles"),
  79      N_("Add wire outlines for all rectangular geometry"))
  80 OPT (WIREFRAME,
  81      N_("Visualize"),
  82      "wireframe",
  83      N_("Show wireframes"),
  84      N_("Add wire outlines for all geometry"))
  85 OPT (DISABLE_BATCHING,
  86      N_("Root Cause"),
  87      "disable-batching",
  88      N_("Disable Journal batching"),
  89      N_("Disable batching of geometry in the Cogl Journal."))
  90 OPT (DISABLE_VBOS,
  91      N_("Root Cause"),
  92      "disable-vbos",
  93      N_("Disable GL Vertex Buffers"),
  94      N_("Disable use of OpenGL vertex buffer objects"))
  95 OPT (DISABLE_PBOS,
  96      N_("Root Cause"),
  97      "disable-pbos",
  98      N_("Disable GL Pixel Buffers"),
  99      N_("Disable use of OpenGL pixel buffer objects"))
 100 OPT (DISABLE_SOFTWARE_TRANSFORM,
 101      N_("Root Cause"),
 102      "disable-software-transform",
 103      N_("Disable software rect transform"),
 104      N_("Use the GPU to transform rectangular geometry"))
 105 OPT (DUMP_ATLAS_IMAGE,
 106      N_("Cogl Specialist"),
 107      "dump-atlas-image",
 108      N_("Dump atlas images"),
 109      N_("Dump texture atlas changes to an image file"))
 110 OPT (DISABLE_ATLAS,
 111      N_("Root Cause"),
 112      "disable-atlas",
 113      N_("Disable texture atlasing"),
 114      N_("Disable use of texture atlasing"))
 115 OPT (DISABLE_SHARED_ATLAS,
 116      N_("Root Cause"),
 117      "disable-shared-atlas",
 118      N_("Disable sharing the texture atlas between text and images"),
 119      N_("When this is set the glyph cache will always use a separate texture "
 120         "for its atlas. Otherwise it will try to share the atlas with images."))
 121 OPT (DISABLE_TEXTURING,
 122      N_("Root Cause"),
 123      "disable-texturing",
 124      N_("Disable texturing"),
 125      N_("Disable texturing any primitives"))
 126 OPT (DISABLE_ARBFP,
 127      N_("Root Cause"),
 128      "disable-arbfp",
 129      N_("Disable arbfp"),
 130      N_("Disable use of ARB fragment programs"))
 131 OPT (DISABLE_FIXED,
 132      N_("Root Cause"),
 133      "disable-fixed",
 134      N_("Disable fixed"),
 135      N_("Disable use of the fixed function pipeline backend"))
 136 OPT (DISABLE_GLSL,
 137      N_("Root Cause"),
 138      "disable-glsl",
 139      N_("Disable GLSL"),
 140      N_("Disable use of GLSL"))
 141 OPT (DISABLE_BLENDING,
 142      N_("Root Cause"),
 143      "disable-blending",
 144      N_("Disable blending"),
 145      N_("Disable use of blending"))
 146 OPT (DISABLE_NPOT_TEXTURES,
 147      N_("Root Cause"),
 148      "disable-npot-textures",
 149      N_("Disable non-power-of-two textures"),
 150      N_("Makes Cogl think that the GL driver doesn't support NPOT textures "
 151         "so that it will create sliced textures or textures with waste instead."))
 152 OPT (DISABLE_SOFTWARE_CLIP,
 153      N_("Root Cause"),
 154      "disable-software-clip",
 155      N_("Disable software clipping"),
 156      N_("Disables Cogl's attempts to clip some rectangles in software."))
 157 OPT (SHOW_SOURCE,
 158      N_("Cogl Tracing"),
 159      "show-source",
 160      N_("Show source"),
 161      N_("Show generated ARBfp/GLSL source code"))
 162 OPT (OPENGL,
 163      N_("Cogl Tracing"),
 164      "opengl",
 165      N_("Trace some OpenGL"),
 166      N_("Traces some select OpenGL calls"))
 167 OPT (OFFSCREEN,
 168      N_("Cogl Tracing"),
 169      "offscreen",
 170      N_("Trace offscreen support"),
 171      N_("Debug offscreen support"))
 172 OPT (DISABLE_BLENDING,
 173      N_("Root Cause"),
 174      "disable-program-caches",
 175      N_("Disable program caches"),
 176      N_("Disable fallback caches for arbfp and glsl programs"))
 177 OPT (DISABLE_FAST_READ_PIXEL,
 178      N_("Root Cause"),
 179      "disable-fast-read-pixel",
 180      N_("Disable read pixel optimization"),
 181      N_("Disable optimization for reading 1px for simple "
 182         "scenes of opaque rectangles"))
 183 OPT (CLIPPING,
 184      N_("Cogl Tracing"),
 185      "clipping",
 186      N_("Trace clipping"),
 187      N_("Logs information about how Cogl is implementing clipping"))