KisAnimTimelineDockerTitlebar Class Reference

A customized titlebar for the Animation Timeline Docker that's packed with useful widgets and menus. More...

#include <KisAnimTimelineDocker.h>

Inheritance diagram for KisAnimTimelineDockerTitlebar:

Public Member Functions
	KisAnimTimelineDockerTitlebar (QWidget *parent=nullptr)
Public Member Functions inherited from KisUtilityTitleBar
void	dockWidgetTitleChanged (const QString &title)
void	featuresChanged (QDockWidget::DockWidgetFeatures features)
	KisUtilityTitleBar (QLabel *title, QWidget *parent=nullptr)
	KisUtilityTitleBar (QWidget *parent=nullptr)
	Private (KisUtilityTitleBar *thePublic)
void	setWidgetArea (QWidget *widgetArea)
QSize	sizeHint () const override
void	toggleFloating ()
void	topLevelChanged (bool topLevel)
void	updateButtonSizes ()
void	updateIcons ()
QWidget *	widgetArea ()
	~KisUtilityTitleBar ()

Public Attributes
QAction *	autoKeyBlank
QAction *	autoKeyDuplicate
QToolButton *	btnAddKeyframe
QToolButton *	btnAudioMenu
QToolButton *	btnAutoKey
QToolButton *	btnDropFrames
QToolButton *	btnDuplicateKeyframe
QToolButton *	btnOnionSkinsMenu
QToolButton *	btnRemoveKeyframe
QToolButton *	btnSettingsMenu
KisIntParseSpinBox *	frameRegister
QAction *	importAudioAction
QAction *	muteAudioAction
QAction *	removeAudioAction
KisIntParseSpinBox *	sbEndFrame
KisIntParseSpinBox *	sbFrameRate
KisSliderSpinBox *	sbSpeed
KisIntParseSpinBox *	sbStartFrame
QString	strImportAudio
KisTransportControls *	transport
KisSliderSpinBox *	volumeSlider
Public Attributes inherited from KisUtilityTitleBar
QPushButton *	closeButton {nullptr}
QDockWidget::DockWidgetFeatures	features
QPushButton *	floatButton {nullptr}
QIcon	floatIcon
QAbstractButton *	lockButton {nullptr}
bool	locked {false}
QIcon	lockIcon
QHBoxLayout *	mainLayout
QIcon	removeIcon
KisUtilityTitleBar *	thePublic {nullptr}
KSqueezedTextLabel *	titleLabel {nullptr}

Private Attributes
const int	MAX_FRAMES = 9999

Additional Inherited Members
Public Slots inherited from KisUtilityTitleBar
void	setLocked (bool locked)
Protected Attributes inherited from KisUtilityTitleBar
Private *const	d
const int	SPACING_UNIT = 16
QHBoxLayout *	widgetAreaLayout

Detailed Description

A customized titlebar for the Animation Timeline Docker that's packed with useful widgets and menus.

To avoid cluttering the UI, elements that are important to the animator's workflow should be available at a glace, while set-and-forget types of things should be hidden inside of menus.

Definition at line 41 of file KisAnimTimelineDocker.h.

Constructor & Destructor Documentation

KisAnimTimelineDockerTitlebar()

KisAnimTimelineDockerTitlebar::KisAnimTimelineDockerTitlebar

(

QWidget *

parent = nullptr

)

Definition at line 61 of file KisAnimTimelineDocker.cpp.

                                                                            :
    KisUtilityTitleBar(new QLabel(i18n("Animation Timeline"), parent), parent)
{
    setFocusPolicy(Qt::ClickFocus);
 
    // Transport Controls...
    transport = new KisTransportControls(this);
    transport->showSkipButtons(true);
    widgetAreaLayout->addWidget(transport);
 
    widgetAreaLayout->addSpacing(SPACING_UNIT);
 
    // Frame Register...
    frameRegister = new KisIntParseSpinBox(this);
    frameRegister->setToolTip(i18n("Frame register"));
    frameRegister->setPrefix("#  ");
    frameRegister->setRange(0, MAX_FRAMES);
    widgetAreaLayout->addWidget(frameRegister);
 
    widgetAreaLayout->addSpacing(SPACING_UNIT);
 
    {   // Drop Frames..
        btnDropFrames = new QToolButton(this);
        btnDropFrames->setAutoRaise(true);
        widgetAreaLayout->addWidget(btnDropFrames);
 
        // Playback Speed..
        sbSpeed = new KisSliderSpinBox(this);
        sbSpeed->setRange(25, 200);
        sbSpeed->setSingleStep(5);
        sbSpeed->setValue(100);
        sbSpeed->setPrefix(i18nc("preview playback speed percentage prefix", "Speed: "));
        sbSpeed->setSuffix(" %");
        sbSpeed->setToolTip(i18n("Preview playback speed"));
 
        widgetAreaLayout->addWidget(sbSpeed);
    }
 
    widgetAreaLayout->addSpacing(SPACING_UNIT);
 
    {   // Frame ops...
        QWidget *widget = new QWidget(this);
        QHBoxLayout *layout = new QHBoxLayout(widget);
        layout->setSpacing(0);
        layout->setContentsMargins(0,0,0,0);
 
        btnAddKeyframe = new QToolButton(this);
        btnAddKeyframe->setAutoRaise(true);
        layout->addWidget(btnAddKeyframe);
 
        btnDuplicateKeyframe = new QToolButton(this);
        btnDuplicateKeyframe->setAutoRaise(true);
        layout->addWidget(btnDuplicateKeyframe);
 
        btnRemoveKeyframe = new QToolButton(this);
        btnRemoveKeyframe->setAutoRaise(true);
        layout->addWidget(btnRemoveKeyframe);
 
        widgetAreaLayout->addWidget(widget);
    }
 
    widgetAreaLayout->addStretch();
 
    {   // Menus..
        QWidget *widget = new QWidget(this);
 
        QHBoxLayout *layout = new QHBoxLayout(widget);
        layout->setSpacing(0);
        layout->setContentsMargins(SPACING_UNIT,0,0,0);
 
        // Onion skins menu.
        btnOnionSkinsMenu = new QToolButton(this);
        btnOnionSkinsMenu->setIcon(KisIconUtils::loadIcon("onion_skin_options"));
        btnOnionSkinsMenu->setToolTip(i18n("Onion skins menu"));
        btnOnionSkinsMenu->setIconSize(QSize(22, 22));
        btnOnionSkinsMenu->setAutoRaise(true);
        layout->addWidget(btnOnionSkinsMenu);
 
        {   // Audio menu..
            QMenu *audioMenu = new QMenu(this);
 
            strImportAudio = QString(i18nc("@item:inmenu Load audio file into Krita from disk.", "Import Audio..."));
            importAudioAction = new QAction(strImportAudio, audioMenu);
            removeAudioAction = new QAction(i18nc("@item:inmenu", "Remove audio"), audioMenu);
 
            muteAudioAction = new QAction(i18nc("@item:inmenu Mute audio playback.", "Mute"), audioMenu);
            muteAudioAction->setCheckable(true);
 
            volumeSlider = new KisSliderSpinBox(audioMenu);
            volumeSlider->setRange(0, 100);
            KisSpinBoxI18nHelper::setText(
                volumeSlider,
                i18nc("@item:inmenu Volume slider; {n} is the number value, % is the percent sign", "Volume: {n}%"));
            volumeSlider->setSingleStep(1);
            volumeSlider->setPageStep(10);
            volumeSlider->setSizePolicy(QSizePolicy::Ignored, QSizePolicy::Fixed);
 
            QWidgetAction *volumeAction = new QWidgetAction(audioMenu);
            volumeAction->setDefaultWidget(volumeSlider);
 
            audioMenu->addSeparator();
 
            audioMenu->addAction(importAudioAction);
            audioMenu->addAction(removeAudioAction);
 
            audioMenu->addSeparator();
 
            audioMenu->addAction(volumeAction);
            audioMenu->addAction(muteAudioAction);
 
            btnAudioMenu = new QToolButton(this);
            btnAudioMenu->setIcon(KisIconUtils::loadIcon("audio-none"));
            btnAudioMenu->setToolTip(i18n("Animation audio menu"));
            btnAudioMenu->setIconSize(QSize(22, 22));
            btnAudioMenu->setAutoRaise(true);
 
            btnAudioMenu->setPopupMode(QToolButton::InstantPopup);
            btnAudioMenu->setMenu(audioMenu);
            btnAudioMenu->setEnabled(false); // To be enabled on set canvas...
 
            layout->addWidget(btnAudioMenu);
        }
 
        {   // Settings menu..
            btnSettingsMenu = new QToolButton(this);
            btnSettingsMenu->setIcon(KisIconUtils::loadIcon("view-choose-22"));
            btnSettingsMenu->setToolTip(i18n("Animation settings menu"));
            btnSettingsMenu->setIconSize(QSize(22, 22));
            btnSettingsMenu->setAutoRaise(true);
 
            QWidget *settingsMenuWidget = new QWidget(this);
            QHBoxLayout *settingsMenuLayout = new QHBoxLayout(settingsMenuWidget);
 
            QWidget *fields = new QWidget(settingsMenuWidget);
            QFormLayout *fieldsLayout = new QFormLayout(fields);
 
            sbStartFrame = new KisIntParseSpinBox(settingsMenuWidget);
            sbStartFrame->setMaximum(10000);
            fieldsLayout->addRow(i18n("Clip Start: "), sbStartFrame);
 
            sbEndFrame = new KisIntParseSpinBox(settingsMenuWidget);
            sbEndFrame->setMaximum(10000);
            fieldsLayout->addRow(i18n("Clip End: "), sbEndFrame);
 
            sbFrameRate = new KisIntParseSpinBox(settingsMenuWidget);
            sbFrameRate->setMinimum(0);
            sbFrameRate->setMaximum(120);
            fieldsLayout->addRow(i18n("Frame Rate: "), sbFrameRate);
 
            QWidget *buttons = new QWidget(settingsMenuWidget);
            QVBoxLayout *buttonsLayout = new QVBoxLayout(buttons);
            buttonsLayout->setAlignment(Qt::AlignTop);
 
            {   // AutoKey..
                // AutoKey Actions & Action Group..
                autoKeyBlank = new QAction(i18n("AutoKey Blank"), this);
                autoKeyBlank->setCheckable(true);
                autoKeyDuplicate = new QAction(i18n("AutoKey Duplicate"), this);
                autoKeyDuplicate->setCheckable(true);
                QActionGroup *autoKeyModes = new QActionGroup(this);
                autoKeyModes->addAction(autoKeyBlank);
                autoKeyModes->addAction(autoKeyDuplicate);
                autoKeyModes->setExclusive(true);
 
                connect(autoKeyModes, &QActionGroup::triggered, this, [this](QAction* modeAction){
                    if (!modeAction) return;
                    {
                        KisImageConfig  imageCfg(false);
                        if (modeAction == autoKeyBlank) {
                            imageCfg.setAutoKeyModeDuplicate(false);
                        } else if (modeAction == autoKeyDuplicate) {
                            imageCfg.setAutoKeyModeDuplicate(true);
                        }
                    }
                    KisImageConfigNotifier::instance()->notifyAutoKeyFrameConfigurationChanged();
                });
 
                // AutoKey Mode Menu..
                QMenu *autoKeyModeMenu = new QMenu(settingsMenuWidget);
                autoKeyModeMenu->addActions(autoKeyModes->actions());
 
                // AutoKey Button..
                btnAutoKey = new QToolButton(settingsMenuWidget);
                btnAutoKey->setMenu(autoKeyModeMenu);
                btnAutoKey->setPopupMode(QToolButton::MenuButtonPopup);
                buttonsLayout->addWidget(btnAutoKey);
            }
 
            settingsMenuLayout->addWidget(fields);
            settingsMenuLayout->addWidget(buttons);
 
            layout->addWidget(btnSettingsMenu);
 
            QMenu *settingsPopMenu = new QMenu(this);
            QWidgetAction *settingsMenuAction = new QWidgetAction(this);
            settingsMenuAction->setDefaultWidget(settingsMenuWidget);
            settingsPopMenu->addAction(settingsMenuAction);
 
            btnSettingsMenu->setPopupMode(QToolButton::InstantPopup);
            btnSettingsMenu->setMenu(settingsPopMenu);
        }
 
        widgetAreaLayout->addWidget(widget);
    }
}

References autoKeyBlank, autoKeyDuplicate, btnAddKeyframe, btnAudioMenu, btnAutoKey, btnDropFrames, btnDuplicateKeyframe, btnOnionSkinsMenu, btnRemoveKeyframe, btnSettingsMenu, buttons(), connect(), frameRegister, importAudioAction, KisImageConfigNotifier::instance(), KisIconUtils::loadIcon(), MAX_FRAMES, muteAudioAction, KisImageConfigNotifier::notifyAutoKeyFrameConfigurationChanged(), removeAudioAction, sbEndFrame, sbFrameRate, sbSpeed, sbStartFrame, KisImageConfig::setAutoKeyModeDuplicate(), KisSliderSpinBox::setPageStep(), KisSliderSpinBox::setRange(), KisSpinBoxI18nHelper::setText(), KisSliderSpinBox::setValue(), KisTransportControls::showSkipButtons(), KisUtilityTitleBar::SPACING_UNIT, strImportAudio, transport, volumeSlider, and KisUtilityTitleBar::widgetAreaLayout.

Member Data Documentation

autoKeyBlank

QAction* KisAnimTimelineDockerTitlebar::autoKeyBlank

Definition at line 74 of file KisAnimTimelineDocker.h.

autoKeyDuplicate

QAction* KisAnimTimelineDockerTitlebar::autoKeyDuplicate

Definition at line 75 of file KisAnimTimelineDocker.h.

btnAddKeyframe

QToolButton* KisAnimTimelineDockerTitlebar::btnAddKeyframe

Definition at line 52 of file KisAnimTimelineDocker.h.

btnAudioMenu

QToolButton* KisAnimTimelineDockerTitlebar::btnAudioMenu

Definition at line 57 of file KisAnimTimelineDocker.h.

btnAutoKey

QToolButton* KisAnimTimelineDockerTitlebar::btnAutoKey

Definition at line 73 of file KisAnimTimelineDocker.h.

btnDropFrames

QToolButton* KisAnimTimelineDockerTitlebar::btnDropFrames

Definition at line 71 of file KisAnimTimelineDocker.h.

btnDuplicateKeyframe

QToolButton* KisAnimTimelineDockerTitlebar::btnDuplicateKeyframe

Definition at line 53 of file KisAnimTimelineDocker.h.

btnOnionSkinsMenu

QToolButton* KisAnimTimelineDockerTitlebar::btnOnionSkinsMenu

Definition at line 56 of file KisAnimTimelineDocker.h.

btnRemoveKeyframe

QToolButton* KisAnimTimelineDockerTitlebar::btnRemoveKeyframe

Definition at line 54 of file KisAnimTimelineDocker.h.

btnSettingsMenu

QToolButton* KisAnimTimelineDockerTitlebar::btnSettingsMenu

Definition at line 58 of file KisAnimTimelineDocker.h.

frameRegister

KisIntParseSpinBox* KisAnimTimelineDockerTitlebar::frameRegister

Definition at line 50 of file KisAnimTimelineDocker.h.

importAudioAction

QAction* KisAnimTimelineDockerTitlebar::importAudioAction

Definition at line 61 of file KisAnimTimelineDocker.h.

MAX_FRAMES

const int KisAnimTimelineDockerTitlebar::MAX_FRAMES = 9999

private

Definition at line 78 of file KisAnimTimelineDocker.h.

muteAudioAction

QAction* KisAnimTimelineDockerTitlebar::muteAudioAction

Definition at line 63 of file KisAnimTimelineDocker.h.

removeAudioAction

QAction* KisAnimTimelineDockerTitlebar::removeAudioAction

Definition at line 62 of file KisAnimTimelineDocker.h.

sbEndFrame

KisIntParseSpinBox* KisAnimTimelineDockerTitlebar::sbEndFrame

Definition at line 67 of file KisAnimTimelineDocker.h.

sbFrameRate

KisIntParseSpinBox* KisAnimTimelineDockerTitlebar::sbFrameRate

Definition at line 68 of file KisAnimTimelineDocker.h.

sbSpeed

KisSliderSpinBox* KisAnimTimelineDockerTitlebar::sbSpeed

Definition at line 69 of file KisAnimTimelineDocker.h.

sbStartFrame

KisIntParseSpinBox* KisAnimTimelineDockerTitlebar::sbStartFrame

Definition at line 66 of file KisAnimTimelineDocker.h.

strImportAudio

QString KisAnimTimelineDockerTitlebar::strImportAudio

Definition at line 60 of file KisAnimTimelineDocker.h.

transport

KisTransportControls* KisAnimTimelineDockerTitlebar::transport

Definition at line 48 of file KisAnimTimelineDocker.h.

volumeSlider

KisSliderSpinBox* KisAnimTimelineDockerTitlebar::volumeSlider

Definition at line 64 of file KisAnimTimelineDocker.h.

---

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

• plugins/dockers/animation/KisAnimTimelineDocker.h
• plugins/dockers/animation/KisAnimTimelineDocker.cpp