sungmg/mutter-performance-source
1
0
Fork 0
Code Activity
mutter-performance-source/cogl/cogl-debug-options.h

188 lines
5.4 KiB
C
Raw Normal View History

profile: Update to uprof-0.3 dep for --enable-profile When building with --enable-profile we now depend on the uprof-0.3 developer release which brings a few improvements: » It lets us "fix" how we initialize uprof so that instead of using a shared object constructor/destructor (which was a hack used when first adding uprof support to Clutter) we can now initialize as part of clutter's normal initialization code. As a side note though, I found that the way Clutter initializes has some quite serious problems whenever it involves GOptionGroups. It is not able to guarantee the initialization of dependencies like uprof and Cogl. For this reason we still use the contructor/destructor approach to initialize uprof in Cogl. » uprof-0.3 provides a better API for adding custom columns when reporting timer and counter statistics which lets us remove quite a lot of manual report generation code in clutter-profile.c. » uprof-0.3 provides a shared context for tracking mainloop timer statistics. This means any mainloop based library following the same "Mainloop" timer naming convention can use the shared context and no matter who ends up owning the final mainloop the statistics will always be in the same place. This allows profiling of Clutter with an external mainloop such as with the Mutter compositor. » uprof-0.3 can export statistics over dbus and comes with an ncurses based ui to vizualize timer and counter stats live. The latest version of uprof can be cloned from: git://github.com/rib/UProf.git
2010-06-21 14:36:46 +00:00
/*
* Cogl
*
* An object oriented GL/GLES Abstraction/Utility Layer
*
* Copyright (C) 2010 Intel Corporation.
*
* 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/>.
*
*
*/
OPT (HANDLE,
"Cogl Tracing",
"ref-counts",
"CoglObject references",
"Debug ref counting issues for CoglObjects")
OPT (SLICING,
"Cogl Tracing",
"slicing",
"Trace Texture Slicing",
"debug the creation of texture slices")
OPT (ATLAS,
"Cogl Tracing",
"atlas",
"Trace Atlas Textures",
"Debug texture atlas management")
OPT (BLEND_STRINGS,
"Cogl Tracing",
"blend-strings",
"Trace Blend Strings",
"Debug CoglBlendString parsing")
OPT (JOURNAL,
"Cogl Tracing",
"journal",
"Trace Journal",
"View all the geometry passing through the journal")
OPT (BATCHING,
"Cogl Tracing",
"batching",
"Trace Batching",
"Show how geometry is being batched in the journal")
OPT (MATRICES,
"Cogl Tracing",
"matrices",
"Trace matrices",
"Trace all matrix manipulation")
/* XXX we should replace the "draw" option its very hand wavy... */
OPT (DRAW,
"Cogl Tracing",
"draw",
"Trace Misc Drawing",
"Trace some misc drawing operations")
OPT (PANGO,
"Cogl Tracing",
"pango",
"Trace Pango Renderer",
"Trace the Cogl Pango renderer")
OPT (TEXTURE_PIXMAP,
"Cogl Tracing",
"texture-pixmap",
"Trace CoglTexturePixmap backend",
"Trace the Cogl texture pixmap backend")
OPT (RECTANGLES,
"Visualize",
"rectangles",
"Outline rectangles",
"Add wire outlines for all rectangular geometry")
debug: Adds a COGL_DEBUG=wireframe option This adds a COGL_DEBUG=wireframe option to visualize the underlying geometry of the primitives being drawn via Cogl. This works for triangle list, triangle fan, triangle strip and quad (internal only) primitives. It also works for indexed vertex arrays.
2010-11-16 13:06:08 +00:00
OPT (WIREFRAME,
"Visualize",
"wireframe",
"Show wireframes",
"Add wire outlines for all geometry")
profile: Update to uprof-0.3 dep for --enable-profile When building with --enable-profile we now depend on the uprof-0.3 developer release which brings a few improvements: » It lets us "fix" how we initialize uprof so that instead of using a shared object constructor/destructor (which was a hack used when first adding uprof support to Clutter) we can now initialize as part of clutter's normal initialization code. As a side note though, I found that the way Clutter initializes has some quite serious problems whenever it involves GOptionGroups. It is not able to guarantee the initialization of dependencies like uprof and Cogl. For this reason we still use the contructor/destructor approach to initialize uprof in Cogl. » uprof-0.3 provides a better API for adding custom columns when reporting timer and counter statistics which lets us remove quite a lot of manual report generation code in clutter-profile.c. » uprof-0.3 provides a shared context for tracking mainloop timer statistics. This means any mainloop based library following the same "Mainloop" timer naming convention can use the shared context and no matter who ends up owning the final mainloop the statistics will always be in the same place. This allows profiling of Clutter with an external mainloop such as with the Mutter compositor. » uprof-0.3 can export statistics over dbus and comes with an ncurses based ui to vizualize timer and counter stats live. The latest version of uprof can be cloned from: git://github.com/rib/UProf.git
2010-06-21 14:36:46 +00:00
OPT (DISABLE_BATCHING,
"Root Cause",
"disable-batching",
"Disable Journal batching",
"Disable batching of geometry in the Cogl Journal.")
OPT (DISABLE_VBOS,
"Root Cause",
"disable-vbos",
"Disable GL Vertex Buffers",
"Disable use of OpenGL vertex buffer objects")
OPT (DISABLE_PBOS,
"Root Cause",
"disable-pbos",
"Disable GL Pixel Buffers",
"Disable use of OpenGL pixel buffer objects")
OPT (DISABLE_SOFTWARE_TRANSFORM,
"Root Cause",
"disable-software-transform",
"Disable software rect transform",
"Use the GPU to transform rectangular geometry")
OPT (DUMP_ATLAS_IMAGE,
"Cogl Specialist",
"dump-atlas-image",
"Dump atlas images",
"Dump texture atlas changes to an image file")
OPT (DISABLE_ATLAS,
"Root Cause",
"disable-atlas",
"Disable texture atlasing",
"Disable use of texture atlasing")
cogl-debug: Add an option to disable atlasing sharing If COGL_DEBUG contains disable-shared-atlas Cogl will not try to share the atlas between glyphs and images.
2011-03-30 15:39:38 +00:00
OPT (DISABLE_SHARED_ATLAS,
"Root Cause",
"disable-shared-atlas",
"Disable sharing the texture atlas between text and images",
"When this is set the glyph cache will always use a separate texture "
"for its atlas. Otherwise it will try to share the atlas with images.")
profile: Update to uprof-0.3 dep for --enable-profile When building with --enable-profile we now depend on the uprof-0.3 developer release which brings a few improvements: » It lets us "fix" how we initialize uprof so that instead of using a shared object constructor/destructor (which was a hack used when first adding uprof support to Clutter) we can now initialize as part of clutter's normal initialization code. As a side note though, I found that the way Clutter initializes has some quite serious problems whenever it involves GOptionGroups. It is not able to guarantee the initialization of dependencies like uprof and Cogl. For this reason we still use the contructor/destructor approach to initialize uprof in Cogl. » uprof-0.3 provides a better API for adding custom columns when reporting timer and counter statistics which lets us remove quite a lot of manual report generation code in clutter-profile.c. » uprof-0.3 provides a shared context for tracking mainloop timer statistics. This means any mainloop based library following the same "Mainloop" timer naming convention can use the shared context and no matter who ends up owning the final mainloop the statistics will always be in the same place. This allows profiling of Clutter with an external mainloop such as with the Mutter compositor. » uprof-0.3 can export statistics over dbus and comes with an ncurses based ui to vizualize timer and counter stats live. The latest version of uprof can be cloned from: git://github.com/rib/UProf.git
2010-06-21 14:36:46 +00:00
OPT (DISABLE_TEXTURING,
"Root Cause",
"disable-texturing",
"Disable texturing",
"Disable texturing any primitives")
OPT (DISABLE_ARBFP,
"Root Cause",
"disable-arbfp",
"Disable arbfp",
"Disable use of ARB fragment programs")
Add a COGL_DEBUG option to disable the fixed function pipeline backend This adds COGL_DEBUG=disable-fixed to disable the fixed function pipeline backend. This is needed to test the GLSL shader generation because otherwise the fixed function backend would always override it.
2010-11-24 17:29:00 +00:00
OPT (DISABLE_FIXED,
"Root Cause",
"disable-fixed",
"Disable fixed",
"Disable use of the fixed function pipeline backend")
profile: Update to uprof-0.3 dep for --enable-profile When building with --enable-profile we now depend on the uprof-0.3 developer release which brings a few improvements: » It lets us "fix" how we initialize uprof so that instead of using a shared object constructor/destructor (which was a hack used when first adding uprof support to Clutter) we can now initialize as part of clutter's normal initialization code. As a side note though, I found that the way Clutter initializes has some quite serious problems whenever it involves GOptionGroups. It is not able to guarantee the initialization of dependencies like uprof and Cogl. For this reason we still use the contructor/destructor approach to initialize uprof in Cogl. » uprof-0.3 provides a better API for adding custom columns when reporting timer and counter statistics which lets us remove quite a lot of manual report generation code in clutter-profile.c. » uprof-0.3 provides a shared context for tracking mainloop timer statistics. This means any mainloop based library following the same "Mainloop" timer naming convention can use the shared context and no matter who ends up owning the final mainloop the statistics will always be in the same place. This allows profiling of Clutter with an external mainloop such as with the Mutter compositor. » uprof-0.3 can export statistics over dbus and comes with an ncurses based ui to vizualize timer and counter stats live. The latest version of uprof can be cloned from: git://github.com/rib/UProf.git
2010-06-21 14:36:46 +00:00
OPT (DISABLE_GLSL,
"Root Cause",
"disable-glsl",
"Disable GLSL",
"Disable use of GLSL")
OPT (DISABLE_BLENDING,
"Root Cause",
"disable-blending",
"Disable blending",
"Disable use of blending")
Replace the disable-npots tool with a COGL_DEBUG option Previously in the tests/tools directory we build a disable-npots library which was used as an LD_PRELOAD to trick Cogl in to thinking there is no NPOT texture extension. This is a little awkward to use so it seems much simpler to just define a COGL_DEBUG option to disable npot textures.
2010-11-05 14:55:46 +00:00
OPT (DISABLE_NPOT_TEXTURES,
"Root Cause",
"disable-npot-textures",
"Disable non-power-of-two textures",
"Makes Cogl think that the GL driver doesn't support NPOT textures "
"so that it will create sliced textures or textures with waste instead.")
Add a COGL_DEBUG option to disable software clipping This adds a debug option called disable-software-clipping which causes the journal to always log the clip stack state rather than trying to manually clip rectangles.
2010-11-10 14:02:31 +00:00
OPT (DISABLE_SOFTWARE_CLIP,
"Root Cause",
"disable-software-clip",
"Disable software clipping",
"Disables Cogl's attempts to clip some rectangles in software.")
profile: Update to uprof-0.3 dep for --enable-profile When building with --enable-profile we now depend on the uprof-0.3 developer release which brings a few improvements: » It lets us "fix" how we initialize uprof so that instead of using a shared object constructor/destructor (which was a hack used when first adding uprof support to Clutter) we can now initialize as part of clutter's normal initialization code. As a side note though, I found that the way Clutter initializes has some quite serious problems whenever it involves GOptionGroups. It is not able to guarantee the initialization of dependencies like uprof and Cogl. For this reason we still use the contructor/destructor approach to initialize uprof in Cogl. » uprof-0.3 provides a better API for adding custom columns when reporting timer and counter statistics which lets us remove quite a lot of manual report generation code in clutter-profile.c. » uprof-0.3 provides a shared context for tracking mainloop timer statistics. This means any mainloop based library following the same "Mainloop" timer naming convention can use the shared context and no matter who ends up owning the final mainloop the statistics will always be in the same place. This allows profiling of Clutter with an external mainloop such as with the Mutter compositor. » uprof-0.3 can export statistics over dbus and comes with an ncurses based ui to vizualize timer and counter stats live. The latest version of uprof can be cloned from: git://github.com/rib/UProf.git
2010-06-21 14:36:46 +00:00
OPT (SHOW_SOURCE,
"Cogl Tracing",
"show-source",
"Show source",
"Show generated ARBfp/GLSL source code")
OPT (OPENGL,
"Cogl Tracing",
"opengl",
"Trace some OpenGL",
"Traces some select OpenGL calls")
OPT (OFFSCREEN,
"Cogl Tracing",
"offscreen",
"Trace offscreen support",
"Debug offscreen support")
arbfp: Adds an ARBfp program cache This adds a cache (A GHashTable) of ARBfp programs and before ever starting to code-generate a new program we will always first try and find an existing program in the cache. This uses _cogl_pipeline_hash and _cogl_pipeline_equal to hash and compare the keys for the cache. There is a new COGL_DEBUG=disable-program-caches option that can disable the cache for debugging purposes.
2010-12-03 12:01:18 +00:00
OPT (DISABLE_BLENDING,
"Root Cause",
"disable-program-caches",
"Disable program caches",
"Disable fallback caches for arbfp and glsl programs")
debug: Adds a COGL_DEBUG=disable-fast-read-pixel option COGL_DEBUG=disable-fast-read-pixel can be used to disable the optimization for reading a single pixel colour back by looking at the geometry in the journal and not involving the GPU. With this disabled we will always flush the journal, rendering to the framebuffer and then use glReadPixels to get the result.
2011-01-20 14:41:51 +00:00
OPT (DISABLE_FAST_READ_PIXEL,
"Root Cause",
"disable-fast-read-pixel",
"Disable read pixel optimization",
"Disable optimization for reading 1px for simple "
"scenes of opaque rectangles")
cogl-debug: Add a debug option for tracing clipping This adds a COGL_DEBUG=clipping option that reports how the clip is being flushed. This is needed to determine whether the scissor, stencil clip planes or software clipping is being used.
2011-01-24 16:36:56 +00:00
OPT (CLIPPING,
"Cogl Tracing",
"clipping",
"Trace clipping",
"Logs information about how Cogl is implementing clipping")
Copy permalink