layer.c File Reference

#include "layer.h"
#include <libbase/libbase.h>
#include <stdlib.h>
#include <wayland-server-core.h>
#include <wayland-util.h>
#include <wlr/types/wlr_output.h>
#include <wlr/types/wlr_output_layout.h>
#include <wlr/util/edges.h>
#include "container.h"
#include "output_tracker.h"
#include "panel.h"
#include "test.h"
#include "tile.h"
#include "workspace.h"

Include dependency graph for layer.c:

Classes
struct	_wlmtk_layer_t
struct	_wlmtk_layer_output_t

Functions
static void	_wlmtk_layer_output_remove_dlnode_panel (bs_dllist_node_t *dlnode_ptr, void *ud_ptr)
static void	_wlmtk_layer_output_add_panel (wlmtk_layer_output_t *layer_output_ptr, wlmtk_panel_t *panel_ptr)
static void	_wlmtk_layer_output_remove_panel (wlmtk_layer_output_t *layer_output_ptr, wlmtk_panel_t *panel_ptr)
static void *	_wlmtk_layer_output_create (struct wlr_output *wlr_output_ptr, void *ud_ptr)
static void	_wlmtk_layer_output_update (struct wlr_output *wlr_output_ptr, void *ud_ptr, void *output_ptr)
static void	_wlmtk_layer_output_destroy (struct wlr_output *wlr_output_ptr, void *ud_ptr, void *output_ptr)
wlmtk_layer_t *	wlmtk_layer_create (struct wlr_output_layout *wlr_output_layout_ptr)
void	wlmtk_layer_destroy (wlmtk_layer_t *layer_ptr)
wlmtk_element_t *	wlmtk_layer_element (wlmtk_layer_t *layer_ptr)
bool	wlmtk_layer_add_panel (wlmtk_layer_t *layer_ptr, wlmtk_panel_t *panel_ptr, struct wlr_output *wlr_output_ptr)
void	wlmtk_layer_remove_panel (wlmtk_layer_t *layer_ptr, wlmtk_panel_t *panel_ptr)
void	wlmtk_layer_output_reconfigure (wlmtk_layer_output_t *layer_output_ptr)
void	wlmtk_layer_set_workspace (wlmtk_layer_t *layer_ptr, wlmtk_workspace_t *workspace_ptr)
static void	test_multi_output (bs_test_t *test_ptr)
static void	test_layout (bs_test_t *test_ptr)

Variables
const bs_test_case_t	wlmtk_layer_test_cases []

Detailed Description

Copyright

Copyright 2023 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

_wlmtk_layer_output_add_panel()

void _wlmtk_layer_output_add_panel ( wlmtk_layer_output_t * layer_output_ptr, wlmtk_panel_t * panel_ptr )

static

Adds the panel to the output.

_wlmtk_layer_output_create()

void * _wlmtk_layer_output_create ( struct wlr_output * wlr_output_ptr, void * ud_ptr )

static

Creates a layer output for wlr_output_ptr.

_wlmtk_layer_output_destroy()

void _wlmtk_layer_output_destroy ( struct wlr_output * wlr_output_ptr, void * ud_ptr, void * output_ptr )

static

Output is removed. Unlink all panels, and destroy the layer output.

_wlmtk_layer_output_remove_dlnode_panel()

void _wlmtk_layer_output_remove_dlnode_panel ( bs_dllist_node_t * dlnode_ptr, void * ud_ptr )

static

Removes dlnode_ptr's panel from the layer output and destroys it.

_wlmtk_layer_output_remove_panel()

void _wlmtk_layer_output_remove_panel ( wlmtk_layer_output_t * layer_output_ptr, wlmtk_panel_t * panel_ptr )

static

Removes the panel from the output.

_wlmtk_layer_output_update()

void _wlmtk_layer_output_update ( struct wlr_output * wlr_output_ptr, void * ud_ptr, void * output_ptr )

static

Reconfigures the layer, if the extents of this output changed.

test_layout()

void test_layout ( bs_test_t * test_ptr )

static

Tests panel layout with multiple panels.

test_multi_output()

void test_multi_output ( bs_test_t * test_ptr )

static

Tests adding + removing outputs, and updates to panel positions.

wlmtk_layer_add_panel()

bool wlmtk_layer_add_panel	(	wlmtk_layer_t *	layer_ptr,
		wlmtk_panel_t *	panel_ptr,
		struct wlr_output *	wlr_output_ptr )

Adds the panel to the output within the specified layer. This will trigger an update to the layer's layout, and a call to request_size of each panel of that output.

Parameters

layer_ptr
panel_ptr
wlr_output_ptr

wlmtk_layer_create()

wlmtk_layer_t * wlmtk_layer_create

(

struct wlr_output_layout *

wlr_output_layout_ptr

)

Creates a layer. Layers contain panels, such as layer shells.

Parameters

wlr_output_layout_ptr

The output layout.

Returns

Pointer to the layer handle or NULL on error.

wlmtk_layer_destroy()

void wlmtk_layer_destroy

(

wlmtk_layer_t *

layer_ptr

)

Destroys the layer.

Parameters

layer_ptr

wlmtk_layer_element()

wlmtk_element_t * wlmtk_layer_element

(

wlmtk_layer_t *

layer_ptr

)

Returns

Pointer to super wlmtk_element_t of the layer.

wlmtk_layer_output_reconfigure()

void wlmtk_layer_output_reconfigure

(

wlmtk_layer_output_t *

layer_output_ptr

)

Calls wlmtk_panel_compute_dimensions for each contained panel.

The Wayland protocol spells it is 'undefined' how panels (layer shells) are stacked and configured within a layer. For wlmaker, we'll configure the panels in sequence as they were added (found in the container, back to front).

Parameters

layer_output_ptr

wlmtk_layer_remove_panel()

void wlmtk_layer_remove_panel	(	wlmtk_layer_t *	layer_ptr,
		wlmtk_panel_t *	panel_ptr )

Removes the panel from the layer.

Parameters

layer_ptr
panel_ptr

wlmtk_layer_set_workspace()

void wlmtk_layer_set_workspace	(	wlmtk_layer_t *	layer_ptr,
		wlmtk_workspace_t *	workspace_ptr )

Sets the parent workspace for the layer.

Should only be called from wlmtk_workspace_t methods.

Parameters

layer_ptr
workspace_ptr	NULL to clear the workspace reference.

Variable Documentation

wlmtk_layer_test_cases

const bs_test_case_t wlmtk_layer_test_cases[]

Initial value:

                                            = {
    { 1, "multi_output", test_multi_output },
    { 1, "layout", test_layout },
    { 0, NULL, NULL }
}

Layer unit test.