timelinefunctions.hpp 7.55 KB
Newer Older
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
/*
Copyright (C) 2017  Jean-Baptiste Mardelle <jb@kdenlive.org>
This file is part of Kdenlive. See www.kdenlive.org.

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 2 of
the License or (at your option) version 3 or any later version
accepted by the membership of KDE e.V. (or its successor approved
by the membership of KDE e.V.), which shall act as a proxy
defined in Section 14 of version 3 of the license.

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 TIMELINEFUNCTIONS_H
#define TIMELINEFUNCTIONS_H

Nicolas Carion's avatar
Nicolas Carion committed
25
26
#include "definitions.h"
#include "undohelper.hpp"
27
28
#include <memory>
#include <unordered_set>
29

30
31
#include <QDir>

32
33
34
35
36
37
/**
 * @namespace TimelineFunction
 * @brief This namespace contains a list of static methods for advanced timeline editing features
 *  based on timelinemodel methods
 */

Nicolas Carion's avatar
Nicolas Carion committed
38
class TimelineItemModel;
Nicolas Carion's avatar
Nicolas Carion committed
39
40
struct TimelineFunctions
{
Nicolas Carion's avatar
Nicolas Carion committed
41
42
43
44
45
    /* @brief Cuts a clip at given position
       If the clip is part of the group, all clips of the groups are cut at the same position. The group structure is then preserved for clips on both sides
       Returns true on success
       @param timeline : ptr to the timeline model
       @param clipId: Id of the clip to split
46
       @param position: position (in frames from the beginning of the timeline) where to cut
Nicolas Carion's avatar
Nicolas Carion committed
47
48
    */
    static bool requestClipCut(std::shared_ptr<TimelineItemModel> timeline, int clipId, int position);
49
    /* This is the same function, except that it accumulates undo/redo */
Nicolas Carion's avatar
Nicolas Carion committed
50
    static bool requestClipCut(const std::shared_ptr<TimelineItemModel> &timeline, int clipId, int position, Fun &undo, Fun &redo);
51
    /* This is the same function, except that it accumulates undo/redo and do not deal with groups. Do not call directly */
Nicolas Carion's avatar
Nicolas Carion committed
52
    static bool processClipCut(const std::shared_ptr<TimelineItemModel> &timeline, int clipId, int position, int &newId, Fun &undo, Fun &redo);
Nicolas Carion's avatar
Nicolas Carion committed
53

54
55
56
57
    /* @brief Makes a perfect clone of a given clip, but do not insert it */
    static bool cloneClip(const std::shared_ptr<TimelineItemModel> &timeline, int clipId, int &newId, PlaylistState::ClipState state, Fun &undo, Fun &redo);

    /* @brief Creates a string representation of the given clips, that can then be pasted using pasteClips(). Return an empty string on failure */
Nicolas Carion's avatar
Nicolas Carion committed
58
    static QString copyClips(const std::shared_ptr<TimelineItemModel> &timeline, const std::unordered_set<int> &itemIds);
59
60
    /* @brief Paste the clips as described by the string. Returns true on success*/
    static bool pasteClips(const std::shared_ptr<TimelineItemModel> &timeline, const QString &pasteString, int trackId, int position);
Nicolas Carion's avatar
Nicolas Carion committed
61

62
63
64
65
66
67
68
    /* @brief Request the addition of multiple clips to the timeline
     * If the addition of any of the clips fails, the entire operation is undone.
     * @returns true on success, false otherwise.
     * @param binIds the list of bin ids to be inserted
     * @param trackId the track where the insertion should happen
     * @param position the position at which the clips should be inserted
     * @param clipIds a return parameter with the ids assigned to the clips if success, empty otherwise
Nicolas Carion's avatar
Nicolas Carion committed
69
     */
Nicolas Carion's avatar
Nicolas Carion committed
70
    static bool requestMultipleClipsInsertion(const std::shared_ptr<TimelineItemModel> &timeline, const QStringList &binIds, int trackId, int position,
Nicolas Carion's avatar
Nicolas Carion committed
71
                                              QList<int> &clipIds, bool logUndo, bool refreshView);
72

73
74
75
76
77
78
79
80
81
    /** @brief This function will find the blank located in the given track at the given position and remove it
        @returns true on success, false otherwise
        @param trackId id of the track to search in
        @param position of the blank
        @param affectAllTracks if true, the same blank will be removed from all tracks. Note that all the tracks must have a blank at least that big in that
       position
    */
    static bool requestDeleteBlankAt(const std::shared_ptr<TimelineItemModel> &timeline, int trackId, int position, bool affectAllTracks);

Nicolas Carion's avatar
Nicolas Carion committed
82
83
84
85
86
    static int requestSpacerStartOperation(const std::shared_ptr<TimelineItemModel> &timeline, int trackId, int position);
    static bool requestSpacerEndOperation(const std::shared_ptr<TimelineItemModel> &timeline, int itemId, int startPosition, int endPosition);
    static bool extractZone(const std::shared_ptr<TimelineItemModel> &timeline, QVector<int> tracks, QPoint zone, bool liftOnly);
    static bool liftZone(const std::shared_ptr<TimelineItemModel> &timeline, int trackId, QPoint zone, Fun &undo, Fun &redo);
    static bool removeSpace(const std::shared_ptr<TimelineItemModel> &timeline, int trackId, QPoint zone, Fun &undo, Fun &redo);
87
88
89
90

    /** @brief This function will insert a blank space starting at zone.x, and ending at zone.y. This will affect all the tracks
        @returns true on success, false otherwise
    */
91
    static bool requestInsertSpace(const std::shared_ptr<TimelineItemModel> &timeline, QPoint zone, Fun &undo, Fun &redo, bool followTargets = true);
Nicolas Carion's avatar
Nicolas Carion committed
92
    static bool insertZone(const std::shared_ptr<TimelineItemModel> &timeline, QList<int> trackIds, const QString &binId, int insertFrame, QPoint zone,
93
                           bool overwrite);
94

Nicolas Carion's avatar
Nicolas Carion committed
95
96
97
    static bool requestItemCopy(const std::shared_ptr<TimelineItemModel> &timeline, int clipId, int trackId, int position);
    static void showClipKeyframes(const std::shared_ptr<TimelineItemModel> &timeline, int clipId, bool value);
    static void showCompositionKeyframes(const std::shared_ptr<TimelineItemModel> &timeline, int compoId, bool value);
98

99
    /* @brief If the clip is activated, disable, otherwise enable
100
101
102
103
104
     * @param timeline: pointer to the timeline that we modify
     * @param clipId: Id of the clip to modify
     * @param status: target status of the clip
     This function creates an undo object and returns true on success
     */
Nicolas Carion's avatar
Nicolas Carion committed
105
    static bool switchEnableState(const std::shared_ptr<TimelineItemModel> &timeline, int clipId);
106
    /* @brief change the clip state and accumulates for undo/redo
107
     */
Nicolas Carion's avatar
Nicolas Carion committed
108
    static bool changeClipState(const std::shared_ptr<TimelineItemModel> &timeline, int clipId, PlaylistState::ClipState status, Fun &undo, Fun &redo);
109

Nicolas Carion's avatar
Nicolas Carion committed
110
111
112
113
    static bool requestSplitAudio(const std::shared_ptr<TimelineItemModel> &timeline, int clipId, int audioTarget);
    static bool requestSplitVideo(const std::shared_ptr<TimelineItemModel> &timeline, int clipId, int videoTarget);
    static void setCompositionATrack(const std::shared_ptr<TimelineItemModel> &timeline, int cid, int aTrack);
    static void enableMultitrackView(const std::shared_ptr<TimelineItemModel> &timeline, bool enable);
114
    static void saveTimelineSelection(const std::shared_ptr<TimelineItemModel> &timeline, const std::unordered_set<int> &selection, const QDir &targetDir);
115
116
    /** @brief returns the number of same type tracks between 2 tracks
     */
Nicolas Carion's avatar
Nicolas Carion committed
117
    static int getTrackOffset(const std::shared_ptr<TimelineItemModel> &timeline, int startTrack, int destTrack);
118
119
    /** @brief returns an offset track id
     */
Nicolas Carion's avatar
Nicolas Carion committed
120
    static int getOffsetTrackId(const std::shared_ptr<TimelineItemModel> &timeline, int startTrack, int offset, bool audioOffset);
121
122
    /** @brief returns a list of ids for all audio tracks and all video tracks
     */
Nicolas Carion's avatar
Nicolas Carion committed
123
    static QPair<QList<int>, QList<int>> getAVTracksIds(const std::shared_ptr<TimelineItemModel> &timeline);
Nicolas Carion's avatar
Nicolas Carion committed
124
};
125
126

#endif