summaryrefslogtreecommitdiff
path: root/README
blob: 1681ae2b1d501d1aa50ed8304d7356c35cff859c (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
Emotion Generic Players 1.11.0
==============================

******************************************************************************
 FOR ANY ISSUES PLEASE EMAIL:
 enlightenment-devel@lists.sourceforge.net
******************************************************************************
  
These are binary players for Emotion using the "generic" module.

Emotion supports multiple modules provided as shared-objects under
PREFIX/lib/emotion/modules, making it extensible. However these
live in the same process as the application, thus problems handling
the media may crash or halt the application. Unfortunately media
handling is very error prone due multiple sources, sinks, decoders et
al, each with their own level of stability.

To solve this, Emotion ships with a "generic" module that is a
layer to talk to another process, the "player", using pipes and shared
memory (shm). If this external process dies, the main application
remains working (without any media, of course). Thus it is safer and
has some nice side effects such as avoiding bringing in many libraries to
decode media, saving memory in the application process, etc.

A secondary benefit is that the generic player is a separate process
and does not link with the user application code or EFL, avoiding
license conflicts. Many decoding libraries or elements exist with
conflicting licenses with GPL, LGPL or even proprietary code.


REQUIREMENTS
------------

  * vlc (libvlc >= 2.0)


COMPONENTS
----------

**VLC Generic Player:**

//GPL v2 license//

This is a binary that uses the VLC library (libvlc) to play videos
inot shared memory.

COMPILING AND INSTALLING
------------------------

    ./configure
    make
    sudo make install


COMPILER FLAGS
--------------

You may want to change the install prefix for EFL with:

    --prefix=/path/to/prefix

**NOTE:**

You should put generic players in the same prefix as EFL or they will
not be found by EFL at runtime.