X-Git-Url: https://git.sesse.net/?a=blobdiff_plain;f=src%2Fcustomtrackview.h;h=dea6e8dff27962e817a146836f779b59bb6a2124;hb=f68bd080a6d251d0d9ffaf03450d5142dfe5515d;hp=aaa0a9fb3d87a4856a33dd9cf34cb7cfe34ed52b;hpb=554f7c8ccac5fe18f2f88394260b3a268a24bd81;p=kdenlive diff --git a/src/customtrackview.h b/src/customtrackview.h index aaa0a9fb..dea6e8df 100644 --- a/src/customtrackview.h +++ b/src/customtrackview.h @@ -21,11 +21,16 @@ #ifndef CUSTOMTRACKVIEW_H #define CUSTOMTRACKVIEW_H +#include +#include + #include #include #include #include #include +#include +#include #include "kdenlivedoc.h" #include "docclipbase.h" @@ -51,19 +56,20 @@ public: virtual void mouseDoubleClickEvent(QMouseEvent *event); void addTrack(TrackInfo type, int ix = -1); void removeTrack(int ix); - void changeTrack(int ix, TrackInfo type); + /** @brief Makes the document use new track infos (name, type, ...). */ + void configTracks(QList trackInfos); int cursorPos(); void checkAutoScroll(); - void moveClip(const ItemInfo start, const ItemInfo end, bool refresh); - void moveGroup(QList startClip, QList startTransition, const GenTime offset, const int trackOffset, bool reverseMove = false); + void moveClip(const ItemInfo &start, const ItemInfo &end, bool refresh); + void moveGroup(QList startClip, QList 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 GenTime &pos, const QString &comment); void setScale(double scaleFactor, double verticalScale); void deleteClip(const QString &clipId); void slotAddEffect(QDomElement effect, GenTime pos, int track); @@ -79,43 +85,64 @@ public: 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); - void checkTrackHeight(); + void setContextMenu(QMenu *timeline, QMenu *clip, QMenu *transition, QActionGroup *clipTypeGroup, QMenu *markermenu); + bool checkTrackHeight(); + void updateSceneFrameWidth(); //QList 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); void initSearchStrings(); void clearSearchStrings(); + QList 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 clipsToMove, QList transToMove, int track, const GenTime duration, const GenTime offset); + void insertSpace(QList clipsToMove, QList transToMove, int track, const GenTime &duration, const GenTime &offset); ClipItem *getActiveClipUnderCursor(bool allowOutsideCursor = false) const; void deleteTimelineTrack(int ix, TrackInfo trackinfo); - void changeTimelineTrack(int ix, TrackInfo trackinfo); void saveThumbnails(); void autoTransition(); - QStringList getLadspaParams(QDomElement effect) const; void initCursorPos(int pos); - void lockTrack(int ix, bool lock); + + /** @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, bool requestUpdate = true); void groupClips(bool group = true); void doGroupClips(QList clipInfos, QList 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); + + /** @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(); @@ -125,20 +152,50 @@ public: void updateProjectFps(); double fps() const; int selectedTrack() const; - void selectClip(bool add, bool group = false); + QStringList selectedClips() const; + QList selectedClipItems() const; + /** @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 editItemDuration(); + void buildGuidesMenu(QMenu *goMenu) const; + /** 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(); + public slots: void setCursorPos(int pos, bool seek = true); void moveCursorPos(int delta); void updateCursorPos(); - void slotDeleteEffect(ClipItem *clip, QDomElement effect); - 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, int effectPos, bool disable); + void slotChangeEffectPosition(ClipItem *clip, int track, int currentPos, int newPos); + void slotUpdateClipEffect(ClipItem *clip, int track, QDomElement oldeffect, QDomElement effect, int ix); + 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()); @@ -148,34 +205,77 @@ public slots: void slotSwitchTrackVideo(int ix); void slotSwitchTrackLock(int ix); void slotUpdateClip(const QString &clipId, bool reload = true); + + /** @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, GenTime t, QString c); - bool addGuide(const GenTime pos, const QString &comment); - void slotAddGuide(); + 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); - void slotChangeTrack(int ix); - void clipNameChanged(const QString id, const QString name); + /** @brief Shows the configure tracks dialog. */ + void slotConfigTracks(int ix); + 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 clips1, QList transitions1, QList clipsCut, QList transitionsCut, QList clips2, QList 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 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 offsetList = QList (), bool skipSelectedItems = false); + 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); @@ -183,6 +283,7 @@ protected: virtual Qt::DropActions supportedDropActions() const; private: + int m_ct; int m_tracksHeight; int m_projectDuration; int m_cursorPos; @@ -205,7 +306,7 @@ private: QPoint m_clickEvent; QList m_searchPoints; QList m_guides; - void updateSnapPoints(AbstractClipItem *selected, QList offsetList = QList (), bool skipSelectedItems = false); + ClipItem *getClipItemAt(int pos, int track); ClipItem *getClipItemAt(GenTime pos, int track); ClipItem *getClipItemAtEnd(GenTime pos, int track); @@ -221,6 +322,7 @@ private: QMenu *m_timelineContextMenu; QMenu *m_timelineContextClipMenu; QMenu *m_timelineContextTransitionMenu; + QMenu *m_markerMenu; QAction *m_autoTransition; QAction *m_pasteEffectsAction; QAction *m_ungroupAction; @@ -246,11 +348,18 @@ private: int m_selectedTrack; int m_spacerOffset; + QMutex m_mutex; + QWaitCondition m_producerNotReady; + KStatefulBrush m_activeTrackBrush; + + /** 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 infoList, int type) const; bool canBePasted(QList items, GenTime offset, int trackOffset) const; bool canBeMoved(QList items, GenTime offset, int trackOffset) const; @@ -273,6 +382,60 @@ private: /** 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); + private slots: void slotRefreshGuides(); void slotEnableRefresh(); @@ -281,22 +444,40 @@ private slots: void slotDeleteTimeLineGuide(); void slotFetchNextThumbs(); void checkTrackSequence(int track); + 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); 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 ix The index of currently selected effect + * @param raise If true, the effect stack widget will be raised (come to front). */ + void clipItemSelected(ClipItem *clip, int ix = -1, 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 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); }; #endif