summaryrefslogtreecommitdiff
path: root/legacy/ephysics/README
blob: e8e68c25542cb72ad0ef0a3975aa449e6477ee17 (plain)
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
EPhysics 0.1.0

******************************************************************************

 FOR ANY ISSUES PLEASE EMAIL:
 enlightenment-devel@lists.sourceforge.net

******************************************************************************

Requirements:
-------------

Must:
  libc
  ecore (at least 1.2.99)
  ecore-evas (at least 1.2.99)
  evas (at least 1.2.99)
  bullet (at least 2.79)
Optional:
  elementary (at least 1.0.99, required to build ephysics_test)

EPhysics is a library that manages Ecore, Evas and Bullet Physics into
an easy to use way. It's a kind of wrapper, a glue, between these libraries.
It's not intended to be a physics library (we already have many out there).

WARNING: if you are building Bullet Physics instead of using a package,
use cmake build option. Autotools seems to be unmaintained.

------------------------------------------------------------------------------

COMPILING AND INSTALLING:

  $ ./configure
  $ make
(as root unless you are installing in your users directories):
  $ make install

If elementary is installed, it will build and install a test application as
well, that showcases EPhysics capabilites. Run

  $ ephysics_test

to see these examples.

------------------------------------------------------------------------------

TESTS

Tests require elementary to be build.

List of test applications:
 * ephysics_test => List with many tests to exemplify specific features
 * ephysics_logo => Example of logo / loading screen made using ephysics
 * ephysics_sandbox => Application to set many different properties to bodies
                       and see they interacting.

ephysics_test supports to launch a specified test on command line, like

 $ ephysics_test "Jumping Balls"

Also, it can run only the test, avoiding the main menu, with parameter
--test-win-only or -to (it must to be passed before the test name):

 $ ephysics_test -to Camera

The other programs don't accept parameters.

------------------------------------------------------------------------------

DOCS

To generate documentation, doxygen is required.

  $ make doc

will create a ephysics/doc/html directory. You could start looking at
index.html.