xdg_toplevel.c File Reference

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

Include dependency graph for xdg_toplevel.c:

Classes
struct	_wlclient_xdg_toplevel_t

Functions
static void	_wlclient_xdg_configure_decoration (wlclient_xdg_toplevel_t *toplevel_ptr)
static void	_wlclient_xdg_surface_configure (void *data, struct xdg_surface *xdg_surface, uint32_t serial)
static void	_wlc_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	_wlclient_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)
wlclient_xdg_toplevel_t *	wlclient_xdg_toplevel_create (wlclient_t *wlclient_ptr, const char *title_ptr, unsigned width, unsigned height)
void	wlclient_xdg_toplevel_destroy (wlclient_xdg_toplevel_t *toplevel_ptr)
bool	wlclient_xdg_supported (wlclient_t *wlclient_ptr)
bool	wlclient_xdg_decoration_set_server_side (wlclient_xdg_toplevel_t *toplevel_ptr, bool enabled)
void	wlclient_xdg_toplevel_register_ready_callback (wlclient_xdg_toplevel_t *toplevel_ptr, bool(*callback)(bs_gfxbuf_t *gfxbuf_ptr, void *ud_ptr), void *callback_ud_ptr)
void	wlclient_xdg_toplevel_register_position_callback (wlclient_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	_wlclient_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	_wlclient_tracker_listener

Detailed Description

Copyright

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

_wlc_xdg_toplevel_decoration_v1_configure()

void _wlc_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.

_wlclient_input_position_observer_position()

void _wlclient_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.

_wlclient_xdg_configure_decoration()

void _wlclient_xdg_configure_decoration ( wlclient_xdg_toplevel_t * toplevel_ptr )

static

Updates the server-side decoration mode.

_wlclient_xdg_surface_configure()

void _wlclient_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 wlclient_xdg_toplevel_t.
xdg_surface_ptr
serial

_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.

wlclient_xdg_decoration_set_server_side()

bool wlclient_xdg_decoration_set_server_side	(	wlclient_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.

wlclient_xdg_supported()

bool wlclient_xdg_supported

(

wlclient_t *

wlclient_ptr

)

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

Parameters

wlclient_ptr

wlclient_xdg_toplevel_create()

wlclient_xdg_toplevel_t * wlclient_xdg_toplevel_create	(	wlclient_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.

wlclient_xdg_toplevel_destroy()

void wlclient_xdg_toplevel_destroy

(

wlclient_xdg_toplevel_t *

toplevel_ptr

)

Destroys the XDG toplevel.

Parameters

toplevel_ptr

wlclient_xdg_toplevel_register_position_callback()

void wlclient_xdg_toplevel_register_position_callback	(	wlclient_xdg_toplevel_t *	toplevel_ptr,
		void(*	callback )(double x, double y, void *ud_ptr),
		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

wlclient_xdg_toplevel_register_ready_callback()

void wlclient_xdg_toplevel_register_ready_callback	(	wlclient_xdg_toplevel_t *	toplevel_ptr,
		bool(*	callback )(bs_gfxbuf_t *gfxbuf_ptr, void *ud_ptr),
		void *	callback_ud_ptr )

Registers the callback to notify when the buffer is ready to draw into.

Parameters

toplevel_ptr
callback
callback_ud_ptr

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 = _wlc_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.

_wlclient_tracker_listener

const struct ext_input_position_observer_v1_listener _wlclient_tracker_listener

static

Initial value:

 = {
    .position = _wlclient_input_position_observer_position,
}

Listeners for the Pointer position Tracker.

_wlclient_xdg_surface_listener

const struct xdg_surface_listener _wlclient_xdg_surface_listener

static

Initial value:

                                       = {
    .configure = _wlclient_xdg_surface_configure,
}

Listeners for the XDG surface.