doc: updated example toolchain files to match current set of build flags

Signed-off-by: Timo Lotterbach <timo.lotterbach@bmw-carit.de>

2 files changed, 176 insertions, 43 deletions

diff --git a/toolchain.cmake b/toolchain.cmake
index 4b2138d..d52ba92 100644
--- a/toolchain.cmake
+++ b/toolchain.cmake
@@ -29,41 +29,97 @@
 #                                                                              #
 ################################################################################
 
-# Disable all GLX Examples
-set (WITH_GLX_EXAMPLE OFF CACHE BOOL "" FORCE)
+# update these settings as required by your target
 
-# Enable all EGL X11 Examples like EGLX11ApplicationExample EGLX11MockNavigation
-set (WITH_EGL_EXAMPLE ON CACHE BOOL "" FORCE)
+# Build examples for client library usage
+set (WITH_CLIENTEXAMPLES             ON  CACHE BOOL "" FORCE)
 
-# Disable all Wayland Examples like EGLWLApplicationExample EGLWLMockNavigation
-set (WITH_WL_EXAMPLE OFF CACHE BOOL "" FORCE)
+# Build LayerManagement client library
+set (WITH_CLIENT_LIB                 ON  CACHE BOOL "" FORCE)
 
-# Enable EGL/GLES 2.0 X11 Renderer / Compositor Plug In
-set (WITH_X11_GLES ON CACHE BOOL "" FORCE)
+# Build renderer plugin for OpenGL/X11 based platforms
+set (WITH_DESKTOP                    OFF CACHE BOOL "" FORCE)
 
-# Disable EGL/GLES 2.0 Wayland Renderer / Compositor Plug In
-set (WITH_WAYLAND OFF CACHE BOOL "" FORCE)
+# Build LayerManagerControl binary
+set (WITH_CONTROL_BIN                ON  CACHE BOOL "" FORCE)
 
-# Disable EGL/GLES 2.0 Wayland Renderer / Compositor Plug In X11
-set (WITH_WAYLAND_X11 OFF CACHE BOOL "" FORCE)
+# Build LayerManagement control library
+set (WITH_CONTROL_LIB                OFF CACHE BOOL "" FORCE)
 
-# Disable EGL/GLES 2.0 Wayland Renderer / Compositor Plug In FBDEV
-set (WITH_WAYLAND_FBDEV OFF CACHE BOOL "" FORCE)
+# Build with DLT logging support
+set (WITH_DLT                        OFF CACHE BOOL "" FORCE)
 
-# Disable all OpenGL 1.1 X11 Renderer / Compositor Plug In
-set (WITH_DESKTOP OFF CACHE BOOL "" FORCE)
+# Generate documentation during build (requires doxygen)
+set (WITH_DOCUMENTATION              OFF CACHE BOOL "" FORCE)
 
-# Disable copy of offscreen buffer into texturespace use zero copy - Driver Support needed !
-set (WITH_FORCE_COPY OFF CACHE BOOL "" FORCE)
+# Build examples for GLES/X11 based platforms
+set (WITH_EGL_EXAMPLE                ON  CACHE BOOL "" FORCE)
 
-# Disable compilation of unit test
-set (WITH_TESTS OFF CACHE BOOL "" FORCE)
+# Build scene provider plugin to run example applications
+set (WITH_EXAMPLE_SCENE_PROVIDER     OFF CACHE BOOL "" FORCE)
 
-# Enable XThreads to post signals over different threads - switching polling to push notification
-set (WITH_XTRHEADS ON CACHE BOOL "" FORCE)
+# Force Software Copy of Pixmaps (compatibility for VMs)
+set (WITH_FORCE_COPY                 OFF CACHE BOOL "" FORCE)
 
-# Disable DLT Logging
-set (WITH_DLT OFF CACHE BOOL "" FORCE)
+# Build Generic Communicator Plugin based on IpcModules
+set (WITH_GENERIC_COMMUNICATOR       ON  CACHE BOOL "" FORCE)
+
+# Build development library for GLES/X11 based renderers
+set (WITH_GLESv2_LIB                 OFF CACHE BOOL "" FORCE)
+
+# Build examples for OpenGL/X11 based platforms
+set (WITH_GLX_EXAMPLE                OFF CACHE BOOL "" FORCE)
+
+# Build development library for OpenGL/X11 based renderers
+set (WITH_GLX_LIB                    OFF CACHE BOOL "" FORCE)
+
+# Build with TCP Ipc Module
+set (WITH_IPC_MODULE_TCP             OFF CACHE BOOL "" FORCE)
+
+# Build with D-Bus Ipc Module
+set (WITH_IPC_MODULE_DBUS            ON  CACHE BOOL "" FORCE)
+
+# Build LayerManagerService binary
+set (WITH_SERVICE_BIN                ON  CACHE BOOL "" FORCE)
+
+# Link all plugins and libraries statically
+set (WITH_STATIC_LIBRARIES           OFF CACHE BOOL "" FORCE)
+
+# Report styleguide problems during build (requires python)
+set (WITH_STYLE_CHECKING             OFF CACHE BOOL "" FORCE)
+
+# Build plugin for systemd based health monitoring
+set (WITH_SYSTEMD_HEALTH_MONITOR     OFF CACHE BOOL "" FORCE)
+
+# Build unit test binaries for all enabled components
+set (WITH_TESTS                      OFF CACHE BOOL "" FORCE)
+
+# Build renderer plugin with pure logging (no rendering)
+set (WITH_TEXT_RENDERER              OFF CACHE BOOL "" FORCE)
+
+# Build renderer plugin for GLES/Wayland with X11 backend
+set (WITH_WAYLAND_X11                OFF CACHE BOOL "" FORCE)
+
+# Build development library for GLES/Wayland X11 based renderers
+set (WITH_WAYLAND_X11_LIB            OFF CACHE BOOL "" FORCE)
+
+# Build renderer plugin for GLES/Wayland with DRM backend
+set (WITH_WAYLAND_DRM                OFF CACHE BOOL "" FORCE)
+
+# Build development library for GLES/Wayland DRM based renderers
+set (WITH_WAYLAND_DRM_LIB            OFF CACHE BOOL "" FORCE)
+
+# Build renderer plugin for GLES/Wayland with FBDEV backend
+set (WITH_WAYLAND_FBDEV              OFF CACHE BOOL "" FORCE)
+
+# Build development library for GLES/Wayland FBDEV based renderers
+set (WITH_WAYLAND_FBDEV_LIB          OFF CACHE BOOL "" FORCE)
+
+# Build examples for GLES/Wayland based platforms
+set (WITH_WL_EXAMPLE                 OFF CACHE BOOL "" FORCE)
+
+# Build renderer plugin for GLES/X11 based platforms
+set (WITH_X11_GLES                   ON  CACHE BOOL "" FORCE)
 
 
 
diff --git a/toolchain_x11_wayland.cmake b/toolchain_x11_wayland.cmake
index 74301f7..34d1caa 100644
--- a/toolchain_x11_wayland.cmake
+++ b/toolchain_x11_wayland.cmake
@@ -31,22 +31,99 @@ set (XKB_INCLUDE_DIR /home/user/weston/include/xkbcommon)
 #                         Layer Manager Configuration                          #
 #                                                                              #
 ################################################################################
-set (WITH_X11_GLES        OFF CACHE BOOL "" FORCE)
-set (WITH_GLESv2_LIB      ON  CACHE BOOL "" FORCE)
-set (WITH_EGL_EXAMPLE     OFF CACHE BOOL "" FORCE)
-set (WITH_WL_EXAMPLE      ON  CACHE BOOL "" FORCE)
-set (WITH_DESKTOP         OFF CACHE BOOL "" FORCE)
-set (WITH_GLX_LIB         OFF CACHE BOOL "" FORCE)
-set (WITH_GLX_EXAMPLE     OFF CACHE BOOL "" FORCE)
-set (WITH_FORCE_COPY      OFF CACHE BOOL "" FORCE)
-set (WITH_XTRHEADS        OFF CACHE BOOL "" FORCE)
-set (WITH_CLIENTEXAMPLES  ON  CACHE BOOL "" FORCE)
-set (WITH_TESTS           OFF CACHE BOOL "" FORCE)
-set (WITH_DLT             OFF CACHE BOOL "" FORCE)
-set (WITH_WAYLAND         ON  CACHE BOOL "" FORCE)
-set (WITH_WAYLAND_X11     ON  CACHE BOOL "" FORCE)
-set (WITH_WAYLAND_DRM     OFF CACHE BOOL "" FORCE)
-set (WITH_WAYLAND_FBDEV   OFF CACHE BOOL "" FORCE)
-
-set (WITH_IPC_MODULE_TCP  ON  CACHE BOOL "" FORCE)
-set (WITH_IPC_MODULE_DBUS OFF CACHE BOOL "" FORCE)
+
+# this preset enables the build of LayerManagement with Wayland Renderer Plugin
+# based in X11 backend.
+# Additionally the Wayland Example applications and LayerManagerControl tool
+# is built.
+
+# Build examples for client library usage
+set (WITH_CLIENTEXAMPLES             OFF  CACHE BOOL "" FORCE)
+
+# Build LayerManagement client library
+set (WITH_CLIENT_LIB                 ON  CACHE BOOL "" FORCE)
+
+# Build renderer plugin for OpenGL/X11 based platforms
+set (WITH_DESKTOP                    OFF CACHE BOOL "" FORCE)
+
+# Build LayerManagerControl binary
+set (WITH_CONTROL_BIN                ON  CACHE BOOL "" FORCE)
+
+# Build LayerManagement control library
+set (WITH_CONTROL_LIB                OFF CACHE BOOL "" FORCE)
+
+# Build with DLT logging support
+set (WITH_DLT                        OFF CACHE BOOL "" FORCE)
+
+# Generate documentation during build (requires doxygen)
+set (WITH_DOCUMENTATION              OFF CACHE BOOL "" FORCE)
+
+# Build examples for GLES/X11 based platforms
+set (WITH_EGL_EXAMPLE                OFF  CACHE BOOL "" FORCE)
+
+# Build scene provider plugin to run example applications
+set (WITH_EXAMPLE_SCENE_PROVIDER     ON CACHE BOOL "" FORCE)
+
+# Force Software Copy of Pixmaps (compatibility for VMs)
+set (WITH_FORCE_COPY                 OFF CACHE BOOL "" FORCE)
+
+# Build Generic Communicator Plugin based on IpcModules
+set (WITH_GENERIC_COMMUNICATOR       ON  CACHE BOOL "" FORCE)
+
+# Build development library for GLES/X11 based renderers
+set (WITH_GLESv2_LIB                 OFF CACHE BOOL "" FORCE)
+
+# Build examples for OpenGL/X11 based platforms
+set (WITH_GLX_EXAMPLE                OFF CACHE BOOL "" FORCE)
+
+# Build development library for OpenGL/X11 based renderers
+set (WITH_GLX_LIB                    OFF CACHE BOOL "" FORCE)
+
+# Build with TCP Ipc Module
+set (WITH_IPC_MODULE_TCP             OFF CACHE BOOL "" FORCE)
+
+# Build with D-Bus Ipc Module
+set (WITH_IPC_MODULE_DBUS            ON  CACHE BOOL "" FORCE)
+
+# Build LayerManagerService binary
+set (WITH_SERVICE_BIN                ON  CACHE BOOL "" FORCE)
+
+# Link all plugins and libraries statically
+set (WITH_STATIC_LIBRARIES           OFF CACHE BOOL "" FORCE)
+
+# Report styleguide problems during build (requires python)
+set (WITH_STYLE_CHECKING             OFF CACHE BOOL "" FORCE)
+
+# Build plugin for systemd based health monitoring
+set (WITH_SYSTEMD_HEALTH_MONITOR     OFF CACHE BOOL "" FORCE)
+
+# Build unit test binaries for all enabled components
+set (WITH_TESTS                      OFF CACHE BOOL "" FORCE)
+
+# Build renderer plugin with pure logging (no rendering)
+set (WITH_TEXT_RENDERER              OFF CACHE BOOL "" FORCE)
+
+# Build renderer plugin for GLES/Wayland with X11 backend
+set (WITH_WAYLAND_X11                ON CACHE BOOL "" FORCE)
+
+# Build development library for GLES/Wayland X11 based renderers
+set (WITH_WAYLAND_X11_LIB            OFF CACHE BOOL "" FORCE)
+
+# Build renderer plugin for GLES/Wayland with DRM backend
+set (WITH_WAYLAND_DRM                OFF CACHE BOOL "" FORCE)
+
+# Build development library for GLES/Wayland DRM based renderers
+set (WITH_WAYLAND_DRM_LIB            OFF CACHE BOOL "" FORCE)
+
+# Build renderer plugin for GLES/Wayland with FBDEV backend
+set (WITH_WAYLAND_FBDEV              OFF CACHE BOOL "" FORCE)
+
+# Build development library for GLES/Wayland FBDEV based renderers
+set (WITH_WAYLAND_FBDEV_LIB          OFF CACHE BOOL "" FORCE)
+
+# Build examples for GLES/Wayland based platforms
+set (WITH_WL_EXAMPLE                 ON CACHE BOOL "" FORCE)
+
+# Build renderer plugin for GLES/X11 based platforms
+set (WITH_X11_GLES                   OFF  CACHE BOOL "" FORCE)
+