Main stream layout widget: grid plus optional focused view. More...

#include <frontend/include/widgets/board.hpp>

Inheritance diagram for board:

Collaboration diagram for board:

[legend]

Public Member Functions
	board (QWidget *parent=nullptr)
	Construct the board widget.
grid_view *	grid_mode () const
	Access the grid view (thumbnail mode).
stream_cell *	active_cell () const
	Get the currently active (focused) stream cell, if any.
void	set_active_stream (const QString &name)
	Make a stream active by name.
void	clear_active ()
	Clear active mode and return the active cell to the grid.
stream_cell *	take_active_cell ()
	Detach and return the active cell without putting it back to grid.

Private Attributes
grid_view *	grid
	Grid view holding all non-active stream cells.
QWidget *	active_container
	Container widget for the active stream view.
QVBoxLayout *	active_layout
	Layout inside active_container.
stream_cell *	active_tile
	Currently active stream cell (reparented into active container).

Detailed Description

Main stream layout widget: grid plus optional focused view.

The board maintains two display modes simultaneously:

Grid mode: all streams are shown in a grid_view.
Active mode: one stream is temporarily taken out of the grid and placed into an enlarged container at the top.

Ownership model:

The board owns the grid view and the active container.
Stream cells are owned by the grid view most of the time.
When a stream becomes active, its cell is reparented into the active container and later returned to the grid (no deletion involved).

Note: The class is final and not intended for subclassing.

Definition at line 40 of file board.hpp.

Constructor & Destructor Documentation

◆ board()

board::board ( QWidget * parent = nullptr )

explicit

Construct the board widget.

Creates:

a grid_view for thumbnail layout,
an active container (initially hidden) that can host one active cell,
an outer vertical layout stacking active container above the grid.

Parameters

parent Optional parent widget.

Definition at line 8 of file board.cpp.

    : QWidget(parent)
    , grid(new grid_view(this))
    , active_container(new QWidget(this))
    , active_layout(new QVBoxLayout(active_container))
    , active_tile(nullptr) {
    active_layout->setContentsMargins(6, 6, 6, 6);
    active_layout->setSpacing(6);
    active_container->setLayout(active_layout);
 
    auto* outer = new QVBoxLayout(this);
    outer->setContentsMargins(0, 0, 0, 0);
    outer->setSpacing(6);
 
    outer->addWidget(active_container, 3);
 
    outer->addWidget(grid, 1);
 
    setLayout(outer);
    active_container->hide();
}

References active_layout, active_tile, and grid.

Member Function Documentation

◆ active_cell()

stream_cell * board::active_cell ( ) const

Get the currently active (focused) stream cell, if any.

Returns: Active stream_cell, or nullptr if none.

Definition at line 32 of file board.cpp.

32{ return active_tile; }

References active_tile.

Referenced by controller::active_cell_checked(), controller::apply_template_preview(), controller::on_active_edit_mode_changed(), controller::on_active_labels_enabled_changed(), controller::on_active_line_params_changed(), controller::on_active_line_undo_requested(), controller::on_active_stream_selected(), controller::sync_active_cell_lines(), and controller::tile_for_stream_name().

Here is the caller graph for this function:

◆ clear_active()

void board::clear_active ( )

Clear active mode and return the active cell to the grid.

If no stream is active, this is a no-op.

Definition at line 66 of file board.cpp.

                         {
    if (!active_tile || !grid) {
        return;
    }
    active_layout->removeWidget(active_tile);
    active_tile->set_active(false);
    grid->put_stream_cell(active_tile);
    // active_tile->deleteLater();
    active_tile = nullptr;
 
    active_container->hide();
    active_container->updateGeometry();
}

References active_layout, active_tile, grid, grid_view::put_stream_cell(), and stream_cell::set_active().

Referenced by controller::on_active_stream_selected().

Here is the call graph for this function:

Here is the caller graph for this function:

◆ grid_mode()

grid_view * board::grid_mode ( ) const

Access the grid view (thumbnail mode).

Returns: Pointer to owned grid_view.

Definition at line 30 of file board.cpp.

30{ return grid; }

References grid.

Referenced by controller::controller().

Here is the caller graph for this function:

◆ set_active_stream()

void board::set_active_stream ( const QString & name )

Make a stream active by name.

If a different stream is already active, it is returned to the grid first. The requested cell is taken from the grid, reparented into the active container, marked active, and enlarged.

If name is empty or not found in grid, the call is ignored.

Parameters

name	Name of the stream to focus.

Definition at line 34 of file board.cpp.

                                                 {
    if (!grid || name.isEmpty()) {
        return;
    }
    if (active_tile && active_tile->get_name() == name) {
        return;
    }
 
    if (active_tile) {
        active_layout->removeWidget(active_tile);
        active_tile->set_active(false);
        grid->put_stream_cell(active_tile);
        active_tile = nullptr;
    }
 
    stream_cell* cell = grid->take_stream_cell(name);
    if (!cell) {
        return;
    }
    active_container->show();
 
    cell->setParent(active_container);
    cell->set_active(true);
 
    cell->setSizePolicy(QSizePolicy::Expanding, QSizePolicy::Expanding);
    cell->show();
    active_layout->addWidget(cell);
    active_tile = cell;
 
    active_container->updateGeometry();
}

References active_layout, active_tile, stream_cell::get_name(), grid, grid_view::put_stream_cell(), stream_cell::set_active(), and grid_view::take_stream_cell().

Referenced by controller::on_active_stream_selected().

Here is the call graph for this function:

Here is the caller graph for this function:

◆ take_active_cell()

stream_cell * board::take_active_cell ( )

Detach and return the active cell without putting it back to grid.

The returned cell:

is removed from the active layout,
is marked inactive,
remains parented to this board until the caller reparents it.

After this call there is no active stream.

Returns: The previously active cell, or nullptr if none.

Definition at line 80 of file board.cpp.

                                     {
    if (!active_tile) {
        return nullptr;
    }
 
    active_layout->removeWidget(active_tile);
    active_tile->set_active(false);
 
    active_container->hide();
    active_container->updateGeometry();
 
    stream_cell* out = active_tile;
    active_tile = nullptr;
    return out;
}