weston

History

Pekka Paalanen 055c1137ae libweston: make wl_output point to weston_head The user data of a wl_resource representing a wl_output protocol object used to be a pointer to weston_output. Now that weston_output is being split, wl_output more accurately refers to weston_head which is a single monitor. Change the wl_output user data to point to weston_head. weston_output_from_resource() is replaced with weston_head_from_resource(). This change is not strictly necessary, but architecturally it is the right thing to do. In the future there might appear the need to refer to a specific head of a cloned pair, for instance. Signed-off-by: Pekka Paalanen <pekka.paalanen@collabora.co.uk> v5 Reviewed-by: Derek Foreman <derekf@osg.samsung.com> Reviewed-by: Ian Ray <ian.ray@ge.com> Reviewed-by: Daniel Stone <daniels@collabora.com> Acked-by: Derek Foreman <derekf@osg.samsung.com>		2018-04-10 14:33:59 +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	hmi-controller: remove dead assignments in add_launchers	2018-03-28 13:09:50 +03:00
input-panel-ivi.c	libweston: make wl_output point to weston_head	2018-04-10 14:33:59 +03:00
ivi-layout-export.h	ivi-shell: change layer visibility to bool	2018-02-08 14:16:44 +02:00
ivi-layout-private.h	ivi-shell: describe members of type wl_list	2016-11-09 16:00:36 +02:00
ivi-layout-shell.h	ivi-shell: remove ivi_layout_get_weston_view	2016-06-13 12:24:04 +03:00
ivi-layout-transition.c	ivi-shell: remove dead assignments in layer transition	2018-03-28 13:09:50 +03:00
ivi-layout.c	ivi-shell: fix the layer assignment change from one screen to another	2018-02-08 14:17:12 +02:00
ivi-shell.c	ivi-shell: remove ivi_shell_setting	2018-02-07 11:55:03 +02:00
ivi-shell.h	include stdint.h for int32_t/uint32_t	2016-07-26 16:26:08 -07:00
weston.ini.in	hmi-controller: load as weston module	2018-02-07 11:54:53 +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