TabDeckEditorVisual provides a fully-featured deck editor tab with an enhanced visual interface. It extends AbstractTabDeckEditor. More...

#include <tab_deck_editor_visual.h>

Inheritance diagram for TabDeckEditorVisual:

[legend]

Collaboration diagram for TabDeckEditorVisual:

[legend]

Public Slots
void	onDeckChanged () override
	Refresh UI when the deck changes.
void	processMainboardCardClick (const QMouseEvent *event, const ExactCard &card, const QString &zoneName)
	Handle card clicks in the mainboard visual deck.
void	processDatabaseCardClick (const QMouseEvent *event, const ExactCard &card)
	Handle card clicks in the database visual display.
bool	actSaveDeckAs () override
	Save the deck under a new name.
Public Slots inherited from AbstractTabDeckEditor
virtual void	onDeckChanged ()
	Called when the deck changes.
virtual void	onDeckModified ()
	Called when the deck is modified.
void	updateCard (const ExactCard &card)
	Updates the card info dock and printing selector.
void	updateCardInfo (const ExactCard &card)
	Updates just the card info dock.
void	addCard (const ExactCard &card, const QString &zoneName)
	Adds a card to the given zone.
void	decrementCard (const ExactCard &card, const QString &zoneName)
	Decrements a card from the given zone.
void	actOpenRecent (const QString &fileName)
	Opens a recently opened deck file.
void	filterTreeChanged (FilterTree *filterTree)
	Called when the filter tree changes.
bool	closeRequest () override
	Requests closing the tab.
void	showPrintingSelector ()
	Shows the printing selector dock and updates it with the current card.
void	openEdhrecTab (const CardInfoPtr &info, bool isCommander)
	Opens an EDHRec tab for the given card.

Public Member Functions
	TabDeckEditorVisual (TabSupervisor *_tabSupervisor)
	Constructs a visual deck editor tab.
void	retranslateUi () override
	Retranslate UI strings (for i18n support).
QString	getTabText () const override
	Get the display text for the tab.
void	changeModelIndexAndCardInfo (const ExactCard &activeCard)
	Update the currently selected card in the deck and UI.
void	changeModelIndexToCard (const ExactCard &activeCard)
	Change the deck view selection to a specific card.
void	createDeckAnalyticsDock ()
	Create the deck analytics dock widget.
void	createMenus () override
	Setup menus for this visual deck editor.
void	createSearchAndDatabaseFrame ()
	Create search and database display frame.
void	createCentralFrame ()
	Create central frame for visual widgets.
Public Member Functions inherited from AbstractTabDeckEditor
	AbstractTabDeckEditor (TabSupervisor *_tabSupervisor)
	Constructs an AbstractTabDeckEditor.
bool	confirmClose ()
	Confirms whether the tab can be safely closed.
void	openDeck (const LoadedDeck &deck)
	Opens a deck in this tab.
DeckEditorDeckDockWidget *	getDeckDockWidget () const
Public Member Functions inherited from Tab
	Tab (TabSupervisor *_tabSupervisor)
const QList< QMenu * > &	getTabMenus () const
TabSupervisor *	getTabSupervisor () const
bool	getContentsChanged () const
void	setContentsChanged (bool _contentsChanged)
virtual bool	closeRequest ()
virtual void	tabActivated ()

Protected Slots
void	loadLayout () override
	Load the editor layout from settings.
void	restartLayout () override
	Reset and restart the layout to default.
void	refreshShortcuts () override
	Refresh keyboard shortcuts for this tab.
bool	eventFilter (QObject o, QEvent e) override
	Synchronize dock state with menu items.
Protected Slots inherited from AbstractTabDeckEditor
virtual void	actNewDeck ()
	Starts a new deck in this tab.
void	cleanDeckAndResetModified ()
	Cleans the current deck and resets the modified state.
virtual void	actLoadDeck ()
	Loads a deck from file.
bool	actSaveDeck ()
	Saves the current deck.
virtual bool	actSaveDeckAs ()
	Saves the current deck under a new name.
virtual void	actLoadDeckFromClipboard ()
	Loads a deck from the clipboard.
void	actEditDeckInClipboard ()
	Opens a deck editor for clipboard contents.
void	actEditDeckInClipboardRaw ()
	Opens a raw clipboard deck editor.
void	actSaveDeckToClipboard ()
	Saves deck to clipboard with full info.
void	actSaveDeckToClipboardNoSetInfo ()
	Saves deck to clipboard without set info.
void	actSaveDeckToClipboardRaw ()
	Saves deck to clipboard in raw format.
void	actSaveDeckToClipboardRawNoSetInfo ()
	Saves deck to clipboard in raw format without set info.
void	actPrintDeck ()
	Prints the deck using a preview dialog.
void	actLoadDeckFromWebsite ()
	Loads a deck from an online website.
void	actExportDeckDecklist ()
	Exports the deck to decklist.org.
void	actExportDeckDecklistXyz ()
	Exports the deck to decklist.xyz.
void	actAnalyzeDeckDeckstats ()
	Analyzes the deck using deckstats.net.
void	actAnalyzeDeckTappedout ()
	Analyzes the deck using tappedout.net.
void	saveDeckRemoteFinished (const Response &r)
	Callback when a remote deck save finishes.
virtual void	loadLayout ()=0
virtual void	restartLayout ()=0
virtual void	refreshShortcuts ()=0
void	closeEvent (QCloseEvent *event) override
	Handles dock close events.
Protected Slots inherited from Tab
void	showCardInfoPopup (const QPoint &pos, const CardRef &cardRef)
void	deleteCardInfoPopup (const QString &cardName)

Protected Attributes
TabDeckEditorVisualTabWidget *	tabContainer
	Tab container holding different visual widgets.
QVBoxLayout *	centralFrame
	Layout for central widgets.
QVBoxLayout *	searchAndDatabaseFrame
	Layout for search and database display.
QHBoxLayout *	searchLayout
	Layout for search bar.
QDockWidget *	searchAndDatabaseDock
	Dock widget for search/database display.
QWidget *	centralWidget
	Central widget of the editor.
Protected Attributes inherited from AbstractTabDeckEditor
QMenu *	viewMenu
QAction *	aResetLayout
QMap< QDockWidget *, DockActions >	dockToActions
Protected Attributes inherited from Tab
TabSupervisor *	tabSupervisor

Private Member Functions
void	setDeck (const LoadedDeck &_deck) override
	Sets the deck for this tab and selects the sub-tab to open on startup, per the "Visual deck editor startup tab" setting (Context / Deck display / Database display).

Additional Inherited Members
Signals inherited from AbstractTabDeckEditor
void	openDeckEditor (const LoadedDeck &deck)
	Emitted when a deck should be opened in a new editor tab.
void	deckEditorClosing (AbstractTabDeckEditor *tab)
	Emitted before the tab is closed.
Signals inherited from Tab
void	userEvent (bool globalEvent=true)
void	tabTextChanged (Tab *tab, const QString &newTabText)
void	cockatriceLinkActivated (const QString &url)
Public Attributes inherited from AbstractTabDeckEditor
DeckStateManager *	deckStateManager
CardDatabaseModel *	databaseModel
	Card database.
DeckEditorMenu *	deckMenu
	Menu for deck operations.
DeckEditorCardDatabaseDockWidget *	cardDatabaseDockWidget
	Database dock.
DeckEditorCardInfoDockWidget *	cardInfoDockWidget
	Card info dock.
DeckEditorDeckDockWidget *	deckDockWidget
	Deck dock.
DeckEditorFilterDockWidget *	filterDockWidget
	Filter dock.
DeckEditorPrintingSelectorDockWidget *	printingSelectorDockWidget
	Printing selector dock.
Protected Types inherited from AbstractTabDeckEditor
enum	DeckOpenLocation { CANCELLED , SAME_TAB , NEW_TAB }
	Enum describing deck open locations. More...
Protected Member Functions inherited from AbstractTabDeckEditor
void	registerDockWidget (QMenu _viewMenu, QDockWidget widget, const QSize &defaultSize)
	registers a QDockWidget as a managed dock widget. Creates the associated actions and menu, adds them to the viewMenu, and connects those actions to the tab's slots.
DeckOpenLocation	confirmOpen (bool openInSameTabIfBlank=true)
	Confirms deck open action based on settings and modified state.
QMessageBox *	createSaveConfirmationWindow ()
	Creates a save confirmation message box.
virtual void	openDeckFromFile (const QString &fileName, DeckOpenLocation deckOpenLocation)
	Opens a deck from a file.
Protected Member Functions inherited from Tab
void	addTabMenu (QMenu *menu)

Detailed Description

TabDeckEditorVisual provides a fully-featured deck editor tab with an enhanced visual interface. It extends AbstractTabDeckEditor.

Description: TabDeckEditorVisual is a fully-featured deck editor tab with an enhanced visual interface. It extends AbstractTabDeckEditor and integrates multiple visual components such as a visual deck view, database display, deck analytics, and sample hand preview.

Purpose:

Provides an intuitive, visual interface for deck editing.
Combines visual deck representation, card database browsing, and analytics into one tab.
Supports card interactions via clicks, hover events, and drag-and-drop-like behavior (not yet).

Dock Widgets and Components:

TabDeckEditorVisualTabWidget — Container for visual sub-tabs (further described in code_client_tabs_deck_editor_visual_tab).
- VisualDeckEditorWidget — Displays and interacts with the deck visually.
- VisualDatabaseDisplayWidget — Allows adding cards from the database visually.
- DeckAnalyticsWidget — Displays deck statistics and analytics.
- VisualDeckEditorSampleHandWidget — Simulates a sample hand from the deck.
DeckEditorCardInfoDockWidget — Shows detailed card info for hovered/selected cards.
DeckEditorDeckDockWidget — Displays deck zones and cards in a tree-view.
DeckEditorFilterDockWidget — Provides filtering options for card searches.
DeckEditorPrintingSelectorDockWidget — Selects specific card printings.

Key Methods:

createCentralFrame() — Sets up the central widget and visual sub-tabs.
onDeckChanged() — Refreshes visual widgets when the deck is modified.
changeModelIndexAndCardInfo(const ExactCard &card) — Updates deck model selection and card info.
changeModelIndexToCard(const ExactCard &card) — Selects the card in the deck view.
processMainboardCardClick(QMouseEvent *event, ...) — Handles clicks on mainboard cards.
processDatabaseCardClick(QMouseEvent *event, ...) — Handles clicks on database cards.
actSaveDeckAs() — Overrides save action with temporary UI adjustments.
showPrintingSelector() — Opens the printing selector dock for the current card.
freeDocksSize() — Frees constraints on dock widget sizes.
refreshShortcuts() — Updates tab-specific shortcuts from settings.
loadLayout() — Loads saved layout or applies default if none exists.
restartLayout() — Resets dock positions, visibility, and floating states.
retranslateUi() — Updates text/UI elements for localization.
eventFilter(QObject *o, QEvent *e) — Syncs dock states with menu actions and saves layout.

Constructor & Destructor Documentation

◆ TabDeckEditorVisual()

TabDeckEditorVisual::TabDeckEditorVisual ( TabSupervisor * _tabSupervisor )

explicit

Constructs a visual deck editor tab.

Constructs the TabDeckEditorVisual instance.

Parameters

_tabSupervisor Pointer to the tab supervisor managing this tab.

Sets up the central widget, tab container, menus, shortcuts, and restores the saved layout.

Parameters

_tabSupervisor Parent tab supervisor managing this tab.

Here is the call graph for this function:

Member Function Documentation

◆ actSaveDeckAs

bool TabDeckEditorVisual::actSaveDeckAs ( )

overrideslot

Save the deck under a new name.

Performs "Save Deck As..." while temporarily disabling the search bar.

Returns: true if successful, false otherwise.

Here is the call graph for this function:

◆ changeModelIndexAndCardInfo()

void TabDeckEditorVisual::changeModelIndexAndCardInfo ( const ExactCard & activeCard )

Update the currently selected card in the deck and UI.

Updates card info and highlights the corresponding card in the deck view.

Parameters

activeCard Card to display.

Here is the call graph for this function:

Here is the caller graph for this function:

◆ changeModelIndexToCard()

void TabDeckEditorVisual::changeModelIndexToCard ( const ExactCard & activeCard )

Change the deck view selection to a specific card.

Selects the given card in the deck view, checking main and side zones.

Parameters

activeCard Card to select in the deck view.

Here is the call graph for this function:

Here is the caller graph for this function:

◆ createCentralFrame()

void TabDeckEditorVisual::createCentralFrame ( )

Create central frame for visual widgets.

Creates the central frame containing the tab container.

Here is the call graph for this function:

Here is the caller graph for this function:

◆ createDeckAnalyticsDock()

void TabDeckEditorVisual::createDeckAnalyticsDock ( )

Create the deck analytics dock widget.

◆ createMenus()

void TabDeckEditorVisual::createMenus ( )

overridevirtual

Setup menus for this visual deck editor.

Creates menus for deck editing and view options, including dock actions.

Implements AbstractTabDeckEditor.

Here is the call graph for this function:

Here is the caller graph for this function:

◆ createSearchAndDatabaseFrame()

void TabDeckEditorVisual::createSearchAndDatabaseFrame ( )

Create search and database display frame.

◆ eventFilter

bool TabDeckEditorVisual::eventFilter	(	QObject *	o,
		QEvent *	e )

overrideprotectedslot

Synchronize dock state with menu items.

Handles dock visibility, floating, and layout saving events.

Parameters

o	The object sending the event.
e	The event being filtered.

Returns: true if the event is handled, false otherwise.

Keeps dock state in sync with menu items and saves layout when hidden.

Here is the call graph for this function:

◆ getTabText()

QString TabDeckEditorVisual::getTabText ( ) const

nodiscardoverridevirtual

Get the display text for the tab.

Returns the tab text, prepending a mark if the deck has unsaved changes.

Returns: Tab text with optional modification indicator.

Implements AbstractTabDeckEditor.

◆ loadLayout

void TabDeckEditorVisual::loadLayout ( )

overrideprotectedslot

Load the editor layout from settings.

Loads the saved layout or resets to default if no layout exists.

Here is the call graph for this function:

Here is the caller graph for this function:

◆ onDeckChanged

void TabDeckEditorVisual::onDeckChanged ( )

overrideslot

Refresh UI when the deck changes.

Updates the visual deck, analytics, and sample hand after a deck change.

Here is the call graph for this function:

◆ processDatabaseCardClick

void TabDeckEditorVisual::processDatabaseCardClick	(	const QMouseEvent *	event,
		const ExactCard &	card )

slot

Handle card clicks in the database visual display.

Handles clicks on cards in the database display.

Parameters

event	Mouse event triggering the action.
card	The clicked card.

Here is the call graph for this function:

Here is the caller graph for this function:

◆ processMainboardCardClick

void TabDeckEditorVisual::processMainboardCardClick	(	const QMouseEvent *	event,
		const ExactCard &	card,
		const QString &	zoneName )

slot

Handle card clicks in the mainboard visual deck.

Parameters

event	Mouse event triggering the action.
card	The clicked card.
zoneName	Deck zone of the card.

Here is the call graph for this function:

Here is the caller graph for this function:

◆ refreshShortcuts

void TabDeckEditorVisual::refreshShortcuts ( )

overrideprotectedslot

Refresh keyboard shortcuts for this tab.

Refreshes keyboard shortcuts for this tab from settings.

Here is the call graph for this function:

Here is the caller graph for this function:

◆ restartLayout

void TabDeckEditorVisual::restartLayout ( )

overrideprotectedslot

Reset and restart the layout to default.

Resets the layout to default positions and dock states.

Here is the caller graph for this function:

◆ retranslateUi()

void TabDeckEditorVisual::retranslateUi ( )

overridevirtual

Retranslate UI strings (for i18n support).

Retranslates UI elements for localization.

Implements AbstractTabDeckEditor.

Here is the caller graph for this function:

◆ setDeck()

void TabDeckEditorVisual::setDeck ( const LoadedDeck & _deck )

overrideprivatevirtual

Sets the deck for this tab and selects the sub-tab to open on startup, per the "Visual deck editor startup tab" setting (Context / Deck display / Database display).

Sets the deck and selects the startup sub-tab matching the context.

Parameters

_deck The deck object.

Reimplemented from AbstractTabDeckEditor.

Here is the call graph for this function:

Member Data Documentation

◆ centralFrame

QVBoxLayout* TabDeckEditorVisual::centralFrame

protected

Layout for central widgets.

◆ centralWidget

QWidget* TabDeckEditorVisual::centralWidget

protected

Central widget of the editor.

◆ searchAndDatabaseDock

QDockWidget* TabDeckEditorVisual::searchAndDatabaseDock

protected

Dock widget for search/database display.

◆ searchAndDatabaseFrame

QVBoxLayout* TabDeckEditorVisual::searchAndDatabaseFrame

protected

Layout for search and database display.

◆ searchLayout

QHBoxLayout* TabDeckEditorVisual::searchLayout

protected

Layout for search bar.

◆ tabContainer

TabDeckEditorVisualTabWidget* TabDeckEditorVisual::tabContainer

protected

Tab container holding different visual widgets.

The documentation for this class was generated from the following files:

cockatrice/src/interface/widgets/tabs/visual_deck_editor/tab_deck_editor_visual.h
cockatrice/src/interface/widgets/tabs/visual_deck_editor/tab_deck_editor_visual.cpp

Public Slots

Public Member Functions

Protected Slots

Protected Attributes

Private Member Functions

Additional Inherited Members

Detailed Description

Constructor & Destructor Documentation

◆ TabDeckEditorVisual()

Member Function Documentation

◆ actSaveDeckAs

◆ changeModelIndexAndCardInfo()

◆ changeModelIndexToCard()

◆ createCentralFrame()

◆ createDeckAnalyticsDock()

◆ createMenus()

◆ createSearchAndDatabaseFrame()

◆ eventFilter

◆ getTabText()

◆ loadLayout

◆ onDeckChanged

◆ processDatabaseCardClick

◆ processMainboardCardClick

◆ refreshShortcuts

◆ restartLayout

◆ retranslateUi()

◆ setDeck()

Member Data Documentation

◆ centralFrame

◆ centralWidget

◆ searchAndDatabaseDock

◆ searchAndDatabaseFrame

◆ searchLayout

◆ tabContainer