doc/html/timelinedock_8h_source.html

/*

 * Copyright (c) 2013-2026 Meltytech, LLC

 *

 * 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 TIMELINEDOCK_H

#define TIMELINEDOCK_H


#include "jobs/ffmpegjob.h"

#include "models/markersmodel.h"

#include "models/multitrackmodel.h"

#include "models/subtitlesmodel.h"

#include "models/subtitlesselectionmodel.h"

#include "sharedframe.h"


#include <QApplication>

#include <QDateTime>

#include <QDockWidget>

#include <QQuickWidget>

#include <QTimer>


namespace Timeline {

class UpdateCommand;

class TrimCommand;

} // namespace Timeline

class UndoHelper;

class QMenu;


class TimelineDock : public QDockWidget

{

    Q_OBJECT

    Q_PROPERTY(int position READ position WRITE setPosition NOTIFY positionChanged)

    Q_PROPERTY(int currentTrack READ currentTrack WRITE setCurrentTrack NOTIFY currentTrackChanged)

    Q_PROPERTY(

        QVariantList selection READ selectionForJS WRITE setSelectionFromJS NOTIFY selectionChanged)

    Q_PROPERTY(bool isRecording READ isRecording NOTIFY isRecordingChanged)

    Q_PROPERTY(int loopStart READ loopStart NOTIFY loopChanged)

    Q_PROPERTY(int loopEnd READ loopEnd NOTIFY loopChanged)


public:

    explicit TimelineDock(QWidget *parent = 0);

    ~TimelineDock();


    enum TrimLocation { TrimInPoint, TrimOutPoint };


    MultitrackModel *model() { return &m_model; }

    MarkersModel *markersModel() { return &m_markersModel; }

    SubtitlesModel *subtitlesModel() { return &m_subtitlesModel; }

    SubtitlesSelectionModel *subtitlesSelectionModel() { return &m_subtitlesSelectionModel; }

    int position() const { return m_position; }

    void setPosition(int position);

    Mlt::Producer producerForClip(int trackIndex, int clipIndex);

    int clipIndexAtPlayhead(int trackIndex = -1);

    int clipIndexAtPosition(int trackIndex, int position);

    void chooseClipAtPosition(int position, int &trackIndex, int &clipIndex);

    void setCurrentTrack(int currentTrack);

    int currentTrack() const;

    int clipCount(int trackIndex) const;

    void setSelectionFromJS(const QVariantList &list);

    void setSelection(QList<QPoint> selection = QList<QPoint>(),

                      int trackIndex = -1,

                      bool isMultitrack = false);

    QVariantList selectionForJS() const;

    const QList<QPoint> selection() const;

    const QVector<QUuid> selectionUuids();

    const QList<QPoint> uuidsToSelection(QVector<QUuid> uuids) const;

    void saveAndClearSelection();

    Q_INVOKABLE void restoreSelection();

    Q_INVOKABLE QVariantList getGroupForClip(int trackIndex, int clipIndex);

    void selectClipUnderPlayhead();

    int centerOfClip(int trackIndex, int clipIndex);

    bool isTrackLocked(int trackIndex) const;

    void trimClipAtPlayhead(TrimLocation location, bool ripple);

    Q_INVOKABLE bool isMultitrackSelected() const { return m_selection.isMultitrackSelected; }

    Q_INVOKABLE int selectedTrack() const { return m_selection.selectedTrack; }

    Q_INVOKABLE bool isFloating() const { return QDockWidget::isFloating(); }

    Q_INVOKABLE static void openProperties();

    void emitSelectedChanged(const QVector<int> &roles);

    void replaceClipsWithHash(const QString &hash, Mlt::Producer &producer);

    Q_INVOKABLE void recordAudio();

    Q_INVOKABLE void stopRecording();

    bool isRecording() const { return m_isRecording; }

    int addTrackIfNeeded(TrackType trackType);

    void getSelectionRange(int *start, int *end);

    int loopStart() const { return m_loopStart; }

    int loopEnd() const { return m_loopEnd; }


signals:

    void currentTrackChanged();

    void selectionChanged();

    void seeked(int position);

    void positionChanged(int position);

    void loopChanged();

    void clipOpened(Mlt::Producer *producer);

    void dragging(const QPointF &pos, int duration);

    void dropped();

    void dropAccepted(const QString &xml);

    void gainChanged(double gain);

    void fadeInChanged(int duration);

    void fadeOutChanged(int duration);

    void selected(Mlt::Producer *producer);

    void clipClicked();

    void showStatusMessage(QString);

    void clipCopied();

    void clipMoved(int fromTrack, int toTrack, int clipIndex, int position, bool ripple);

    void filteredClicked();

    void durationChanged();

    void transitionAdded(int trackIndex, int clipIndex, int position, bool ripple);

    void zoomIn();

    void zoomOut();

    void zoomToFit();

    void setZoom(double value);

    void markerRangesChanged();

    void markerSeeked(int markerIndex);

    void isRecordingChanged(bool);

    void multitrackSelected();

    void warnTrackLocked(int trackIndex);

    void refreshWaveforms();

    void updateThumbnails(int trackIndex, int clipIndex);

    void trimStarted();

    void trimEnded();


public slots:

    int addAudioTrack();

    int addVideoTrack();

    void alignSelectedClips();

    void onShowFrame(const SharedFrame &frame);

    void onSeeked(int position);

    void append(int trackIndex);

    void remove(int trackIndex, int clipIndex, bool ignoreTransition = false);

    bool mergeClipWithNext(int trackIndex, int clipIndex, bool dryrun);

    void lift(int trackIndex, int clipIndex, bool ignoreTransition = false);

    void removeSelection(bool withCopy = false);

    void liftSelection();

    void incrementCurrentTrack(int by);

    void selectTrackHead(int trackIndex);

    void selectMultitrack();

    void copy(int trackIndex, int clipIndex);

    void setTrackName(int trackIndex, const QString &value);

    void toggleTrackMute(int trackIndex);

    void toggleOtherTracksMute(int trackIndex);

    void toggleTrackHidden(int trackIndex);

    void toggleOtherTracksHidden(int trackIndex);

    void setTrackComposite(int trackIndex, bool composite);

    void setTrackLock(int trackIndex, bool lock);

    bool moveClip(int fromTrack, int toTrack, int clipIndex, int position, bool ripple);

    void onClipMoved(int fromTrack, int toTrack, int clipIndex, int position, bool ripple);

    bool trimClipIn(

        int trackIndex, int clipIndex, int oldClipIndex, int delta, bool ripple, bool roll);

    bool trimClipOut(int trackIndex, int clipIndex, int delta, bool ripple, bool roll);

    bool resizeTransition(int trackIndex, int clipIndex, int delta);

    void insert(int trackIndex, int position = -1, const QString &xml = QString(), bool seek = true);

    void overwrite(int trackIndex,

                   int position = -1,

                   const QString &xml = QString(),

                   bool seek = true);

    void appendFromPlaylist(Mlt::Playlist *playlist, bool skipProxy, bool emptyTrack);

    bool changeGain(int trackIndex, int clipIndex, double gain);

    void fadeIn(int trackIndex, int clipIndex = -1, int duration = -1);

    void fadeOut(int trackIndex, int clipIndex = -1, int duration = -1);

    void seekPreviousEdit();

    void seekNextEdit();

    void seekInPoint(int clipIndex);

    void clearSelectionIfInvalid();

    void insertTrack();

    void insertAudioTrack();

    void insertVideoTrack();

    void removeTrack();

    void moveTrack(int fromTrackIndex, int toTrackIndex);

    void moveTrackUp();

    void moveTrackDown();

    void onProducerChanged(Mlt::Producer *);

    void emitSelectedFromSelection();

    void remakeAudioLevels(int trackIndex, int clipIndex, bool force = true);

    void commitTrimCommand();

    void onRowsInserted(const QModelIndex &parent, int first, int last);

    void onRowsRemoved(const QModelIndex &parent, int first, int last);

    void onRowsMoved(

        const QModelIndex &parent, int start, int end, const QModelIndex &destination, int row);

    void detachAudio(int trackIndex, int clipIndex);

    void selectAll();

    void selectAllOnCurrentTrack();

    void onProducerModified();

    void replace(int trackIndex, int clipIndex, const QString &xml = QString());

    void createOrEditMarker();

    void createOrEditSelectionMarker();

    void createMarker();

    void editMarker(int markerIndex);

    void deleteMarker(int markerIndex = -1);

    void seekNextMarker();

    void seekPrevMarker();

    void onFilterModelChanged();

    void trimClipIn(bool ripple = false);

    void trimClipOut(bool ripple = false);

    void initLoad();

    void handleDrop(int trackIndex, int position, QString xml);

    void onLoopChanged(int start, int end);


protected:

    void dragEnterEvent(QDragEnterEvent *event);

    void dragMoveEvent(QDragMoveEvent *event);

    void dragLeaveEvent(QDragLeaveEvent *event);

    void dropEvent(QDropEvent *event);

    bool event(QEvent *event);

    void keyPressEvent(QKeyEvent *event);

    void keyReleaseEvent(QKeyEvent *event);


private:

    bool isBlank(int trackIndex, int clipIndex);

    bool clipsAreSelected();

    bool blankIsSelected();

    bool nothingIsSelected();

    bool isTransition(int trackIndex, int clipIndex);

    bool isEmptyTrack(Mlt::Playlist &playlist);

    void emitNonSeekableWarning();

    void emitClipExtendStatus(int cappedOut, int requestedOut, int currentOut);

    int limitClipOut(Mlt::Playlist &playlist, int clipIndex, int in, int frameCount, int out);

    void addTrackIfNeeded(int mltTrackIndex, Mlt::Producer *srcTrack);

    void setupActions();

    bool isMultitrackValid() { return m_model.tractor() && !m_model.trackList().empty(); }

    void reportSelectionChange();

    void applyCopiedFiltersToSelectdClips();

    void insertOrOverwriteDrop(int trackIndex, int position, const QString &xml);

    void freezeFrame();

    void addGenerator(QWidget *widget);


    QQuickWidget m_quickView;

    MultitrackModel m_model;

    MarkersModel m_markersModel;

    SubtitlesModel m_subtitlesModel;

    SubtitlesSelectionModel m_subtitlesSelectionModel;

    int m_position{-1};

    std::unique_ptr<Timeline::UpdateCommand> m_updateCommand;

    bool m_ignoreNextPositionChange{false};

    struct Selection

    {

        QList<QPoint> selectedClips; // x is the clip index, y is the track index

        int selectedTrack;

        bool isMultitrackSelected;

    };

    Selection m_selection;

    int m_savedSelectedTrack{-1};

    bool m_savedIsMultitrackSelected{false};

    QVector<QUuid> m_savedSelectionUuids;

    QTimer m_selectionSignalTimer;

    std::unique_ptr<Timeline::TrimCommand> m_trimCommand;

    std::unique_ptr<UndoHelper> m_undoHelper;

    int m_trimDelta{0};

    int m_transitionDelta{0};

    bool m_isRecording{false};

    std::unique_ptr<AbstractJob> m_recordJob;

    QTimer m_recordingTimer;

    QDateTime m_recordingTime;

    int m_recordingTrackIndex{-1};

    int m_recordingClipIndex{-1};

    int m_currentTrack{0};

    QMenu *m_mainMenu{nullptr};

    QMenu *m_clipMenu{nullptr};

    int m_loopStart{-1};

    int m_loopEnd{-1};


private slots:

    void load(bool force);

    void onTopLevelChanged(bool floating);

    void onTransitionAdded(int trackIndex, int clipIndex, int position, bool ripple);

    void selectClip(int trackIndex, int clipIndex);

    void onMultitrackClosed();

    void reloadTimelineModels();

    void onRecordStarted();

    void updateRecording();

    void onRecordFinished(AbstractJob *, bool);

    void onWarnTrackLocked();

    void onTimelineRightClicked();

    void onClipRightClicked();

    void onNoMoreEmptyTracks(bool isAudio);

    void addGenerator();

};


#endif // TIMELINEDOCK_H