ladybird/Userland/Libraries/LibSoftGPU/Config.h

/*
 * Copyright (c) 2021, Stephan Unverwerth <s.unverwerth@serenityos.org>
 *
 * SPDX-License-Identifier: BSD-2-Clause
 */

#pragma once

#define INCREASE_STATISTICS_COUNTER(stat, n)     \
    do {                                         \
        if constexpr (ENABLE_STATISTICS_OVERLAY) \
            stat += (n);                         \
    } while (0)

namespace SoftGPU {

static constexpr bool ENABLE_STATISTICS_OVERLAY = false;
static constexpr int NUM_SAMPLERS = 2;
static constexpr int MILLISECONDS_PER_STATISTICS_PERIOD = 500;
static constexpr int NUM_LIGHTS = 8;

// See: https://www.khronos.org/opengl/wiki/Common_Mistakes#Texture_edge_color_problem
// FIXME: make this dynamically configurable through ConfigServer
static constexpr bool CLAMP_DEPRECATED_BEHAVIOR = false;

}
LibSoftGPU: Put all constexpr config options into Config.h 2021-12-29 21:59:13 +01:00			`/*`
			`* Copyright (c) 2021, Stephan Unverwerth <s.unverwerth@serenityos.org>`
			`*`
			`* SPDX-License-Identifier: BSD-2-Clause`
			`*/`

			`#pragma once`

LibSoftGPU: Add option to render a debug overlay This displays statistics regarding frame timings and number of pixels rendered. Timings are based on the time between draw_debug_overlay() invocations. This measures actual number of frames presented to the user vs. wall clock time so this also includes everything the app might do besides rendering. Triangles are counted after clipping. This number might actually be higher than the number of triangles coming from LibGL. Pixels are counted after the initial scissor and coverage test. Pixels rejected here are not counted. Shaded pixels is the percentage of all pixels that made it to the shading stage. Blended pixels is the percentage of shaded pixels that were alpha blended to the color buffer. Overdraw measures how many pixels were shaded vs. how many pixels the render target has. e.g. a 640x480 render target has 307200 pixels. If exactly that many pixels are shaded the overdraw number will read 0%. 614400 shaded pixels will read as an overdraw of 100%. Sampler calls is simply the number of times sampler.sample_2d() was called. 2021-12-30 01:04:55 +01:00			`#define INCREASE_STATISTICS_COUNTER(stat, n) \`
			`do { \`
			`if constexpr (ENABLE_STATISTICS_OVERLAY) \`
			`stat += (n); \`
			`} while (0)`

LibSoftGPU: Put all constexpr config options into Config.h 2021-12-29 21:59:13 +01:00			`namespace SoftGPU {`

LibSoftGPU: Add option to render a debug overlay This displays statistics regarding frame timings and number of pixels rendered. Timings are based on the time between draw_debug_overlay() invocations. This measures actual number of frames presented to the user vs. wall clock time so this also includes everything the app might do besides rendering. Triangles are counted after clipping. This number might actually be higher than the number of triangles coming from LibGL. Pixels are counted after the initial scissor and coverage test. Pixels rejected here are not counted. Shaded pixels is the percentage of all pixels that made it to the shading stage. Blended pixels is the percentage of shaded pixels that were alpha blended to the color buffer. Overdraw measures how many pixels were shaded vs. how many pixels the render target has. e.g. a 640x480 render target has 307200 pixels. If exactly that many pixels are shaded the overdraw number will read 0%. 614400 shaded pixels will read as an overdraw of 100%. Sampler calls is simply the number of times sampler.sample_2d() was called. 2021-12-30 01:04:55 +01:00			`static constexpr bool ENABLE_STATISTICS_OVERLAY = false;`
LibSoftGPU: Reduce number of samplers to 2 OpenGL mandates at least 2 texture units when multitexturing is supported. This keeps our vertices lean and gives a nice speed improvement in glquake. Until we support shaders this should be enough. 2022-01-15 21:10:22 +01:00			`static constexpr int NUM_SAMPLERS = 2;`
LibSoftGPU: Configure stats overlay period Problem: - The statistics overlay period is hardcoded to 500 ms. This time is very short and can result in the values being very "jumpy". Solution: - Increasing this value can result in more steady values which is useful when trying to evaluate the performance impact of a change. A new config value is offered in `Config.h` to let the developer change to any value desired. 2022-01-08 14:30:56 -07:00			`static constexpr int MILLISECONDS_PER_STATISTICS_PERIOD = 500;`
LibGL+LibSoftGPU: Add `GL_MAX_LIGHTS` to get_context_parameter This is required to allow lighting to work properly in the GL. We currently have the maximum number of lights in the software GL context set to 8, as this is the minimum that OpenGL mandates according to the spec. 2022-01-07 22:32:32 +11:00			`static constexpr int NUM_LIGHTS = 8;`
LibSoftGPU: Put all constexpr config options into Config.h 2021-12-29 21:59:13 +01:00
			`// See: https://www.khronos.org/opengl/wiki/Common_Mistakes#Texture_edge_color_problem`
			`// FIXME: make this dynamically configurable through ConfigServer`
			`static constexpr bool CLAMP_DEPRECATED_BEHAVIOR = false;`

			`}`