vcl/README.vars

   1 Environment variables in VCL:
   2
   3 General
   4 -------
   5 SAL_USE_VCLPLUGIN - use a VCL plugin
   6 SAL_RTL_ENABLED - Enable RTL UI
   7 SAL_NO_NWF - disable native widgets
   8 SAL_FORCEDPI - force a specific DPI (gtk3 & qt5/kf5 plugins only)
   9 SAL_FORCE_HC - force high-contrast mode
  10
  11 SAL_NO_FONT_LOOKUP - disable font search and fallback and always use a hard-coded font name (for some unit tests)
  12
  13 LO_COLLECT_UIINFO - enable the uitesting logging, value is expected to be a relative file name that
  14 will be used to write the log under instdir/uitest/.
  15
  16 VCL_DOUBLEBUFFERING_AVOID_PAINT - don't paint the buffer, useful to see where we do direct painting
  17 VCL_DOUBLEBUFFERING_FORCE_ENABLE - enable double buffered painting
  18 VCL_DOUBLEBUFFERING_ENABLE - enable a safe subset of double buffered painting (currently in Writer, not in any other applications)
  19
  20 VCL_DEBUG_DISABLE_PDFCOMPRESSION - disable compression in the PDF writer
  21
  22 Gtk+
  23 ----
  24 VCL_GTK3_PAINTDEBUG - in debug builds, if set to 1 then holding down shift+0 forces a redraw event, shift+1 repaints everything, and
  25 shift+2 dumps cairo frames to pngs as /tmp/frame<n>.png
  26 GDK_SCALE=2 - for HiDPI scaling (just supports integers)
  27
  28 Bitmap
  29 ------
  30 VCL_NO_THREAD_SCALE - disable threaded bitmap scale
  31 VCL_NO_THREAD_IMPORT - disable threaded bitmap import
  32 EMF_PLUS_DISABLE - use EMF rendering and ignore EMF+ specifics
  33
  34 OpenGL
  35 ------
  36 SAL_FORCEGL - force enable OpenGL
  37 SAL_GL_NO_SWAP - disable buffer swapping if set (should show nothing)
  38 SAL_GL_SLEEP_ON_SWAP - sleep for half a second on each swap-buffers.
  39 SAL_DISABLE_WATCHDOG - don't start the thread that watches for broken GL/Vulkan/OpenCL drivers
  40 SAL_DISABLE_GLYPH_CACHING - don't render glyphs through OpenGL textures or Skia surfaces
  41
  42 Skia
  43 ----
  44 SAL_DISABLESKIA=1 - force disabled Skia
  45 SAL_ENABLESKIA=1 - enable Skia, unless denylisted (and if the VCL backend supports Skia)
  46 SAL_FORCESKIA=1 - force using Skia, even if denylisted
  47 SAL_SKIA=raster|vulkan - select Skia's drawing method, by default Vulkan is used
  48 SAL_DISABLE_SKIA_CACHE=1 - disable caching of complex images
  49 SAL_SKIA_KEEP_BITMAP_BUFFER=1 - SkiaSalBitmap will keep its bitmap buffer even after storing in SkImage
  50
  51 OpenGL,Skia
  52 -----------
  53 SAL_WITHOUT_WIDGET_CACHE - disable LRU caching of native widget textures
  54
  55 Qt
  56 -----
  57 QT_SCALE_FACTOR=2 - for HiDPI testing (also supports float)
  58 SAL_VCL_QT5_NO_FONTCONFIG - ignore fontconfig provided font substitutions
  59 SAL_VCL_QT5_NO_NATIVE - disable QStyle'd controls
  60 SAL_VCL_QT5_USE_CAIRO - use cairo for text rendering and fonts (default for kf5, but not qt5)