xdg_toplevel.c File Reference

#include "xdg_toplevel.h"
#include <libbase/libbase.h>
#include <stdlib.h>
#include <wayland-client-protocol.h>
#include "ext-input-observation-v1-client-protocol.h"
#include "wlclient.h"
#include "xdg-decoration-client-protocol.h"
#include "xdg-shell-client-protocol.h"

Include dependency graph for xdg_toplevel.c:

Classes
struct	_wlmcl_xdg_toplevel_t

Functions
static void	_wlmcl_xdg_configure_decoration (wlmcl_xdg_toplevel_t *toplevel_ptr)
static void	_wlmcl_xdg_surface_configure (void *data, struct xdg_surface *xdg_surface, uint32_t serial)
static void	_wlmcl_xdg_toplevel_decoration_v1_configure (void *data_ptr, struct zxdg_toplevel_decoration_v1 *zxdg_toplevel_decoration_v1_ptr, uint32_t mode)
static void	_xdg_toplevel_handle_configure (void *data_ptr, struct xdg_toplevel *xdg_toplevel_ptr, int32_t width, int32_t height, struct wl_array *states)
static void	_xdg_toplevel_handle_close (void *data_ptr, struct xdg_toplevel *xdg_toplevel_ptr)
static void	_xdg_toplevel_handle_configure_bounds (void *data_ptr, struct xdg_toplevel *xdg_toplevel_ptr, int32_t width, int32_t height)
static void	_xdg_toplevel_handle_wm_capabilities (void *data_ptr, struct xdg_toplevel *xdg_toplevel_ptr, struct wl_array *capabilities)
static void	_wlmcl_input_position_observer_position (void *data_ptr, struct ext_input_position_observer_v1 *input_position_observer_ptr, struct wl_surface *wl_surface_ptr, uint32_t instance, int32_t relative_x, int32_t relative_y)
wlmcl_xdg_toplevel_t *	wlmcl_xdg_toplevel_create (wlmcl_client_t *wlclient_ptr, const char *title_ptr, unsigned width, unsigned height)
void	wlmcl_xdg_toplevel_destroy (wlmcl_xdg_toplevel_t *toplevel_ptr)
bool	wlmcl_xdg_supported (wlmcl_client_t *wlclient_ptr)
bool	wlmcl_xdg_decoration_set_server_side (wlmcl_xdg_toplevel_t *toplevel_ptr, bool enabled)
struct wl_surface *	wlmcl_xdg_toplevel_wl_surface (wlmcl_xdg_toplevel_t *toplevel_ptr)
void	wlmcl_xdg_toplevel_register_configure_callback (wlmcl_xdg_toplevel_t *toplevel_ptr, void(*callback)(void *ud_ptr, uint32_t width, uint32_t height), void *ud_ptr)
void	wlmcl_xdg_toplevel_register_position_callback (wlmcl_xdg_toplevel_t *toplevel_ptr, void(*callback)(double x, double y, void *ud_ptr), void *callback_ud_ptr)

Variables
static const struct xdg_toplevel_listener	_wlc_xdg_toplevel_listener
static const struct xdg_surface_listener	_wlmcl_xdg_surface_listener
static const struct zxdg_toplevel_decoration_v1_listener	_wlc_xdg_toplevel_decoration_v1_listener
static const struct ext_input_position_observer_v1_listener	_wlmcl_tracker_listener

Detailed Description

Copyright

Copyright (c) 2026 Philipp Kaeser (kaese.nosp@m.r@gu.nosp@m.bbe.c.nosp@m.h) Copyright 2024 Google LLC

Licensed under the Apache License, Version 2.0 (the "License"); you may not use this file except in compliance with the License. You may obtain a copy of the License at

https://www.apache.org/licenses/LICENSE-2.0

Unless required by applicable law or agreed to in writing, software distributed under the License is distributed on an "AS IS" BASIS, WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. See the License for the specific language governing permissions and limitations under the License.

Function Documentation

_wlmcl_input_position_observer_position()

void _wlmcl_input_position_observer_position ( void *  data_ptr, struct ext_input_position_observer_v1 *  input_position_observer_ptr, struct wl_surface *  wl_surface_ptr, uint32_t  instance, int32_t  relative_x, int32_t  relative_y  )

static

Callback for when a position event is received.

_wlmcl_xdg_configure_decoration()

void _wlmcl_xdg_configure_decoration ( wlmcl_xdg_toplevel_t *  toplevel_ptr )

static

Updates the server-side decoration mode.

_wlmcl_xdg_surface_configure()

void _wlmcl_xdg_surface_configure ( void *  data_ptr, struct xdg_surface *  xdg_surface_ptr, uint32_t  serial  )

static

Handler for the configure event of the XDG surface.

Parameters

data_ptr	Untyped pointer to wlmcl_xdg_toplevel_t.
xdg_surface_ptr
serial

_wlmcl_xdg_toplevel_decoration_v1_configure()

void _wlmcl_xdg_toplevel_decoration_v1_configure ( void *  data_ptr, struct zxdg_toplevel_decoration_v1 *  zxdg_toplevel_decoration_v1_ptr, uint32_t  mode  )

static

Handles the decoration mode change listener.

_xdg_toplevel_handle_close()

void _xdg_toplevel_handle_close ( void *  data_ptr, struct xdg_toplevel *  xdg_toplevel_ptr  )

static

Handles the action of the 'close' button.

_xdg_toplevel_handle_configure()

void _xdg_toplevel_handle_configure ( void *  data_ptr, struct xdg_toplevel *  xdg_toplevel_ptr, int32_t  width, int32_t  height, struct wl_array *  states  )

static

Handles XDG toplevel's configure event.

_xdg_toplevel_handle_configure_bounds()

void _xdg_toplevel_handle_configure_bounds ( void *  data_ptr, struct xdg_toplevel *  xdg_toplevel_ptr, int32_t  width, int32_t  height  )

static

Handles 'configure_bounds' of the toplevel.

_xdg_toplevel_handle_wm_capabilities()

void _xdg_toplevel_handle_wm_capabilities ( void *  data_ptr, struct xdg_toplevel *  xdg_toplevel_ptr, struct wl_array *  capabilities  )

static

Handles the 'wm_capabilities' request.

wlmcl_xdg_decoration_set_server_side()

bool wlmcl_xdg_decoration_set_server_side	(	wlmcl_xdg_toplevel_t *	toplevel_ptr,
		bool	enabled
	)

Sets XDG decoration mode to "server side".

Parameters

toplevel_ptr
enabled	Whether to enable server-side decoration. If false, will set client-side decoration.

Returns

true if the XDG decoration protocol is supported.

wlmcl_xdg_supported()

bool wlmcl_xdg_supported

(

wlmcl_client_t *

wlclient_ptr

)

Returns whether the XDG shell protocol is supported on the client.

Parameters

wlclient_ptr

wlmcl_xdg_toplevel_create()

wlmcl_xdg_toplevel_t * wlmcl_xdg_toplevel_create	(	wlmcl_client_t *	wlclient_ptr,
		const char *	title_ptr,
		unsigned	width,
		unsigned	height
	)

Creates a XDG toplevel.

Parameters

wlclient_ptr
title_ptr
width
height

Returns

State of the toplevel or NULL on error.

wlmcl_xdg_toplevel_destroy()

void wlmcl_xdg_toplevel_destroy

(

wlmcl_xdg_toplevel_t *

toplevel_ptr

)

Destroys the XDG toplevel.

Parameters

toplevel_ptr

wlmcl_xdg_toplevel_register_configure_callback()

void wlmcl_xdg_toplevel_register_configure_callback	(	wlmcl_xdg_toplevel_t *	toplevel_ptr,
		void(*)(void *ud_ptr, uint32_t width, uint32_t height)	callback,
		void *	ud_ptr
	)

Registers the callback to notify when the toplevel's layout/size changes.

Parameters

toplevel_ptr
callback
ud_ptr

wlmcl_xdg_toplevel_register_position_callback()

void wlmcl_xdg_toplevel_register_position_callback	(	wlmcl_xdg_toplevel_t *	toplevel_ptr,
		void(*)(double x, double y, void *ud_ptr)	callback,
		void *	callback_ud_ptr
	)

Registers the callback to notify the pointer position relative to the toplevel's surface.

Parameters

toplevel_ptr
callback
callback_ud_ptr

wlmcl_xdg_toplevel_wl_surface()

struct wl_surface * wlmcl_xdg_toplevel_wl_surface

(

wlmcl_xdg_toplevel_t *

toplevel_ptr

)

Returns the underlying Wayland surface of the XDG toplevel.

Parameters

toplevel_ptr

Returns

The wl_surface pointer.

Variable Documentation

_wlc_xdg_toplevel_decoration_v1_listener

const struct zxdg_toplevel_decoration_v1_listener _wlc_xdg_toplevel_decoration_v1_listener

static

Initial value:

= {
    .configure = _wlmcl_xdg_toplevel_decoration_v1_configure,
}

Listeners for the XDG decoration manager.

_wlc_xdg_toplevel_listener

const struct xdg_toplevel_listener _wlc_xdg_toplevel_listener

static

Initial value:

= {
    .configure = _xdg_toplevel_handle_configure,
    .close = _xdg_toplevel_handle_close,
    .configure_bounds = _xdg_toplevel_handle_configure_bounds,
    .wm_capabilities = _xdg_toplevel_handle_wm_capabilities
}

Listeners for the XDG toplevel.

_wlmcl_tracker_listener

const struct ext_input_position_observer_v1_listener _wlmcl_tracker_listener

static

Initial value:

= {
    .position = _wlmcl_input_position_observer_position,
}

Listeners for the Pointer position Tracker.

_wlmcl_xdg_surface_listener

const struct xdg_surface_listener _wlmcl_xdg_surface_listener

static

Initial value:

= {
    .configure = _wlmcl_xdg_surface_configure,
}

Listeners for the XDG surface.