X-Git-Url: https://git.sesse.net/?a=blobdiff_plain;f=src%2Fmainwindow.h;h=116c5661d127a08efedfa78d71cadc7e06419130;hb=7c066a50b5c795b85b4e94d489dfb18458d7ce7b;hp=57d87fe6a9d0057075d4ae33eba54e6b1c283802;hpb=1089e039028d629791ad426b7b885e53243468c9;p=kdenlive diff --git a/src/mainwindow.h b/src/mainwindow.h index 57d87fe6..116c5661 100644 --- a/src/mainwindow.h +++ b/src/mainwindow.h @@ -27,6 +27,7 @@ #include #include #include +#include #include #include @@ -41,6 +42,7 @@ #include "gentime.h" #include "definitions.h" #include "statusbarmessagelabel.h" +#include "dvdwizard.h" class KdenliveDoc; class TrackView; @@ -59,21 +61,35 @@ class JogShuttle; class DocClipBase; class Render; class Transition; - -class MainWindow : public KXmlGuiWindow { +class Histogram; +class Vectorscope; +class Waveform; +class RGBParade; +class KActionCollection; + +class MainWindow : public KXmlGuiWindow +{ Q_OBJECT 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 * - * 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. */ - MainWindow(const QString &MltPath = QString(), const KUrl & Url = KUrl(), QWidget *parent = 0); + * 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(), QWidget *parent = 0); + + /** @brief Locates the MLT environment. + * @param mltPath (optional) path to MLT environment + * + * 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; @@ -81,68 +97,95 @@ public: 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_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_undoViewDock; QUndoView *m_undoView; QUndoGroup *m_commandStack; KComboBox *m_timecodeFormat; - QDockWidget *overviewDock; - CustomTrackView *m_overView; - + 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; @@ -151,29 +194,40 @@ private: #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; - QAction *m_loopZone; - QAction *m_playZone; + KAction *m_zoomIn; + KAction *m_zoomOut; + KAction *m_loopZone; + KAction *m_playZone; StatusBarMessageLabel *m_messageLabel; + QActionGroup *m_clipTypeGroup; + KActionCollection *m_effectsActionCollection; bool m_findActivated; QString m_findString; QTimer m_findTimer; - bool m_initialized; void readOptions(); void saveOptions(); @@ -185,57 +239,124 @@ private: void findAhead(); void doOpenFile(const KUrl &url, KAutoSaveFile *stale); void recoverFiles(QList 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(); 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); 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, GenTime pos = GenTime(), int track = -1); void slotEditProfiles(); + void slotDetectAudioDriver(); void slotEditProjectSettings(); 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); 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); + + void 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); @@ -245,17 +366,23 @@ private slots: void slotShuttleButton(int code); #endif /* NO_JOGSHUTTLE */ void slotShowClipProperties(DocClipBase *clip); + void slotShowClipProperties(QList cliplist, QMap 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(); @@ -269,7 +396,6 @@ private slots: void slotPaste(); void slotPasteEffects(); void slotReloadEffects(); - void slotChangeClipSpeed(); void slotAdjustClipMonitor(); void slotAdjustProjectMonitor(); @@ -277,16 +403,63 @@ private slots: 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); - void slotGetNewStuff(); + /** @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 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 folderids); + void slotShowTitleBars(bool show); + void slotSwitchTitles(); signals: Q_SCRIPTABLE void abortRenderJob(const QString &url);