#include <QProgressBar>
#include <QEvent>
#include <QTimer>
+#include <QShortcut>
#include <KXmlGuiWindow>
#include <KTextEdit>
class DocClipBase;
class Render;
class Transition;
+class Histogram;
+class Vectorscope;
+class Waveform;
+class RGBParade;
+class KActionCollection;
+class AudioSignal;
class MainWindow : public KXmlGuiWindow
{
Q_CLASSINFO("D-Bus Interface", "org.kdenlive.MainWindow")
public:
- /** Constructor
- * \param MltPath path to MLT environment
- * \param Url Url to open
- * \param parent Std. widget parent
+
+ /** @brief Initialises the main window.
+ * @param MltPath (optional) path to MLT environment
+ * @param Url (optional) file to open
+ * @param clipsToLoad (optional) a comma separated list of clips to import in project
+ *
+ * If Url is present, it will be opened, otherwhise, if openlastproject is
+ * set, latest project will be opened. If no file is open after trying this,
+ * a default new file will be created. */
+ explicit MainWindow(const QString &MltPath = QString(),
+ const KUrl &Url = KUrl(), const QString & clipsToLoad = QString(), QWidget *parent = 0);
+ virtual ~MainWindow();
+
+ /** @brief Locates the MLT environment.
+ * @param mltPath (optional) path to MLT environment
*
- * The constructor inits the main window. If Url is present, it will be opened.
- * If Url is not present, and openLastproject is set, last project will be set
- * If no file is open after trying this, a default "newfile" will be created. */
- explicit MainWindow(const QString &MltPath = QString(), const KUrl & Url = KUrl(), QWidget *parent = 0);
+ * It tries to set the paths of the MLT profiles and renderer, using
+ * mltPath, MLT_PREFIX, searching for the binary `melt`, or asking to the
+ * user. It doesn't fill any list of profiles, while its name suggests so. */
void parseProfiles(const QString &mltPath = QString());
static EffectsList videoEffects;
static EffectsList customEffects;
static EffectsList transitions;
protected:
+
+ /** @brief Closes the window.
+ * @return false if the user presses "Cancel" on a confirmation dialog or
+ * the operation requested (starting waiting jobs or saving file) fails,
+ * true otherwise */
virtual bool queryClose();
- virtual void customEvent(QEvent * e);
+
+ /** @brief Reports a message in the status bar when an error occurs. */
+ virtual void customEvent(QEvent *e);
+
+ /** @brief Enables live search in the timeline. */
virtual void keyPressEvent(QKeyEvent *ke);
- /** Override hideEvent to get events when the mainwindow gets hidden */
+
+ /** @brief Stops the active monitor when the window gets hidden. */
virtual void hideEvent(QHideEvent *e);
+
+ /** @brief Filters key events to the live search. */
bool eventFilter(QObject *obj, QEvent *ev);
- /**
- * This function is called when it is time for the app to save its
- * properties for session management purposes.
- */
- void saveProperties(KConfig *);
-
- /**
- * This function is called when this app is restored. The KConfig
- * object points to the session management config file that was saved
- * with @ref saveProperties
- */
- void readProperties(KConfig *);
+
+ /** @brief Saves the file and the window properties when saving the session. */
+ virtual void saveProperties(KConfigGroup &config);
+
+ /** @brief Restores the window and the file when a session is loaded. */
+ virtual void readProperties(const KConfigGroup &config);
private:
KTabWidget* m_timelineArea;
- QProgressBar *statusProgressBar;
+ QProgressBar *m_statusProgressBar;
+
+ /** @brief Sets up all the actions and attaches them to the collection. */
void setupActions();
KdenliveDoc *m_activeDocument;
TrackView *m_activeTimeline;
MonitorManager *m_monitorManager;
- QDockWidget *projectListDock;
+ QDockWidget *m_projectListDock;
ProjectList *m_projectList;
- QDockWidget *effectListDock;
+ QDockWidget *m_effectListDock;
EffectsListView *m_effectList;
//KListWidget *m_effectList;
- QDockWidget *effectStackDock;
- EffectStackView *effectStack;
+ QDockWidget *m_notesDock;
+ KTextEdit *m_notesWidget;
+
+ QDockWidget *m_effectStackDock;
+ EffectStackView *m_effectStack;
- QDockWidget *transitionConfigDock;
- TransitionSettings *transitionConfig;
+ QDockWidget *m_transitionConfigDock;
+ TransitionSettings *m_transitionConfig;
- QDockWidget *clipMonitorDock;
+ QDockWidget *m_clipMonitorDock;
Monitor *m_clipMonitor;
- QDockWidget *projectMonitorDock;
+ QDockWidget *m_projectMonitorDock;
Monitor *m_projectMonitor;
- QDockWidget *recMonitorDock;
+ QDockWidget *m_recMonitorDock;
RecMonitor *m_recMonitor;
- QDockWidget *undoViewDock;
+ QDockWidget *m_vectorscopeDock;
+ Vectorscope *m_vectorscope;
+
+ QDockWidget *m_waveformDock;
+ Waveform *m_waveform;
+
+ QDockWidget *m_RGBParadeDock;
+ RGBParade *m_RGBParade;
+
+ QDockWidget *m_histogramDock;
+ Histogram *m_histogram;
+
+ QDockWidget *m_audiosignalDock;
+ AudioSignal *m_audiosignal;
+
+ QDockWidget *m_undoViewDock;
QUndoView *m_undoView;
QUndoGroup *m_commandStack;
KComboBox *m_timecodeFormat;
+ /** This list holds all the scopes used in Kdenlive, allowing to manage some global settings */
+ QList <QDockWidget *> m_scopesList;
+
+ QMenu *m_videoEffectsMenu;
+ QMenu *m_audioEffectsMenu;
QMenu *m_customEffectsMenu;
+ QMenu *m_transitionsMenu;
QMenu *m_timelineContextMenu;
QMenu *m_timelineContextClipMenu;
QMenu *m_timelineContextTransitionMenu;
+ KUrl m_startUrl;
+
+ /** @brief Shortcut to remove the focus from any element.
+ *
+ * It allows to get out of e.g. text input fields and to press another
+ * shortcut. */
+ QShortcut* m_shortcutRemoveFocus;
RenderWidget *m_renderWidget;
#endif /* NO_JOGSHUTTLE */
KRecentFilesAction *m_fileOpenRecent;
+ KAction *m_fileRevert;
KAction *m_projectSearch;
KAction *m_projectSearchNext;
+ KAction **m_videoEffects;
+ KAction **m_audioEffects;
+ KAction **m_customEffects;
+ KAction **m_transitions;
KAction *m_buttonAudioThumbs;
KAction *m_buttonVideoThumbs;
KAction *m_buttonShowMarkers;
KAction *m_buttonFitZoom;
+ KAction *m_buttonAutomaticSplitAudio;
+ KAction *m_normalEditTool;
+ KAction *m_overwriteEditTool;
+ KAction *m_insertEditTool;
KAction *m_buttonSelectTool;
KAction *m_buttonRazorTool;
KAction *m_buttonSpacerTool;
KAction *m_buttonSnap;
- QActionGroup *m_toolGroup;
KAction *m_saveAction;
KAction *m_closeAction;
QSlider *m_zoomSlider;
+ KAction *m_zoomIn;
+ KAction *m_zoomOut;
KAction *m_loopZone;
KAction *m_playZone;
+ KAction *m_loopClip;
StatusBarMessageLabel *m_messageLabel;
QActionGroup *m_clipTypeGroup;
+ KActionCollection *m_effectsActionCollection;
bool m_findActivated;
QString m_findString;
void findAhead();
void doOpenFile(const KUrl &url, KAutoSaveFile *stale);
void recoverFiles(QList<KAutoSaveFile *> staleFiles);
+
+ /** @brief Loads static and dynamic plugins.
+ *
+ * It scans static plugins as well as the filesystem: it doesn't load more
+ * than one plugin per file name, to avoid duplication due to conflicting
+ * installations. */
void loadPlugins();
void populateMenus(QObject *plugin);
void addToMenu(QObject *plugin, const QStringList &texts,
QMenu *menu, const char *member,
QActionGroup *actionGroup);
void aboutPlugins();
+
+ /** @brief Instantiates a "Get Hot New Stuff" dialog.
+ * @param configFile configuration file for KNewStuff
+ * @return number of installed items */
+ int getNewStuff(const QString &configFile = QString());
QStringList m_pluginFileNames;
QByteArray m_timelineState;
+ void loadTranscoders();
+ QPixmap createSchemePreviewIcon(const KSharedConfigPtr &config);
+
+ /** @brief Checks that the Kdenlive mime type is correctly installed.
+ * @return The mimetype */
+ QString getMimeType();
+
+ /** @brief Populates the "load layout" menu. */
+ void loadLayouts();
public slots:
+ /** @brief Prepares opening @param url.
+ *
+ * Checks if already open and whether backup exists */
void openFile(const KUrl &url);
void slotGotProgressInfo(const QString &message, int progress);
+ void slotReloadEffects();
Q_SCRIPTABLE void setRenderingProgress(const QString &url, int progress);
Q_SCRIPTABLE void setRenderingFinished(const QString &url, int status, const QString &error);
+
private slots:
- void newFile(bool showProjectSettings = true);
+ void newFile(bool showProjectSettings = true, bool force = false);
void queryQuit();
void activateDocument();
void connectDocument(TrackView*, KdenliveDoc*);
+
+ /** @brief Shows file open dialog. */
void openFile();
void openLastFile();
+
+ /** @brief Checks whether a URL is available to save to.
+ * @return Whether the file was saved. */
bool saveFile();
+
+ /** @brief Shows a save file dialog for saving the project.
+ * @return Whether the file was saved. */
bool saveFileAs();
+
+ /** @brief Set properties to match outputFileName and save the document.
+ * @param outputFileName The URL to save to / The document's URL.
+ * @return Whether we had success. */
bool saveFileAs(const QString &outputFileName);
+
+ /** @brief Shows the shortcut dialog. */
+ void slotEditKeys();
void slotPreferences(int page = -1, int option = -1);
+
+ /** @brief Reflects setting changes to the GUI. */
void updateConfiguration();
void slotConnectMonitors();
void slotRaiseMonitor(bool clipMonitor);
- void slotSetClipDuration(const QString &id, int duration);
+ void slotUpdateClip(const QString &id);
void slotUpdateMousePosition(int pos);
- void slotAddEffect(QDomElement effect, GenTime pos = GenTime(), int track = -1);
+ void slotAddEffect(const QDomElement effect);
void slotEditProfiles();
+ void slotDetectAudioDriver();
void slotEditProjectSettings();
+ /** @brief Change current document MLT profile. */
+ void slotUpdateProjectProfile(const QString &profile);
void slotDisplayActionMessage(QAction *a);
+
+ /** @brief Turns automatic splitting of audio and video on/off. */
+ void slotSwitchSplitAudio();
void slotSwitchVideoThumbs();
void slotSwitchAudioThumbs();
void slotSwitchMarkersComments();
void slotSwitchSnap();
void slotRenderProject();
- void slotDoRender(const QString &dest, const QString &render, const QStringList &overlay_args, const QStringList &avformat_args, bool zoneOnly, bool playAfter, double guideStart, double guideEnd, bool resizeProfile, const QString &scriptExport);
void slotFullScreen();
void slotUpdateDocumentState(bool modified);
+
+ /** @brief Sets the timeline zoom slider to @param value.
+ *
+ * Also disables zoomIn and zoomOut actions if they cannot be used at the moment. */
+ void slotSetZoom(int value);
+ /** @brief Decreases the timeline zoom level by 1. */
void slotZoomIn();
+ /** @brief Increases the timeline zoom level by 1. */
void slotZoomOut();
+ /** @brief Makes the timeline zoom level fit the timeline content. */
void slotFitZoom();
- void closeCurrentDocument();
- void slotDeleteTimelineClip();
+ /** @brief Updates the zoom slider tooltip to fit @param zoomlevel. */
+ void slotUpdateZoomSliderToolTip(int zoomlevel);
+
+ /** @brief Displays the zoom slider tooltip.
+ * @param zoomlevel (optional) The zoom level to show in the tooltip.
+ *
+ * Adopted from Dolphin (src/statusbar/dolphinstatusbar.cpp) */
+ void slotShowZoomSliderToolTip(int zoomlevel = -1);
+ /** @brief Close currently opened document. Returns false if something went wrong (cannot save modifications, ...). */
+ bool closeCurrentDocument(bool saveChanges = true);
+ /** @brief Deletes item in timeline, project tree or effect stack depending on focus. */
+ void slotDeleteItem();
void slotAddClipMarker();
void slotDeleteClipMarker();
void slotDeleteAllClipMarkers();
void slotEditClipMarker();
void slotCutTimelineClip();
+ void slotInsertClipOverwrite();
+ void slotSelectTimelineClip();
+ void slotSelectTimelineTransition();
+ void slotDeselectTimelineClip();
+ void slotDeselectTimelineTransition();
+ void slotSelectAddTimelineClip();
+ void slotSelectAddTimelineTransition();
void slotAddVideoEffect(QAction *result);
void slotAddAudioEffect(QAction *result);
void slotAddCustomEffect(QAction *result);
void slotShuttleButton(int code);
#endif /* NO_JOGSHUTTLE */
void slotShowClipProperties(DocClipBase *clip);
+ void slotShowClipProperties(QList <DocClipBase *>cliplist, QMap<QString, QString> commonproperties);
void slotActivateEffectStackView();
void slotActivateTransitionView(Transition *);
void slotChangeTool(QAction * action);
+ void slotChangeEdit(QAction * action);
void slotSetTool(PROJECTTOOL tool);
void slotSnapForward();
void slotSnapRewind();
void slotClipStart();
void slotClipEnd();
+ void slotZoneStart();
+ void slotZoneEnd();
void slotFind();
void findTimeout();
void slotFindNext();
+ void slotSelectClipInTimeline();
+ void slotClipInTimeline(const QString &clipId);
void slotInsertSpace();
void slotRemoveSpace();
void slotCopy();
void slotPaste();
void slotPasteEffects();
- void slotReloadEffects();
- void slotChangeClipSpeed();
void slotAdjustClipMonitor();
void slotAdjustProjectMonitor();
void slotSetInPoint();
void slotSetOutPoint();
+ void slotResizeItemStart();
+ void slotResizeItemEnd();
void configureNotifications();
void slotInsertTrack(int ix = 0);
void slotDeleteTrack(int ix = 0);
- void slotChangeTrack(int ix = 0);
+ /** @brief Shows the configure tracks dialog and updates transitions afterwards. */
+ void slotConfigTrack(int ix = -1);
void slotGetNewLumaStuff();
+ void slotGetNewTitleStuff();
void slotGetNewRenderStuff();
void slotGetNewMltProfileStuff();
void slotAutoTransition();
void slotRunWizard();
+ /** @brief Lets the sampleplugin create a generator. */
void generateClip();
void slotZoneMoved(int start, int end);
void slotUpdatePreviewSettings();
void slotDvdWizard(const QString &url = QString(), const QString &profile = "dv_pal");
void slotGroupClips();
void slotUnGroupClips();
+ void slotEditItemDuration();
+ void slotClipInProjectTree();
+ //void slotClipToProjectTree();
void slotSplitAudio();
void slotUpdateClipType(QAction *action);
void slotShowTimeline(bool show);
void slotMaximizeCurrent(bool show);
+ void slotTranscode(KUrl::List urls = KUrl::List());
+ void slotTranscodeClip();
+ void slotSetDocumentRenderProfile(QMap <QString, QString> props);
+ void slotPrepareRendering(bool scriptExport, bool zoneOnly, const QString &chapterFile);
+
+ /** @brief Switches between displaying frames or timecode.
+ * @param ix 0 = display timecode, 1 = display frames. */
+ void slotUpdateTimecodeFormat(int ix);
+
+ /** @brief Removes the focus of anything. */
+ void slotRemoveFocus();
+ void slotCleanProject();
+ void slotUpdateClipMarkers(DocClipBase *clip);
+ void slotRevert();
+ void slotShutdown();
+ void slotUpdateTrackInfo();
+
+ /** @brief Changes the color scheme. */
+ void slotChangePalette(QAction *action, const QString &themename = QString());
+ void slotSwitchMonitors();
+ void slotCheckRenderStatus();
+ void slotInsertZoneToTree();
+ void slotInsertZoneToTimeline();
+
+ /** @brief Deletes items from timeline and document.
+ * @param ids The ids of the clips to delete.
+ * @param folderids The names and ids of the folders to delete. */
+ void slotDeleteProjectClips(QStringList ids, QMap<QString, QString> folderids);
+ void slotShowTitleBars(bool show);
+ void slotSwitchTitles();
+ /** @brief Update the capture folder if user asked a change. */
+ void slotUpdateCaptureFolder();
+
+ /** @brief Saves the widgets layout */
+ void slotSaveLayout(QAction*);
+ void slotLoadLayout(QAction*);
+
+ /** @brief The monitor informs that it needs (or not) to have frames sent by the renderer. */
+ void slotMonitorRequestRenderFrame(bool request);
+ /** @brief Check if someone needs the render frame sent. */
+ void slotUpdateScopeFrameRequest();
+ /** @brief Check if someone needs the render frame sent. */
+ void slotDoUpdateScopeFrameRequest();
+ /** @brief When switching between monitors, update the visible scopes. */
+ void slotUpdateColorScopes();
signals:
Q_SCRIPTABLE void abortRenderJob(const QString &url);