oak-editor/app/panel/panel.h

/***

  Olive - Non-Linear Video Editor
  Copyright (C) 2022 Olive Team
  Modifications Copyright (C) 2025 mikesolar

  This program is free software: you can redistribute it and/or modify
  it under the terms of the GNU General Public License as published by
  the Free Software Foundation, either version 3 of the License, or
  (at your option) any later version.

  This program is distributed in the hope that it will be useful,
  but WITHOUT ANY WARRANTY; without even the implied warranty of
  MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.  See the
  GNU General Public License for more details.

  You should have received a copy of the GNU General Public License
  along with this program.  If not, see <http://www.gnu.org/licenses/>.

***/

#ifndef PANEL_WIDGET_H
#define PANEL_WIDGET_H

#include "KDDockWidgets/src/core/Window_p.h"
#include "KDDockWidgets/src/qtwidgets/views/TabBar.h"

#include <kddockwidgets/DockWidget.h>
#include <QEvent>

#include "common/define.h"

#include <QTabWidget>

namespace olive
{

/**
 * @brief A widget that is always dockable within the MainWindow.
 */
class PanelWidget : public KDDockWidgets::QtWidgets::DockWidget {
	Q_OBJECT
public:
	/**
   * @brief PanelWidget Constructor
   *
   * @param parent
   *
   * The PanelWidget's parent, enforced to help with memory handling. Most of the time this will be an instance of
   * MainWindow.
   */
	PanelWidget(const QString &object_name);

	virtual ~PanelWidget() override;

	/**
   * @brief Set visibility of panel's highlighted border, mostly used for showing panel focus
   *
   * @param enabled
   */
	void SetBorderVisible(bool enabled);

	/**
   * @brief If enabled, sends signal CloseRequested() when the user closes instead of closing
   *
   * Defaults to FALSE. Use this to override default panel closing functionality.
   */
	void SetSignalInsteadOfClose(bool e);

	using Info = std::map<QString, QString>;

	virtual void LoadData(const Info &info)
	{
	}
	virtual Info SaveData() const
	{
		return Info();
	}

	/**
   * @brief Called whenever this panel is focused and user uses "Zoom In" (either in menus or as a keyboard shortcut)
   *
   * This function is up to the Panel's interpretation of what the user intends to zoom into. Default behavior is a
   * no-op.
   */
	virtual void ZoomIn()
	{
	}

	/**
   * @brief Called whenever this panel is focused and user uses "Zoom Out" (either in menus or as a keyboard shortcut)
   *
   * This function is up to the Panel's interpretation of what the user intends to zoom out of. Default behavior is a
   * no-op.
   */
	virtual void ZoomOut()
	{
	}

	virtual void GoToStart()
	{
	}

	virtual void PrevFrame()
	{
	}

	/**
   * @brief Called whenever this panel is focused and user uses "Play/Pause" (either in menus or as a keyboard shortcut)
   *
   * This function is up to the Panel's interpretation of what the user intends to zoom out of. Default behavior is a
   * no-op.
   */
	virtual void PlayPause()
	{
	}

	virtual void PlayInToOut()
	{
	}

	virtual void NextFrame()
	{
	}

	virtual void GoToEnd()
	{
	}

	virtual void SelectAll()
	{
	}

	virtual void DeselectAll()
	{
	}

	virtual void RippleToIn()
	{
	}

	virtual void RippleToOut()
	{
	}

	virtual void EditToIn()
	{
	}

	virtual void EditToOut()
	{
	}

	virtual void ShuttleLeft()
	{
	}

	virtual void ShuttleStop()
	{
	}

	virtual void ShuttleRight()
	{
	}

	virtual void GoToPrevCut()
	{
	}

	virtual void GoToNextCut()
	{
	}

	virtual void RenameSelected()
	{
	}

	virtual void DeleteSelected()
	{
	}

	virtual void RippleDelete()
	{
	}

	virtual void IncreaseTrackHeight()
	{
	}

	virtual void DecreaseTrackHeight()
	{
	}

	virtual void SetIn()
	{
	}

	virtual void SetOut()
	{
	}

	virtual void ResetIn()
	{
	}

	virtual void ResetOut()
	{
	}

	virtual void ClearInOut()
	{
	}

	virtual void SetMarker()
	{
	}

	virtual void ToggleLinks()
	{
	}

	virtual void CutSelected()
	{
	}

	virtual void CopySelected()
	{
	}

	virtual void Paste()
	{
	}

	virtual void PasteInsert()
	{
	}

	virtual void ToggleShowAll()
	{
	}

	virtual void GoToIn()
	{
	}

	virtual void GoToOut()
	{
	}

	virtual void DeleteInToOut()
	{
	}

	virtual void RippleDeleteInToOut()
	{
	}

	virtual void ToggleSelectedEnabled()
	{
	}

	virtual void Duplicate()
	{
	}

	virtual void SetColorLabel(int)
	{
	}

	virtual void NudgeLeft()
	{
	}

	virtual void NudgeRight()
	{
	}

	virtual void MoveInToPlayhead()
	{
	}

	virtual void MoveOutToPlayhead()
	{
	}

signals:
	void CloseRequested();
	void shown(Qt::FocusReason reason);
	void hidden();
protected:
	/**
   * @brief paintEvent
   * @param event
   */
	void paintEvent(QPaintEvent *event) override;

	virtual void changeEvent(QEvent *e) override;

	virtual void closeEvent(QCloseEvent *event) override;

	virtual void Retranslate();

	void SetWidgetWithPadding(QWidget *widget);

protected slots:
	/**
   * @brief Set panel's title
   *
   * Use this function to set the title of the panel.
   *
   * A PanelWidget has the default format of "Title: Subtitle" (can differ depending on translation). If no Subtitle
   * is set, the title will just be formatted "Title".
   *
   * @param t
   *
   * String to set the title to
   */
	void SetTitle(const QString &t);

	/**
   * @brief Set panel's subtitle
   *
   * Use this function to set the subtitle of the panel.
   *
   * A PanelWidget has the default format of "Title: Subtitle" (can differ depending on translation). If no Subtitle
   * is set, the title will just be formatted "Title".
   *
   * @param t
   *
   * String to set the subtitle to
   */
	void SetSubtitle(const QString &t);
protected slots:
private:
	/**
   * @brief Internal function that sets the QDockWidget's window title whenever the title/subtitle change.
   *
   * Should be called any time a change is made to title_ or subtitle_
   */
	void UpdateTitle();

	QString title_;

	QString subtitle_;

	bool border_visible_;

	bool signal_instead_of_close_;

	QMetaObject::Connection m_tabBarConnection;
	QMetaObject::Connection m_windowConnection;
	bool m_lastVisibleState = false;
};

}

#endif // PANEL_WIDGET_H