aboutsummaryrefslogtreecommitdiff
path: root/README.md
diff options
context:
space:
mode:
authorMiles Macklin <[email protected]>2017-03-10 14:51:31 +1300
committerMiles Macklin <[email protected]>2017-03-10 14:51:31 +1300
commitad3d90fafe5ee79964bdfe1f1e0704c3ffcdfd5f (patch)
tree4cc6f3288363889d7342f7f8407c0251e6904819 /README.md
downloadflex-ad3d90fafe5ee79964bdfe1f1e0704c3ffcdfd5f.tar.xz
flex-ad3d90fafe5ee79964bdfe1f1e0704c3ffcdfd5f.zip
Initial 1.1.0 binary release
Diffstat (limited to 'README.md')
-rw-r--r--README.md109
1 files changed, 109 insertions, 0 deletions
diff --git a/README.md b/README.md
new file mode 100644
index 0000000..667c302
--- /dev/null
+++ b/README.md
@@ -0,0 +1,109 @@
+NVIDIA Flex - 1.1.0
+===================
+
+Flex is a particle-based simulation library designed for real-time applications.
+Please see the programmer's manual included in this release package for more information on
+the solver API and usage.
+
+The latest pre-built binary release can be found in on the NVIDIA Developer Zone:
+
+https://developer.nvidia.com/flex
+
+Supported Platforms
+-------------------
+
+* Windows 32/64 bit (CUDA, DX11, DX12)
+* Linux 64 bit (CUDA, tested with Ubuntu 14.04 LTS and Mint 17.2 Rafaela)
+
+Requirements
+------------
+
+A D3D11 capable graphics card with the following driver versions:
+
+* NVIDIA GeForce Game Ready Driver 372.90 or above
+* AMD Radeon Software Version 16.9.1 or above
+* IntelĀ® Graphics Version 15.33.43.4425 or above
+
+To build the demo at least one of the following is required:
+
+* Microsoft Visual Studio 2013
+* Microsoft Visual Studio 2015
+* g++ 4.6.3 or higher
+
+And either:
+
+* CUDA 8.0.44 toolkit
+* DirectX 11/12 SDK
+
+Demo
+====
+
+Use the `run_cuda.bat` or `run_d3d.bat` files to launch the demo.
+
+Notes
+-----
+
+* Some scenes also have fluid emitters that can be started using 'space'
+* For running the Linux binaries you will need to export the path to where the CUDA run time libraries are
+ For example, you may add to your .bashrc file the following:
+
+ export LD_LIBRARY_PATH=$LD_LIBRARY_PATH:/usr/local/cuda/lib64
+
+
+Command Line Options
+--------------------
+
+The following commands may be passed to the demo application to modify behavior:
+
+ -fullscreen=wxh Start fullscreen e.g.: -fullscreen=1280x720
+ -msaa=0 Disable multisampling (default is on)
+ -device=n Choose GPU to run on
+ -d3d12 Enable D3D12 compute
+ -benchmark Enable bencmark mode, will write a benchmark.txt to the root folder
+ -vsync=0 Disable vsync
+
+Controls
+--------
+
+ w,s,a,d - Fly Camera
+ right mouse - Mouse look
+ shift + left mouse - Particle select and drag
+
+ p - Pause/Unpause
+ o - Step
+ h - Hide/Show onscreen help
+
+ left/right arrow keys - Move to prev/next scene
+ up/down arrow keys - Select next scene
+ enter - Launch selected scene
+ r - Reset current scene
+
+ e - Draw fluid surface
+ v - Draw points
+ f - Draw springs
+ i - Draw diffuse
+ m - Draw meshes
+
+ space - Toggle fluid emitter
+ y - Toggle wave pool
+ c - Toggle video capture
+ u - Toggle fullscreen
+ j - Wind gust
+ - - Remove a plane
+ esc - Quit
+
+Known Issues
+============
+
+* Crash with inflatable scenes on Intel HD Graphics 530
+
+
+Acknowledgements
+================
+
+* SDL is licensed under the zlib license
+* GLEW is licensed under the Modified BSD license
+* Regal is licensed under the BSD license
+* stb_truetype by Sean Barrett is public domain
+* imgui by Mikko Mononen is licensed under the ZLib license
+