From: Courtney Goeltzenleuchter <courtney@LunarG.com>
Date: Tue, 2 Sep 2014 00:05:45 +0000 (-0600)
Subject: xgl: Add build instructions
X-Git-Tag: upstream/1.1.92~6525
X-Git-Url: http://review.tizen.org/git/?a=commitdiff_plain;h=fd5b87e1b7ffef26582fe28515aaa8e11ae92b9c;p=platform%2Fupstream%2FVulkan-Tools.git

xgl: Add build instructions
---

diff --git a/BUILD.md b/BUILD.md
new file mode 100644
index 0000000..deb9c58
--- /dev/null
+++ b/BUILD.md
@@ -0,0 +1,36 @@
+The XGL Sample Intel driver supports Linux.
+
+System Requirements
+===================
+
+Ubuntu 13.10, Ubuntu 14.04 LTS
+gcc
+drm
+
+
+BUILD
+=====
+
+The sample driver users cmake and should work with the usual cmake options and utilities.
+The standard build process builds the icd, the icd loader and all the tests.
+
+Example debug build:
+cd xgl  # cd to the root of the xgl git repository
+cmake -H. -Bdbuild -DCMAKE_BUILD_TYPE=Debug
+cd dbuild
+make
+
+To run XGL programs you must tell the icd loader where to find the libraries. Set the
+environment variable LIBXGL_DRIVERS_PATH to the driver path. For example:
+> export LIBXGL_DRIVERS_PATH=~/xgl/dbuild/icd/intel
+
+TEST
+====
+
+The test executibles can be found in the build/tests directory. The tests use the Google
+gtest infrastructure. Tests avilable so far:
+- xglinfo: Report GPU properties
+- xglbase: Test basic entry points
+- xgl_image_tests: Test XGL image related calls needed by render_test
+- xgl_render_tests: Render a single triangle with XGL. Triangle will be in a .ppm in
+the current directory at the end of the test.