diff options
| author | Miles Macklin <[email protected]> | 2017-03-10 14:51:31 +1300 |
|---|---|---|
| committer | Miles Macklin <[email protected]> | 2017-03-10 14:51:31 +1300 |
| commit | ad3d90fafe5ee79964bdfe1f1e0704c3ffcdfd5f (patch) | |
| tree | 4cc6f3288363889d7342f7f8407c0251e6904819 /README.md | |
| download | flex-ad3d90fafe5ee79964bdfe1f1e0704c3ffcdfd5f.tar.xz flex-ad3d90fafe5ee79964bdfe1f1e0704c3ffcdfd5f.zip | |
Initial 1.1.0 binary release
Diffstat (limited to 'README.md')
| -rw-r--r-- | README.md | 109 |
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 + |