aboutsummaryrefslogtreecommitdiff
path: root/README.md
blob: b191f6a46eca1350aaf61356c12199fac4e8f005 (plain) (blame)
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71
72
73
74
75
76
77
78
79
80
81
82
83
84
85
86
87
88
89
90
91
92
93
94
95
96
97
98
99
100
101
102
103
104
105
106
107
108
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.

Note that the Flex binaries are not included in the repository directly. The latest pre-built binaries can be found in the releases section on Github:

https://github.com/NVIDIAGameWorks/FleX/releases

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