summaryrefslogtreecommitdiff
path: root/vcl/skia/README
diff options
context:
space:
mode:
authorLuboš Luňák <l.lunak@collabora.com>2019-10-29 13:06:40 +0100
committerLuboš Luňák <l.lunak@collabora.com>2019-11-27 09:55:13 +0100
commite614161cadb2d882b2275dc9d1166050d201fae1 (patch)
tree164c0fcb829a9a97323b2ac165a61b08e4f5dd4b /vcl/skia/README
parent065034637e53975e138887a900ba840f59353709 (diff)
add Skia VCL README with some basic information
Change-Id: Ifff230ce76b4b33cd91322e564be1685afea763f
Diffstat (limited to 'vcl/skia/README')
-rw-r--r--vcl/skia/README24
1 files changed, 24 insertions, 0 deletions
diff --git a/vcl/skia/README b/vcl/skia/README
new file mode 100644
index 000000000000..6c3da7254b8b
--- /dev/null
+++ b/vcl/skia/README
@@ -0,0 +1,24 @@
+This is code for using the Skia library as a drawing library in VCL backends.
+See external/skia for info on the library itself.
+
+Environment variables:
+======================
+
+SAL_DISABLESKIA=1 - force disabled Skia
+SAL_ENABLESKIA=1 - enable Skia, unless blacklisted (and if the VCL backend supports Skia)
+SAL_FORCESKIA=1 - force using Skia, even if blacklisted
+SAL_SKIA=raster|vulkan - select Skia's drawing method, by default Vulkan is used
+
+There also also GUI options for controlling whether Skia is enabled.
+
+Note that many backends do not use Skia. E.g. on Linux it is necessary to also use
+SAL_USE_VCLPLUGIN=gen .
+
+Skia drawing methods:
+=====================
+
+Skia supports several methods to draw:
+- Raster - CPU-based drawing (here primarily used for debugging)
+- Vulkan - Vulkan-based GPU drawing, this is the default
+
+There are more (OpenGL, Metal on Mac, etc.), but (as of now) they are not supported by VCL.