X-Git-Url: https://git.sesse.net/?a=blobdiff_plain;f=src%2Fmainwindow.h;h=6d26e393422bd810d60c5e7e60486604e1d87b8e;hb=4ea740d89bef3af2870a2578f252f889be897516;hp=ac56b7547d80b6da1a1d499c1e81b6b74a815c94;hpb=2e9be1f3c112ff69ec177810aea67daaeb920ed4;p=kdenlive diff --git a/src/mainwindow.h b/src/mainwindow.h index ac56b754..6d26e393 100644 --- a/src/mainwindow.h +++ b/src/mainwindow.h @@ -37,12 +37,15 @@ #include #include #include +#include #include "effectslist.h" #include "gentime.h" #include "definitions.h" #include "statusbarmessagelabel.h" #include "dvdwizard.h" +#include "stopmotion/stopmotion.h" +#include "noteswidget.h" class KdenliveDoc; class TrackView; @@ -57,10 +60,20 @@ class CustomTrackView; class RenderWidget; #ifndef NO_JOGSHUTTLE class JogShuttle; +class JogShuttleAction; #endif /* NO_JOGSHUTTLE */ class DocClipBase; class Render; class Transition; +class Histogram; +class Vectorscope; +class Waveform; +class RGBParade; +class KActionCollection; +class AudioSignal; +class AbstractAudioScopeWidget; +class AudioSpectrum; +class Spectrogram; class MainWindow : public KXmlGuiWindow { @@ -68,15 +81,25 @@ 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; @@ -84,28 +107,36 @@ 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. - */ + + /** @brief Saves the file and the window properties when saving the session. */ virtual void saveProperties(KConfigGroup &config); - /** - * 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 - */ + /** @brief Restores the window and the file when a session is loaded. */ virtual void readProperties(const KConfigGroup &config); private: KTabWidget* m_timelineArea; QProgressBar *m_statusProgressBar; + + /** @brief Sets up all the actions and attaches them to the collection. */ void setupActions(); KdenliveDoc *m_activeDocument; TrackView *m_activeTimeline; @@ -118,6 +149,9 @@ private: EffectsListView *m_effectList; //KListWidget *m_effectList; + QDockWidget *m_notesDock; + NotesWidget *m_notesWidget; + QDockWidget *m_effectStackDock; EffectStackView *m_effectStack; @@ -133,28 +167,63 @@ private: QDockWidget *m_recMonitorDock; RecMonitor *m_recMonitor; + 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_audioSpectrumDock; + AudioSpectrum *m_audioSpectrum; + + QDockWidget *m_spectrogramDock; + Spectrogram *m_spectrogram; + QDockWidget *m_undoViewDock; QUndoView *m_undoView; QUndoGroup *m_commandStack; KComboBox *m_timecodeFormat; - QMenu *m_customEffectsMenu; + /** This list holds all the scopes used in Kdenlive, allowing to manage some global settings */ + QList m_gfxScopesList; + QList m_audioScopesList; + + KActionCategory *m_effectActions; + QMenu *m_effectsMenu; + QMenu *m_transitionsMenu; QMenu *m_timelineContextMenu; QMenu *m_timelineContextClipMenu; QMenu *m_timelineContextTransitionMenu; KUrl m_startUrl; - /** - * Shortcut to remove the focus of any element. Allows to get out - * of e.g. text input fields and to press another shortcut. - */ + /** Actions used in the stopmotion widget */ + KActionCategory *m_stopmotion_actions; + + /** Action names that can be used in the slotDoAction() slot, with their i18n() names */ + QStringList m_action_names; + + + /** @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; #ifndef NO_JOGSHUTTLE JogShuttle *m_jogProcess; + JogShuttleAction* m_jogShuttle; #endif /* NO_JOGSHUTTLE */ KRecentFilesAction *m_fileOpenRecent; @@ -162,22 +231,34 @@ private: 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; + KSelectAction *m_loadLayout; StatusBarMessageLabel *m_messageLabel; QActionGroup *m_clipTypeGroup; + KActionCollection *m_effectsActionCollection; bool m_findActivated; QString m_findString; @@ -187,50 +268,95 @@ private: void saveOptions(); #ifndef NO_JOGSHUTTLE void activateShuttleDevice(); - void slotShuttleAction(int code); #endif /* NO_JOGSHUTTLE */ void connectDocumentInfo(KdenliveDoc *doc); 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(); + + /** @brief Populates the "load layout" menu. */ + void loadLayouts(); + + StopmotionWidget *m_stopmotion; + 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 queryQuit(); + void newFile(bool showProjectSettings = true, bool force = false); 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 slotUpdateClip(const QString &id); void slotUpdateMousePosition(int pos); - void slotAddEffect(const 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(); @@ -238,16 +364,42 @@ private slots: void slotRenderProject(); 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(bool saveChanges = true); - 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(); + + /** @brief Adds marker or auide at the current position without showing the marker dialog. + * + * Adds a marker if clip monitor is active, otherwise a guide. + * The comment is set to the current position (therefore not dialog). + * This can be useful to mark something during playback. */ + void slotAddMarkerGuideQuickly(); void slotCutTimelineClip(); + void slotInsertClipOverwrite(); void slotSelectTimelineClip(); void slotSelectTimelineTransition(); void slotDeselectTimelineClip(); @@ -255,17 +407,14 @@ private slots: void slotSelectAddTimelineClip(); void slotSelectAddTimelineTransition(); void slotAddVideoEffect(QAction *result); - void slotAddAudioEffect(QAction *result); - void slotAddCustomEffect(QAction *result); void slotAddTransition(QAction *result); void slotAddProjectClip(KUrl url); -#ifndef NO_JOGSHUTTLE - void slotShuttleButton(int code); -#endif /* NO_JOGSHUTTLE */ void slotShowClipProperties(DocClipBase *clip); - void slotActivateEffectStackView(); + void slotShowClipProperties(QList cliplist, QMap commonproperties); + void slotActivateEffectStackView(ClipItem* item = NULL, int ix = -1, bool raise = true); void slotActivateTransitionView(Transition *); void slotChangeTool(QAction * action); + void slotChangeEdit(QAction * action); void slotSetTool(PROJECTTOOL tool); void slotSnapForward(); void slotSnapRewind(); @@ -276,6 +425,8 @@ private slots: void slotFind(); void findTimeout(); void slotFindNext(); + void slotSelectClipInTimeline(); + void slotClipInTimeline(const QString &clipId); void slotInsertSpace(); void slotRemoveSpace(); @@ -288,7 +439,6 @@ private slots: void slotCopy(); void slotPaste(); void slotPasteEffects(); - void slotReloadEffects(); void slotAdjustClipMonitor(); void slotAdjustProjectMonitor(); @@ -296,41 +446,97 @@ 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); + /** @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(const QString &dest, const QString &name, const QString &file); + /** @brief Archive project: creates a copy of the project file with all clips in a new folder. */ + void slotArchiveProject(); + 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); - /** Removes the focus of anything */ + + /** @brief Removes the focus of anything. */ void slotRemoveFocus(); void slotCleanProject(); - void slotSetZoom(int value); void slotUpdateClipMarkers(DocClipBase *clip); void slotRevert(); void slotShutdown(); void slotUpdateTrackInfo(); - /** \brief Change color scheme */ - void slotChangePalette(QAction *action, const QString &themename = QString()); + /** @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(); + /** @brief Update the capture folder if user asked a change. */ + void slotUpdateCaptureFolder(); + + /** @brief Apply new properties to a clip */ + void slotApplyNewClipProperties(const QString id, QMap props, QMap newprops, bool refresh, bool reload); + + /** @brief Delete a clip from current project */ + void slotDeleteClip(const QString &id); + + /** @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 slotUpdateGfxScopeFrameRequest(); + /** @brief Check if someone needs the render frame sent. */ + void slotDoUpdateGfxScopeFrameRequest(); + void slotUpdateAudioScopeFrameRequest(); + void slotDoUpdateAudioScopeFrameRequest(); + /** @brief When switching between monitors, update the visible scopes. */ + void slotUpdateColorScopes(); + /** @brief Switch current monitor to fullscreen. */ + void slotSwitchFullscreen(); + /** @brief Open the stopmotion dialog. */ + void slotOpenStopmotion(); + /** @brief Implements all the actions that are int he ActionsCollection. */ + void slotDoAction(const QString& action_name); + /** @brief Update project because the use of proxy clips was enabled / disabled. */ + void slotUpdateProxySettings(); + /** @brief Insert current project's timecode into the notes widget. */ + void slotInsertNotesTimecode(); signals: Q_SCRIPTABLE void abortRenderJob(const QString &url); };