X-Git-Url: https://git.sesse.net/?a=blobdiff_plain;f=src%2Fcustomtrackview.h;h=afa0b44912c8de691c94dcca7a81cc23347da628;hb=11a50a78e6d3c8bc7e1d189ec01233c4a33b7387;hp=2c704280e6f06f06b31c754723a4cedb5f1520f9;hpb=2de6a4383d1837c573e064307cd7f8d82eec6b6b;p=kdenlive diff --git a/src/customtrackview.h b/src/customtrackview.h index 2c704280..afa0b449 100644 --- a/src/customtrackview.h +++ b/src/customtrackview.h @@ -22,12 +22,15 @@ #define CUSTOMTRACKVIEW_H #include +#include #include #include #include #include #include +#include +#include #include "kdenlivedoc.h" #include "docclipbase.h" @@ -40,6 +43,7 @@ class AbstractClipItem; class AbstractGroupItem; class Transition; + class CustomTrackView : public QGraphicsView { Q_OBJECT @@ -53,7 +57,6 @@ 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(); @@ -83,6 +86,7 @@ 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, QMenu *markermenu); void checkTrackHeight(); @@ -107,6 +111,7 @@ public: void setDocumentModified(); void setInPoint(); void setOutPoint(); + /** @brief Prepares inserting space. * * Shows a dialog to configure length and track. */ @@ -116,21 +121,29 @@ public: 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); + /** @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 clipInfos, QList transitionInfos, bool group); void loadGroups(const QDomNodeList groups); + + /** @brief Creates SplitAudioCommands for selected clips. */ void splitAudio(); + + /** @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, bool split); void setVideoOnly(); void setAudioOnly(); @@ -143,24 +156,45 @@ public: int selectedTrack() const; QStringList selectedClips() const; QList selectedClipItems() const; - void selectClip(bool add, bool group = false); + + /** @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; 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; public slots: void setCursorPos(int pos, bool seek = true); 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, 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()); @@ -170,9 +204,17 @@ 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(); + + /** @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); @@ -184,8 +226,10 @@ public slots: 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); /** @brief Shows the configure tracks dialog. */ void slotConfigTracks(int ix); void clipNameChanged(const QString id, const QString name); @@ -194,12 +238,43 @@ public slots: 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); @@ -229,7 +304,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); @@ -271,6 +346,14 @@ 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); @@ -298,6 +381,51 @@ 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 Updates @param item's pan and zoom effect after resize or cut. + * @param item clip whose pan and zoom effect should be updated + * @param cutPos (optional) if clip was cut, cut position relative to the original's clip position */ + void updatePanZoom(ClipItem *item, GenTime cutPos = GenTime()); + + /** @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); + private slots: void slotRefreshGuides(); void slotEnableRefresh(); @@ -326,6 +454,12 @@ signals: 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