summaryrefslogtreecommitdiff
path: root/pages/about-efl.md.txt
blob: 355e4966e7bc1bbe0cace4cd3861f2f61a01bba9 (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
---
~~Title: About EFL~~
~~NOCACHE~~
---

# EFL #

![EFL Core](/_media/efl-core.png)

EFL, or the *Enlightenment Foundation Libraries*, powers millions of systems from mobile phones to set-top boxes, desktops, laptops, game systems and more. EFL is recognized for its forward-thinking approach which allows product designers and developers to offer more than the run-of-the-mill user experience of the past. This is where EFL excels.

[Free.fr](http://www.free.fr) has shipped millions of set top boxes in France powered by EFL. The [Openmoko Freerunner project](http://wiki.openmoko.org/wiki/Neo_FreeRunner) also sold thousands of devices using EFL and Enlightenment.

EFL powers [Samsung Galaxy Gear](http://www.samsung.com/us/mobile/wearable-tech) smartwatches and is behind Samsung Smart Televisions such as the [Class Q9F QLED 4K TV](https://www.samsung.com/us/televisions-home-theater/tvs/qled-tvs/65--class-q9f-qled-4k-tv-qn65q9famfxza/) and refrigerators such as the [Samsung Family Hub Refrigerator](https://www.samsung.com/us/explore/family-hub-refrigerator/overview/), which are based on Tizen. GPS devices such as the [Coyote](https://www.moncoyote.com/) also run EFL.

You can [download EFL from here](/download).

## How to Use EFL ##

EFL covers a wide range of functions including inter-process communication (IPC), graphics, audio and even location services. Other powerful features include file handling utilities, widgets and user interface controls, thumbnailing and rendering via scene graph. You can discover more of EFL's capabilities by visiting the [About EFL](https://www.enlightenment.org/about-efl) page.

## Parts of EFL ###

EFL is made up of a number of libraries which build on top of each other in layers, steadily becoming higher-level, yet allowing access to each level as they go. The higher up you go, the less you have to do yourself. Elementary is about as high up as you get, while you still access layers below it for day to day tasks.

EFL exposes all of its APIs by default in C. There are several bindings available. Work is progressing on supporting bindings for various language as first-class-citizens in EFL by auto-generating them directly from the new object orientation infrastructure for C.

The main focus is on C mostly because the libraries have been around for a long time, were originally written in that language and the developers of those libraries prefer C. The developers add OO features in C with tools and infrastructure where needed. Moving from C would also limit the audience. C programmers couldn't access a C++ API for instance, whereas a C++ programmer can access both C and C++. That is partly why the developers aim to auto-generate bindings so programmers of various languages can get native-like APIs for their chose language from the same core EFL API set.

The components are divided into named libraries or projects. Core EFL components include:

| Component   | Description |
| -------------- | -------------- |
| Evas | Core scene graph and rendering    |
| Eina | Data structures and low level helpers   |
| Edje | UI layout & animation data files for themes |
| Eet | Data (de)serialization and storage  |
| Ecore | Core loop and system abstractions like X11 |
| Efreet | Freedesktop.org standards handling  |
| Eldbus | D-Bus glue and handling   |
| Embryo | Tiny VM and compiler based on Pawn  |
| Eeze | Device enumeration and access library  |
| Emotion | Video decode wrapping, glue and abstraction |
| Ethumb| Thumbnailing handler  |
| Ephysics | Physics (bullet) wrapper and Evas glue  |
| EIO | Asynchronous I/O handling  |
| Evas Generic Loaders  | Extra image loaders for complex image types|
| Emotion Generic Players | Extra video decoders (for VLC)      |
| Elementary     | Widgets and high level abstractions    |


Binding support exists for several languages such , including Python, Javascript, C++, Ruby and Lua.

### The EFL Model ###

![model1](/_media/model1.png "EFL Model")

EFL operates on the same "main loop" concept adopted by GTK+ and many other toolkits. Once you initialize an application it enters the Ecore main loop.

The main loop continuously checks for events, handles timers, callbacks and any other services that have previously been set up until an exit request is sent. By way of an example if EFL were used to create a video game, the mainloop would check for user inputs and update the game world accordingly as you play.

The mainloop is designed efficiently. It will remain idle, consuming virtually no CPU resources until an event occurs. Events can be based on user input such as using the mouse or time-based. Ecore will then handle the event appropriately.

Read more about [the Ecore main loop here](https://docs.enlightenment.org/auto/group__Ecore__Main__Loop__Group.html).

For more detailed information on the EFL model including events and callbacks see the [EFL Concept Overview.](https://phab.enlightenment.org/w/efl_concept_overview/)

### EFL Application Structure ###

![model1](/_media/efllibs.png "EFL Libs")

Whenever you create a basic EFL Application, it uses a basic set of libraries:

  * **Elementary** is the top-most library. It provides all the functions you need to create windows, manage layouts and add widgets.
  * **Edje**  is the library used by Elementary to provide powerful,customisable themes. You can also use Edje to create your own objects and use them in an application.
  * **Ecore** is the library which manages the main loop of your application, as outlined above.
  * **Evas**  is the canvas engine, which draws content. Any graphical objects you create are Evas objects. It handles the entire state of the window by filling the canvas with objects and manipulating their states. Evas objects are created and then manipulated until they are no longer needed, at which point they are deleted.
  * **Eina** forms the basis of all EFL libraries. It's a toolbox that implements an API for data types in an efficient way. Eina contains all the functions needed to create lists and hashes, manage shared strings, open shared libraries, and manage errors and memory pools.

EFL naturally contains many more libraries than the basic ones outlined above. Visit our [Basic Application Structure](https://www.enlightenment.org/develop/legacy/program_guide/basic_application_structure_pg) page for more information on the core libraries. You can also learn about other libraries in our other programming guides.

## Further Reading ##

[EFL Coverity scan status](https://scan.coverity.com/projects/552)
:    EFL's code quality.

[Ecore loop](https://docs.enlightenment.org/auto/group__Ecore__Main__Loop__Group.html)
:    Functions that act on Ecore's main loop or on events and infrastructure directly linked to it.

[EFL Concept Overview.](https://phab.enlightenment.org/w/efl_concept_overview/)
:    More detailed information on the EFL model including events and callbacks