#ifndef CUSTOMTRACKVIEW_H
#define CUSTOMTRACKVIEW_H
-#include <KPixmapCache>
+#include <kdeversion.h>
+#include <KColorScheme>
#include <QGraphicsView>
#include <QGraphicsItemAnimation>
#include <QTimeLine>
#include <QMenu>
#include <QUndoStack>
+#include <QMutex>
+#include <QWaitCondition>
#include "kdenlivedoc.h"
#include "docclipbase.h"
class AbstractClipItem;
class AbstractGroupItem;
class Transition;
+class AudioCorrelation;
class CustomTrackView : public QGraphicsView
{
void configTracks(QList <TrackInfo> trackInfos);
int cursorPos();
void checkAutoScroll();
- void moveClip(const ItemInfo start, const ItemInfo end, bool refresh);
- void moveGroup(QList <ItemInfo> startClip, QList <ItemInfo> startTransition, const GenTime offset, const int trackOffset, bool reverseMove = false);
+ /**
+ Move the clip at \c start to \c end.
+
+ If \c out_actualEnd is not NULL, it will be set to the position the clip really ended up at.
+ For example, attempting to move a clip to t = -1 s will actually move it to t = 0 s.
+ */
+ bool moveClip(const ItemInfo &start, const ItemInfo &end, bool refresh, ItemInfo *out_actualEnd = NULL);
+ void moveGroup(QList <ItemInfo> startClip, QList <ItemInfo> startTransition, const GenTime &offset, const int trackOffset, bool reverseMove = false);
/** move transition, startPos = (old start, old end), endPos = (new start, new end) */
- void moveTransition(const ItemInfo start, const ItemInfo end, bool m_refresh);
- void resizeClip(const ItemInfo start, const ItemInfo end, bool dontWorry = false);
+ void moveTransition(const ItemInfo &start, const ItemInfo &end, bool refresh);
+ void resizeClip(const ItemInfo &start, const ItemInfo &end, bool dontWorry = false);
void addClip(QDomElement xml, const QString &clipId, ItemInfo info, EffectsList list = EffectsList(), bool overwrite = false, bool push = false, bool refresh = true);
void deleteClip(ItemInfo info, bool refresh = true);
void slotDeleteClipMarker(const QString &comment, const QString &id, const GenTime &position);
void slotDeleteAllClipMarkers(const QString &id);
- void addMarker(const QString &id, const GenTime &pos, const QString comment);
+ void addMarker(const QString &id, const CommentedTime marker);
+ void addData(const QString &id, const QString &key, const QString &data);
void setScale(double scaleFactor, double verticalScale);
void deleteClip(const QString &clipId);
+ /** @brief Add effect to current clip */
void slotAddEffect(QDomElement effect, GenTime pos, int track);
- void slotAddGroupEffect(QDomElement effect, AbstractGroupItem *group);
+ void slotAddGroupEffect(QDomElement effect, AbstractGroupItem *group, AbstractClipItem *dropTarget = NULL);
void addEffect(int track, GenTime pos, QDomElement effect);
void deleteEffect(int track, GenTime pos, QDomElement effect);
- void updateEffect(int track, GenTime pos, QDomElement insertedEffect, int ix, bool triggeredByUser = true);
- void moveEffect(int track, GenTime pos, int oldPos, int newPos);
+ void updateEffect(int track, GenTime pos, QDomElement insertedEffect, bool refreshEffectStack = false);
+ /** @brief Enable / disable a list of effects */
+ void updateEffectState(int track, GenTime pos, QList <int> effectIndexes, bool disable, bool updateEffectStack);
+ void moveEffect(int track, GenTime pos, QList <int> oldPos, QList <int> newPos);
void addTransition(ItemInfo transitionInfo, int endTrack, QDomElement params, bool refresh);
void deleteTransition(ItemInfo transitionInfo, int endTrack, QDomElement params, bool refresh);
void updateTransition(int track, GenTime pos, QDomElement oldTransition, QDomElement transition, bool updateTransitionWidget);
void activateMonitor();
int duration() const;
void deleteSelectedClips();
+ /** @brief Cuts all clips that are selected at the timeline cursor position. */
void cutSelectedClips();
void setContextMenu(QMenu *timeline, QMenu *clip, QMenu *transition, QActionGroup *clipTypeGroup, QMenu *markermenu);
- void checkTrackHeight();
+ bool checkTrackHeight();
+ void updateSceneFrameWidth();
//QList <TrackInfo> tracksList() const;
void setTool(PROJECTTOOL tool);
ClipItem *cutClip(ItemInfo info, GenTime cutTime, bool cut, bool execute = true);
void slotSeekToPreviousSnap();
void slotSeekToNextSnap();
double getSnapPointForPos(double pos);
- void editKeyFrame(const GenTime pos, const int track, const int index, const QString keyframes);
+ void editKeyFrame(const GenTime &pos, const int track, const int index, const QString &keyframes);
bool findString(const QString &text);
void selectFound(QString track, QString pos);
bool findNextString(const QString &text);
QList<ItemInfo> findId(const QString &clipId);
void clipStart();
void clipEnd();
- void changeClipSpeed();
void doChangeClipSpeed(ItemInfo info, ItemInfo speedIndependantInfo, const double speed, const double oldspeed, int strobe, const QString &id);
/** @brief Sets the document as modified. */
void setDocumentModified();
void setInPoint();
void setOutPoint();
+
/** @brief Prepares inserting space.
*
* Shows a dialog to configure length and track. */
void slotInsertSpace();
/** @brief Prepares removing space. */
void slotRemoveSpace();
- void insertSpace(QList<ItemInfo> clipsToMove, QList<ItemInfo> transToMove, int track, const GenTime duration, const GenTime offset);
+ void insertSpace(QList<ItemInfo> clipsToMove, QList<ItemInfo> transToMove, int track, const GenTime &duration, const GenTime &offset);
ClipItem *getActiveClipUnderCursor(bool allowOutsideCursor = false) const;
void deleteTimelineTrack(int ix, TrackInfo trackinfo);
void saveThumbnails();
void autoTransition();
- QStringList getLadspaParams(QDomElement effect) const;
void initCursorPos(int pos);
+
/** @brief Locks or unlocks a track.
* @param ix number of track
* @param lock whether to lock or unlock
+ * @param requestUpdate (default = true) Whether to request an update of the icon in the track header
*
* Makes sure no clip on track to lock is selected. */
- void lockTrack(int ix, bool lock);
+ void lockTrack(int ix, bool lock, bool requestUpdate = true);
void groupClips(bool group = true);
void doGroupClips(QList <ItemInfo> clipInfos, QList <ItemInfo> transitionInfos, bool group);
- void loadGroups(const QDomNodeList groups);
+ void loadGroups(const QDomNodeList &groups);
+
+ /** @brief Creates SplitAudioCommands for selected clips. */
void splitAudio();
- void doSplitAudio(const GenTime &pos, int track, bool split);
+
+ /// Define which clip to take as reference for automatic audio alignment
+ void setAudioAlignReference();
+
+ /// Automatically align the currently selected clips to synchronize their audio with the reference's audio
+ void alignAudio();
+
+ /** @brief Seperates the audio of a clip to a audio track.
+ * @param pos Position of the clip to split
+ * @param track Track of the clip
+ * @param split Split or unsplit */
+ void doSplitAudio(const GenTime &pos, int track, EffectsList effects, bool split);
void setVideoOnly();
void setAudioOnly();
void setAudioAndVideo();
int selectedTrack() const;
QStringList selectedClips() const;
QList<ClipItem *> selectedClipItems() const;
- void selectClip(bool add, bool group = false);
+ /** @brief Checks wheter an item can be inserted (make sure it does not overlap another item) */
+ bool canBePastedTo(ItemInfo info, int type) const;
+
+ /** @brief Selects a clip.
+ * @param add Whether to select or deselect
+ * @param group (optional) Whether to add the clip to a group
+ * @param track (optional) The track of the clip (has to be combined with @param pos)
+ * @param pos (optional) The position of the clip (has to be combined with @param track) */
+ void selectClip(bool add, bool group = false, int track = -1, int pos = -1);
void selectTransition(bool add, bool group = false);
QStringList extractTransitionsLumas();
void setEditMode(EDITMODE mode);
+
+ /** @brief Inserts @param clip.
+ * @param clip The clip to insert
+ * @param in The inpoint of the clip (crop from start)
+ * @param out The outpoint of the clip (crop from end)
+ *
+ * Inserts at the position of timeline cursor and selected track. */
void insertClipCut(DocClipBase *clip, int in, int out);
- void clearSelection();
+ void clearSelection(bool emitInfo = true);
void editItemDuration();
void buildGuidesMenu(QMenu *goMenu) const;
- KPixmapCache* pixmapCache;
+ /** update the timeline objects when palette changes */
+ void updatePalette();
+ /** @brief Returns true if a track has audio data on it.
+ * @param track The track number
+ *
+ * Check whether given track has a clip with audio in it. */
+ bool hasAudio(int track) const;
+ int getFrameWidth();
+ /** @brief Returns last requested seeking pos (or SEEK_INACTIVE if no seek). */
+ int seekPosition() const;
+
public slots:
- void setCursorPos(int pos, bool seek = true);
+ /** @brief Send seek request to MLT. */
+ void seekCursorPos(int pos);
+ /** @brief Move timeline cursor to new position. */
+ void setCursorPos(int pos);
void moveCursorPos(int delta);
void updateCursorPos();
- void slotDeleteEffect(ClipItem *clip, QDomElement effect, bool affectGroup = true);
- void slotChangeEffectState(ClipItem *clip, int effectPos, bool disable);
- void slotChangeEffectPosition(ClipItem *clip, int currentPos, int newPos);
- void slotUpdateClipEffect(ClipItem *clip, QDomElement oldeffect, QDomElement effect, int ix);
+ void slotDeleteEffect(ClipItem *clip, int track, QDomElement effect, bool affectGroup = true);
+ void slotChangeEffectState(ClipItem *clip, int track, QList <int> effectIndexes, bool disable);
+ void slotChangeEffectPosition(ClipItem *clip, int track, QList <int> currentPos, int newPos);
+ void slotUpdateClipEffect(ClipItem *clip, int track, QDomElement oldeffect, QDomElement effect, int ix, bool refreshEffectStack = true);
+ void slotUpdateClipRegion(ClipItem *clip, int ix, QString region);
void slotRefreshEffects(ClipItem *clip);
void setDuration(int duration);
void slotAddTransition(ClipItem* clip, ItemInfo transitionInfo, int endTrack, QDomElement transition = QDomElement());
void slotSwitchTrackVideo(int ix);
void slotSwitchTrackLock(int ix);
void slotUpdateClip(const QString &clipId, bool reload = true);
- void slotAddClipMarker(const QString &id, GenTime t, QString c);
- bool addGuide(const GenTime pos, const QString &comment);
- void slotAddGuide();
+
+ /** @brief Add extra data to a clip. */
+ void slotAddClipExtraData(const QString &id, const QString &key, const QString &data = QString(), QUndoCommand *groupCommand = 0);
+ /** @brief Creates a AddClipCommand to add, edit or delete a marker.
+ * @param id Id of the marker's clip
+ * @param t Position of the marker
+ * @param c Comment of the marker */
+ void slotAddClipMarker(const QString &id, QList <CommentedTime> newMarker, QUndoCommand *groupCommand = 0);
+ void slotLoadClipMarkers(const QString &id);
+ void slotSaveClipMarkers(const QString &id);
+ bool addGuide(const GenTime &pos, const QString &comment);
+
+ /** @brief Shows a dialog for adding a guide.
+ * @param dialog (default = true) false = do not show the dialog but use current position as position and comment */
+ void slotAddGuide(bool dialog = true);
void slotEditGuide(CommentedTime guide);
void slotEditGuide(int guidePos = -1);
void slotDeleteGuide(int guidePos = -1);
void slotDeleteAllGuides();
- void editGuide(const GenTime oldPos, const GenTime pos, const QString &comment);
+ void editGuide(const GenTime &oldPos, const GenTime &pos, const QString &comment);
void copyClip();
void pasteClip();
void pasteClipEffects();
void slotUpdateAllThumbs();
void slotCheckPositionScrolling();
void slotInsertTrack(int ix);
+
+ /** @brief Shows a dialog for selecting a track to delete.
+ * @param ix Number of the track, which should be pre-selected in the dialog */
void slotDeleteTrack(int ix);
/** @brief Shows the configure tracks dialog. */
void slotConfigTracks(int ix);
- void clipNameChanged(const QString id, const QString name);
+ void clipNameChanged(const QString &id, const QString &name);
void slotTrackUp();
void slotTrackDown();
void slotSelectTrack(int ix);
void insertZoneOverwrite(QStringList data, int in);
+ /** @brief Rebuilds a group to fit again after children changed.
+ * @param childTrack the track of one of the groups children
+ * @param childPos The position of the same child */
+ void rebuildGroup(int childTrack, GenTime childPos);
+ /** @brief Rebuilds a group to fit again after children changed.
+ * @param group The group to rebuild */
+ void rebuildGroup(AbstractGroupItem *group);
+
+ /** @brief Cuts a group into two parts.
+ * @param clips1 Clips before the cut
+ * @param transitions1 Transitions before the cut
+ * @param clipsCut Clips that need to be cut
+ * @param transitionsCut Transitions that need to be cut
+ * @param clips2 Clips behind the cut
+ * @param transitions2 Transitions behind the cut
+ * @param cutPos Absolute position of the cut
+ * @param cut true = cut, false = "uncut" */
+ void slotRazorGroup(QList <ItemInfo> clips1, QList <ItemInfo> transitions1, QList <ItemInfo> clipsCut, QList <ItemInfo> transitionsCut, QList <ItemInfo> clips2, QList <ItemInfo> transitions2, GenTime cutPos, bool cut);
+
+ /** @brief Add en effect to a track.
+ * @param effect The new effect xml
+ * @param ix The track index */
+ void slotAddTrackEffect(const QDomElement &effect, int ix);
+ /** @brief Select all clips in selected track. */
+ void slotSelectClipsInTrack();
+ /** @brief Select all clips in timeline. */
+ void slotSelectAllClips();
+
+ /** @brief Update the list of snap points (sticky timeline hotspots).
+ * @param selected The currently selected clip if any
+ * @param offsetList The list of points that should also snap (for example when movin a clip, start and end points should snap
+ * @param skipSelectedItems if true, the selected item start and end points will not be added to snap list */
+ void updateSnapPoints(AbstractClipItem *selected, QList <GenTime> offsetList = QList <GenTime> (), bool skipSelectedItems = false);
+
+ void slotAddEffect(ClipItem *clip, QDomElement effect);
+ void slotImportClipKeyframes(GRAPHICSRECTITEM type);
+
+ /** @brief Get effect parameters ready for MLT*/
+ static void adjustEffectParameters(EffectsParameterList ¶meters, QDomNodeList params, MltVideoProfile profile, const QString &prefix = QString());
+ /** @brief Move playhead to mouse curser position if defined key is pressed */
+ void slotAlignPlayheadToMousePos();
+
protected:
virtual void drawBackground(QPainter * painter, const QRectF & rect);
//virtual void drawForeground ( QPainter * painter, const QRectF & rect );
virtual void dragEnterEvent(QDragEnterEvent * event);
virtual void dragMoveEvent(QDragMoveEvent * event);
virtual void dragLeaveEvent(QDragLeaveEvent * event);
+ /** @brief Something has been dropped onto the timeline */
virtual void dropEvent(QDropEvent * event);
virtual void wheelEvent(QWheelEvent * e);
virtual void keyPressEvent(QKeyEvent * event);
virtual Qt::DropActions supportedDropActions() const;
private:
+ int m_ct;
int m_tracksHeight;
int m_projectDuration;
int m_cursorPos;
QPoint m_clickEvent;
QList <CommentedTime> m_searchPoints;
QList <Guide *> m_guides;
- void updateSnapPoints(AbstractClipItem *selected, QList <GenTime> offsetList = QList <GenTime> (), bool skipSelectedItems = false);
+
ClipItem *getClipItemAt(int pos, int track);
ClipItem *getClipItemAt(GenTime pos, int track);
ClipItem *getClipItemAtEnd(GenTime pos, int track);
ClipItem *getClipItemAtStart(GenTime pos, int track);
+ Transition *getTransitionItem(TransitionInfo info);
Transition *getTransitionItemAt(int pos, int track);
Transition *getTransitionItemAt(GenTime pos, int track);
Transition *getTransitionItemAtEnd(GenTime pos, int track);
int m_selectedTrack;
int m_spacerOffset;
+ QMutex m_mutex;
+ QWaitCondition m_producerNotReady;
+ KStatefulBrush m_activeTrackBrush;
+
+ AudioCorrelation *m_audioCorrelator;
+ ClipItem *m_audioAlignmentReference;
+
+ /** stores the state of the control modifier during mouse press.
+ * Will then be used to identify whether we resize a group or only one item of it. */
+ bool m_controlModifier;
+
/** Get the index of the video track that is just below current track */
int getPreviousVideoTrack(int track);
- void updatePositionEffects(ClipItem * item, ItemInfo info);
- bool insertDropClips(const QMimeData *data, const QPoint pos);
- bool canBePastedTo(ItemInfo info, int type) const;
+ void updatePositionEffects(ClipItem * item, ItemInfo info, bool standalone = true);
+ bool insertDropClips(const QMimeData *data, const QPoint &pos);
bool canBePastedTo(QList <ItemInfo> infoList, int type) const;
bool canBePasted(QList<AbstractClipItem *> items, GenTime offset, int trackOffset) const;
bool canBeMoved(QList<AbstractClipItem *> items, GenTime offset, int trackOffset) const;
/** Adjust keyframes when pasted to another clip */
void adjustKeyfames(GenTime oldstart, GenTime newstart, GenTime duration, QDomElement xml);
+ /** @brief Removes the tip and stops the animation timer. */
+ void removeTipAnimation();
+ /** @brief Creates a new tip animation.
+ * @param clip clip to display the tip on
+ * @param mode operation mode for which the tip should be displayed
+ * @param size size of the tip */
+ void setTipAnimation(AbstractClipItem *clip, OPERATIONTYPE mode, const double size);
+
+ /** @brief Takes care of updating effects and attached transitions during a resize from start.
+ * @param item Item to resize
+ * @param oldInfo The item's info before resizement (set to item->info() is @param check true)
+ * @param pos New startPos
+ * @param check (optional, default = false) Whether to check for collisions
+ * @param command (optional) Will be used as parent command (for undo history) */
+ void prepareResizeClipStart(AbstractClipItem *item, ItemInfo oldInfo, int pos, bool check = false, QUndoCommand *command = NULL);
+
+ /** @brief Takes care of updating effects and attached transitions during a resize from end.
+ * @param item Item to resize
+ * @param oldInfo The item's info before resizement (set to item->info() is @param check true)
+ * @param pos New endPos
+ * @param check (optional, default = false) Whether to check for collisions
+ * @param command (optional) Will be used as parent command (for undo history) */
+ void prepareResizeClipEnd(AbstractClipItem *item, ItemInfo oldInfo, int pos, bool check = false, QUndoCommand *command = NULL);
+
+ /** @brief Collects information about the group's children to pass it on to RazorGroupCommand.
+ * @param group The group to cut
+ * @param cutPos The absolute position of the cut */
+ void razorGroup(AbstractGroupItem *group, GenTime cutPos);
+
+ /** @brief Gets the effect parameters that will be passed to Mlt. */
+ EffectsParameterList getEffectArgs(const QDomElement &effect);
+
+ /** @brief Update Tracknames to fit again after track was added/deleted.
+ * @param track Number of track which was added/deleted
+ * @param added true = track added, false = track deleted
+ *
+ * The default track name consists of type + number. If we add/delete a track the number has to be adjusted
+ * if the name is still the default one. */
+ void updateTrackNames(int track, bool added);
+
+ /** @brief Updates the duration stored in a track's TrackInfo.
+ * @param track Number of track as used in ItemInfo (not the numbering used in KdenliveDoc) (negative for all tracks)
+ * @param command If effects need to be updated the commands to do this will be attached to this undo command
+ *
+ * In addition to update the duration in TrackInfo it updates effects with keyframes on the track. */
+ void updateTrackDuration(int track, QUndoCommand *command);
+
+ /** @brief Adjusts effects after a clip resize.
+ * @param item The item that was resized
+ * @param oldInfo pre resize info
+ * @param fromStart false = resize from end
+ * @param command Used as a parent for EditEffectCommand */
+ void adjustEffects(ClipItem *item, ItemInfo oldInfo, QUndoCommand *command);
+
+ /** @brief Prepare an add clip command for an effect */
+ void processEffect(ClipItem *item, QDomElement effect, int offset, QUndoCommand *effectCommand);
+
private slots:
void slotRefreshGuides();
void slotEnableRefresh();
void slotGoToMarker(QAction *action);
void slotResetMenuPosition();
void slotDoResetMenuPosition();
+ /** @brief Re-create the clip thumbnails.
+ * @param id The clip's Id string.
+ * @param resetThumbs Should we recreate the timeline thumbnails. */
+ void slotRefreshThumbs(const QString &id, bool resetThumbs);
+ /** @brief A Filter job producer results. */
+ void slotGotFilterJobResults(const QString &id, int startPos, int track, stringMap filterParams, stringMap extra);
+
signals:
void cursorMoved(int, int);
void zoomIn();
void zoomOut();
void mousePosition(int);
- void clipItemSelected(ClipItem*, int ix = -1);
+ /** @brief A clip was selected in timeline, update the effect stack
+ * @param clip The clip
+ * @param raise If true, the effect stack widget will be raised (come to front). */
+ void clipItemSelected(ClipItem *clip, bool raise = true);
void transitionItemSelected(Transition*, int track = 0, QPoint p = QPoint(), bool update = false);
void activateDocumentMonitor();
void trackHeightChanged();
void tracksChanged();
- void displayMessage(const QString, MessageType);
- void showClipFrame(DocClipBase *, QPoint, const int);
+ void displayMessage(const QString &, MessageType);
+ void showClipFrame(DocClipBase *, QPoint, bool, const int);
void doTrackLock(int, bool);
void updateClipMarkers(DocClipBase *);
+ void updateClipExtraData(DocClipBase *);
void updateTrackHeaders();
void playMonitor();
+ /** @brief Monitor document changes (for example the presence of audio data in timeline for export widget.*/
+ void documentModified();
+ void forceClipProcessing(const QString &);
+ void showTrackEffects(int, TrackInfo);
+ /** @brief Update the track effect button that shows if a track has effects or not.*/
+ void updateTrackEffectState(int);
+ /** @brief Cursor position changed, repaint ruler.*/
+ void updateRuler();
+ /** @brief Send data from a clip to be imported as keyframes for effect / transition.*/
+ void importKeyframes(GRAPHICSRECTITEM type, const QString&);
};
#endif