Struct wayland_server::Display

pub struct Display { /* fields omitted */ }

The wayland display

This is the core of your wayland server, this object must be kept alive as long as your server is running. It allows you to manage listening sockets and clients.

Methods

impl Display

pub fn new() -> (Display, EventLoop)

Create a new display

This method provides you a Display as well as the main EventLoop which will host your clients' objects.

Note that at this point, your server is not yet ready to receive connections, your need to add listening sockets using the add_socket* methods.

pub fn create_global<I: Interface, Impl>(     &mut self,     _: &LoopToken,     version: u32,     implementation: Impl ) -> Global<I> where     Impl: Implementation<NewResource<I>, u32> + 'static,

Create a new global object

This object will be advertized to all clients, and they will be able to instanciate it from their registries.

Your implementation will be called whenever a client instanciates this global.

The version specified is the highest supported version, you must be able to handle clients that choose to instanciate this global with a lower version number.

pub fn flush_clients(&self)

Flush events to the clients

Will send as many pending events as possible to the respective sockets of the clients. Will not block, but might not send everything if the socket buffer fills up.

impl Display

pub fn add_socket<S>(&mut self, name: Option<S>) -> IoResult<()> where     S: AsRef<OsStr>,

Add a listening socket to this display

Wayland clients will be able to connect to your compositor from this socket.

Socket will be created in the directory specified by the environment variable XDG_RUNTIME_DIR.

If a name is provided, it is used. Otherwise, if WAYLAND_DISPLAY environment variable is set, its contents are used as socket name. Otherwise, wayland-0 is used.

Errors if name contains an interior null, or if XDG_RUNTIME_DIR is not set, or if specified could not be bound (either it is already used or the compositor does not have the rights to create it).

pub fn add_socket_auto(&mut self) -> IoResult<OsString>

Add an automatically named listening socket to this display

Wayland clients will be able to connect to your compositor from this socket.

Socket will be created in the directory specified by the environment variable XDG_RUNTIME_DIR. The directory is scanned for any name in the form wayland-$d with 0 <= $d < 32 and the first available one is used.

Errors if XDG_RUNTIME_DIR is not set, or all 32 names are already in use.

pub fn add_socket_from<T>(&mut self, socket: T) -> IoResult<()> where     T: IntoRawFd,

Add existing listening socket to this display

Wayland clients will be able to connect to your compositor from this socket.

The existing socket fd must already be created, opened, and locked. The fd must be properly set to CLOEXEC and bound to a socket file with both bind() and listen() already called. An error is returned otherwise.

pub unsafe fn add_socket_fd(&mut self, fd: RawFd) -> IoResult<()>

Add existing listening socket to this display from a raw file descriptor

Wayland clients will be able to connect to your compositor from this socket.

The library takes ownership of the provided socket if this method returns successfully.

The existing socket fd must already be created, opened, and locked. The fd must be properly set to CLOEXEC and bound to a socket file with both bind() and listen() already called. An error is returned otherwise.

pub unsafe fn create_client(&mut self, fd: RawFd) -> Client

Create a new client to this display from an already-existing connected Fd

impl Display

pub fn c_ptr(&self) -> *mut wl_display

Retrieve a pointer from the C lib to this wl_display