weston

History

Giulio Camuffo 179fcda31f Split the modules and include files between weston and libweston The backends are now installed in lib/libweston-0, and the include files that will be used by libweston in include/libweston-0. The other modules and weston-specific include files are kept in the old paths. A new wet_load_module() is added to load plugins in the old path, which is not part of libweston, but weston only and defined in main.c. To allow that to be used by out of tree weston plugins, the function is declared in a new weston.h, installed in include/weston. The -0 in the paths is the abi version of libweston, and it will also be used by the libweston .so. If the abi changes the number will need to be increased. Signed-off-by: Giulio Camuffo <giuliocamuffo@gmail.com> Reviewed-by: Quentin Glidic <sardemff7+git@sardemff7.net> Acked-by: Pekka Paalanen <pekka.paalanen@collabora.co.uk>		2016-06-03 13:17:18 +03:00
..
.gitignore	ivi-shell: a reference of weston.ini for ivi-shell and ivi-hmi-controller.	2014-12-04 17:25:50 +02:00
README	Spellcheck fixes	2015-03-19 17:02:08 +02:00
hmi-controller.c	compositor: remove the weston_config field in weston_compositor	2016-06-03 13:16:39 +03:00
input-panel-ivi.c	ivi-shell: add input panel label func	2016-03-24 13:48:21 +02:00
ivi-layout-export.h	ivi-shell: add API for weston_surface -> ivi_layout_surface	2016-06-01 11:06:49 +03:00
ivi-layout-private.h	ivi-shell: move event_mask to properties struct	2016-04-01 14:39:30 +03:00
ivi-layout-shell.h	ivi-shell: remove add_configured_listener left-over	2016-03-16 16:20:07 +02:00
ivi-layout-transition.c	ivi-shell: remove configured signal from ivi-layout	2016-03-16 13:11:11 +02:00
ivi-layout.c	Split the modules and include files between weston and libweston	2016-06-03 13:17:18 +03:00
ivi-shell.c	compositor: remove the weston_config field in weston_compositor	2016-06-03 13:16:39 +03:00
ivi-shell.h	ivi-shell: add API for weston_surface -> ivi_layout_surface	2016-06-01 11:06:49 +03:00
weston.ini.in	hmi-controller: allocate background surfaces for multi-screen	2015-12-14 13:16:11 +02:00

README

In-vehicle infotainment (information and entertainment)
graphical environment support modules for Weston

IVI-shell is an alternative shell for Weston, a Wayland display server.
Window management and application interaction with the display server
are very different to that of a normal desktop, which is why this is
a separate shell and not an extension to the desktop-shell suite with
xdg_shell. As such, applications need to be specifically written to use
IVI-shell.

IVI-shell contains two main features:
- Common layout library for surface, which allow ivi-shell developer
to develop own shell, linking Common layout library.
For the time being, the library refers Genivi ilm interface.

http://projects.genivi.org/wayland-ivi-extension/

- Extension protocol; ivi-application to tie wl_surface and a given ID.
With this ID, shell can identify which wl_surface is drawn by which
application. In in-vehicle infortainment system, a shell has to update
a property of a wl_surface. E.g. there may be a use case when vehicle
starts to move, the wl_surface drawn by Car navigation is expected to
move top of surfaces.

The actual software components delivered with Weston are:

- ivi-application.xml:
Wayland protocol extension for IVI-applications; the public
shell protocol (the same concept as xdg_shell).
Implemented by ivi-shell.so.

- ivi-shell.so:
A Weston shell module that implements ivi-application.xml interfaces.
Loads ivi-layout.so.

- ivi-layout.so:
Implements the IVI window management concepts: Screen, Layer,
Surface, groups of Layers, groups of Surfaces, see:
http://projects.genivi.org/ivi-layer-management/node/13
Offers a stable API for writing IVI-controller modules like
hmi-controller.so against the IVI concepts. In other words,
it offers an API to write IVI window manager modules.

- hmi-controller.so:
A sample implementation of an IVI-controller module, usually
replaced by IVI system vendors.
Uses ivi-layout.so to perform essentially window manager tasks.
This implementation keeps all window management inside the module,
while IVI-systems may use another module that exposes all window
management via Wayland or other protocol for an external process
to control:
http://git.projects.genivi.org/?p=wayland-ivi-extension.git;a=summary

- ivi-hmi-controller.xml:
Wayland protocol extension for IVI display control; the private
shell protocol for weston-ivi-shell-user-interface client
(the same concept as desktop-shell.xml).
Implemented by hmi-controller.so, and usually replaced by IVI
system vendors.

- weston-ivi-shell-user-interface:
A sample implementation of an IVI shell helper client, usually
replaced by IVI system vendors.
A helper client for basic display content, similar to
weston-desktop-shell.

How to compile:
same as weston. To disable, use option: --disable-ivi-shell for configure.

How to configure weston.ini:
reference ini file will be generated in <build_dir>/ivi-shell.

How to run:
same as weston. exec weston.

How to use UI:
http://lists.freedesktop.org/archives/wayland-devel/attachments/20140625/abbfc064/attachment-0001.png