###############################################################################
# /etc/environment
#
# To reload the Wayland environment, run:
#   kwin_wayland --replace
#   env KEY=VAL KEY2=VAL2 ... kwin_wayland --replace
###############################################################################


###############################################################################
# Vendor / Graphics Driver Settings
###############################################################################
# __GL_VRR_ALLOWED
# Enables Variable Refresh Rate (VRR) support for NVIDIA drivers.
# Set to 1 to allow VRR for smoother display output on compatible monitors.
#__GL_VRR_ALLOWED=1

# __GL_GSYNC_ALLOWED
# Enables NVIDIA G-SYNC functionality for supported displays.
# Set to 1 to allow G-SYNC for reduced screen tearing.
#__GL_GSYNC_ALLOWED=1

# __GL_SYNC_TO_VBLANK
# Synchronizes OpenGL rendering with the display’s vertical blank.
# Set to 1 to enable vertical synchronization (vsync) and minimize tearing.
#__GL_SYNC_TO_VBLANK=1

# __GL_THREADED_OPTIMIZATIONS
# Enables threaded optimizations in OpenGL.
# Set to 1 to allow multi-threaded improvements in rendering performance.
#__GL_THREADED_OPTIMIZATIONS=1

# __GL_YIELD
# Controls whether OpenGL should yield processing time to other threads.
# Set to 1 to yield processor time during intensive rendering.
#__GL_YIELD=1

# __GLX_VENDOR_LIBRARY_NAME
# Specifies the vendor library to use for GLX.
# This variable is used to select the appropriate graphics driver.
# For NVIDIA proprietary drivers, set to "nvidia".
__GLX_VENDOR_LIBRARY_NAME=nvidia

# LIBGL_DEBUG
# Activates debug output for Mesa’s libGL.
# Useful for troubleshooting OpenGL issues (e.g., set to "verbose").
#LIBGL_DEBUG=verbose

# MESA_DEBUG
# Enables additional debugging output from the Mesa graphics library.
# Set to 1 for enhanced debugging information.
#MESA_DEBUG=1

# MESA_NO_ERROR
# Disables Mesa’s error checking to improve performance.
# Set to 1 to disable error reporting (use with caution).
#MESA_NO_ERROR=1

# MESA_GL_VERSION_OVERRIDE
# Overrides the OpenGL version reported by Mesa.
# Useful for testing compatibility with specific OpenGL versions.
#MESA_GL_VERSION_OVERRIDE=...

# MESA_GLES_VERSION_OVERRIDE
# Overrides the OpenGL ES version reported by Mesa.
# Useful for compatibility testing on mobile or embedded systems.
#MESA_GLES_VERSION_OVERRIDE=...

# MESA_SHADER_CACHE_DISABLE
# Disables the shader caching mechanism in Mesa.
# Set to 1 to disable caching (typically for debugging purposes).
#MESA_SHADER_CACHE_DISABLE=1

# VDPAU_DRIVER
# Specifies the VDPAU (Video Decode and Presentation API for Unix) driver to use.
# For NVIDIA, set to "nvidia" to enable proper video decoding acceleration.
#VDPAU_DRIVER=nvidia

# __NV_PRIME_RENDER_OFFLOAD
# Enables NVIDIA Prime Render Offload for offloading rendering tasks to the NVIDIA GPU.
# Set to 1 to activate offloading for hybrid graphics configurations.
#__NV_PRIME_RENDER_OFFLOAD=1


###############################################################################
# Additional OpenGL Driver Options
###############################################################################
# __GL_ALLOW_FXAA_USAGE
# Allows the use of Fast Approximate Anti-Aliasing (FXAA) to smooth jagged edges.
# Set to 1 to enable FXAA.
#__GL_ALLOW_FXAA_USAGE=1

# __GL_ALLOW_UNOFFICIAL_PROTOCOL
# Allows usage of unofficial or non-standard OpenGL protocols.
# Set to 1 to enable such protocols.
#__GL_ALLOW_UNOFFICIAL_PROTOCOL=1

# __GL_ConformantBlitFramebufferScissor
# Enforces conformant scissor behavior during framebuffer blit operations.
# Set to 1 to standardize scissor operations during blit.
#__GL_ConformantBlitFramebufferScissor=1

# __GL_DOOM3
# Enables specific optimizations or compatibility features for the Doom 3 engine.
# Set to 1 to activate Doom 3–related rendering adjustments.
#__GL_DOOM3=1

# __GL_ExtensionStringVersion
# Overrides the reported version of the OpenGL extension string.
# Useful for compatibility with applications expecting a specific extension version.
#__GL_ExtensionStringVersion=...

# __GL_FSAA_MODE
# Sets the Full-Scene Anti-Aliasing (FSAA) mode for rendering.
# Specify an integer value corresponding to the desired FSAA level.
#__GL_FSAA_MODE=...

# __GL_IGNORE_GLSL_EXT_REQS
# Instructs the driver to ignore certain GLSL extension requirements.
# Set to 1 to bypass strict GLSL extension checks.
#__GL_IGNORE_GLSL_EXT_REQS=1

# __GL_LOG_MAX_ANISO
# Defines the maximum anisotropic filtering level to be logged for debugging.
# Set a numeric value to specify the maximum anisotropy level.
#__GL_LOG_MAX_ANISO=...

# __GL_NO_DSO_FINALIZER
# Disables finalization routines for dynamically loaded shared objects (DSO).
# Set to 1 to disable finalizers when troubleshooting cleanup issues.
#__GL_NO_DSO_FINALIZER=1

# __GL_SELINUX_BOOLEANS
# Configures SELinux booleans related to OpenGL driver behavior.
# Set the appropriate booleans for your security context.
#__GL_SELINUX_BOOLEANS=...

# __GL_SHADER_DISK_CACHE
# Enables or disables the use of a disk cache for compiled shaders.
# Set to 1 to enable caching for improved shader load performance.
#__GL_SHADER_DISK_CACHE=1

# __GL_SHADER_DISK_CACHE_PATH
# Specifies the file system path for storing the shader disk cache.
# Set this to a directory where cached shaders should be stored.
#__GL_SHADER_DISK_CACHE_PATH=/path/to/shader/cache

# __GL_SHARPEN_ENABLE
# Enables a sharpening filter in the OpenGL rendering pipeline.
# Set to 1 to activate image sharpening.
#__GL_SHARPEN_ENABLE=1

# __GL_SHARPEN_IGNORE_FILM_GRAIN
# Configures the sharpening filter to ignore film grain effects.
# Set to 1 to bypass film grain during the sharpening process.
#__GL_SHARPEN_IGNORE_FILM_GRAIN=1

# __GL_SHARPEN_VALUE
# Sets the intensity value for the sharpening filter.
# Use a numeric value to define the level of sharpening applied.
#__GL_SHARPEN_VALUE=...

# __GL_SHOW_GRAPHICS_OSD
# Displays an on-screen display (OSD) for graphics diagnostics and performance.
# Set to 1 to enable the graphics OSD.
#__GL_SHOW_GRAPHICS_OSD=1

# __GL_SINGLE_THREADED
# Forces OpenGL operations to run in a single-threaded mode.
# Set to 1 to disable multi-threading, which may help in debugging.
#__GL_SINGLE_THREADED=1

# __GL_SORT_FBCONFIGS
# Enables sorting of framebuffer configurations for optimal selection.
# Set to 1 to automatically sort and choose the best framebuffer configuration.
#__GL_SORT_FBCONFIGS=1

# __GL_SYNC_DISPLAY_DEVICE
# Synchronizes rendering with a specific display device.
# Set this variable to the identifier of the target display device.
#__GL_SYNC_DISPLAY_DEVICE=...

# __GL_WRITE_TEXT_SECTION
# Controls whether textual sections of shaders are written for debugging purposes.
# Set to 1 to enable writing of shader text sections.
#__GL_WRITE_TEXT_SECTION=1


###############################################################################
# Platform and Environment Settings
###############################################################################
# XDG_SESSION_TYPE
# Defines the type of session (e.g., "x11" or "wayland").
# This setting determines which window system will be used.
#XDG_SESSION_TYPE=wayland

# CLUTTER_BACKEND
# Sets the backend for Clutter applications.
# Common values include "x11" or "wayland" depending on your environment.
#CLUTTER_BACKEND=wayland

# GBM_BACKEND
# Specifies the backend for the Generic Buffer Manager (GBM).
# Used in rendering systems that support GBM.
#GBM_BACKEND=...

# LIBVA_DRIVER_NAME
# Defines the driver for VA-API (Video Acceleration API) for hardware video decoding.
# Common values might be "i965", "vaapi", or "nvidia" for NVIDIA proprietary drivers.
#LIBVA_DRIVER_NAME=nvidia

# QT_ENABLE_HIGHDPI_SCALING
# Enables High DPI scaling for Qt applications.
# Set to 1 to automatically adjust application scaling on high-resolution displays.
QT_ENABLE_HIGHDPI_SCALING=1

# QT_AUTO_SCREEN_SCALE_FACTOR
# Allows Qt to automatically scale the user interface based on screen DPI.
# Uncomment and set to 1 if you want automatic DPI adjustments.
#QT_AUTO_SCREEN_SCALE_FACTOR=1

# QT_SCALE_FACTOR
# Manually sets the scaling factor for Qt applications.
# Useful for overriding automatic scaling; default is typically 1.0.
#QT_SCALE_FACTOR=1.0

# QT_QPA_PLATFORM
# Determines the Qt platform plugin to use.
# Valid options include "xcb" for X11 and "wayland" for Wayland.
#QT_QPA_PLATFORM=wayland

# QT_QPA_PLATFORMTHEME
# Sets the platform theme for Qt applications.
# Common themes include "gtk2", "qt5ct", etc.
QT_QPA_PLATFORMTHEME=qt5ct

# QT_LOGGING_CONF
# Specifies the file path for Qt’s logging configuration.
# Use this to define custom logging settings for Qt applications.
#QT_LOGGING_CONF=/path/to/logging.conf


###############################################################################
# Window Manager and Compositor Settings
###############################################################################
# QT_XCB_NO_COMPOSITE
# Disables Qt’s internal compositing on XCB (X11).
# Set to 1 if you want to force the use of an external compositor.
#QT_XCB_NO_COMPOSITE=1

# QT_WAYLAND_DISABLE_WINDOWDECORATION
# Disables Qt’s internal window decorations under Wayland.
# This allows the compositor (e.g., KWin) to manage window borders and title bars.
QT_WAYLAND_DISABLE_WINDOWDECORATION=1

# KWIN_X11_FORCE_SOFTWARE_VSYNC
# Forces KWin to use software vsync on X11.
# Useful for testing or when hardware vsync causes issues.
#KWIN_X11_FORCE_SOFTWARE_VSYNC=1

# KWIN_X11_REFRESH_RATE
# Specifies the refresh rate (in Hz) for KWin on X11.
# Define your display's refresh rate here (e.g., 60, 144).
#KWIN_X11_REFRESH_RATE=60

# KWIN_TRIPLE_BUFFER
# Enables triple buffering in KWin.
# Triple buffering may smooth display output at the cost of increased latency.
#KWIN_TRIPLE_BUFFER=1

# KWIN_DRM_NO_AMS
# Disables Atomic Modesetting (AMS) in KWin's DRM backend.
# Use this setting to troubleshoot display issues on some hardware configurations.
#KWIN_DRM_NO_AMS=1