Looking for the latest version? Download plansch-1.22-win.tar.gz (1.8 MB)
Home
Name Modified Size Downloads / Week Status
Totals: 3 Items   1.9 MB 2
plansch 2014-01-15 2 weekly downloads
plansch-1.22-win.tar.gz 2014-01-15 1.8 MB 11 weekly downloads
README.txt 2014-01-10 5.1 kB 11 weekly downloads
[Abstract] ------------------------------------------------------------------------------- This is plansch, a little particle "simulation". It started as game for my son as an attempt to avoid the mess in the bathroom when he played with water. In the meantime, playing with water got boring, plansch got too complicated, so it's my lunchtime programming game now .. Plansch is the german word for "splash". [Usage] ------------------------------------------------------------------------------- Pre-compiled binaries were built under Ubuntu/64bit and Windows 7. In Linux, just call "plansch", or plansch -h to get the options (see below). Under Windows directly call one of the plansch_<variant>.exe. Plansch does some force field calculation which is done by the CPU (relatively unprecise) or by the GPU (needs a potent graphics card). There are several compile-time variants which select the mode: [default] No GPU suppport, should run on all SSE2 capable CPUs. [opengl] With GPU support using GLSL shaders. Screen output done with OpenGL. ot as fast as OpenCL code, GPU calculations can be disabled with "-G" switch if it causes problems. [sopengl] Like "default", output is done by OpenGL. [opencl] Screen output done by opengl, field calculation via OpenCL. Tested with ATI APP SDK. For Some GPUs or CPU platform devices the -C switch may need to be set (see below). Focus is on the OpenCl version, the other ones aren't really maintained any more. [Command Line Parameters] ------------------------------------------------------------------------------- -n Maximum number of particles -N OpenCL: Maximum number of GPU particles -c Starting CPU core -G Force not to use GPU -T Default particle type -m Which mode to run at (shell wrapper option) -X Check whether mode is supported and exit -b Big Bang with half of particles -B Big Bang with all particles -i Screen update interval in msec (0 = no update) -t Number of particle processing threads (1, 2, 4) -r Place all particles randomly on the screen, using a random charge between -1 and 1 -H No screen output -g Screen geometry in <width>x<height> -f Fullscreen mode -u Particle field iterations per movement iterations Default: 1 (5 with GPU support) -M Number of iterations. -I Runtime in seconds -l Load .tape file at startup. -L Options for startup file: exit - Exit program when tape is finished imm - Load tape contents immedeately -C OpenCl: Do not try to directly render into OpenGl textures/PBOs. Make the data take a detour via host memory instead, which is slower but sometimes required (e.g. for a CPU OpenCl platform with Intel IGP) -D <i> OpenCl: Use the i-th available device on this platform (default = 0) -p Try to use pinned memory for some OpenCL buffers. Experimental. [System Requirements] ------------------------------------------------------------------------------- - An x86 CPU supporting SSE2. Recommended are at least 2 cores. SSSE3 or SSE4.1 code is enabled dynamically if the CPU supports it. - SDL runtime library - Optionally: SDL_ttf runtime library - Optionally: OpenGL/GLSL support (Tested with AMD and Intel IGP only). The only Nvidia card tested (Quadro 1700) didn't produce any output... - Optionally: OpenCL (Tested with AMD APP SDK only) [User interface] ------------------------------------------------------------------------------- At the bottom are a bunch of buttons you can play around with. Pressing F1 over a button provides some help, pressing F1 somewhere else lists the keyboard shortcuts. Pressing the right mouse button on in an unoccupied menu space toggles between additional panels. The rest (drawing particles, walls, etc.) happens in the draw area. There is some documentation in the "docs" directory, but it hasn't been updated recently ... [Building] ------------------------------------------------------------------------------- For Linux, edit Makefile and make sure "linux.mk" is selected at the top. Have a look at linux.mk and call make. Same for Windows: use/edit msys.mk instead. GPGPU support is currently available via OpenGL GLSL (obsolete) and OpenCL. For OpenCL, i tested it with ATI Stream SDK only. Download it, install it, and set $OPENCLROOT to the install path unless it's already in the OS. I don't know about Nvidia ... Plansch basically builds and runs under Windows using MinGW/Msys, but it requires gcc 4.x for OpenMP support. I have tested it under TDM/mingw, but only 32-bit. For OpenGL support you need the glew library. I have packaged all libraries i use in planschlibs.tar.gz. Extract it the build directory. [Bugs] ------------------------------------------------------------------------------- - Many, it will always be an alpha version .. - Save/restore related code hasn't been maintained - consle output in Windows does not work, it's stored in stdout.txt. So if something does not seem to work (e.g. OpenCL), have a look there. Have fun.
Source: README.txt, updated 2014-01-10