1 /***************************************************************************
2 * Copyright (C) 2007 by Jean-Baptiste Mardelle (jb@kdenlive.org) *
4 * This program is free software; you can redistribute it and/or modify *
5 * it under the terms of the GNU General Public License as published by *
6 * the Free Software Foundation; either version 2 of the License, or *
7 * (at your option) any later version. *
9 * This program is distributed in the hope that it will be useful, *
10 * but WITHOUT ANY WARRANTY; without even the implied warranty of *
11 * MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the *
12 * GNU General Public License for more details. *
14 * You should have received a copy of the GNU General Public License *
15 * along with this program; if not, write to the *
16 * Free Software Foundation, Inc., *
17 * 51 Franklin Street, Fifth Floor, Boston, MA 02110-1301 USA *
18 ***************************************************************************/
21 #ifndef CUSTOMTRACKVIEW_H
22 #define CUSTOMTRACKVIEW_H
24 #include <kdeversion.h>
25 #include <KColorScheme>
27 #include <QGraphicsView>
28 #include <QGraphicsItemAnimation>
33 #include <QWaitCondition>
35 #include "kdenlivedoc.h"
36 #include "docclipbase.h"
38 #include "effectslist.h"
39 #include "customtrackscene.h"
42 class AbstractClipItem;
43 class AbstractGroupItem;
45 class AudioCorrelation;
47 class CustomTrackView : public QGraphicsView
52 CustomTrackView(KdenliveDoc *doc, CustomTrackScene* projectscene, QWidget *parent = 0);
53 virtual ~ CustomTrackView();
54 virtual void mousePressEvent(QMouseEvent * event);
55 virtual void mouseReleaseEvent(QMouseEvent * event);
56 virtual void mouseMoveEvent(QMouseEvent * event);
57 virtual void mouseDoubleClickEvent(QMouseEvent *event);
58 void addTrack(TrackInfo type, int ix = -1);
59 void removeTrack(int ix);
60 /** @brief Makes the document use new track infos (name, type, ...). */
61 void configTracks(QList <TrackInfo> trackInfos);
63 void checkAutoScroll();
65 Move the clip at \c start to \c end.
67 If \c out_actualEnd is not NULL, it will be set to the position the clip really ended up at.
68 For example, attempting to move a clip to t = -1 s will actually move it to t = 0 s.
70 bool moveClip(const ItemInfo &start, const ItemInfo &end, bool refresh, ItemInfo *out_actualEnd = NULL);
71 void moveGroup(QList <ItemInfo> startClip, QList <ItemInfo> startTransition, const GenTime &offset, const int trackOffset, bool reverseMove = false);
72 /** move transition, startPos = (old start, old end), endPos = (new start, new end) */
73 void moveTransition(const ItemInfo &start, const ItemInfo &end, bool refresh);
74 void resizeClip(const ItemInfo &start, const ItemInfo &end, bool dontWorry = false);
75 void addClip(QDomElement xml, const QString &clipId, ItemInfo info, EffectsList list = EffectsList(), bool overwrite = false, bool push = false, bool refresh = true);
76 void deleteClip(ItemInfo info, bool refresh = true);
77 void slotDeleteClipMarker(const QString &comment, const QString &id, const GenTime &position);
78 void slotDeleteAllClipMarkers(const QString &id);
79 void addMarker(const QString &id, const CommentedTime marker);
80 void addData(const QString &id, const QString &key, const QString &data);
81 void setScale(double scaleFactor, double verticalScale);
82 void deleteClip(const QString &clipId);
83 /** @brief An effect was dropped on @param clip */
84 void slotDropEffect(ClipItem *clip, QDomElement effect, GenTime pos, int track);
85 /** @brief Add effect to current clip */
86 void slotAddEffect(QDomElement effect, GenTime pos, int track);
87 void slotAddGroupEffect(QDomElement effect, AbstractGroupItem *group, AbstractClipItem *dropTarget = NULL);
88 void addEffect(int track, GenTime pos, QDomElement effect);
89 void deleteEffect(int track, GenTime pos, QDomElement effect);
90 void updateEffect(int track, GenTime pos, QDomElement insertedEffect, bool refreshEffectStack = false);
91 /** @brief Enable / disable a list of effects */
92 void updateEffectState(int track, GenTime pos, QList <int> effectIndexes, bool disable, bool updateEffectStack);
93 void moveEffect(int track, GenTime pos, QList <int> oldPos, QList <int> newPos);
94 void addTransition(ItemInfo transitionInfo, int endTrack, QDomElement params, bool refresh);
95 void deleteTransition(ItemInfo transitionInfo, int endTrack, QDomElement params, bool refresh);
96 void updateTransition(int track, GenTime pos, QDomElement oldTransition, QDomElement transition, bool updateTransitionWidget);
97 void moveTransition(GenTime oldpos, GenTime newpos);
98 void activateMonitor();
100 void deleteSelectedClips();
101 /** @brief Cuts all clips that are selected at the timeline cursor position. */
102 void cutSelectedClips();
103 void setContextMenu(QMenu *timeline, QMenu *clip, QMenu *transition, QActionGroup *clipTypeGroup, QMenu *markermenu);
104 bool checkTrackHeight();
105 void updateSceneFrameWidth();
106 //QList <TrackInfo> tracksList() const;
107 void setTool(PROJECTTOOL tool);
108 ClipItem *cutClip(ItemInfo info, GenTime cutTime, bool cut, EffectsList oldStack = EffectsList(), bool execute = true);
109 void slotSeekToPreviousSnap();
110 void slotSeekToNextSnap();
111 double getSnapPointForPos(double pos);
112 void editKeyFrame(const GenTime &pos, const int track, const int index, const QString &keyframes);
113 bool findString(const QString &text);
114 void selectFound(QString track, QString pos);
115 bool findNextString(const QString &text);
116 void initSearchStrings();
117 void clearSearchStrings();
118 QList<ItemInfo> findId(const QString &clipId);
121 void doChangeClipSpeed(ItemInfo info, ItemInfo speedIndependantInfo, const double speed, const double oldspeed, int strobe, const QString &id);
122 /** @brief Sets the document as modified. */
123 void setDocumentModified();
127 /** @brief Prepares inserting space.
129 * Shows a dialog to configure length and track. */
130 void slotInsertSpace();
131 /** @brief Prepares removing space. */
132 void slotRemoveSpace();
133 void insertSpace(QList<ItemInfo> clipsToMove, QList<ItemInfo> transToMove, int track, const GenTime &duration, const GenTime &offset);
134 ClipItem *getActiveClipUnderCursor(bool allowOutsideCursor = false) const;
135 void deleteTimelineTrack(int ix, TrackInfo trackinfo);
136 void saveThumbnails();
137 void autoTransition();
138 void initCursorPos(int pos);
140 /** @brief Locks or unlocks a track.
141 * @param ix number of track
142 * @param lock whether to lock or unlock
143 * @param requestUpdate (default = true) Whether to request an update of the icon in the track header
145 * Makes sure no clip on track to lock is selected. */
146 void lockTrack(int ix, bool lock, bool requestUpdate = true);
147 void groupClips(bool group = true, QList<QGraphicsItem *> itemList = QList<QGraphicsItem *>(), QUndoCommand *command = NULL);
148 void doGroupClips(QList <ItemInfo> clipInfos, QList <ItemInfo> transitionInfos, bool group);
149 void loadGroups(const QDomNodeList &groups);
151 /** @brief Creates SplitAudioCommands for selected clips. */
154 /// Define which clip to take as reference for automatic audio alignment
155 void setAudioAlignReference();
157 /// Automatically align the currently selected clips to synchronize their audio with the reference's audio
160 /** @brief Seperates the audio of a clip to a audio track.
161 * @param pos Position of the clip to split
162 * @param track Track of the clip
163 * @param split Split or unsplit */
164 void doSplitAudio(const GenTime &pos, int track, EffectsList effects, bool split);
167 void setAudioAndVideo();
168 void doChangeClipType(const GenTime &pos, int track, bool videoOnly, bool audioOnly);
169 int hasGuide(int pos, int offset);
170 void reloadTransitionLumas();
171 void updateProjectFps();
173 int selectedTrack() const;
174 QStringList selectedClips() const;
175 QList<ClipItem *> selectedClipItems() const;
176 /** @brief Checks wheter an item can be inserted (make sure it does not overlap another item) */
177 bool canBePastedTo(ItemInfo info, int type) const;
179 /** @brief Selects a clip.
180 * @param add Whether to select or deselect
181 * @param group (optional) Whether to add the clip to a group
182 * @param track (optional) The track of the clip (has to be combined with @param pos)
183 * @param pos (optional) The position of the clip (has to be combined with @param track) */
184 void selectClip(bool add, bool group = false, int track = -1, int pos = -1);
185 void selectTransition(bool add, bool group = false);
186 QStringList extractTransitionsLumas();
187 void setEditMode(EDITMODE mode);
189 /** @brief Inserts @param clip.
190 * @param clip The clip to insert
191 * @param in The inpoint of the clip (crop from start)
192 * @param out The outpoint of the clip (crop from end)
194 * Inserts at the position of timeline cursor and selected track. */
195 void insertClipCut(DocClipBase *clip, int in, int out);
196 void clearSelection(bool emitInfo = true);
197 void editItemDuration();
198 void buildGuidesMenu(QMenu *goMenu) const;
199 /** update the timeline objects when palette changes */
200 void updatePalette();
201 /** @brief Returns true if a track has audio data on it.
202 * @param track The track number
204 * Check whether given track has a clip with audio in it. */
205 bool hasAudio(int track) const;
208 /** @brief Returns last requested seeking pos (or SEEK_INACTIVE if no seek). */
209 int seekPosition() const;
211 /** @brief Trigger a monitor refresh. */
212 void monitorRefresh();
214 /** @brief Returns frame number of current mouse position. */
215 int getMousePos() const;
218 /** @brief Send seek request to MLT. */
219 void seekCursorPos(int pos);
220 /** @brief Move timeline cursor to new position. */
221 void setCursorPos(int pos);
222 void moveCursorPos(int delta);
223 void updateCursorPos();
224 void slotDeleteEffect(ClipItem *clip, int track, QDomElement effect, bool affectGroup = true);
225 void slotChangeEffectState(ClipItem *clip, int track, QList <int> effectIndexes, bool disable);
226 void slotChangeEffectPosition(ClipItem *clip, int track, QList <int> currentPos, int newPos);
227 void slotUpdateClipEffect(ClipItem *clip, int track, QDomElement oldeffect, QDomElement effect, int ix, bool refreshEffectStack = true);
228 void slotUpdateClipRegion(ClipItem *clip, int ix, QString region);
229 void slotRefreshEffects(ClipItem *clip);
230 void setDuration(int duration);
231 void slotAddTransition(ClipItem* clip, ItemInfo transitionInfo, int endTrack, QDomElement transition = QDomElement());
232 void slotAddTransitionToSelectedClips(QDomElement transition);
233 void slotTransitionUpdated(Transition *, QDomElement);
234 void slotSwitchTrackAudio(int ix);
235 void slotSwitchTrackVideo(int ix);
236 void slotSwitchTrackLock(int ix);
237 void slotUpdateClip(const QString &clipId, bool reload = true);
239 /** @brief Add extra data to a clip. */
240 void slotAddClipExtraData(const QString &id, const QString &key, const QString &data = QString(), QUndoCommand *groupCommand = 0);
241 /** @brief Creates a AddClipCommand to add, edit or delete a marker.
242 * @param id Id of the marker's clip
243 * @param t Position of the marker
244 * @param c Comment of the marker */
245 void slotAddClipMarker(const QString &id, QList <CommentedTime> newMarker, QUndoCommand *groupCommand = 0);
246 void slotLoadClipMarkers(const QString &id);
247 void slotSaveClipMarkers(const QString &id);
248 bool addGuide(const GenTime &pos, const QString &comment);
250 /** @brief Shows a dialog for adding a guide.
251 * @param dialog (default = true) false = do not show the dialog but use current position as position and comment */
252 void slotAddGuide(bool dialog = true);
253 void slotEditGuide(CommentedTime guide);
254 void slotEditGuide(int guidePos = -1);
255 void slotDeleteGuide(int guidePos = -1);
256 void slotDeleteAllGuides();
257 void editGuide(const GenTime &oldPos, const GenTime &pos, const QString &comment);
260 void pasteClipEffects();
261 void slotUpdateAllThumbs();
262 void slotCheckPositionScrolling();
263 void slotInsertTrack(int ix);
265 /** @brief Shows a dialog for selecting a track to delete.
266 * @param ix Number of the track, which should be pre-selected in the dialog */
267 void slotDeleteTrack(int ix);
268 /** @brief Shows the configure tracks dialog. */
269 void slotConfigTracks(int ix);
270 void clipNameChanged(const QString &id, const QString &name);
272 void slotTrackDown();
273 void slotSelectTrack(int ix);
274 void insertZoneOverwrite(QStringList data, int in);
276 /** @brief Rebuilds a group to fit again after children changed.
277 * @param childTrack the track of one of the groups children
278 * @param childPos The position of the same child */
279 void rebuildGroup(int childTrack, GenTime childPos);
280 /** @brief Rebuilds a group to fit again after children changed.
281 * @param group The group to rebuild */
282 void rebuildGroup(AbstractGroupItem *group);
284 /** @brief Add en effect to a track.
285 * @param effect The new effect xml
286 * @param ix The track index */
287 void slotAddTrackEffect(const QDomElement &effect, int ix);
288 /** @brief Select all clips in selected track. */
289 void slotSelectClipsInTrack();
290 /** @brief Select all clips in timeline. */
291 void slotSelectAllClips();
293 /** @brief Update the list of snap points (sticky timeline hotspots).
294 * @param selected The currently selected clip if any
295 * @param offsetList The list of points that should also snap (for example when movin a clip, start and end points should snap
296 * @param skipSelectedItems if true, the selected item start and end points will not be added to snap list */
297 void updateSnapPoints(AbstractClipItem *selected, QList <GenTime> offsetList = QList <GenTime> (), bool skipSelectedItems = false);
299 void slotAddEffect(ClipItem *clip, QDomElement effect);
300 void slotImportClipKeyframes(GRAPHICSRECTITEM type);
302 /** @brief Get effect parameters ready for MLT*/
303 static void adjustEffectParameters(EffectsParameterList ¶meters, QDomNodeList params, MltVideoProfile profile, const QString &prefix = QString());
304 /** @brief Move playhead to mouse curser position if defined key is pressed */
305 void slotAlignPlayheadToMousePos();
308 virtual void drawBackground(QPainter * painter, const QRectF & rect);
309 //virtual void drawForeground ( QPainter * painter, const QRectF & rect );
310 virtual void dragEnterEvent(QDragEnterEvent * event);
311 virtual void dragMoveEvent(QDragMoveEvent * event);
312 virtual void dragLeaveEvent(QDragLeaveEvent * event);
313 /** @brief Something has been dropped onto the timeline */
314 virtual void dropEvent(QDropEvent * event);
315 virtual void wheelEvent(QWheelEvent * e);
316 virtual void keyPressEvent(QKeyEvent * event);
317 virtual QStringList mimeTypes() const;
318 virtual Qt::DropActions supportedDropActions() const;
323 int m_projectDuration;
325 KdenliveDoc *m_document;
326 CustomTrackScene *m_scene;
327 QGraphicsLineItem *m_cursorLine;
328 ItemInfo m_dragItemInfo;
329 ItemInfo m_selectionGroupInfo;
330 OPERATIONTYPE m_operationMode;
331 OPERATIONTYPE m_moveOpMode;
332 AbstractClipItem *m_dragItem;
334 QUndoStack *m_commandStack;
335 QGraphicsItem *m_visualTip;
336 QGraphicsItemAnimation *m_animation;
337 QTimeLine *m_animationTimer;
342 QList <CommentedTime> m_searchPoints;
343 QList <Guide *> m_guides;
345 ClipItem *getClipItemAt(int pos, int track);
346 ClipItem *getClipItemAt(GenTime pos, int track);
347 ClipItem *getClipItemAtEnd(GenTime pos, int track);
348 ClipItem *getClipItemAtStart(GenTime pos, int track);
349 Transition *getTransitionItem(TransitionInfo info);
350 Transition *getTransitionItemAt(int pos, int track);
351 Transition *getTransitionItemAt(GenTime pos, int track);
352 Transition *getTransitionItemAtEnd(GenTime pos, int track);
353 Transition *getTransitionItemAtStart(GenTime pos, int track);
354 void checkScrolling();
355 /** Should we auto scroll while playing (keep in sync with KdenliveSettings::autoscroll() */
357 void displayContextMenu(QPoint pos, AbstractClipItem *clip, AbstractGroupItem *group);
358 QMenu *m_timelineContextMenu;
359 QMenu *m_timelineContextClipMenu;
360 QMenu *m_timelineContextTransitionMenu;
362 QAction *m_autoTransition;
363 QAction *m_pasteEffectsAction;
364 QAction *m_ungroupAction;
365 QAction *m_editGuide;
366 QAction *m_deleteGuide;
367 QList <QAction*> m_audioActions;
368 QList <QAction*> m_avActions;
369 QActionGroup *m_clipTypeGroup;
370 QTimer m_scrollTimer;
371 QTimer m_thumbsTimer;
377 QCursor m_razorCursor;
378 QCursor m_spacerCursor;
379 /** list containing items currently copied in the timeline */
380 QList<AbstractClipItem *> m_copiedItems;
381 /** Used to get the point in timeline where a context menu was opened */
382 QPoint m_menuPosition;
384 AbstractGroupItem *m_selectionGroup;
385 QList <ClipItem *> m_waitingThumbs;
389 QMutex m_selectionMutex;
391 QWaitCondition m_producerNotReady;
392 KStatefulBrush m_activeTrackBrush;
394 AudioCorrelation *m_audioCorrelator;
395 ClipItem *m_audioAlignmentReference;
397 /** stores the state of the control modifier during mouse press.
398 * Will then be used to identify whether we resize a group or only one item of it. */
399 bool m_controlModifier;
401 /** Get the index of the video track that is just below current track */
402 int getPreviousVideoTrack(int track);
403 void updatePositionEffects(ClipItem * item, ItemInfo info, bool standalone = true);
404 bool insertDropClips(const QMimeData *data, const QPoint &pos);
405 bool canBePastedTo(QList <ItemInfo> infoList, int type) const;
406 bool canBePasted(QList<AbstractClipItem *> items, GenTime offset, int trackOffset) const;
407 bool canBeMoved(QList<AbstractClipItem *> items, GenTime offset, int trackOffset) const;
408 ClipItem *getClipUnderCursor() const;
409 AbstractClipItem *getMainActiveClip() const;
410 void resetSelectionGroup(bool selectItems = true);
411 void groupSelectedItems(QList <QGraphicsItem *> selection = QList <QGraphicsItem *>(), bool createNewGroup = false, bool selectNewGroup = false);
412 /** Get available space for clip move (min and max free positions) */
413 void getClipAvailableSpace(AbstractClipItem *item, GenTime &minimum, GenTime &maximum);
414 /** Get available space for transition move (min and max free positions) */
415 void getTransitionAvailableSpace(AbstractClipItem *item, GenTime &minimum, GenTime &maximum);
416 void updateClipTypeActions(ClipItem *clip);
417 /** Whether an item can be moved to a new position without colliding with similar items */
418 bool itemCollision(AbstractClipItem *item, ItemInfo newPos);
419 /** Selects all items in the scene rect, and sets ok to false if a group going over several tracks is found in it */
420 QList<QGraphicsItem *> checkForGroups(const QRectF &rect, bool *ok);
421 /** Adjust clips under another one when working in overwrite mode */
422 void adjustTimelineClips(EDITMODE mode, ClipItem *item, ItemInfo posinfo, QUndoCommand *command);
423 void adjustTimelineTransitions(EDITMODE mode, Transition *item, QUndoCommand *command);
424 /** Adjust keyframes when pasted to another clip */
425 void adjustKeyfames(GenTime oldstart, GenTime newstart, GenTime duration, QDomElement xml);
427 /** @brief Removes the tip and stops the animation timer. */
428 void removeTipAnimation();
429 /** @brief Creates a new tip animation.
430 * @param clip clip to display the tip on
431 * @param mode operation mode for which the tip should be displayed
432 * @param size size of the tip */
433 void setTipAnimation(AbstractClipItem *clip, OPERATIONTYPE mode, const double size);
435 /** @brief Takes care of updating effects and attached transitions during a resize from start.
436 * @param item Item to resize
437 * @param oldInfo The item's info before resizement (set to item->info() is @param check true)
438 * @param pos New startPos
439 * @param check (optional, default = false) Whether to check for collisions
440 * @param command (optional) Will be used as parent command (for undo history) */
441 void prepareResizeClipStart(AbstractClipItem *item, ItemInfo oldInfo, int pos, bool check = false, QUndoCommand *command = NULL);
443 /** @brief Takes care of updating effects and attached transitions during a resize from end.
444 * @param item Item to resize
445 * @param oldInfo The item's info before resizement (set to item->info() is @param check true)
446 * @param pos New endPos
447 * @param check (optional, default = false) Whether to check for collisions
448 * @param command (optional) Will be used as parent command (for undo history) */
449 void prepareResizeClipEnd(AbstractClipItem *item, ItemInfo oldInfo, int pos, bool check = false, QUndoCommand *command = NULL);
451 /** @brief Collects information about the group's children to pass it on to RazorGroupCommand.
452 * @param group The group to cut
453 * @param cutPos The absolute position of the cut */
454 void razorGroup(AbstractGroupItem *group, GenTime cutPos);
456 /** @brief Gets the effect parameters that will be passed to Mlt. */
457 EffectsParameterList getEffectArgs(const QDomElement &effect);
459 /** @brief Update Tracknames to fit again after track was added/deleted.
460 * @param track Number of track which was added/deleted
461 * @param added true = track added, false = track deleted
463 * The default track name consists of type + number. If we add/delete a track the number has to be adjusted
464 * if the name is still the default one. */
465 void updateTrackNames(int track, bool added);
467 /** @brief Updates the duration stored in a track's TrackInfo.
468 * @param track Number of track as used in ItemInfo (not the numbering used in KdenliveDoc) (negative for all tracks)
469 * @param command If effects need to be updated the commands to do this will be attached to this undo command
471 * In addition to update the duration in TrackInfo it updates effects with keyframes on the track. */
472 void updateTrackDuration(int track, QUndoCommand *command);
474 /** @brief Adjusts effects after a clip resize.
475 * @param item The item that was resized
476 * @param oldInfo pre resize info
477 * @param fromStart false = resize from end
478 * @param command Used as a parent for EditEffectCommand */
479 void adjustEffects(ClipItem *item, ItemInfo oldInfo, QUndoCommand *command);
481 /** @brief Prepare an add clip command for an effect */
482 void processEffect(ClipItem *item, QDomElement effect, int offset, QUndoCommand *effectCommand);
485 void slotRefreshGuides();
486 void slotEnableRefresh();
487 void slotCheckMouseScrolling();
488 void slotEditTimeLineGuide();
489 void slotDeleteTimeLineGuide();
490 void slotFetchNextThumbs();
491 void checkTrackSequence(int track);
492 void slotGoToMarker(QAction *action);
493 void slotResetMenuPosition();
494 void slotDoResetMenuPosition();
495 /** @brief Re-create the clip thumbnails.
496 * @param id The clip's Id string.
497 * @param resetThumbs Should we recreate the timeline thumbnails. */
498 void slotRefreshThumbs(const QString &id, bool resetThumbs);
499 /** @brief A Filter job producer results. */
500 void slotGotFilterJobResults(const QString &id, int startPos, int track, stringMap filterParams, stringMap extra);
504 void cursorMoved(int, int);
507 void mousePosition(int);
508 /** @brief A clip was selected in timeline, update the effect stack
509 * @param clip The clip
510 * @param raise If true, the effect stack widget will be raised (come to front). */
511 void clipItemSelected(ClipItem *clip, bool raise = true);
512 void transitionItemSelected(Transition*, int track = 0, QPoint p = QPoint(), bool update = false);
513 void activateDocumentMonitor();
514 void trackHeightChanged();
515 void tracksChanged();
516 void displayMessage(const QString &, MessageType);
517 void showClipFrame(DocClipBase *, QPoint, bool, const int);
518 void doTrackLock(int, bool);
519 void updateClipMarkers(DocClipBase *);
520 void updateClipExtraData(DocClipBase *);
521 void updateTrackHeaders();
523 /** @brief Monitor document changes (for example the presence of audio data in timeline for export widget.*/
524 void documentModified();
525 void forceClipProcessing(const QString &);
526 void showTrackEffects(int, TrackInfo);
527 /** @brief Update the track effect button that shows if a track has effects or not.*/
528 void updateTrackEffectState(int);
529 /** @brief Cursor position changed, repaint ruler.*/
531 /** @brief Send data from a clip to be imported as keyframes for effect / transition.*/
532 void importKeyframes(GRAPHICSRECTITEM type, const QString&, int maximum);